ONLYOFFICE Docs 7.x 在 CentOS 8 上的部署策略：单命令脚本与手动部署的深度对比

1. 部署方案概述

ONLYOFFICE Docs 作为一款开源的在线文档协作套件，在企业内部文档处理中扮演着重要角色。针对 CentOS 8 环境，我们主要考察两种部署方式：

• 官方单命令脚本部署 ：通过自动化脚本快速完成环境配置
• 手动分步部署 ：精细化控制每个组件参数

这两种方式在易用性、资源消耗和后期维护等方面存在显著差异。对于运维团队而言，选择哪种方案需要综合考虑团队技术储备、服务器资源状况以及业务需求。

2. 单命令脚本部署详解

2.1 准备工作

在开始部署前，请确保系统满足以下要求：

# 系统要求检查
sudo dnf check-update
sudo dnf install -y curl wget

提示：建议预留至少 4GB 内存和 40GB 磁盘空间以获得最佳性能

2.2 执行一键部署

官方提供的安装脚本会自动处理所有依赖关系：

# 下载并执行安装脚本
curl -O https://download.onlyoffice.com/docs/docs-install.sh
chmod +x docs-install.sh
sudo ./docs-install.sh

安装过程会提示选择部署方式，输入 Y 选择 Docker 方式安装。主要步骤包括：

1. 自动安装 Docker 环境
2. 拉取 ONLYOFFICE 官方镜像
3. 配置网络端口映射
4. 初始化数据卷

2.3 验证安装

部署完成后，通过以下命令验证服务状态：

# 检查容器运行状态
docker ps -a | grep onlyoffice

# 测试服务可用性
curl -I http://localhost

典型输出应包含 HTTP 200 状态码：

HTTP/1.1 200 OK
Server: nginx
Date: [当前日期]
Content-Type: text/html

3. 手动分步部署指南

3.1 基础环境准备

依赖组件安装

# 安装EPEL仓库
sudo dnf install -y epel-release

# 安装基础依赖
sudo dnf install -y nginx postgresql-server redis rabbitmq-server

数据库配置

-- PostgreSQL初始化
sudo postgresql-setup --initdb
sudo systemctl enable --now postgresql

-- 创建数据库用户
sudo -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"
sudo -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"

3.2 ONLYOFFICE 核心安装

添加官方仓库

sudo rpm -Uvh https://download.onlyoffice.com/repo/centos/main/noarch/onlyoffice-repo.noarch.rpm

安装文档服务

sudo dnf install -y onlyoffice-documentserver

服务配置

# 启动服务
sudo systemctl enable --now nginx
sudo systemctl enable --now supervisord

4. 两种方案对比分析

4.1 效率对比

指标	单命令脚本	手动部署
部署时间	5-10分钟	30-60分钟
命令复杂度	1条命令	11+步骤
首次启动时间	2分钟	5分钟

4.2 资源占用对比

测试环境：CentOS 8.4，4核CPU，8GB内存

# 资源监控命令示例
docker stats  # 对于容器部署
top           # 对于传统部署

典型资源消耗：

• 内存占用 ：

  • 单命令部署：约1.2GB
  • 手动部署：约1.5GB

• CPU使用率 ：

  • 空闲状态下两者差异不大（3-5%）
  • 高负载时手动部署表现更稳定

4.3 维护性对比

• 升级难度 ：

  • 单命令： docker pull onlyoffice/documentserver:latest
  • 手动：需要逐个组件检查兼容性

• 配置灵活性 ：

  • 手动部署支持更细粒度的参数调整
  • 单命令部署需通过环境变量修改配置

5. 常见问题解决方案

5.1 端口冲突处理

当80端口被占用时，修改映射端口：

# 对于Docker部署
docker run -i -t -d -p 8080:80 onlyoffice/documentserver

# 对于传统部署
vim /etc/onlyoffice/documentserver/nginx/ds.conf

5.2 字体缺失问题

安装微软核心字体：

sudo rpm -i https://deac-ams.dl.sourceforge.net/project/mscorefonts2/rpms/msttcore-fonts-installer-2.6-1.noarch.rpm

5.3 JWT密钥配置

增强API安全性：

# 编辑配置文件
vim /etc/onlyoffice/documentserver/local.json

# 添加JWT配置
{
  "services": {
    "CoAuthoring": {
      "token": {
        "enable": {
          "request": {
            "inbox": true,
            "outbox": true
          },
          "browser": true
        },
        "inbox": {
          "header": "Authorization"
        },
        "outbox": {
          "header": "Authorization"
        }
      },
      "secret": {
        "inbox": "your-secret-key",
        "outbox": "your-secret-key",
        "browser": "your-secret-key"
      }
    }
  }
}

6. 性能优化建议

6.1 容器部署优化

# 限制容器资源
docker run -i -t -d -p 80:80 \
  --memory 2g --memory-swap 2g \
  --cpus 2 \
  onlyoffice/documentserver

6.2 传统部署优化

调整Nginx配置：

# /etc/nginx/nginx.conf
worker_processes auto;
worker_rlimit_nofile 65535;

events {
  worker_connections 4096;
  multi_accept on;
}

http {
  # 启用gzip压缩
  gzip on;
  gzip_types text/plain text/css application/json application/javascript text/xml;
}

7. 安全加固措施

7.1 防火墙配置

# 开放必要端口
sudo firewall-cmd --permanent --add-port=80/tcp
sudo firewall-cmd --permanent --add-port=443/tcp
sudo firewall-cmd --reload

7.2 SELinux策略

# 临时禁用（不推荐生产环境）
setenforce 0

# 或设置合适的安全上下文
semanage port -a -t http_port_t -p tcp 8080

8. 监控与日志管理

8.1 关键日志位置

组件	日志路径
Nginx	/var/log/nginx/error_log
PostgreSQL	/var/lib/pgsql/data/pg_log
ONLYOFFICE	/var/log/onlyoffice/documentserver

8.2 健康检查端点

curl http://localhost/healthcheck

正常应返回：

{"error":0}