docker部署在线协作工具核心是选稳定官方镜像、用docker compose编排多服务网络、挂载卷持久化数据、配置反向代理与https。需注意域名转义、服务间调用用容器名、时区同步及资源限制。
用 Docker 部署在线协作工具（如 OnlyOffice、Etherpad、Collabora Online 或 Nextcloud + Collabora 集成）核心在于：选对镜像、配好网络、持久化数据、处理反向代理与 HTTPS。不需从零编译，关键在配置协调。
选稳定镜像，优先官方或高星社区版
避免使用无人维护的镜像。例如：
-
OnlyOffice：用
onlyoffice/documentserver官方镜像（注意区分community-server和documentserver，前者是完整套件，后者仅文档服务）； -
Etherpad：推荐
etherpad/etherpad（Docker Hub 官方认证）； -
Collabora Online：用
collabora/code（由 Collabora 官方维护，支持 ARM/x86）； -
Nextcloud + 协作插件：用
nextcloud:apache镜像，再通过docker exec或初始化脚本启用richdocuments（Collabora 插件）或onlyoffice插件。
用 Docker Compose 编排多容器协作链路
典型协作场景常含多个服务：前端（Nginx）、应用（OnlyOffice/Nextcloud）、协作后端（Collabora）、数据库（PostgreSQL/MySQL）、缓存（Redis）。Docker Compose 可统一管理依赖与网络。
示例要点：
- 所有服务共用自定义 bridge 网络（如
collab-net），避免使用默认bridge； - Collabora 容器需设置环境变量
-e "domain=myapp\.example\.com"（注意双转义点号）以匹配前端域名； - OnlyOffice Document Server 默认监听
localhost:80，若与 Nextcloud 同 compose 文件，应通过服务名（如onlyoffice:80）调用，而非127.0.0.1； - 为 Nextcloud 挂载
/var/www/html/custom_apps和/var/www/html/config到宿主机，方便安装和保留插件配置。
持久化数据与配置，避免重启丢配置
协作工具高度依赖状态：用户数据、文档版本、插件设置、SSL 证书、数据库内容。必须显式挂载卷：
- 数据库：PostgreSQL 数据目录（
/var/lib/postgresql/data）映射到宿主机路径或命名卷； - OnlyOffice：挂载
/app/onlyoffice/DocumentServer/logs、/app/onlyoffice/DocumentServer/data、/app/onlyoffice/DocumentServer/cache； - Nextcloud：除
/var/www/html外，必须挂载/var/www/html/data（用户文件）和/var/www/html/config（配置）； - 证书：Nginx 或 Caddy 的 SSL 目录（如
/etc/letsencrypt）建议用命名卷或绑定挂载，配合 certbot 自动续期。
反向代理与 HTTPS 是可用性前提
单容器暴露 80/443 不安全也不灵活。推荐用 Nginx 或 Caddy 作为前置网关：
- Caddy v2 配置极简：
myapp.example.com { reverse_proxy http://nextcloud:80; reverse_proxy /lool/ http://collabora:9980/lool/ }； - Nginx 需手动配置 proxy_pass、WebSocket 支持（
Upgrade和Connection头）、以及 /cache、/convert、/coauthoring 路径转发给 OnlyOffice； - 务必启用 HTTPS——Caddy 自动申请 Let’s Encrypt；Nginx 可搭配 certbot；否则浏览器会阻止加载混合内容或 WebSocket 连接；
- 检查浏览器控制台是否有
Blocked loading mixed active content或WebSocket connection to ... failed，多因协议不一致（HTTP 前端 → HTTPS 后端，或反之）或 header 缺失。
不复杂但容易忽略：时间同步（容器内时区需与宿主机一致，否则 JWT token 或日志时间错乱）、健康检查（为关键服务添加 healthcheck）、资源限制（Collabora/OnlyOffice 内存占用高，建议 mem_limit: 2g）。
