Nextcloud接入Euro-Office DocumentServer:私有云文档协作完整指南

原创2026-10-10 13:50:161,844 阅读

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 秒打开并编辑文档

  1. 打开 http://localhost:8081/ ,用默认账号 admin / admin 登录
  2. 进入 Files,上传任意 .docx / .xlsx / .pptx 文件,或直接新建
  3. 单击文件——浏览器内直接打开完整功能编辑器,工具栏、选项卡一应俱全,编辑结果自动回存到私有云
  4. 只想体验编辑器?访问 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 个常见问题排查

  1. 文档打不开 → 先核对两侧 JWT 密钥;再查容器内 /var/log/euro-office/documentserver/ 下的 ds-example_out.log(JWT 相关)与 converter/out.log(下载 403 相关)
  2. Nextcloud 启动报错、提示数据版本过新 → 本地 nextcloud:latest 镜像落后于数据卷,执行 docker pull nextcloud:latest && make 即可,NC 入口会自动执行升级
  3. 报 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」的完整在线文档协作环境:文件存在自己的云里,编辑发生在自己的浏览器里,整条数据链路完全自主可控。无论是个人知识库还是企业级文档协作,这套组合都值得一试。

登录后查看全文
DocumentServer