Euro-Office DocumentServer首次体验:在线创建与编辑Word、Excel和PowerPoint
Euro-Office DocumentServer首次体验:在线创建与编辑Word、Excel和PowerPoint
Euro-Office DocumentServer 是一款开源自托管的在线文档服务器:部署后,你可以在浏览器里直接在线创建与编辑 Word(.docx)、Excel(.xlsx)和 PowerPoint(.pptx) 文件,无需安装 Office 桌面软件。它基于 ONLYOFFICE Document Server 社区项目构建,由 Euro-Office 团队重新品牌化并持续增强,口号是 "Your sovereign office"(你的主权办公空间)。当前版本为 9.3.5,见 VERSION。
🖥️ 它是什么?一个跑在自己服务器上的"云端 Office"
传统在线文档服务需要把文件上传到别人的云,而 DocumentServer 让你把文档服务完整部署在自己的服务器或 NAS 上:
- 📄 Word 兼容:完整支持 .docx 格式的创建、编辑与格式设置
- 📊 Excel 兼容:支持 .xlsx 电子表格与公式计算
- 📽️ PowerPoint 兼容:支持 .pptx 演示文稿的在线制作
- 📱 浏览器 + 移动端双端支持:手机、平板同样可以打开文档
- 🔒 数据不出门:所有文档都存储在你的基础设施内
整个仓库是 Euro-Office 生态的"总编排器",管理着 server、web-apps、sdkjs、core 等 11 个子模块,详见 AGENTS.md。
🚀 最快部署方法:Docker 两行命令启动
DocumentServer 官方提供 Docker 镜像,是最简单、也是新手推荐的上手方式。在装有 Docker 的服务器上执行:
docker pull ghcr.io/euro-office/documentserver:latest
docker run -i -t -d -p 8080:80 --restart=always \
-e EXAMPLE_ENABLED=true \
-e JWT_SECRET=一个至少32位的随机密钥 \
ghcr.io/euro-office/documentserver:latest
启动完成后,用浏览器访问 http://localhost:8080 即可看到文档服务首页;想确认服务是否就绪,可以请求健康检查接口 /healthcheck(返回 true 即表示成功)。
💡 提示:
EXAMPLE_ENABLED=true会开启官方示例页,方便你零配置体验新建文档;JWT_SECRET是接口签名密钥,生产环境请务必换成足够长的随机字符串。
✍️ 在线创建文档:Word、Excel、PowerPoint 三件套
开启示例页后,访问 http://localhost:8080/example/,页面上提供了三个一键新建入口,这正是测试团队在端到端测试中反复验证的场景:
| 编辑器 | 新建文件 | 能做什么 |
|---|---|---|
| 📄 Document(文字处理) | .docx |
输入文本、加粗、斜体等格式设置 |
| 📊 Spreadsheet(电子表格) | .xlsx |
输入数字、编写公式并自动计算 |
| 📽️ Presentation(演示文稿) | .pptx |
新建幻灯片、多页排版 |
这些能力都有对应的自动化测试作为保障,感兴趣的新手可以阅读测试代码来"反推"编辑器支持哪些操作,是非常好的源码入门材料:
- Word 输入与加粗/斜体:e2e/tests/document-editing.spec.ts
- Excel 数字与公式:e2e/tests/spreadsheet-formula.spec.ts
- PPT 多页创建:e2e/tests/presentation-slides.spec.ts
📱 不止于桌面:移动端编辑与更多格式
- 移动端编辑器:在手机上打开同样可以编辑 Word、Excel、PowerPoint,项目用真实的移动视口(414×896)为三类文档编写了冒烟测试,见 e2e/tests/mobile-editor.spec.ts
- PDF 查看:文档可直接以 PDF 形式在线浏览
- 格式与资源扩展:仓库内置 document-formats/(格式处理)、document-templates/(文档模板)、dictionaries/(多语言词典)等模块,支撑了丰富的格式兼容能力
☁️ 进阶玩法:接入 Nextcloud 打造私有云办公
官方开发环境 develop/docker-compose.yml 中已经预置了 Nextcloud 服务,并自动安装配置 eurooffice 连接器插件,一条命令就能体验"私有网盘 + 在线 Office"的完整流程:
cd develop
docker compose up -d eo nextcloud
随后在 Nextcloud 的"文件"应用中直接新建并打开 Word/Excel/PPT,编辑体验与桌面 Office 非常接近。连接器初始化脚本见 develop/setup/enable-office.sh,完整部署说明在 develop/README.md。
🗂️ 仓库结构速览:源码都放在哪里
| 目录 | 作用 | 适合谁看 |
|---|---|---|
| server/ | 后端文档服务(解析、协作、存储接口) | 想了解"服务端"的新手 |
| web-apps/ | 浏览器端 Web 编辑器前端 | 想了解界面实现的新手 |
| sdkjs/ | 前端 JavaScript SDK(文档引擎核心) | 想做二次开发的朋友 |
| document-server-integration/ | 第三方系统集成支持 | 想接入自己系统的开发者 |
| scripts/ | 镜像同步、版本标签等维护脚本 | 运维方向 |
❓ 新手常见问题(FAQ)
Q1:它和 ONLYOFFICE 是什么关系?
DocumentServer 源自 ONLYOFFICE Document Server 社区代码,由 Euro-Office 项目重新品牌化为 Euro-Office Docs 并持续维护,界面主题(THEME: euro-office)与默认品牌均已切换。
Q2:部署后打不开页面怎么办?
先确认端口映射(8080:80)是否冲突,再访问 /healthcheck 查看服务状态;开发环境的启动脚本 eo.sh 会自动等待健康检查通过后再输出访问地址。
Q3:许可证是什么? 采用 GNU AGPL v3 开源协议,见 LICENSE 与 ATTRIBUTION。
📝 总结
Euro-Office DocumentServer 给新手提供了一条极低门槛的路径:两条 Docker 命令 → 浏览器打开 → 在线创建并编辑 Word、Excel、PowerPoint。数据完全掌握在自己手中,又能无缝接入 Nextcloud 私有云,是搭建"自托管在线办公"的完整解决方案。建议下一步阅读 README.md 了解生态全貌,再顺着 AGENTS.md 中的子模块依赖链(core-fonts → core → sdkjs → web-apps → server)深入源码。