ONLYOFFICE Document Server 是一款在线办公套件,包含文本、电子表格和演示文稿的查看器与编辑器,完全兼容 Office Open XML 格式(.docx、.xlsx、.pptx),并支持实时协作编辑功能。
与 ONLYOFFICE Community Server 集成后,可实现:
如需单独安装 ONLYOFFICE Document Server,执行以下命令:
bashsudo docker run -i -t -d -p 80:80 onlyoffice/documentserver
容器数据存储在以下指定目录(数据卷):
/var/log/onlyoffice:Document Server 日志/var/www/onlyoffice/Data:证书文件/var/lib/onlyoffice:文件缓存/var/lib/postgresql:数据库文件通过 -v 参数挂载宿主机目录实现数据持久化:
bashsudo docker run -i -t -d -p 80:80 \ -v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice \ # 日志目录 -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data \ # 证书目录 -v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice \ # 缓存目录 -v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql \ # 数据库目录 onlyoffice/documentserver
数据持久化适用场景:
通过 -p 参数指定宿主机端口(格式:宿主机端口:容器端口),例如使用 8080 端口访问:
bashsudo docker run -i -t -d -p 8080:80 onlyoffice/documentserver
通过 HTTPS 访问需挂载证书目录并映射 443 端口:
bashsudo docker run -i -t -d -p 443:443 \ -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data \ onlyoffice/documentserver
实现 HTTPS 需准备:
证书文件需放置在宿主机目录 /app/onlyoffice/DocumentServer/data/certs/,文件名为:
onlyoffice.key(私钥)onlyoffice.crt(证书)若无需 CA 认证证书,可按以下步骤生成自签名证书:
步骤 1:生成服务器私钥
bashopenssl genrsa -out onlyoffice.key 2048
步骤 2:生成证书签名请求(CSR)
bashopenssl req -new -key onlyoffice.key -out onlyoffice.csr
步骤 3:使用私钥和 CSR 签名证书(有效期 365 天)
bashopenssl x509 -req -days 365 -in onlyoffice.csr -signkey onlyoffice.key -out onlyoffice.crt
生成 Diffie-Hellman 参数提升安全性:
bashopenssl dhparam -out dhparam.pem 2048
将生成的 onlyoffice.key、onlyoffice.crt 和 dhparam.pem 复制到宿主机证书目录,并设置权限:
bashmkdir -p /app/onlyoffice/DocumentServer/data/certs cp onlyoffice.key /app/onlyoffice/DocumentServer/data/certs/ cp onlyoffice.crt /app/onlyoffice/DocumentServer/data/certs/ cp dhparam.pem /app/onlyoffice/DocumentServer/data/certs/ chmod 400 /app/onlyoffice/DocumentServer/data/certs/onlyoffice.key # 限制私钥访问权限
通过环境变量自定义 HTTPS 及服务配置,支持以下参数:
| 参数名 | 描述 | 默认值 |
|---|---|---|
| ONLYOFFICE_HTTPS_HSTS_ENABLED | 是否启用 HSTS 配置(仅 HTTPS 模式) | true |
| ONLYOFFICE_HTTPS_HSTS_MAXAGE | HSTS 缓存时长(秒,仅 HTTPS 模式) | 31536000(1 年) |
| SSL_CERTIFICATE_PATH | SSL 证书路径 | /var/www/onlyoffice/Data/certs/onlyoffice.crt |
| SSL_KEY_PATH | 私钥路径 | /var/www/onlyoffice/Data/certs/onlyoffice.key |
| SSL_DHPARAM_PATH | Diffie-Hellman 参数路径 | /var/www/onlyoffice/Data/certs/dhparam.pem |
| SSL_VERIFY_CLIENT | 是否验证客户端证书(需配合 CA_CERTIFICATES_PATH) | false |
| POSTGRESQL_SERVER_HOST | 外部 PostgreSQL 服务器地址 | - |
| POSTGRESQL_SERVER_PORT | 外部 PostgreSQL 端口 | - |
| POSTGRESQL_SERVER_DB_NAME | PostgreSQL 数据库名 | - |
| POSTGRESQL_SERVER_USER | PostgreSQL 用户名 | - |
| POSTGRESQL_SERVER_PASS | PostgreSQL 密码 | - |
| RABBITMQ_SERVER_URL | RabbitMQ 服务器 AMQP 连接 URL | - |
| REDIS_SERVER_HOST | Redis 服务器地址 | - |
| REDIS_SERVER_PORT | Redis 端口 | - |
| NGINX_WORKER_PROCESSES | Nginx 工作进程数 | - |
| NGINX_WORKER_CONNECTIONS | 单个 Nginx 进程最大连接数 | - |
| JWT_ENABLED | 是否启用 JWT 验证 | false |
| JWT_SECRET | JWT 验证密钥 | secret |
| JWT_HEADER | 传递 JWT 的 HTTP 头字段 | Authorization |
bashdocker network create --driver bridge onlyoffice
参考 MySQL *** Docker 文档 部署 MySQL。
bashsudo docker run --net onlyoffice -i -t -d --restart=always --name onlyoffice-document-server \ -v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice \ -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data \ -v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice \ -v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql \ onlyoffice/documentserver
需指定邮件服务器域名(yourdomain.com):
bashsudo docker run --init --net onlyoffice --privileged -i -t -d --restart=always --name onlyoffice-mail-server \ -p 25:25 -p 143:143 -p 587:587 \ -e MYSQL_SERVER=onlyoffice-mysql-server \ -e MYSQL_SERVER_PORT=3306 \ -e MYSQL_ROOT_USER=root \ -e MYSQL_ROOT_PASSWD=my-secret-pw \ -e MYSQL_SERVER_DB_NAME=onlyoffice_mailserver \ -v /app/onlyoffice/MailServer/data:/var/vmail \ -v /app/onlyoffice/MailServer/data/certs:/etc/pki/tls/mailserver \ -v /app/onlyoffice/MailServer/logs:/var/log \ -h yourdomain.com \ onlyoffice/mailserver
bashsudo docker run --net onlyoffice -i -t -d --restart=always --name onlyoffice-community-server \ -p 80:80 -p 443:443 -p 5222:5222 \ -e MYSQL_SERVER_ROOT_PASSWORD=my-secret-pw \ -e MYSQL_SERVER_DB_NAME=onlyoffice \ -e MYSQL_SERVER_HOST=onlyoffice-mysql-server \ -e MYSQL_SERVER_USER=onlyoffice_user \ -e MYSQL_SERVER_PASS=onlyoffice_pass \ -e DOCUMENT_SERVER_PORT_80_TCP_ADDR=onlyoffice-document-server \ -e MAIL_SERVER_API_HOST=${MAIL_SERVER_IP} \ -e MAIL_SERVER_DB_HOST=onlyoffice-mysql-server \ -e MAIL_SERVER_DB_NAME=onlyoffice_mailserver \ -e MAIL_SERVER_DB_PORT=3306 \ -e MAIL_SERVER_DB_USER=root \ -e MAIL_SERVER_DB_PASS=my-secret-pw \ -v /app/onlyoffice/CommunityServer/data:/var/www/onlyoffice/Data \ -v /app/onlyoffice/CommunityServer/logs:/var/log/onlyoffice \ onlyoffice/communityserver
获取邮件服务器 IP:
bashdocker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' onlyoffice-mail-server
使用***脚本快速部署完整社区版:
bash# 下载脚本 wget [***] # 执行安装(替换 yourdomain.com 为实际域名) bash opensource-install.sh -md yourdomain.com
setenforce 0,或更换为 Ubuntu 系统。onlyoffice 标签提问或解答问题来自真实用户的反馈,见证轩辕镜像的优质服务
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像加速服务
在 Docker Desktop 配置镜像加速
Docker Compose 项目配置加速
Kubernetes 集群配置 Containerd
在宝塔面板一键配置镜像加速
Synology 群晖 NAS 配置加速
飞牛 fnOS 系统配置镜像加速
极空间 NAS 系统配置加速服务
爱快 iKuai 路由系统配置加速
绿联 NAS 系统配置镜像加速
QNAP 威联通 NAS 配置加速
Podman 容器引擎配置加速
HPC 科学计算容器配置加速
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名加速
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429