chore: sync fnOS package with Havline 2.0.0

README.md

@@ -19,66 +19,36 @@
 
 仍需完成：
 
-- 修复 Gitea Registry 的 HTTP token realm，使 Docker 能正常 push/pull；
+- 在飞牛 x86_64 与 ARM 设备验证离线安装、启动、入口、升级和卸载；
-- 确认飞牛设备是否可以匿名拉取，或在安装前配置 Registry 登录；
+- 验证应用用户加入 `docker` 组后的 `docker load`、`docker inspect` 权限。
-- 在飞牛测试设备验证安装、启动、入口、升级和卸载；
-- 验证 amd64 与 arm64 镜像均可在真实设备上拉取。
 
-## 当前阻塞
+## 离线镜像包
 
-`jayhub.top/mrlee/havline:1.9.0` 已经包含 amd64 与 arm64 多架构索引，
+当前应用已经切换为离线镜像包模式，不依赖外部 Docker Registry。
-但当前 Gitea 返回的认证地址仍是 HTTP：
+
+包内包含：
 
 ```text
-WWW-Authenticate: Bearer realm="http://jayhub.top/v2/token", ...
+target/docker/havline-<version>-amd64.tar.gz
+target/docker/havline-<version>-arm64.tar.gz
 ```
 
-Docker 会在 HTTP 到 HTTPS 的跳转过程中丢失换取 token 所需的认证信息，
+安装或升级回调会执行：
-因此 `docker pull` 和 `docker push` 都会报：
-
-```text
-failed to fetch oauth token:
-authorization server did not include a token in the response
-```
-
-在 Gitea `ROOT_URL` 改成 `https://jayhub.top/` 并确认反向代理传递
-`X-Forwarded-Proto: https` 之前，飞牛设备无法稳定拉取该镜像。
-详细修复步骤见主程序仓库：
-
-```text
-docs/gitea-registry-fix.md
-```
-
-## 镜像地址
-
-当前应用使用：
-
-```text
-jayhub.top/mrlee/havline:${TRIM_APPVER}
-```
-
-对应标签需要包含：
-
-```text
-linux/amd64
-linux/arm64
-```
-
-新地址已经使用 HTTPS，不需要再配置 `insecure-registries`。
-
-验证镜像：
 
 ```bash
-docker pull jayhub.top/mrlee/havline:1.9.0
+docker load -i target/docker/havline-<version>-<arch>.tar.gz
 ```
 
-如果仓库不是公开可拉取，先登录：
+Compose 使用本地镜像：
 
-```bash
+```yaml
-docker login jayhub.top
+image: havline:${TRIM_APPVER}
+pull_policy: never
 ```
 
-拉取成功后重新安装 `havline-1.9.0.fpk`。
+因此安装时不需要访问外部镜像仓库（GitHub Container Registry），也不需要配置 Registry 登录。
+
+当前 2.0.0 双架构 `.fpk` 约 `150 MB`（以实际构建产物为准）。
 
 ## 打包
 
@@ -95,6 +65,13 @@ cd F:\Fonu-main\fnos
 fnos/dist/havline-<version>.fpk
 ```
 
