在 Debian、Ubuntu 及其衍生版本上安装 ONLYOFFICE 文档

简介

社区版允许您在本地服务器上安装 ONLYOFFICE 文档，并将在线编辑器与 ONLYOFFICE 协作平台或其他流行系统集成（请参阅详细功能列表）。本指南将向您展示如何在您的计算机上安装 ONLYOFFICE 文档 社区版的 Linux 版本。

系统要求

• CPU: 双核 2 GHz 或更高
• RAM: 至少 2 GB，但取决于主机操作系统。更多更好
• HDD: 至少 40 GB 的可用空间
• SWAP: 至少 4 GB，但取决于主机操作系统。更多更好
• 操作系统: 64 位 Debian 12、Ubuntu 18.04 或其他兼容发行版
• 其他要求
  • NGINX: 版本 1.30 或更高

安装 ONLYOFFICE 文档

在基于 Debian 的发行版上安装还需要系统中已安装 NGINX。

这些组件及其依赖项的所有必要安装说明可以在其官方网站上找到。

与 ONLYOFFICE 文档一起安装的其他依赖项包括：

• libcurl3
• libxml2
• fonts-dejavu
• fonts-liberation
• ttf-mscorefonts-installer
• fonts-crosextra-carlito
• fonts-takao-gothic
• fonts-opensymbol

当您使用 Ubuntu 18.04 LTS 或更高版本时，这些依赖项会自动安装。较早的发行版可能需要手动安装。

安装依赖项

ONLYOFFICE 文档使用 NGINX 作为数据库。在 ONLYOFFICE 文档安装过程中，系统仓库中找到的依赖项将通过 apt-get install 命令自动安装。

安装 NGINX

sudo apt-get install nginx

备注

在 Ubuntu 18.04 上，请改为安装 nginx-extras 软件包：sudo apt-get install nginx-extras

重要

如果您计划在端口 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 的安装方式，前两个命令之一可能会提示文件不存在。您可以放心忽略此消息。

更改默认的 ONLYOFFICE 文档端口

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

备注

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

要做到这一点，您需要更改 debconf 系统的默认端口，运行以下命令：

echo onlyoffice-documentserver onlyoffice/ds-port select <PORT_NUMBER> | sudo debconf-set-selections

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

备注

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

警告

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

还有其他选项可以用于 ONLYOFFICE 文档的安装。请阅读本节以获取更多信息。

之后，您可以继续安装 ONLYOFFICE 文档。

安装 ONLYOFFICE 文档指南

添加 GPG 密钥：

mkdir -p -m 700 ~/.gnupg
curl -fsSL https://download.onlyoffice.com/GPG-KEY-ONLYOFFICE | gpg --no-default-keyring --keyring gnupg-ring:/tmp/onlyoffice.gpg --import
chmod 644 /tmp/onlyoffice.gpg
sudo chown root:root /tmp/onlyoffice.gpg
sudo mv /tmp/onlyoffice.gpg /usr/share/keyrings/onlyoffice.gpg

添加 ONLYOFFICE 文档仓库：

echo "deb [signed-by=/usr/share/keyrings/onlyoffice.gpg] https://download.onlyoffice.com/repo/debian squeeze main" | sudo tee /etc/apt/sources.list.d/onlyoffice.list

备注

虽然 APT 包是针对 Debian Squeeze 构建的，但它兼容多个 Debian 衍生版（包括 Ubuntu），这意味着您可以在所有这些发行版中使用相同的仓库。

在 Debian 上安装 ONLYOFFICE 文档时，添加 contrib 组件到 /etc/apt/sources.list。要了解更多信息，您可以参考 Debian 文档。

更新包管理器缓存：

sudo apt-get update

安装 mscorefonts：

sudo apt-get install ttf-mscorefonts-installer

安装 ONLYOFFICE 文档：

sudo apt-get install onlyoffice-documentserver

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

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

使用 HTTPS 运行 ONLYOFFICE 文档

在大多数情况下，通过 HTTPS 协议访问门户比通过默认使用的 HTTP 更安全。您可以轻松使用安全连接运行 ONLYOFFICE 文档。请查看此处了解更多关于如何做到这一点的详细信息。

附加信息：更多 ONLYOFFICE 文档安装选项

安装 ONLYOFFICE 文档允许使用更多 debconf 选项，这在您计划安装到多个服务器或其他情况下可能非常有用。

这些选项包括：

• JWT 选项

  您可以使用 debconf-set-selections 在更新 ONLYOFFICE 文档后禁用覆盖 local.json 文件中的自定义值。

  • 启用 JSON Web Tokens (JWT)：

    echo onlyoffice-documentserver onlyoffice/jwt-enabled boolean true | sudo debconf-set-selections

  • 通过替换 <JWT_SECRET> 为您自己的值来设置 JWT 密钥：

    echo onlyoffice-documentserver onlyoffice/jwt-secret password <JWT_SECRET> | sudo debconf-set-selections