OnlyOffice部署教程
OnlyOffice 是一款强大的在线文档协作套件，支持 Word、Excel、PPT 等多种格式，广泛应用于企业私有云和协作平台。本教程将手把手教你如何在本地或服务器上快速部署 OnlyOffice Document Server，并实现基本的安全配置和常见问题排查。
一、环境准备
- 推荐操作系统：Linux（如 Ubuntu 20.04/22.04）、CentOS 7/8，或 Windows Server
- 推荐部署方式：Docker（简单、隔离性好、易于升级）
- 服务器要求：2核CPU、4GB内存以上（生产环境建议8GB+），10GB以上磁盘空间
- 需开放端口：默认 80（或自定义）、443（如用 HTTPS）
二、使用 Docker 部署 OnlyOffice
1. 安装 Docker
以 Ubuntu 为例：
sudo apt update
sudo apt install -y docker.io
sudo systemctl enable docker --now
2. 拉取 OnlyOffice 镜像
docker pull onlyoffice/documentserver:latest
如需指定版本（如 8.3.3）：
docker pull onlyoffice/documentserver:8.3.3
3. 运行 OnlyOffice 容器
最基础的启动命令：
docker run -d --name onlyoffice \-p 8066:80 \onlyoffice/documentserver:8.3.3
- 这样访问
http://服务器IP:8066即可打开 OnlyOffice 欢迎页。
带 JWT 安全和自动重启：
docker run -d --name onlyoffice \--restart=always \-p 8066:80 \-e JWT_ENABLED=true \-e JWT_SECRET=0123456789abcdef0123456789abcdef \onlyoffice/documentserver:8.3.3
JWT_SECRET必须为32位（256bit）以上的字符串。
挂载数据目录（可选）：
docker run -d --name onlyoffice \--restart=always \-p 8066:80 \-v /opt/onlyoffice/logs:/var/log/onlyoffice \-v /opt/onlyoffice/data:/var/www/onlyoffice/Data \-e JWT_ENABLED=true \-e JWT_SECRET=0123456789abcdef0123456789abcdef \onlyoffice/documentserver:8.3.3
4. 浏览器访问
- 打开
http://你的服务器IP:8066，看到 OnlyOffice 页面即部署成功。
按照提示开启测试示例，不开启是无法访问的
#开启测试示例
sudo docker exec d6f370d10a49 sudo supervisorctl start ds:example
#将其添加到自动启动（如果不添加，容器重启后测试示例就无法访问了，需要重新开启）
sudo docker exec d6f370d10a49 sudo sed 's,autostart=false,autostart=true,' -i /etc/supervisor/conf.d/ds-example.conf
下面是官方测试示例页面，可以创建新文档，可以在线编辑，可以保存，尽情尝试吧~
三、常用配置说明
- 端口映射：
-p 8066:80，左侧为宿主机端口，右侧为容器内端口。 - JWT 安全：推荐生产环境开启，前端或业务后端生成 token，防止未授权访问。
- 挂载目录：建议挂载日志和数据目录，便于持久化和排查问题。
- 自动重启：
--restart=always保证容器异常退出后自动拉起。
四、常见问题排查
1. 容器启动后无法访问
- 检查服务器防火墙和云平台安全组，确保 8066 端口已放行。
- 用
docker ps查看容器是否正常运行。
2. 打开页面报 502/503
- 资源不足（内存<4G），建议升级服务器。
- 查看日志：
docker logs onlyoffice，或进入容器/var/log/onlyoffice查看详细日志。
3. OnlyOffice 与业务系统集成时保存失败
- 检查 JWT 密钥是否一致。
- 检查回调接口（callbackUrl）是否能被 OnlyOffice 容器访问。
- 检查回调接口是否返回
{"error":0}。
4. 跨域问题
- 可在业务后端或 Nginx 设置 CORS 允许 OnlyOffice 服务器访问。
五、进阶：HTTPS 配置（可选）
建议生产环境使用 HTTPS。可用 Nginx 反向代理实现：
server {listen 443 ssl;server_name your-domain.com;ssl_certificate /path/to/fullchain.pem;ssl_certificate_key /path/to/privkey.pem;location / {proxy_pass http://127.0.0.1:8066/;proxy_set_header Host $host;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;}
}
六、卸载与升级
-
停止并删除容器：
docker stop onlyoffice && docker rm onlyoffice -
删除镜像（如需）：
docker rmi onlyoffice/documentserver:8.3.3 -
升级只需拉取新镜像，重新运行即可。
七、参考资料
- 官方文档：https://helpcenter.onlyoffice.com/installation/docs-community-install-docker.aspx
- GitHub：https://github.com/ONLYOFFICE/Docker-DocumentServer
总结
OnlyOffice 部署非常简单，推荐使用 Docker 快速启动。生产环境建议开启 JWT，合理挂载数据目录，并配合后端实现文档保存回调。遇到问题多看日志，基本都能顺利解决。
tps://github.com/ONLYOFFICE/Docker-DocumentServer
总结
OnlyOffice 部署非常简单，推荐使用 Docker 快速启动。生产环境建议开启 JWT，合理挂载数据目录，并配合后端实现文档保存回调。遇到问题多看日志，基本都能顺利解决。
如需 OnlyOffice 与 Spring Boot、前端集成等进阶教程，欢迎留言交流！