Euro-Office DocumentServer快速上手:5分钟Docker部署私有化在线Office
Euro-Office DocumentServer快速上手:5分钟Docker部署私有化在线Office
DocumentServer 是 Euro-Office 社区开源的私有化在线 Office 服务器(当前版本 9.3.5,见 VERSION),基于 AGPLv3 协议完全免费。它能让文档数据完全留在你自己的服务器上,通过 Docker 两条命令即可搭建,无需任何 Office 客户端。本文带你快速完成 DocumentServer 的 Docker 部署,并教你打开第一个在线文档。
一、DocumentServer 是什么?适合谁用
简单来说,DocumentServer 就是一个可以自建的在线文档编辑服务,核心能力包括:
- 📄 在线编辑:在浏览器中直接创建和编辑文字文档(docx)、电子表格(xlsx)、演示文稿(pptx)
- 🔄 格式转换:内置文件转换器,支持打开和互转主流 Office 格式
- 🤝 标准集成:通过 WOPI 等标准协议,可与 Nextcloud 等网盘打通,实现"网盘里点开就能改"
- 🔒 数据主权:私有化部署,文档不出内网,适合企业、NAS 玩家和对数据敏感的个人
项目采用模块化架构,核心组件分为文档内核(core/)、前端编辑器(web-apps/、sdkjs/)和服务端(server/)等子模块,整体由 AGENTS.md 中的依赖链统一管理。
二、一键部署:两条命令启动 DocumentServer
部署前只需确保服务器装好了 Docker,无需数据库、无需编译。
1. 拉取镜像
docker pull ghcr.io/euro-office/documentserver:latest
镜像内置了 Postgres、Redis、RabbitMQ、Nginx 等全部依赖,是一个完全自包含的容器。
2. 启动容器
docker run -i -t -d -p 8080:80 --restart=always \
-e EXAMPLE_ENABLED=true \
-e JWT_SECRET=my_long_jwt_secret_at_least_32_chars \
ghcr.io/euro-office/documentserver:latest
两个关键参数说明:
| 参数 | 作用 | 注意事项 |
|---|---|---|
-p 8080:80 |
端口映射 | 宿主机端口可自定义,如 -p 9000:80 |
JWT_SECRET |
请求签名密钥 | 必须至少 32 位,请换成自己的长随机字符串 |
EXAMPLE_ENABLED |
启用示例应用 | 设为 true 后可开箱即用体验编辑器 |
--restart=always 保证服务器重启后服务自动拉起,这是生产环境的推荐做法。
3. 验证服务是否就绪
容器启动后,用健康检查接口确认 DocumentServer 已完全启动:
curl -sf http://localhost:8080/healthcheck
返回 true 即代表部署成功,整个过程通常不超过 1 分钟。
三、打开编辑器:体验你的在线 Office
浏览器访问:
- 🏠 欢迎页:
http://localhost:8080/ - 📝 示例应用:
http://localhost:8080/example/
进入示例应用后,点击 Create new,就可以新建文字文档、电子表格或演示文稿并直接在浏览器中编辑。打开 .docx / .xlsx 文件时,会同时走 FileConverter 转换流程,能真实检验转换功能是否正常。
💡 小提示:示例应用入口是通过"新建文档"的方式创建文件的;如果直接访问带
fileName参数的编辑器链接,会因文件不存在而失败,这是预期行为。
四、进阶玩法:对接 Nextcloud 网盘
如果你的服务器上有 Nextcloud,可以把 DocumentServer 接入进去,实现网盘文件点开即编辑。仓库的 develop/docker-compose.yml 中就内置了完整的 Nextcloud 集成环境(Nextcloud 运行在 8081 端口),关键配置由 develop/setup/shared/hooks/after-install.sh 自动完成,包括:
- 等待 DocumentServer 健康检查通过
- 自动启用 Euro-Office 连接器插件
- 配置双向通信地址(
DocumentServerUrl/StorageUrl)和共享 JWT 密钥
配置完成后,在 Nextcloud 的 Files 里创建文档,即可无缝打开编辑。详细的开发环境搭建步骤见 develop/README.md。
五、常见问题速查 🛠️
Q1:文档打不开,提示 403?
通常是 JWT 密钥不匹配。确保你的应用(或 Nextcloud)里配置的 JWT_SECRET 与容器启动时传入的完全一致,可参考 develop/eo.sh 中对 JWT 默认值的说明。
Q2:想查看服务日志排查问题?
日志位于容器内 /var/log/euro-office/documentserver/ 目录,例如 docservice/out.log(编辑服务)、converter/out.log(格式转换)。
Q3:支持 ARM64(如苹果芯片 Mac、ARM 服务器)吗?
支持。官方发布的是多架构镜像(amd64 + arm64),docker pull 会自动选择对应架构。
Q4:安全方面需要注意什么? 安全漏洞请遵循 SECURITY.md 的流程私下发给维护者,不要公开提交 issue。项目继承了 OnlyOffice 的代码,上游已知 CVE 也可能影响 Euro-Office。
六、写在最后
回顾一下 5 分钟部署路径:拉取镜像 → 配置 JWT → 启动容器 → 健康检查 → 打开编辑器,你的私有化在线 Office 就跑起来了。后续如果想深入定制(如替换主题、扩展集成、二次开发),可以从 develop/README.md 的开发环境文档和 CONTRIBUTING.md 的协作规范入手,仓库的 e2e/ 目录下还有基于 Playwright 的端到端测试用例,可以帮你快速理解各编辑场景的预期行为。