跳到主要内容

在 CentOS 或 RHEL 上安装 ONLYOFFICE 文档（适用于 arm64）

介绍​

本指南将向您展示如何在适用于 arm64 的 CentOS Stream 9 和 10 以及 RHEL 8、9 和 10 上安装 ONLYOFFICE 文档社区版 Linux 版本 7.1 及更高版本。有关可用功能的完整列表，请参阅 ONLYOFFICE 文档版本概览。如果您使用 ONLYOFFICE Workspace，安装文档后还可以共享文件、管理访问权限、嵌入文档以及编辑已连接云存储中的文件。

系统要求​

  • CPU：64 位 ARM 处理器
  • 内存：至少 2 GB，但取决于主机操作系统。更多更好
  • 硬盘：至少 40 GB 的可用空间
  • 交换分区：至少 4 GB，但取决于主机操作系统。更多更好
  • 操作系统：适用于 arm64 的 CentOS Stream 9 或 10、RHEL 8、RHEL 9 或 RHEL 10
  • 其他要求
    • 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
module_hotfixes=true

安装 NGINX：

sudo yum install nginx

删除以下文件：

sudo rm /etc/nginx/conf.d/default.conf

官方说明

之后，编辑 /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 更改为您的操作系统版本（8 对应 8.x 版本，9 对应 9.x 版本，等等）。

安装 ONLYOFFICE 文档​

添加 ONLYOFFICE 文档仓库​

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

sudo yum install https://download.onlyoffice.com/repo/centos/main/noarch/onlyoffice-repo.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，并保存更改。

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

在浏览器中启动 ONLYOFFICE 文档​

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