feat: add upgrade and migration flow for native fnOS

README.md

@@ -11,7 +11,7 @@
 
 构建过程不再引用 `F:\Fonu-main\havline`。
 
-阶段三范围：
+阶段四范围：
 
 - Go 主程序原生运行
 - 统一网关 `/app/havline`
@@ -22,6 +22,10 @@
 - Nginx 依赖库与 `mime.types`
 - HTTP 18080 与 HTTPS 9443
 - frpc 与 cloudflared 按需下载，不打包进 FPK
+- Native 版本 1.9.1
+- Docker 版数据目录兼容
+- 旧 `data/` 布局自动迁移
+- 升级前数据库备份
 
 按需下载位置：
 
@@ -44,6 +48,28 @@ havline:1.9.0                     arm64
 
 如果本地没有对应架构镜像，先加载 amd64 与 arm64 镜像归档。
 
+Nginx 提取镜像版本默认固定为 `1.9.0`，与应用版本解耦。需要时可传入：
+
+```powershell
+.\build.ps1 -NginxImageVersion 1.9.0
+```
+
+## 升级与迁移
+
+详细步骤见：
+
+```text
+docs/upgrade-and-migration.md
+```
+
+推荐路径：
+
+```text
+卸载 Docker 版时保留数据
+安装 Native 1.9.1
+启动后自动迁移数据库和旧数据布局
+```
+
 ## 构建
 
 ```powershell
@@ -54,7 +80,7 @@ cd F:\Fonu-main\fnos-native
 输出：
 
 ```text
