背景

ZcNas 是一台装了飞牛 fnOS 的机器，插着 RX 6600，跑着 23 个 Docker 容器 —— 从 Wallos 记账到 Gitea 代码托管，从 RSSHub 到 Tiny Tiny RSS，全在 /vol1/1000/docker/ 下用 Compose 管理。每个容器都打了 WatchCow 标签，这样 fnOS 桌面能自动识别为「原生应用」，点图标就能打开。

前几天想着把镜像都更新一遍，结果踩了一串坑。

第一步：SSH 权限 —— 门都进不去

日常用的 mifsh 用户不在 docker 组里，SSH 上去连 docker ps 都跑不了：

1
# 在 fnOS 上以 root 执行
2
sudo usermod -aG docker mifsh

搞定。之后用 sshpass 连：

1
sshpass -p '***' ssh mifsh@192.168.3.166

第二步：批量更新 ——23 个容器一口气

所有 compose 文件分散在 /vol1/1000/docker/ 下的子目录里，逐个 pull 再重建：

1
for d in wallos bilibili-sync doocs-md homer homebox donetick \
2
         rustpad drydock vcompose rsshub linkding gitea tt-rss \
3
         frpc karakeep; do
4
    cd "/vol1/1000/docker/$d"
5
    docker compose pull
6
    docker compose up -d
7
done

大部分顺利，但 bili-sync-rs 报了个错：

1
Conflict. The container name "/bili-sync-rs" is already in use

原因是这个容器是很早之前手动 docker run 起的，后来才补了 compose 文件 —— 旧容器不在 compose 管理范围内，新容器想用同一个名字就冲突了。解决方法很简单：

1
docker stop bili-sync-rs
2
docker rm bili-sync-rs
3
cd /vol1/1000/docker/bilibili-sync && docker compose up -d

先停掉旧的、删掉，再让 compose 接管。

更新完 23 个容器全部健康运行，但问题才刚开始。

第三步：WatchCow 标签集体失灵

批量更新后第二天，突然发现 fnOS 桌面上少了几个应用图标。用 docker inspect 检查 labels 是好的：

1
docker inspect wallos --format '{{json .Config.Labels}}'
2
# 输出包含 watchcow.enable, watchcow.display_name, watchcow.service_port

但 /var/apps/ 下这些目录全没了：

1
watchcow.wallos
2
watchcow.rsshub
3
watchcow.md-editor
4
watchcow.karakeep
5
watchcow.tt-rss
6
watchcow.bili-sync

翻 WatchCow 日志

1
tail -100 /usr/local/apps/@appdata/watchcow/info.log

关键线索在这里 —— 每次安装都有这条警告：

1
[Error] Use `--volume` to specify the volume index,
2
or configure a default using `appcenter-cli default-volume [index]`

日志随后确实显示了 Successfully installed fnOS app，但这骗了我。实际上应用装得不完整。查一下默认卷配置：

1
# root@ZcNas:~# appcenter-cli default-volume
2
0    # ← 未设置！

根因找到了。appcenter-cli 没有默认存储卷，于是 install 命令不知道把应用数据往哪放，只能装一半。

第四步：三连修复

1. 设默认卷

1
appcenter-cli default-volume 1
2
# 验证
3
appcenter-cli default-volume
4
# 输出：1

2. 卸载残次品

之前 volume 缺失时安装的应用处于损坏状态（返回 code 10500），得卸了重来：

1
appcenter-cli uninstall watchcow.rsshub     # 已损坏
2
appcenter-cli uninstall watchcow.md-editor  # 已损坏
3
# watchcow.wallos 没装成功，不需要卸载

3. 重启 WatchCow

1
kill $(cat /usr/local/apps/@appdata/watchcow/app.pid)
2
sleep 2
3
/usr/local/apps/@appcenter/watchcow/watchcow &

WatchCow 重启后自动扫所有容器 labels，重新生成并安装应用包。这次日志干净了，没有 volume 报错。

最终结果

fnOS 桌面上 16 个应用全部回归：

总结

核心教训就一句话：fnOS 上用 WatchCow 自动发现 Docker 容器，必须先执行 appcenter-cli default-volume 1。 这步没做的话，应用安装看着成功了，实际上残废 —— 桌面图标隔天就消失。