docs(fnos): 手册补充 fpk 应用下载地址与 GitHub Release

发布 v0.1.1 并附 x86/arm 安装包，安装手册与 README/INSTALL 链到 Releases。

Author: funchs

README.md

@@ -66,7 +66,9 @@ forwarding 提供原生网关路径。
 
 **普通用户：飞牛应用中心本地安装 `.fpk` 包**
 
-1. 按 NAS 架构选择 `packaging/fnos/opensurge_0.1.1_x86.fpk` 或 `_arm.fpk`
+1. 从 [GitHub Releases](https://github.com/funchs/opensurge-fnos/releases/latest) 下载安装包  
+   - x86：`opensurge_0.1.1_x86.fpk`  
+   - ARM：`opensurge_0.1.1_arm.fpk`
 2. 应用中心 → 本地安装 → 按向导填端口 / 网卡 / 局域网 IP
 3. 启动应用后浏览器打开：`http://<NAS-IP>:61767/enter`
 

docs/fnos-port/DEPLOY.md

@@ -117,7 +117,7 @@ compose 需监听 `0.0.0.0`，且配置中 `gateway.lan_ip`（或环境变量
 ## 排查
 
 **打开 GUI 提示安全连接过期** —— 用 `/enter`；核对 `lan_ip`；`docker pull` 最新
-`v0.1.1` 后重建容器。详见 [FPK-USER-GUIDE.md §8.1](./FPK-USER-GUIDE.md)。
+`v0.1.1` 后重建容器。详见 [FPK-USER-GUIDE.md §9.1](./FPK-USER-GUIDE.md)。
 
 **`ip_forward` 写入失败** —— compose 里少了 `cap_add: SYS_ADMIN`，或者 fnOS 的 Docker
 版本不允许 remount。容器日志会直接打出提示。

docs/fnos-port/FPK-USER-GUIDE.md

@@ -12,10 +12,32 @@
 | 镜像 | `ghcr.io/funchs/opensurge-fnos:v0.1.1`（`linux/amd64` + `linux/arm64`） |
 | Web GUI 默认端口 | **61767** |
 | 推荐入口 | `http://<NAS-IP>:61767/enter` |
+| 应用下载 | [GitHub Releases（最新）](https://github.com/funchs/opensurge-fnos/releases/latest) |
 
 ---
 
-## 1. 你将得到什么
+## 1. 下载应用安装包
+
+普通用户请从 **GitHub Release** 下载，不要自己编译：
+
+- **发布页（推荐）**  
+  <https://github.com/funchs/opensurge-fnos/releases/latest>
+
+- **当前版本 v0.1.1 直接下载**
+
+| 架构 | 安装包 | 直链 |
+| --- | --- | --- |
+| Intel / AMD（N100、N305 等） | `opensurge_0.1.1_x86.fpk` | [下载](https://github.com/funchs/opensurge-fnos/releases/download/v0.1.1/opensurge_0.1.1_x86.fpk) |
+| ARM64（瑞芯微等） | `opensurge_0.1.1_arm.fpk` | [下载](https://github.com/funchs/opensurge-fnos/releases/download/v0.1.1/opensurge_0.1.1_arm.fpk) |
+
+> 仓库源码：<https://github.com/funchs/opensurge-fnos>  
+> 默认开发分支：`fnos-port`（与 `master` 同步）。
+
+下载后用浏览器或网盘传到本机，在飞牛网页「应用中心 → 本地安装」中选中该 `.fpk` 即可。
+
+---
+
+## 2. 你将得到什么
 
 - 在 NAS 上跑 mihomo + dnsmasq + nftables 的旁路由网关
 - 浏览器 Web GUI：总览、网络、订阅源、设备、策略、连通性、诊断
@@ -28,9 +50,9 @@
 
 ---
 
-## 2. 安装前准备
+## 3. 安装前准备
 
-### 2.1 确认 NAS CPU 架构
+### 3.1 确认 NAS CPU 架构
 
 | 架构 | 选用安装包 |
 | --- | --- |
@@ -39,7 +61,7 @@
 
 两个 fpk 内容相同，仅 `manifest` 的 `platform` 字段不同；镜像是多架构的，运行时按 NAS 架构拉对应层。
 
-### 2.2 网络与权限前提
+### 3.2 网络与权限前提
 
 - NAS 已接入局域网，并有稳定 IPv4（建议固定 IP 或 DHCP 预留）
 - 能访问 Docker Hub / ghcr.io（若不能，见下文「离线导入镜像」）
@@ -48,9 +70,10 @@
   - `NET_ADMIN` / `NET_RAW` / `SYS_ADMIN`
   - `/dev/net/tun`
 
-### 2.3 准备安装包
+### 3.3 自己构建安装包（可选）
 
-开发者在本仓库构建：
+普通用户请直接使用 [§1 下载](#1-下载应用安装包) 的 Release。  
+开发者可在本仓库构建：
 
 ```bash
 cd packaging/fnos
@@ -59,14 +82,13 @@ cd packaging/fnos
 ./build-fpk.sh all       # 生成 x86 + arm 两个 fpk
 ```
 
-产物位于 `packaging/fnos/opensurge_0.1.1_{x86,arm}.fpk`。  
-把对应架构的 fpk 拷到能被飞牛网页上传的位置（本机即可）。
+产物位于 `packaging/fnos/opensurge_0.1.1_{x86,arm}.fpk`。
 
 ---
 
-## 3. 安装步骤（应用中心）
+## 4. 安装步骤（应用中心）
 
-### 3.1 拉取 Docker 镜像
+### 4.1 拉取 Docker 镜像
 
 **在线（推荐）**
 
@@ -96,11 +118,11 @@ docker save ghcr.io/funchs/opensurge-fnos:v0.1.1 -o opensurge-v0.1.1.tar
 docker load -i opensurge-v0.1.1.tar
 ```
 
-### 3.2 本地安装 fpk
+### 4.2 本地安装 fpk
 
 1. 打开 **飞牛应用中心**
 2. 左下角 **本地安装** / **手动安装**
-3. 选择 `opensurge_0.1.1_x86.fpk` 或 `_arm.fpk`
+3. 选择已下载的 `opensurge_0.1.1_x86.fpk` 或 `_arm.fpk`
 4. 按安装向导填写：
 
 | 字段 | 说明 | 建议 |
@@ -119,17 +141,17 @@ docker load -i opensurge-v0.1.1.tar
 
 ---
 
-## 4. 首次打开 Web GUI
+## 5. 首次打开 Web GUI
 
-### 4.1 推荐入口
+### 5.1 推荐入口
 
 ```text
 http://<NAS-IP>:61767/enter
 ```
 
 端口以向导填写为准。桌面图标默认也打开 **`/enter`**。
 
-### 4.2 为什么不能只打开根路径？
+### 5.2 为什么不能只打开根路径？
 
 控制面 API 需要 **session cookie**。  
 `/enter` 在局域网模式（已配置 BaseURL / `gateway.lan_ip`）下会：
@@ -148,7 +170,7 @@ http://<NAS-IP>:61767/enter
 | 容器是否运行 | `docker ps \| grep opensurge` |
 | 浏览器 | 换无痕窗口，避免旧 cookie |
 
-### 4.3 调试：手工签发 30 秒 bootstrap 链接
+### 5.3 调试：手工签发 30 秒 bootstrap 链接
 
 ```bash
 # 在装有仓库脚本的机器上，或把 scripts/fnos-gui-url.sh 拷到 NAS
@@ -158,25 +180,25 @@ http://<NAS-IP>:61767/enter
 原理：读取容器内 `state/store/control-token`，调用  
 `POST /api/v1/session/bootstrap`。日常使用优先 `/enter`，不必每次跑脚本。
 
-### 4.4 安全说明
+### 5.4 安全说明
 
 - 61767 在 host 网络上对局域网可见，属于 **内网可信** 模型  
 - **不要**把该端口端口转发到公网（HTTP 明文）  
 - 运维级 `control-token` 在容器卷 `.../state/store/control-token`（权限 0600）
 
 ---
 
-## 5. 日常使用
+## 6. 日常使用
 
-### 5.1 启动 / 停止
+### 6.1 启动 / 停止
 
 - 应用中心：打开 / 停止 OpenSurge  
 - 或 Docker：对容器 `start` / `stop` / `restart`  
   容器名默认 `opensurge`
 
 停止时应走正常 stop（会清理网关状态）；避免 `docker kill`，以免留下 nft 表或 `ip_forward`。
 
-### 5.2 Web GUI 功能概览
+### 6.2 Web GUI 功能概览
 
 | 页面 | 用途 |
 | --- | --- |
@@ -188,7 +210,7 @@ http://<NAS-IP>:61767/enter
 | 连通性 | 本机 applied 路径探测 |
 | 诊断 | doctor / 日志类信息 |
 
-### 5.3 客户端（旁路由）
+### 6.3 客户端（旁路由）
 
 需要走代理的设备上设置：
 
@@ -197,7 +219,7 @@ http://<NAS-IP>:61767/enter
 
 不要改主路由 DHCP 全局下发，除非你有意做全屋接管（进阶，见上游文档中的 DHCP 接管说明；fpk 默认旁路由种子配置）。
 
-### 5.4 配置文件位置
+### 6.4 配置文件位置
 
 以实际安装卷为准，常见：
 
@@ -210,15 +232,15 @@ http://<NAS-IP>:61767/enter
 
 首次安装若无配置，会从包内 `config.fnos.example.yaml` 种子化，并写入向导里的网卡名与局域网 IP。
 
-### 5.5 修改端口 / 网卡 / IP
+### 6.5 修改端口 / 网卡 / IP
 
 - **应用设置 / 配置向导**：可改 Web 端口；网卡与 IP 留空占位会重新自动探测，填写则覆盖  
 - 改完通常需要 **重启容器 / 应用** 才完全生效  
 - `gateway.lan_ip` 变更后，请用 **新 IP** 访问 `/enter`
 
 ---
 
-## 6. 升级与重装
+## 7. 升级与重装
 
 1. 应用中心卸载（可选择保留数据）  
 2. 安装新 fpk（版本号与镜像 tag 应一致，当前均为 `0.1.1` / `v0.1.1`）  
@@ -246,7 +268,7 @@ http://<NAS-IP>:61767/enter
 
 ---
 
-## 7. 卸载
+## 8. 卸载
 
 1. 应用中心 → 卸载 OpenSurge  
 2. 向导可选择是否删除数据目录（默认保留配置便于重装）  
@@ -259,9 +281,9 @@ http://<NAS-IP>:61767/enter
 
 ---
 
-## 8. 故障排查
+## 9. 故障排查
 
-### 8.1 打开 GUI 提示「安全连接已过期」
+### 9.1 打开 GUI 提示「安全连接已过期」
 
 | 步骤 | 操作 |
 | --- | --- |
@@ -271,7 +293,7 @@ http://<NAS-IP>:61767/enter
 | 4 | 换无痕窗口，清掉旧 `opensurge_session` cookie |
 | 5 | 镜像是否含 `/enter`：需使用已推送的 `v0.1.1` 新构建，`docker pull` 后再 `up -d` |
 
-### 8.2 容器起不来 / 不断重启
+### 9.2 容器起不来 / 不断重启
 
 ```bash
 docker logs opensurge --tail 100
@@ -283,7 +305,7 @@ docker logs opensurge --tail 100
 - 无 `SYS_ADMIN` 且宿主 `ip_forward=0`  
 - 镜像未拉取成功  
 
-### 8.3 网关启不来 / 无流量
+### 9.3 网关启不来 / 无流量
 
 ```bash
 docker exec opensurge omg doctor --config /etc/opensurge/config.yaml
@@ -295,14 +317,14 @@ ss -lnup | grep -E ':53|:61767'
 - TUN：确认设备映射 `/dev/net/tun`  
 - 客户端是否已把网关/DNS 指到 NAS  
 
-### 8.4 应用中心图标仍是旧的，但桌面已是新的
+### 9.4 应用中心图标仍是旧的，但桌面已是新的
 
 磁盘 `ICON.PNG` 已更新时，属于 **应用中心 UI 缓存**（飞牛已知现象）。  
 强刷 / 无痕 / 重新登录；必要时执行第 6 节图标修复命令。
 
 ---
 
-## 9. 路径与组件速查
+## 10. 路径与组件速查
 
 | 组件 | 作用 |
 | --- | --- |
@@ -327,7 +349,7 @@ opensurge_0.1.1_x86.fpk   # tar.gz
 
 ---
 
-## 10. 相关文档
+## 11. 相关文档
 
 | 文档 | 内容 |
 | --- | --- |
@@ -338,8 +360,9 @@ opensurge_0.1.1_x86.fpk   # tar.gz
 
 ---
 
-## 11. 快速检查清单
+## 12. 快速检查清单
 
+- [ ] 已从 [Releases](https://github.com/funchs/opensurge-fnos/releases/latest) 下载对应架构 fpk  
 - [ ] 选对 x86 / arm fpk  
 - [ ] 镜像 `v0.1.1` 已 pull 或 docker load  
 - [ ] 向导端口、网卡、**lan_ip = 访问 IP**  

packaging/fnos/INSTALL.md

@@ -3,9 +3,18 @@
 > **完整用户手册（推荐）**  
 > [docs/fnos-port/FPK-USER-GUIDE.md](../../docs/fnos-port/FPK-USER-GUIDE.md)
 
+## 下载
+
+| 架构 | 安装包 |
+| --- | --- |
+| Intel / AMD | [opensurge_0.1.1_x86.fpk](https://github.com/funchs/opensurge-fnos/releases/download/v0.1.1/opensurge_0.1.1_x86.fpk) |
+| ARM64 | [opensurge_0.1.1_arm.fpk](https://github.com/funchs/opensurge-fnos/releases/download/v0.1.1/opensurge_0.1.1_arm.fpk) |
+
+发布页：<https://github.com/funchs/opensurge-fnos/releases/latest>
+
 ## 一分钟安装
 
-1. 选架构包：`opensurge_0.1.1_x86.fpk` 或 `opensurge_0.1.1_arm.fpk`
+1. 按 NAS 架构下载上表中的 fpk
 2. 飞牛应用中心 → **本地安装**
 3. 向导：端口（默认 61767）、网卡、**NAS 局域网 IP（须与浏览器访问 IP 一致）**
 4. 启动应用