-dist/havline-native-1.9.0.fpk
+dist/havline-native-1.9.1.fpk
 ```
 
 构建脚本会：

app-src/VERSION

@@ -1 +1 @@
-1.9.0
+1.9.1

build.ps1

@@ -1,6 +1,7 @@
 param(
   [string]$FnpackPath = "",
-  [string]$GoBin = "go"
+  [string]$GoBin = "go",
+  [string]$NginxImageVersion = "1.9.0"
 )
 
 $ErrorActionPreference = "Stop"
@@ -88,6 +89,7 @@ try {
     }
   }
   $env:VITE_BASE_PATH = "/app/havline/"
+  $env:VITE_APP_VERSION = $version
   npm run build
   if ($LASTEXITCODE -ne 0) {
     throw "前端构建失败，退出码：$LASTEXITCODE"
@@ -118,8 +120,8 @@ Copy-Tree -Source (Join-Path $mainRepo "web\assets\image") -Destination (Join-Pa
 
 $serverDir = Join-Path $stage "app\server"
 $dockerBin = Resolve-DockerCli
-Export-Nginx -DockerBin $dockerBin -Platform "linux/amd64" -Arch "amd64" -Image "jayhub.top/mrlee/havline:$version" -OutputDir $serverDir
+Export-Nginx -DockerBin $dockerBin -Platform "linux/amd64" -Arch "amd64" -Image "jayhub.top/mrlee/havline:$NginxImageVersion" -OutputDir $serverDir
-Export-Nginx -DockerBin $dockerBin -Platform "linux/arm64" -Arch "arm64" -Image "havline:$version" -OutputDir $serverDir
+Export-Nginx -DockerBin $dockerBin -Platform "linux/arm64" -Arch "arm64" -Image "havline:$NginxImageVersion" -OutputDir $serverDir
 
 $env:CGO_ENABLED = "0"
 $env:GOOS = "linux"

docs/upgrade-and-migration.md

@@ -0,0 +1,129 @@
+# Havline Native 升级与迁移
+
+> 适用版本：Native 1.9.1 及以后
+> 迁移来源：飞牛 Docker 应用版 Havline
+
+## 一、数据目录
+
+Docker 版和 Native 版使用同一个飞牛应用数据目录：
+
+```text
+${TRIM_PKGVAR}
+```
+
+主要数据：
+
+```text
+havline.db
+session_secret
+nginx/
+certs/
+frp/
+cloudflared/
+logs/
+ssh_known_hosts
+```
+
+Native 版启动时设置：
+
+```text
+HAVLINE_DATA_DIR=${TRIM_PKGVAR}
+```
+
+因此正常情况下不需要复制数据。
+
+## 二、推荐迁移路径
+
+```text
+1. 在飞牛应用中心备份或导出重要配置
+2. 卸载 Docker 版 Havline，选择“保留数据”
+3. 确认旧容器已停止，6893/18080/9443 端口已释放
+4. 安装 havline-native-1.9.1.fpk
+5. Native 安装回调检查数据目录
+6. 启动后主程序自动执行数据库迁移
+7. 登录验证反向代理、证书、FRP、Cloudflare 配置
+```
+
+卸载时不要选择“删除全部数据”。
+
+## 三、直接覆盖升级
+
+如果飞牛应用中心允许同一 `appname=havline` 直接升级：
+
+```text
+Docker 版 1.9.0
+  -> Native 版 1.9.1
+```
+
+升级回调会执行：
+
+```text
+检查 havline.db 可读
+检查 session_secret 可读
+迁移旧数据布局
+备份数据库到 ${TRIM_PKGVAR}/backups
+保留全部数据
+```
+
+如果应用中心不允许跨包类型直接升级，请使用推荐迁移路径。
+
+## 四、旧数据布局兼容
+
+部分早期 Docker 包可能使用：
+
+```text
+${TRIM_PKGVAR}/data/havline.db
+```
+
+Native 版检测到该布局且根目录没有 `havline.db` 时，会把
+`${TRIM_PKGVAR}/data` 下的内容迁移到 `${TRIM_PKGVAR}`。
+
+迁移规则：
+
+```text
+只迁移目标不存在的文件
+不覆盖已有数据
+保留原数据目录中的未迁移内容
+```
+
+## 五、升级前备份
+
+`upgrade_callback` 会把数据库复制到：
+
+```text
+${TRIM_PKGVAR}/backups/havline-pre-upgrade-<时间戳>.db
+```
+
+备份失败会导致升级失败，不会静默继续。
+
+## 六、回滚
+
+如果需要回滚到 Docker 版：
+
+```text
+1. 停止 Native 版 Havline
+2. 保留 ${TRIM_PKGVAR}
+3. 安装旧 Docker 版 FPK
+4. 启动后验证数据
+```
+
+`session_secret` 必须保持不变，否则已加密的 API Token、DDNS 凭据、
+通知密码和 Cloudflare 凭据将无法解密。
+
+## 七、验证清单
+
+```text
+[ ] 旧应用已停止
+[ ] 端口 6893/18080/9443 已释放
+[ ] ${TRIM_PKGVAR}/havline.db 存在
+[ ] ${TRIM_PKGVAR}/session_secret 存在
+[ ] Native 安装成功
+[ ] Native 启动成功
+[ ] 数据库迁移成功
+[ ] 升级前备份已生成
+[ ] 管理员可以登录
+[ ] 反向代理规则保留
+[ ] 证书保留
+[ ] FRP 配置保留
+[ ] Cloudflare 配置保留
+```

havline/cmd/install_callback

@@ -1,9 +1,14 @@
 #!/bin/bash
 set -euo pipefail
 
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/migrate_legacy.sh"
+
 mkdir -p "$TRIM_PKGVAR/logs"
 chown -R "$TRIM_USERNAME:$TRIM_GROUPNAME" "$TRIM_PKGVAR"
 
+migrate_legacy_data
+
 ARCH="$(uname -m)"
 case "$ARCH" in
   x86_64|amd64) ARCH_DIR="amd64" ;;

havline/cmd/migrate_legacy.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+set -euo pipefail
+
+migrate_legacy_data() {
+  local legacy_root="$TRIM_PKGVAR/data"
+  local legacy_db="$legacy_root/havline.db"
+  local target_db="$TRIM_PKGVAR/havline.db"
+
+  if [ ! -f "$legacy_db" ] || [ -f "$target_db" ]; then
+    return 0
+  fi
+
+  echo "检测到旧版数据布局：$legacy_root"
+  mkdir -p "$TRIM_PKGVAR/backups"
+
+  for item in "$legacy_root"/* "$legacy_root"/.[!.]* "$legacy_root"/..?*; do
+    [ -e "$item" ] || continue
+    local name
+    name="$(basename "$item")"
+    if [ -e "$TRIM_PKGVAR/$name" ]; then
+      continue
+    fi
+    mv "$item" "$TRIM_PKGVAR/$name"
+  done
+
+  echo "旧版数据已迁移到：$TRIM_PKGVAR"
+}
+
+backup_database() {
+  local db="$TRIM_PKGVAR/havline.db"
+  if [ ! -f "$db" ]; then
+    return 0
+  fi
+
+  mkdir -p "$TRIM_PKGVAR/backups"
+  cp -f "$db" "$TRIM_PKGVAR/backups/havline-pre-upgrade-$(date +%Y%m%d%H%M%S).db"
+}

havline/cmd/upgrade_callback

@@ -1,6 +1,9 @@
 #!/bin/bash
 set -euo pipefail
 
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/migrate_legacy.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,7 @@ if [ -f "$TRIM_PKGVAR/session_secret" ] && [ ! -r "$TRIM_PKGVAR/session_secret"
   exit 1
 fi
 
+migrate_legacy_data
+backup_database
+
 exit 0

havline/manifest

@@ -1,7 +1,7 @@
 appname               = havline
-version               = 1.9.0
+version               = 1.9.1
 display_name          = Havline
-desc                  = NAS 公网访问管理：原生应用阶段三
+desc                  = NAS 公网访问管理：原生应用阶段四
 platform              = all
 source                = thirdparty
 maintainer            = Havline
@@ -11,4 +11,4 @@ desktop_uidir         = ui
 desktop_applaunchname = havline.main
 ctl_stop              = true
 os_min_version        = 1.1.3100
-changelog             = 原生应用阶段三：frpc 与 cloudflared 按需下载
+changelog             = 原生应用阶段四：升级迁移、旧数据布局兼容和升级前备份