飞牛 ARM OnlyOffice 在线编辑 — 完整部署指南

最终效果

浏览器打开 https://oo.929295.xyz/ → 输账号密码 → 直接展示 /vol1/1000/onlyoffice 目录（科幻风深色 UI）→ 新建/删除文件夹、上传/新建/下载/删除文件 → 点击 xlsx/docx/pptx 在线编辑 → 关闭标签页自动保存回写磁盘。

前提条件

文件清单

第一步：获取 Tailscale IP

tailscale ip -4
# 记下输出（如 100.65.232.26）

第二步：修改配置

2.1 生成密码

openssl passwd -apr1 "你的飞牛登录密码"
# 输出写入 .htpasswd：yingfanyu:哈希

2.2 docker-compose.yaml 替换项

2.3 隧道令牌

1. Cloudflare Zero Trust → Networks → Tunnels → Create
2. 选 Docker → 复制 eyJ... 令牌 → 填入 cloudflared-standalone.yaml
3. 添加 Public Hostname：oo.929295.xyz → http://<Tailscale IP>:10099

第三步：部署

mkdir -p /opt/onlyoffice-connector
# 把 6 个文件拷贝到 /opt/onlyoffice-connector/

cd /opt/onlyoffice-connector
docker compose up -d                    # 主栈
docker compose -f cloudflared-standalone.yaml up -d   # 隧道

# 验证
docker ps                               # 4 个容器均应 Up
docker logs onlyoffice-cloudflared --tail 10   # 应有 Registered tunnel connection

第四步：Cloudflare 关键设置

Cloudflare **Auto Minify（JS）**和 Rocket Loader 会破坏页面的 JavaScript，必须关闭：

1. Cloudflare 仪表盘 → 选域名
2. 速度 → 优化 → Auto Minify → JavaScript 关
3. 速度 → 优化 → Rocket Loader → 关
4. 缓存 → 配置 → 清除所有内容

第五步：验证

# 本机测试（绕开隧道）
curl -u yingfanyu:密码 -s "http://localhost:10099/" | grep "page.js"
# 应有输出

curl -u yingfanyu:密码 -s "http://localhost:10099/api/list?path=/vol1/1000/onlyoffice"
# 应返回 JSON 文件列表

浏览器无痕窗口 → https://oo.929295.xyz/ → 输密码 → 直接进入 /vol1/1000/onlyoffice 目录。

日常更新

cd /opt/onlyoffice-connector
# 覆盖文件后必须 restart，docker compose up -d 不会重新加载 bind mount
docker restart onlyoffice-files       # 更新 files_app.py
docker restart onlyoffice-nginx       # 更新 nginx.conf 或 .htpasswd

架构

浏览器 ──→ CF Tunnel ──→ fnnas:10099 (nginx) ─┬─→ onlyoffice-files:8080   (文件/API)
                                               ├─→ onlyoffice-connector     (DS 连接器)
                                               └─→ of.929295.xyz           (外部 DS)

安全

• 人类入口（/、/edit、/api/*）→ basic-auth 鉴权
• DS 回写路径（/download、/callback、/api/save）→ 不设密码（DS 无浏览器登录态）
• 前端 apiFetch 带 credentials，遇 401 自动重新登录

排障

ARM.OnlyOffice.zip