OnlyOffice Docker部署全攻略：从容器化到域名访问配置指南

一、为什么选择Docker部署OnlyOffice？

OnlyOffice作为开源的在线办公套件，支持文档协作、电子表格和演示文稿的在线编辑。对于开发者和企业用户而言，Docker容器化部署具有显著优势：

环境一致性：消除开发、测试、生产环境的差异
快速部署：通过镜像实现分钟级部署
资源隔离：每个容器独立运行，避免服务冲突
易于维护：通过Docker Compose实现服务编排

典型应用场景包括：

中小企业私有化部署在线办公系统
开发环境快速搭建测试环境
混合云环境下的跨平台部署

二、环境准备与基础部署

1. 系统要求

服务器配置：建议2核4G以上（根据并发量调整）
操作系统：Ubuntu 20.04/CentOS 7+
存储空间：至少20GB可用空间（包含文档存储）

2. Docker安装

# Ubuntu示例
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER  # 添加当前用户到docker组
newgrp docker  # 立即生效
# CentOS示例
yum install -y yum-utils
yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
yum install docker-ce docker-ce-cli containerd.io
systemctl enable --now docker

3. 基础容器部署

使用官方镜像快速启动：

docker run -i -t -d -p 8080:80 \
  --restart=always \
  -e JWT_ENABLED=true \
  -e JWT_SECRET=your_secret_key \
  onlyoffice/documentserver

关键参数说明：

-p 8080:80：将容器80端口映射到主机8080端口
JWT_ENABLED：启用JWT令牌验证（推荐生产环境使用）
JWT_SECRET：设置JWT加密密钥

三、进阶配置：域名访问实现

1. 反向代理配置（Nginx示例）

生产环境必须通过反向代理暴露服务，推荐使用Nginx：

安装Nginx

# Ubuntu
apt install nginx
# CentOS
yum install epel-release
yum install nginx

配置示例

server {
    listen 80;
    server_name docs.example.com;  # 替换为实际域名
    location / {
        proxy_pass http://localhost:8080;  # 对应Docker映射端口
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
    # 静态资源缓存配置
    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
        expires 1y;
        add_header Cache-Control "public";
    }
}

2. HTTPS加密配置（Let’s Encrypt）

通过Certbot免费获取SSL证书：

# 安装Certbot
apt install certbot python3-certbot-nginx
# 获取证书（会暂停Nginx服务）
certbot --nginx -d docs.example.com
# 自动续期测试
certbot renew --dry-run

3. Docker Compose编排（推荐方案）

创建docker-compose.yml文件实现服务编排：

version: '3.8'
services:
  onlyoffice:
    image: onlyoffice/documentserver
    container_name: onlyoffice
    restart: always
    environment:
      - JWT_ENABLED=true
      - JWT_SECRET=your_secure_key
    volumes:
      - ./data:/var/www/onlyoffice/Data
      - ./logs:/var/log/onlyoffice
      - ./fonts:/usr/share/fonts/truetype/custom
    ports:
      - "8080:80"
  nginx:
    image: nginx:latest
    container_name: nginx-proxy
    restart: always
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
      - ./certs:/etc/letsencrypt/live
      - ./html:/usr/share/nginx/html
    depends_on:
      - onlyoffice

四、生产环境优化建议

1. 性能调优

内存限制：通过--memory参数限制容器内存使用
并发连接：调整Nginx的worker_connections参数（默认1024）

缓存策略：

proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=onlyoffice_cache:10m inactive=60m;
location / {
    proxy_cache onlyoffice_cache;
    proxy_cache_valid 200 302 1h;
}

2. 安全加固

防火墙规则：

ufw allow 80/tcp
ufw allow 443/tcp
ufw deny 8080/tcp  # 禁止直接访问容器端口

JWT验证：生成强密钥：
```
openssl rand -base64 32
```

定期备份：

docker exec onlyoffice tar -czf /backup/onlyoffice_data.tar.gz /var/www/onlyoffice/Data

3. 监控方案

Prometheus监控：

# docker-compose.yml补充
prometheus:
  image: prom/prometheus
  volumes:
    - ./prometheus.yml:/etc/prometheus/prometheus.yml
  ports:
    - "9090:9090"

关键指标：
- 容器内存使用率
- 请求响应时间（P99）
- 文档转换成功率

五、常见问题解决方案

1. 502 Bad Gateway错误

检查Docker容器是否正常运行：docker ps -a
查看Nginx错误日志：tail -f /var/log/nginx/error.log
验证端口映射：netstat -tulnp | grep 8080

2. 文档转换失败

检查字体安装：确保容器内包含所需字体

调整内存限制：

onlyoffice:
  deploy:
    resources:
      limits:
        memory: 2G

3. 跨域问题

在Nginx配置中添加：

add_header 'Access-Control-Allow-Origin' '*';
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range';

六、升级与维护策略

1. 版本升级流程

# 1. 备份数据
docker exec onlyoffice tar -czf /backup/data_backup.tar.gz /var/www/onlyoffice/Data
# 2. 拉取新镜像
docker pull onlyoffice/documentserver:latest
# 3. 重新部署（使用原有配置）
docker-compose up -d --no-deps --force-recreate onlyoffice

2. 日志分析

容器日志：docker logs onlyoffice --tail 100

访问日志分析：

awk '{print $1}' /var/log/nginx/access.log | sort | uniq -c | sort -nr | head -n 10

七、扩展应用场景

1. 与Nextcloud集成

在Nextcloud的config/config.php中添加：

'onlyoffice' => [
    'verify_peer_off' => true,
    'jwt_secret' => 'your_secret_key',
    'jwt_header' => 'AuthorizationJwt'
],

2. 高可用架构

采用主从复制模式：

services:
  onlyoffice-master:
    image: onlyoffice/documentserver
    environment:
      - DOCUMENT_SERVER_CLUSTER_TYPE=master
  onlyoffice-slave:
    image: onlyoffice/documentserver
    environment:
      - DOCUMENT_SERVER_CLUSTER_TYPE=slave
      - DOCUMENT_SERVER_MASTER_ADDR=onlyoffice-master

通过本文的详细指导，开发者可以完成从Docker基础部署到生产级域名访问配置的全流程。实际部署时建议先在测试环境验证配置，再逐步迁移到生产环境。对于企业用户，建议结合CI/CD流程实现自动化部署，并建立完善的监控告警体系。