Nextcloud接入Euro-Office DocumentServer:私有云文档协作完整指南
Nextcloud接入Euro-Office DocumentServer:私有云文档协作完整指南
Euro-Office DocumentServer 是一款开源的在线办公文档协作服务器,支持 Word、Excel、PPT 的浏览器内编辑。本文带你用几分钟把它接入 Nextcloud 私有云,让团队在自己的服务器上完成文档在线协作、协同编辑与预览,数据完全自主可控。
什么是 Euro-Office DocumentServer?
- 主权办公:项目口号就是 "Your sovereign office" —— 文档编辑能力完整部署在你自己的数据中心
- 三种编辑器:文档(docx)、表格(xlsx)、演示文稿(pptx)均可在线创建与编辑
- Docker 原生:提供官方 Docker 镜像,一条命令即可运行
- WOPI 兼容:可与 Nextcloud 等主流私有云存储打通
项目介绍见 README.md,仓库结构与组件依赖说明见 AGENTS.md,当前版本 v9.3.5(VERSION)。
工作原理:2 个容器 + 1 个连接器
仓库的 develop/ 目录提供了一个开箱即用的集成环境,本质上是「2 个容器 + 1 个连接器应用」:
| 组件 | 角色 | 访问地址 |
|---|---|---|
eo 容器 |
Euro-Office 文档服务器(编辑引擎、格式转换) | http://localhost:8080 |
nextcloud 容器 |
Nextcloud 私有云(文件存储、用户账号) | http://localhost:8081 |
eurooffice 应用 |
Nextcloud 连接器,负责签发/回调,首次启动自动安装 | Nextcloud 管理后台 |
连接器应用 eurooffice 来自独立的 eurooffice-nextcloud 仓库,以只读方式挂载进 Nextcloud 容器,开发环境会自动完成安装与配置。两侧通过 JWT 密钥对接:用户打开文档时,Nextcloud 生成带签名的地址交给文档服务器,文档服务器再凭同一签名读取和回写文件,全程无需人工配置。
容器定义与端口映射见 develop/docker-compose.yml。
一键安装步骤
前置条件:机器上已安装 Docker。以下 3 步即可完成部署。
第 1 步:获取代码仓库
git clone https://gitcode.com/gh_mirrors/doc/DocumentServer
第 2 步:启动环境
cd DocumentServer/develop
make local
该命令会自动拉取预构建镜像(amd64 / arm64 双架构,无需本地编译)、启动 eo 与 nextcloud 两个容器、安装并配置 eurooffice 连接器,最后进入容器 shell(不想进 shell 可直接 docker compose up -d)。
第 3 步:验证就绪
curl -sf http://localhost:8080/healthcheck
返回 true 即代表文档服务器已就绪。
Nextcloud 连接器配置详解
首次启动时,develop/setup/enable-office.sh 会自动写入 4 个关键配置。理解它们是手动配置与排查问题的关键:
| 参数 | 开发环境默认值 | 含义 |
|---|---|---|
DocumentServerUrl |
http://localhost:8080/ |
浏览器端可访问的文档服务器地址 |
StorageUrl |
http://nextcloud/ |
文档服务器内部请求的 Nextcloud 地址 |
DocumentServerInternalUrl |
http://eo/ |
Nextcloud 内部请求的文档服务器地址 |
jwt_secret |
euro-office-dev-jwt-secret-key-2026 |
双向签名密钥,两侧必须一致 |
⚠️ 文档打不开时,最常见的原因就是两侧 JWT 密钥不一致。可先核对两个容器是否使用同一密钥(环境变量
EO_JWT_SECRET可覆盖默认值)。
30 秒打开并编辑文档
- 打开 http://localhost:8081/ ,用默认账号
admin/admin登录 - 进入 Files,上传任意
.docx/.xlsx/.pptx文件,或直接新建 - 单击文件——浏览器内直接打开完整功能编辑器,工具栏、选项卡一应俱全,编辑结果自动回存到私有云
- 只想体验编辑器?访问 http://localhost:8080/example/ ,点 "Create new" 即可创建 Document / Spreadsheet / Presentation
仓库里的自动化测试(如 e2e/tests/document-editing.spec.ts、e2e/tests/spreadsheet-formula.spec.ts)验证的正是这条链路,可作自检参考。
常用命令速查表
以下命令均在 develop/ 目录下执行:
| 需求 | 命令 |
|---|---|
| 启动本地环境 | make local |
| 启动移动端 / 局域网访问(自动探测 LAN IP) | make mobile |
| IP 变更后刷新 URL(免重建) | make refresh-urls |
| 固定 Nextcloud 版本 | NC_VERSION=34 make local |
| 测试未来的 Nextcloud 版本 | make next NC_BRANCH=stable34 |
| 清空 Nextcloud 数据 | make wipe-nc |
| 启动单容器轻量测试服务器 | ./eo.sh up demo |
详细说明见 develop/Makefile 与 develop/README.md。
3 个常见问题排查
- 文档打不开 → 先核对两侧 JWT 密钥;再查容器内
/var/log/euro-office/documentserver/下的ds-example_out.log(JWT 相关)与converter/out.log(下载 403 相关) - Nextcloud 启动报错、提示数据版本过新 → 本地
nextcloud:latest镜像落后于数据卷,执行docker pull nextcloud:latest && make即可,NC 入口会自动执行升级 - 报
Makefile: No such file→ 单文件挂载失效,执行docker compose up -d --force-recreate eo恢复(注意:容器内已构建的组件会回退到镜像版本)
从开发环境到生产部署
develop/ 环境面向开发验证,生产部署可直接使用官方生产镜像:
docker pull ghcr.io/euro-office/documentserver:latest
docker run -i -t -d -p 8080:80 --restart=always \
-e JWT_SECRET=<自定义32位以上密钥> \
ghcr.io/euro-office/documentserver:latest
两条生产加固建议:
JWT_SECRET换成自己的随机密钥,并启用 HTTPS- 不启用
EXAMPLE_ENABLED,避免暴露演示页
如需深入源码,可看各子模块:编辑核心 core/、前端编辑器 web-apps/、服务端 server/、格式解析 document-formats/。
写在最后
一条 make local,你就拥有了「Nextcloud 私有云 + Euro-Office DocumentServer」的完整在线文档协作环境:文件存在自己的云里,编辑发生在自己的浏览器里,整条数据链路完全自主可控。无论是个人知识库还是企业级文档协作,这套组合都值得一试。