WatchCow使用方法简介，实现任意docker自动生成飞牛应用

xls8013

一、前言

1. 本人为小白，在论坛和网上找了一圈，别的教程有点不够小白，所以以小白的视角写一篇喂饭级别的教程，让小白们能更好的理解与应用。

二、前置准备

1. 环境要求

   • 应用商店安装WatchCow
   • 准备图标库，文末我会给出大佬分享的图标库，将图标放入你自己的nas
     

三、实操步骤：Docker 容器对接飞牛应用（以 omnibox 为例）

1. 原docker compose文件

services:
  omnibox:
    image: lampon/omnibox:latest  # 使用最新的 Omnibox 镜像
    container_name: omnibox  # 容器名称为 omnibox
    restart: always  # 容器自动重启策略设置为总是重启
    environment:
      - TZ=Asia/Shanghai  # 设置时区为上海
    ports:
      - "7023:7023"  # 映射本地端口 到容器的 7023 端口
    volumes:
      - /vol1/1000/docker/omnibox/data:/app/data  # 将本地的 ./omnibox/data 目录挂载到容器的 /app/data 目录
    networks:
      - media-net  # 使用内部网络 media-net 进行通信
networks:
  media-net:
    driver: bridge  # 使用默认的桥接网络驱动

2. 根据WatchCow的github地址：GitHub - tf4fun/watchcow提供的示例在docker compose文件里加入以下代码：

    labels:
      watchcow.enable: "true"
      watchcow.appname: "Omnibox"   # 对应前面的应用名
      watchcow.service_port: "7023"   # 和前面libretv的端口名对应
      watchcow.protocol: "http"
      watchcow.path: "/"
      watchcow.icon: "file:///vol1/1000/docker/icons/omnibox.png"   # 这里替换成你自己的图标库
      # watchcow.icon: "https://example.com/libretv.png"     # 这里也可以改成在线图标，把前面注释掉就行了

3. 完整的docker compose文件

services:
  omnibox:
    image: lampon/omnibox:latest  # 使用最新的 Omnibox 镜像
    container_name: omnibox  # 容器名称为 omnibox
    restart: always  # 容器自动重启策略设置为总是重启
    environment:
      - TZ=Asia/Shanghai  # 设置时区为上海
    ports:
      - "7023:7023"  # 映射本地端口 到容器的 7023 端口
    volumes:
      - /vol1/1000/docker/omnibox/data:/app/data  # 将本地的 ./omnibox/data 目录挂载到容器的 /app/data 目录
    networks:
      - media-net  # 使用内部网络 media-net 进行通信
    labels:
      watchcow.enable: "true"
      watchcow.appname: "Omnibox"   # 对应前面的应用名
      watchcow.service_port: "7023"   # 和前面libretv的端口名对应
      watchcow.protocol: "http"
      watchcow.path: "/"
      watchcow.icon: "file:///vol1/1000/docker/icons/omnibox.png"   # 这里替换成你自己的图标库
      # watchcow.icon: "https://example.com/libretv.png"     # 这里也可以改成在线图标，把前面注释掉就行了
networks:
  media-net:
    driver: bridge  # 使用默认的桥接网络驱动

4. 进入docker使用docker compose的方式安装docker
   
5. 看看有没有正确生成图标，名称是否正确
   
6. 访问测试，是否正常
   

六、感谢与引用：

1. [](https://github.com/tf4fun/watchcow) WatchCow原作者Github
2. 星河流放大佬的帖子：转换任意 Docker 容器为飞牛应用 - 攻略分享 飞牛私有云论坛 fnOS
3. 论坛大佬 quanmingxin 上传的图标库：小飞机网盘

lostlost

这样做有什么好处吗，一直都比较喜欢用compose方式部署

L·Z·M

成功成功成功

xls8013

lostlost 发表于 2026-1-9 23:52
这样做有什么好处吗，一直都比较喜欢用compose方式部署

当你在一台电脑上用fn id登录过fnos的管理界面之后，可以实现伪域名无端口访问应用，比如https://omnibox.fnid.fnos.net/   可以直接访问应用。哈哈，其实最方便的还是把docker应用加到主页之后，可以直接点应用打开docker最方便。

nd4256450

不需要穿透了 可以直接远程打开了 意义不大 聊胜于无 现在小宝组网很方便

星河流放

WatchCow其实还可以通过它注册文件右键入口, 我最近写了一个 OnlyOffice 的连接器, 可以用纯 Docker 部署的方式完成和飞牛文件管理器的集成

networks:
  onlyoffice-net:
    name: onlyoffice-net
    driver: bridge

services:
  onlyoffice-connector:
    image: xingheliufang/onlyoffice-fnos:main
    container_name: onlyoffice-connector
    networks:
      - onlyoffice-net
    restart: unless-stopped
    depends_on:
      - onlyoffice-documentserver
    environment:
      - DOCUMENT_SERVER_URL=http://onlyoffice-documentserver
      - DOCUMENT_SERVER_SECRET=your-secret-key-change-me  # 请修改
      - BASE_URL=http://onlyoffice-connector:10099
    ports:
      - '10099:10099'
    volumes:
      - /vol1:/vol1  # 根据实际存储卷调整
    labels:
      watchcow.enable: "true"
      watchcow.editor.service_port: "10099"
      watchcow.editor.protocol: "http"
      watchcow.editor.path: "/editor"
      watchcow.editor.ui_type: "iframe"
      watchcow.editor.all_users: "true"
      watchcow.editor.title: "使用 OnlyOffice 打开"
      watchcow.editor.file_types: "docx,xlsx,pptx,doc,xls,ppt,odt,ods,odp,pdf,txt,rtf,csv,djvu,oxps,epub,fb2"
      watchcow.editor.icon: "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/onlyoffice.png"
      watchcow.editor.no_display: "true"

  onlyoffice-documentserver:
    image: onlyoffice/documentserver:latest
    container_name: onlyoffice-documentserver
    networks:
      - onlyoffice-net
    restart: unless-stopped
    stop_grace_period: 60s
    environment:
      - JWT_ENABLED=true
      - JWT_SECRET=your-secret-key-change-me  # 与 connector 保持一致
      - JWT_HEADER=Authorization
      - JWT_IN_BODY=true
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8000/info/info.json"]
      interval: 30s
      retries: 5
      start_period: 60s
      timeout: 10s
    volumes:
      - ./volumes/data:/var/www/onlyoffice/Data
      - ./volumes/log:/var/log/onlyoffice
      - ./volumes/lib:/var/lib/onlyoffice
      - ./volumes/plugins:/var/www/onlyoffice/documentserver/sdkjs-plugins
      - ./volumes/fonts:/usr/share/fonts/truetype/custom

需要改一下 DOCUMENT_SERVER_SECRET 和 JWT_SECRET , 以及你的存储卷, 就能跑了, 我在电脑端测试过应该没问题, 手机端的fn connect还有点问题,有兴趣可以玩一下, 第一次启动会很久,onlyoffice-documentserver 有一些插件要安装, 显示为healthy就可以用了, 仓库地址在 https://github.com/tf4fun/onlyoffice-fnos , 欢迎来报issue

onlyoffice 图标: