feat: bundle multi-arch offline images into fnOS package

README.md

@@ -19,66 +19,36 @@
 
 仍需完成：
 
-- 修复 Gitea Registry 的 HTTP token realm，使 Docker 能正常 push/pull；
-- 确认飞牛设备是否可以匿名拉取，或在安装前配置 Registry 登录；
-- 在飞牛测试设备验证安装、启动、入口、升级和卸载；
-- 验证 amd64 与 arm64 镜像均可在真实设备上拉取。
+- 在飞牛 x86_64 与 ARM 设备验证离线安装、启动、入口、升级和卸载；
+- 验证应用用户加入 `docker` 组后的 `docker load`、`docker inspect` 权限。
 
-## 当前阻塞
+## 离线镜像包
 
-`jayhub.top/mrlee/havline:1.9.0` 已经包含 amd64 与 arm64 多架构索引，
-但当前 Gitea 返回的认证地址仍是 HTTP：
+当前应用已经切换为离线镜像包模式，不依赖外部 Docker Registry。
+
+包内包含：
 
 ```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
-docker login jayhub.top
+```yaml
+image: havline:${TRIM_APPVER}
+pull_policy: never
 ```
 
-拉取成功后重新安装 `havline-1.9.0.fpk`。
+因此安装时不需要访问 `jayhub.top`，也不需要配置 Registry 登录。
+
+当前 1.9.0 双架构 `.fpk` 约 `150.6 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 目录。