Euro-Office DocumentServer快速上手:5分钟Docker部署私有化在线Office

原创2026-10-10 12:56:111,326 阅读

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 的端到端测试用例,可以帮你快速理解各编辑场景的预期行为。

登录后查看全文
DocumentServer