在 CentOS 及其衍生版本上安装 ONLYOFFICE 文档

介绍

社区版允许您在本地服务器上安装 ONLYOFFICE 文档，并将在线编辑器与 ONLYOFFICE 协作平台或其他流行系统集成，从而共享文件、管理访问权限、将文档嵌入到网站中，以及编辑存储在与 ONLYOFFICE 连接的 Drive、Box、Dropbox、OneDrive 或 ownCloud 上的文件（请参阅详细功能列表）。本指南将向您展示如何在您的机器上安装 ONLYOFFICE 文档社区版的 Linux 版本。

系统要求

• CPU：双核 2 GHz 或更高
• 内存：至少 2 GB，但取决于主机操作系统。更多更好
• 硬盘：至少 40 GB 的可用空间
• 交换分区：至少 4 GB，但取决于主机操作系统。更多更好
• 操作系统：CentOS Stream 9，RHEL 8，或 RHEL 9
• 其他要求
  • NGINX：版本 1.30 或更高

安装依赖项

安装最新的 NGINX 包版本

要为 RHEL/CentOS 设置 yum 仓库，请创建名为 /etc/yum.repos.d/nginx.repo 的文件，内容如下：

[nginx-stable]
name=nginx stable repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key
[nginx-mainline]
name=nginx mainline repo
baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/
gpgcheck=1
enabled=0
gpgkey=https://nginx.org/keys/nginx_signing.key

官方说明

安装 NGINX：

sudo yum install nginx

之后，编辑 /etc/nginx/nginx.conf NGINX 配置文件，使其如下所示：

user                  nginx;
worker_processes      1;
error_log             /var/log/nginx/error.log warn;
pid                   /var/run/nginx.pid;
events {
  worker_connections  1024;
}
http {
  include             /etc/nginx/mime.types;
  default_type        application/octet-stream;
  log_format          main  '$remote_addr - $remote_user [$time_local] "$request" '
                            '$status $body_bytes_sent "$http_referer" '
                            '"$http_user_agent" "$http_x_forwarded_for"';
  access_log          /var/log/nginx/access.log  main;
  sendfile            on;
  #tcp_nopush         on;
  keepalive_timeout   65;
  #gzip               on;
  include             /etc/nginx/conf.d/*.conf;
}

重要

如果您计划在端口 80 上运行 ONLYOFFICE 文档，请现在禁用 NGINX 默认网站。否则，ONLYOFFICE 文档可能无法正常工作。为此，请运行以下命令：

sudo mv -f /etc/nginx/sites-enabled/default /etc/nginx/sites-available/default.disabled
sudo mv -f /etc/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf.disabled
sudo systemctl is-active --quiet nginx && sudo systemctl reload nginx || sudo systemctl start nginx

根据 NGINX 的安装方式，前两个命令之一可能会提示文件不存在。您可以放心忽略此消息。

安装 EPEL 仓库

sudo yum install epel-release

要在 CentOS 9 上安装 EPEL，请使用以下命令：

sudo yum config-manager --set-enabled crb
sudo yum install epel-release epel-next-release

要在 RHEL 上安装 EPEL，请使用以下命令：

sudo subscription-manager repos --enable codeready-builder-for-rhel-$REV-$(arch)-rpms
sudo yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-$REV.noarch.rpm

手动将 $REV 更改为您的操作系统版本（7 对应 7.x 版本，8 对应 8.x 版本，9 对应 9.x 版本，等等）。

添加 ONLYOFFICE 文档仓库

使用以下命令添加 yum ONLYOFFICE 文档仓库：

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

安装 mscorefonts

安装 cabextract 和 xorg-x11-font-utils 包：

sudo yum install cabextract xorg-x11-font-utils

对于 CentOS 7.8(2003)，还需要 fontconfig：

sudo yum install fontconfig

安装 msttcore 字体包：

sudo rpm -i https://sourceforge.net/projects/mscorefonts2/files/rpms/msttcore-fonts-installer-2.6-1.noarch.rpm

安装 ONLYOFFICE 文档

为社区版执行以下命令：

sudo yum install onlyoffice-documentserver

启动 nginx 服务并启用开机自启动：

sudo service nginx start
sudo systemctl enable nginx

之后，ONLYOFFICE 文档将作为一个进程运行。该软件包将像其他 rpm 包一样更新。

更新 ONLYOFFICE 文档

要更新 ONLYOFFICE 文档，请运行以下命令：

sudo yum update onlyoffice-documentserver

重要

在 RHEL 8 及其衍生版本上，启用 ONLYOFFICE 仓库时运行 yum update 可能会因依赖项错误而失败。

为防止这种情况，请从 ONLYOFFICE 仓库中排除这些包，使其改为从系统 AppStream 仓库获取：

echo "excludepkgs=xorg-x11-server-Xvfb,xorg-x11-server-common" >> /etc/yum.repos.d/onlyoffice.repo

此命令只需运行一次。之后，yum update 将按预期工作。

如果您是通过 OneClick Install 安装的 ONLYOFFICE 文档，则此排除已自动应用。

更改默认的 ONLYOFFICE 文档端口

默认情况下，ONLYOFFICE 文档使用端口 8083 监听传入连接。从版本 4.3 开始，如果您计划使用不同的端口，可以更改 ONLYOFFICE 文档的端口。

备注

如果您打算更改默认端口，请确保它对传入/传出连接是开放的。请参阅 ONLYOFFICE 文档使用的完整端口列表。

为此，您需要通过运行以下命令编辑 DS_PORT 环境变量：

export DS_PORT=<PORT_NUMBER>

请在上述命令中将 <PORT_NUMBER> 替换为端口号。

备注

如果您将端口设置为 80，请确保已按照安装最新的 NGINX 包版本部分所述禁用了 NGINX 默认网站。

警告

如果您想将 ONLYOFFICE 文档协议更改为 HTTPS，请不要将端口更改为 443，而是使用此说明。

之后，您可以继续配置 ONLYOFFICE 文档。

配置 ONLYOFFICE 文档

运行配置脚本

运行 documentserver-configure 脚本：

bash documentserver-configure

添加防火墙例外

sudo firewall-cmd --zone=public --add-port=8083/tcp --permanent
sudo firewall-cmd --reload

禁用 SELinux

备注

自 v.5.0 起已弃用

使用任何文本编辑器打开 /etc/selinux/config 文件，将 SELINUX=enforcing 或 SELINUX=permissive 字符串替换为 SELINUX=disabled，并保存更改。

重新启动服务器以使更改生效。

注意

出于安全原因，从 v8.1 开始，在运行 documentserver-configure 脚本时会在 local.json 中生成新的 WOPI 密钥。如果您使用 WOPI 连接，则需要在更新 ONLYOFFICE 文档后运行该脚本：

documentserver-configure --wopienabled true

在浏览器中启动 ONLYOFFICE 文档

配置完成后，您可以在浏览器地址栏中输入 http://localhost:8083 以打开 ONLYOFFICE 文档欢迎页面，在那里您将找到有关如何启用文档示例或使用提供的 API 将在线编辑器集成到您的 Web 应用程序中的进一步说明。

要将 ONLYOFFICE 文档连接到 ONLYOFFICE Workspace，请参阅此说明。