手把手教你搞定OnlyOffice Docs 7.5.1在CentOS 7的离线安装（含全套RPM包下载与避坑指南）

在企业级IT环境中，网络隔离是常见的安全策略。面对完全无外网的CentOS 7服务器，部署OnlyOffice Docs 7.5.1需要一套完整的离线解决方案。本文将详细拆解从依赖包下载到最终配置的全流程，特别针对离线环境中的典型问题提供实战指南。

1. 环境准备与依赖包获取

在开始安装前，需要准备一个可联网的临时环境用于下载所有必需的RPM包。推荐使用与目标服务器相同版本的CentOS 7系统，确保软件包兼容性。

关键依赖清单：

• Node.js 9.11.2
• Nginx 1.24.0
• PostgreSQL 9.2.24
• RabbitMQ 3.3.5
• Redis 3.2.12

使用以下命令下载基础依赖包到本地目录（如/opt/offline_pkgs）：

mkdir -p /opt/offline_pkgs yum install --downloadonly --downloaddir=/opt/offline_pkgs nodejs-9.11.2 nginx-1.24.0

对于第三方仓库的软件（如EPEL），需要先配置仓库再下载：

yum install epel-release yum install --downloadonly --downloaddir=/opt/offline_pkgs redis jemalloc

注意：实际下载时可能会遇到依赖层级较深的情况，建议使用yumdownloader工具递归下载所有依赖：

yum install yum-utils yumdownloader --resolve --destdir=/opt/offline_pkgs postgresql-server

2. 离线安装核心组件

将准备好的RPM包传输到目标服务器后，按特定顺序安装可避免依赖冲突。以下是经过验证的安装顺序：

2.1 Node.js安装与验证

rpm -ivh nodejs-9.11.2-1nodesource.x86_64.rpm

验证安装：

node --version # 应显示v9.11.2 npm --version # 应显示配套版本

2.2 Nginx定制化配置

安装完成后需调整关键参数：

worker_processes auto; # 根据CPU核心数调整 events { worker_connections 1024; }

2.3 PostgreSQL特殊配置

离线环境下需要手动初始化数据库：

/usr/bin/postgresql-setup initdb systemctl start postgresql

创建OnlyOffice专用账户时，密码策略需要特别注意：

CREATE USER onlyoffice WITH PASSWORD 'StrongPassword123!'; ALTER SYSTEM SET listen_addresses = '*';

3. 解决典型离线安装问题

3.1 依赖缺失问题

当出现类似Error: Package: onlyoffice-documentserver-7.5.1.x86_64 requires libstdc++.so.6(GLIBCXX_3.4.20)的错误时，表明存在隐藏依赖。解决方法：

1. 在开发机上查找提供该库的包：

yum provides "*/libstdc++.so.6"

2. 下载对应的libstdc++版本并传输到目标机

3.2 服务启动失败排查

RabbitMQ启动失败的常见原因及解决方案：

3.3 字体配置优化

离线环境需要额外安装微软核心字体：

rpm -ivh msttcore-fonts-installer-2.6-1.noarch.rpm fc-cache -fv # 刷新字体缓存

4. OnlyOffice Docs最终配置

4.1 JWT安全设置

修改配置文件关闭JWT验证（仅限内网环境）：

sed -i 's/"token": {/"token": {\n "enable": false,/g' /etc/onlyoffice/documentserver/default.json

4.2 防火墙例外配置

如果启用防火墙，需开放必要端口：

firewall-cmd --permanent --add-port=80/tcp firewall-cmd --permanent --add-port=443/tcp firewall-cmd --reload

4.3 性能调优建议

在/etc/onlyoffice/documentserver/production.json中添加：

"services": { "CoAuthoring": { "sql": { "clientSideCache": true } } }

5. 验证与维护

完成安装后，通过以下步骤验证：

1. 访问http://服务器IP/welcome/
2. 测试文档上传、预览和协作编辑功能
3. 检查各服务状态：

systemctl status ds-* nginx postgresql

对于长期维护，建议：

• 定期备份PostgreSQL数据库
• 监控/var/log/onlyoffice/documentserver日志
• 建立本地yum仓库管理更新包