飞牛必备神器｜WatchCow 使用教程：Docker自动生成桌面图标

在飞牛 OS（fnOS）上部署 Docker 应用后，默认需手动输入 IP + 端口访问，既不便记忆也不利于快速启动。WatchCow是飞牛 OS 专属 Docker 工具，核心作用是自动识别 Docker 容器并在桌面生成应用图标，一键直达服务，完美整合第三方容器与飞牛原生生态。

image

本文从安装→配置→多实例→图标美化→故障排查全流程详解，新手也能零门槛上手。

一、WatchCow 核心功能

• ✅ 自动发现：监控 Docker 容器，自动读取配置生成图标

• ✅ 一键访问：桌面 / 手机端直接点击图标打开 Web 服务

• ✅ 多协议支持：兼容http/https，可自定义路径与端口

• ✅ 图标自定义：支持本地图片 / 在线 URL，打造统一桌面风格

• ✅ 多入口配置：单个容器生成多个访问图标（如管理页 + 前台页）

• ✅ 权限控制：可隐藏图标、设置只读访问，兼顾安全与便捷

二、前置准备

1. 飞牛 OS 已激活，Docker 服务正常运行（桌面→系统设置→Docker，确认已开启）

2. 网络正常，能访问飞牛应用商店

3. 准备图标素材（推荐尺寸128×128px，PNG 透明背景，可选本地存储或在线 CDN）

三、第一步：安装 WatchCow

1. 登录飞牛 OS 桌面，打开应用中心

2. 搜索WatchCow，点击安装（约 10MB，等待 1-2 分钟完成）

3. 安装后自动启动，桌面生成 WatchCow 管理图标（首次安装无需配置，后台自动运行）

四、第二步：Docker Compose 配置（核心！必看）

WatchCow 通过 Docker 容器的labels标签识别应用，只需在 compose 文件中添加指定标签，无需额外插件。

4.1 基础标签模板（必加）

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 笔记为例）

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"

五、第三步：部署容器并生效

1. 保存上述docker-compose.yml文件

2. 执行部署命令：

   docker-compose up -d

3. 等待生效：容器启动后，WatchCow 默认1 分钟内自动识别，刷新桌面即可看到新图标

4. 手机端同步：打开飞牛 APP→应用，即可看到同款图标，点击直接访问

六、高级用法

6.1 多入口配置（单个容器多个图标）

用watchcow..格式，实现一个容器生成多个访问入口：

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 图标美化（本地图标设置）

1. 在 NAS 中创建图标目录（如/vol1/1000/docker/icons）

2. 上传 PNG 图标文件（命名简洁，如trilium.png）

3. 标签中填写路径：watchcow.icon: "file:///vol1/1000/docker/icons/trilium.png"

4. 重启容器生效：docker restart 容器名

6.3 隐藏图标（后台服务专用）

无需桌面显示的服务（如数据库、缓存），添加标签：

watchcow.no_display: "true"

七、常见问题排查（必看！解决 90% 问题）

7.1 图标不显示（最常见）

1. 端口错误：watchcow.service_port必须填宿主机映射端口（如53738），不是容器内部端口（8080）

2. 标签格式错：检查缩进（YAML 对缩进敏感）、引号是否闭合、拼写是否正确（watchcow无大写）

3. 未重启容器：修改标签后必须docker restart 容器名，仅up -d不生效

4. WatchCow 未运行：应用中心确认 WatchCow 已启动，或重启 WatchCow

5. 网络隔离：容器使用自定义网络（非bridge）时，需确保 WatchCow 能访问该网络

7.2 图标显示但打不开

1. 协议错误：容器用https时，watchcow.protocol需设为https

2. 路径错误：watchcow.path需与容器实际访问路径一致（如/app）

3. 端口冲突：宿主机端口被占用，更换映射端口后重新部署

7.3 手机端不显示图标

1. 手机飞牛 APP 更新到最新版

2. 同步桌面图标：APP→应用→刷新

3. 网络正常：手机与 NAS 在同一局域网，或已配置外网访问

八、替代方案（备用）

若 WatchCow 临时异常，可手动创建桌面快捷方式，无需插件：

1. 飞牛桌面空白处右键→添加快捷方式

2. 名称：填应用名（如Trilium笔记）

3. 地址：http://NAS内网IP:端口（如http://192.168.1.100:53738）

4. 保存，立即生成图标，稳定无依赖

九、总结

WatchCow 是飞牛 OS 整合 Docker 应用的必备工具，配置简单、效果显著，彻底告别 “记 IP + 端口” 的繁琐操作。按照本文步骤，新手也能快速完成配置，打造整洁高效的 NAS 桌面生态。