+默认会同时导出 amd64 与 arm64 镜像归档。若本次只修改了打包元数据，
+且已有对应版本的镜像归档，可以使用：
+
+```powershell
+.\build.ps1 -SkipImageExport
+```
+
 如果 `fnpack` 已在 PATH 中，也可以传入路径：
 
 ```powershell
@@ -110,7 +87,7 @@ appcenter-cli install-fpk havline.fpk
 安装后检查：
 
 1. 应用中心显示 Havline；
-2. Docker 镜像可以拉取；
+2. 安装回调成功加载离线镜像；
 3. Havline 容器能够启动；
 4. 桌面入口可以打开管理界面；
 5. 数据写入 `${TRIM_PKGVAR}`；
@@ -126,7 +103,8 @@ appcenter-cli install-fpk havline.fpk
 
 ## 首发边界
 
-- 不挂载 Docker Socket。
+- 容器本身不挂载 Docker Socket。
+- 生命周期脚本通过应用用户的 `docker` 附加组执行 `docker load` 和状态检查。
 - 不启动 Havline 自带 updater。
 - 不使用 host 网络。
 - 不共享数据库、证书、密钥、Nginx、FRP 和 cloudflared 目录。

build.ps1

@@ -1,5 +1,6 @@
-param(
+param(
-  [string]$FnpackPath = ""
+  [string]$FnpackPath = "",
+  [switch]$SkipImageExport
 )
 
 $ErrorActionPreference = "Stop"
@@ -7,10 +8,94 @@ $root = (Resolve-Path (Join-Path $PSScriptRoot "..")).Path
 $project = Join-Path $root "fnos\havline"
 $version = (Get-Content -Raw (Join-Path $root "havline\VERSION")).Trim()
 
+function Resolve-DockerCli {
+  if ($env:DOCKER_BIN) { return $env:DOCKER_BIN }
+  $command = Get-Command docker -ErrorAction SilentlyContinue
+  if ($command) { return $command.Source }
+  $default = "C:\Program Files\Docker\Docker\resources\bin\docker.exe"
+  if (Test-Path -LiteralPath $default) { return $default }
+  throw "找不到 docker 命令"
+}
+
+function Export-OfflineImage {
+  param(
+    [string]$DockerBin,
+    [string]$BuildContext,
+    [string]$Platform,
+    [string]$Arch,
+    [string]$Version,
+    [string]$OutputDir
+  )
+
+  $tarName = "havline-$Version-$Arch.tar"
+  $tar = Join-Path $OutputDir $tarName
+  $gz = Join-Path $OutputDir "havline-$Version-$Arch.tar.gz"
+
+  Push-Location $BuildContext
+  try {
+    & $DockerBin buildx build `
+      --platform $Platform `
+      --build-arg VERSION_FILE=VERSION `
+      --provenance=false `
+      --sbom=false `
+      --output "type=docker,name=havline:$Version,dest=$tar" `
+      .
+    if ($LASTEXITCODE -ne 0) {
+      throw "导出 $Arch 镜像失败，退出码：$LASTEXITCODE"
+    }
+  }
+  finally {
+    Pop-Location
+  }
+
+  Compress-GzipFile -Source $tar -Destination $gz
+
+  Remove-Item -LiteralPath $tar -Force
+  Write-Output "镜像归档：$gz"
+}
+
+function Compress-GzipFile {
+  param(
+    [string]$Source,
+    [string]$Destination
+  )
+
+  $sourceStream = [System.IO.File]::OpenRead($Source)
+  try {
+    $targetStream = [System.IO.File]::Create($Destination)
+    try {
+      $gzip = New-Object System.IO.Compression.GZipStream($targetStream, [System.IO.Compression.CompressionLevel]::Optimal)
+      try {
+        $sourceStream.CopyTo($gzip)
+      }
+      finally {
+        $gzip.Dispose()
+      }
+    }
+    finally {
+      $targetStream.Dispose()
+    }
+  }
+  finally {
+    $sourceStream.Dispose()
+  }
+}
+
 if (-not (Test-Path -LiteralPath $project)) {
   throw "找不到飞牛应用工程：$project"
 }
 
+# 版本一致性校验：Docker 版离线镜像标签为 havline:<主仓 VERSION>，
+# 而容器运行时按 ${TRIM_APPVER}=manifest.version 加载镜像，两者必须严格一致。
+$manifestVersion = ([regex]::Match((Get-Content -Raw (Join-Path $project "manifest")), '(?m)^version\s*=\s*(\S+)')).Groups[1].Value
+if (-not $manifestVersion) {
+  throw "Docker manifest 缺少 version 字段：$(Join-Path $project 'manifest')"
+}
+Write-Output "App version: $version; Manifest version: $manifestVersion"
+if ($manifestVersion -ne $version) {
+  throw "版本不一致：主仓 VERSION=$version，Docker manifest=$manifestVersion。镜像标签与运行时加载版本不匹配，请先将 fnos\havline\manifest 的 version 同步为主仓 VERSION。"
+}
+
 if (-not $FnpackPath) {
   $localTool = Join-Path $PSScriptRoot "fnpack.exe"
   $FnpackPath = if (Test-Path -LiteralPath $localTool) { $localTool } else { "fnpack" }
@@ -24,6 +109,24 @@ if ($LASTEXITCODE -ge 8) {
   throw "复制飞牛应用工程失败，robocopy 退出码：$LASTEXITCODE"
 }
 
+$imageDir = Join-Path $stage "app\docker"
+New-Item -ItemType Directory -Force $imageDir | Out-Null
+
+if (-not $SkipImageExport) {
+  $dockerBin = Resolve-DockerCli
+  $buildContext = Join-Path $root "havline"
+  Export-OfflineImage -DockerBin $dockerBin -BuildContext $buildContext -Platform "linux/amd64" -Arch "amd64" -Version $version -OutputDir $imageDir
+  Export-OfflineImage -DockerBin $dockerBin -BuildContext $buildContext -Platform "linux/arm64" -Arch "arm64" -Version $version -OutputDir $imageDir
+}
+else {
+  foreach ($arch in @("amd64", "arm64")) {
+    $required = Join-Path $imageDir "havline-$version-$arch.tar.gz"
+    if (-not (Test-Path -LiteralPath $required)) {
+      throw "缺少离线镜像：$required"
+    }
+  }
+}
+
 Push-Location $PSScriptRoot
 try {
   & $FnpackPath build -d $stage
@@ -35,6 +138,8 @@ try {
   New-Item -ItemType Directory -Force $dist | Out-Null
   Copy-Item -LiteralPath $output -Destination (Join-Path $dist "havline-$version.fpk") -Force
   Write-Output "FPK: $(Join-Path $dist "havline-$version.fpk")"
+  $sizeMB = [math]::Round((Get-Item (Join-Path $dist "havline-$version.fpk")).Length / 1MB, 1)
+  Write-Output "FPK 大小：$sizeMB MB"
 }
 finally {
   Pop-Location

havline/app/docker/docker-compose.yaml

@@ -1,6 +1,7 @@
 services:
   havline:
-    image: jayhub.top/mrlee/havline:${TRIM_APPVER}
+    image: havline:${TRIM_APPVER}
+    pull_policy: never
     container_name: havline
     restart: unless-stopped
     ports:

havline/cmd/install_callback

@@ -1,8 +1,13 @@
 #!/bin/bash
 set -euo pipefail
 
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/offline_image.sh"
+
 mkdir -p "$TRIM_PKGVAR" "$TRIM_PKGVAR/backups"
 chown -R "$TRIM_USERNAME:$TRIM_GROUPNAME" "$TRIM_PKGVAR"
 
+load_offline_image
+
 echo "Havline 数据目录已准备：$TRIM_PKGVAR"
 exit 0

havline/cmd/offline_image.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+set -euo pipefail
+
+image_arch() {
+  case "$(uname -m)" in
+    x86_64|amd64) echo "amd64" ;;
+    aarch64|arm64) echo "arm64" ;;
+    *) return 1 ;;
+  esac
+}
+
+image_path() {
+  local arch="$1"
+  local primary="$TRIM_APPDEST/docker/havline-${TRIM_APPVER}-${arch}.tar.gz"
+
+  if [ -f "$primary" ]; then
+    echo "$primary"
+    return 0
+  fi
+
+  find "$TRIM_APPDEST" -name "havline-${TRIM_APPVER}-${arch}.tar.gz" 2>/dev/null | head -n 1
+}
+
+load_offline_image() {
+  local arch path
+
+  arch="$(image_arch)" || {
+    echo "不支持的设备架构：$(uname -m)" > "$TRIM_TEMP_LOGFILE"
+    exit 1
+  }
+
+  path="$(image_path "$arch")"
+  if [ -z "$path" ] || [ ! -f "$path" ]; then
+    echo "找不到离线镜像：havline-${TRIM_APPVER}-${arch}.tar.gz" > "$TRIM_TEMP_LOGFILE"
+    exit 1
+  fi
+
+  if ! docker load -i "$path" >/dev/null 2>&1; then
+    echo "加载离线镜像失败：$path" > "$TRIM_TEMP_LOGFILE"
+    exit 1
+  fi
+
+  if ! docker image inspect "havline:${TRIM_APPVER}" >/dev/null 2>&1; then
+    echo "离线镜像加载后未找到 havline:${TRIM_APPVER}" > "$TRIM_TEMP_LOGFILE"
+    exit 1
+  fi
+
+  echo "离线镜像已加载：$path"
+}

havline/cmd/upgrade_callback

@@ -1,6 +1,9 @@
 #!/bin/bash
 set -euo pipefail
 
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/offline_image.sh"
+
 if [ -f "$TRIM_PKGVAR/havline.db" ] && [ ! -r "$TRIM_PKGVAR/havline.db" ]; then
   echo "数据库不可读：$TRIM_PKGVAR/havline.db" > "$TRIM_TEMP_LOGFILE"
   exit 1
@@ -11,4 +14,6 @@ if [ -f "$TRIM_PKGVAR/session_secret" ] && [ ! -r "$TRIM_PKGVAR/session_secret"
   exit 1
 fi
 
+load_offline_image
+
 exit 0

havline/config/privilege

@@ -3,5 +3,6 @@
     "run-as": "package"
   },
   "username": "havline",
-  "groupname": "havline"
+  "groupname": "havline",
+  "join-groups": ["docker"]
 }

havline/manifest

@@ -1,14 +1,14 @@
 appname               = havline
-version               = 1.9.0
+version               = 2.0.0
 display_name          = Havline
 desc                  = NAS 公网访问管理：反向代理、DDNS、HTTPS 证书、FRP、Cloudflare Tunnel 与一键升级
 platform              = all
 source                = thirdparty
 maintainer            = Havline
-maintainer_url        = https://jayhub.top/mrlee/Havline
+maintainer_url        = https://github.com/mrlee233/havline
 distributor           = Havline
 desktop_uidir         = ui
 desktop_applaunchname = havline.main
 checkport             = false
 ctl_stop              = true
-changelog             = 首发飞牛应用：支持安装向导、端口配置、数据持久化和应用中心升级
+changelog             = 2.0.0：同步主仓 2.0.0；新增内置 SSH 终端（二次认证、会话审计、录像与常用命令）、DDNS 服务商名称与自定义 IP、公网反代默认转发 WebSocket 升级头；离线镜像安装，不依赖外部仓库，同时支持 amd64 与 arm64