飞牛 OS 神器｜WatchCow 超详细使用教程：Docker 容器自动生成桌面图标
目录
在飞牛 OS（fnOS）上部署 Docker 应用后，默认需手动输入 IP + 端口访问，既不便记忆也不利于快速启动。WatchCow是飞牛 OS 专属 Docker 工具，核心作用是自动识别 Docker 容器并在桌面生成应用图标，一键直达服务，完美整合第三方容器与飞牛原生生态。
本文从安装→配置→多实例→图标美化→故障排查全流程详解，新手也能零门槛上手。
一、WatchCow 核心功能
- ✅ 自动发现：监控 Docker 容器，自动读取配置生成图标
- ✅ 一键访问：桌面 / 手机端直接点击图标打开 Web 服务
- ✅ 多协议支持：兼容
http/https，可自定义路径与端口 - ✅ 图标自定义：支持本地图片 / 在线 URL，打造统一桌面风格
- ✅ 多入口配置：单个容器生成多个访问图标（如管理页 + 前台页）
- ✅ 权限控制：可隐藏图标、设置只读访问，兼顾安全与便捷
二、前置准备
- 飞牛 OS 已激活，Docker 服务正常运行（桌面→系统设置→Docker，确认已开启）
- 网络正常，能访问飞牛应用商店
- 准备图标素材（推荐尺寸
128×128px，PNG 透明背景，可选本地存储或在线 CDN）
三、第一步：安装 WatchCow
- 登录飞牛 OS 桌面，打开应用中心
- 搜索
WatchCow，点击安装（约 10MB，等待 1-2 分钟完成）
- 安装后自动启动，桌面生成 WatchCow 管理图标（首次安装无需配置，后台自动运行）
四、第二步：Docker Compose 配置（核心！必看）
WatchCow 通过 Docker 容器的labels标签识别应用，只需在 compose 文件中添加指定标签，无需额外插件。
4.1 基础标签模板（必加）
|
1 2 3 4 5 6 7 |
labels: watchcow.enable: "true" # 开启WatchCow识别（必填） watchcow.appname: "应用名称" # 桌面显示的图标名称（必填） watchcow.service_port: "端口" # 容器对外映射端口（必填，如8080） watchcow.protocol: "http" # 访问协议（http/https，默认http） watchcow.path: "/" # 访问路径（默认/，如/admin） watchcow.icon: "图标地址" # 本地路径/在线URL（可选，默认系统图标） |
4.2 完整示例（以 Trilium 笔记为例）
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
version: '3' services: trilium-cn: image: nriver/trilium-cn container_name: trilium-cn restart: always ports: - "53738:8080" # 宿主机端口:容器端口 volumes: - /vol1/1000/docker/trilium-cn/trilium-data:/root/trilium-data labels: watchcow.enable: "true" watchcow.appname: "Trilium笔记" watchcow.service_port: "53738" watchcow.protocol: "http" watchcow.path: "/" watchcow.icon: "file:///vol1/1000/docker/icons/trilium.png" # 本地图标 # watchcow.icon: "https://cdn.example.com/trilium.png" # 在线图标（二选一） |
4.3 标签详细说明（避坑重点）
| 标签 | 必填 | 说明 | 示例 |
|---|---|---|---|
watchcow.enable |
✅ | 设为true启用识别，false忽略 |
"true" |
watchcow.appname |
✅ | 图标显示名，简洁易记 | "Trilium笔记" |
watchcow.service_port |
✅ | 宿主机映射端口（非容器内部端口！） | "53738" |
watchcow.protocol |
❌ | 协议，默认http |
"https" |
watchcow.path |
❌ | 访问路径，默认/ |
"/admin" |
watchcow.icon |
❌ | 图标地址：file://本地路径，http://在线 URL |
"file:///vol1/icons/xxx.png" |
watchcow.no_display |
❌ | 设为true隐藏图标（后台运行） |
"false" |
五、第三步：部署容器并生效
- 保存上述
docker-compose.yml文件 - 执行部署命令：
1docker-compose up -d - 等待生效：容器启动后，WatchCow 默认1 分钟内自动识别，刷新桌面即可看到新图标
- 手机端同步：打开飞牛 APP→应用，即可看到同款图标，点击直接访问
六、高级用法
6.1 多入口配置（单个容器多个图标）
用watchcow.<entry>.<field>格式，实现一个容器生成多个访问入口：
|
1 2 3 4 5 6 7 8 9 10 11 12 |
labels: watchcow.enable: "true" watchcow.appname: "NAS管理" watchcow.service_port: "8080" # 入口1：前台页面 watchcow.front.appname: "NAS前台" watchcow.front.port: "8080" watchcow.front.path: "/" # 入口2：管理员页面 watchcow.admin.appname: "NAS后台" watchcow.admin.port: "8080" watchcow.admin.path: "/admin" |
6.2 图标美化（本地图标设置）
- 在 NAS 中创建图标目录（如
/vol1/1000/docker/icons） - 上传 PNG 图标文件（命名简洁，如
trilium.png） - 标签中填写路径：
watchcow.icon: "file:///vol1/1000/docker/icons/trilium.png" - 重启容器生效：
docker restart 容器名
6.3 隐藏图标（后台服务专用）
无需桌面显示的服务（如数据库、缓存），添加标签：
watchcow.no_display: "true"
七、常见问题排查（必看！解决 90% 问题）
7.1 图标不显示（最常见）
- 端口错误：
watchcow.service_port必须填宿主机映射端口（如53738），不是容器内部端口（8080） - 标签格式错：检查缩进（YAML 对缩进敏感）、引号是否闭合、拼写是否正确（
watchcow无大写） - 未重启容器：修改标签后必须
docker restart 容器名，仅up -d不生效 - WatchCow 未运行：应用中心确认 WatchCow 已启动，或重启 WatchCow
- 网络隔离：容器使用自定义网络（非
bridge）时，需确保 WatchCow 能访问该网络
7.2 图标显示但打不开
- 协议错误：容器用
https时，watchcow.protocol需设为https - 路径错误：
watchcow.path需与容器实际访问路径一致（如/app） - 端口冲突：宿主机端口被占用，更换映射端口后重新部署
7.3 手机端不显示图标
- 手机飞牛 APP 更新到最新版
- 同步桌面图标：APP→应用→刷新
- 网络正常：手机与 NAS 在同一局域网，或已配置外网访问
八、替代方案（备用）
若 WatchCow 临时异常，可手动创建桌面快捷方式，无需插件：
- 飞牛桌面空白处右键→添加快捷方式
- 名称：填应用名（如
Trilium笔记） - 地址：
http://NAS内网IP:端口（如http://192.168.1.100:53738） - 保存，立即生成图标，稳定无依赖
九、总结
WatchCow 是飞牛 OS 整合 Docker 应用的必备工具，配置简单、效果显著，彻底告别 “记 IP + 端口” 的繁琐操作。按照本文步骤，新手也能快速完成配置，打造整洁高效的 NAS 桌面生态。
