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

简介

开发者版允许您在本地服务器上安装ONLYOFFICE 文档，并将在线编辑器与您的 Web 应用集成。

ONLYOFFICE 文档是一套在线办公软件，包括文本、电子表格和演示文稿的查看器和编辑器，完全兼容 Office Open XML 格式：.docx、.xlsx、.pptx，并支持实时协作编辑。

功能

• 文档编辑器
• 电子表格编辑器
• 演示文稿编辑器
• 移动网页查看器
• 移动网页编辑器
• 协作编辑
• 支持象形文字
• 支持所有流行格式：DOC、DOCX、TXT、ODT、RTF、ODP、EPUB、ODS、XLS、XLSX、CSV、PPTX、HTML

查看 ONLYOFFICE 文档 开发者版的详细功能列表。

本指南将向您展示如何在您的机器上安装ONLYOFFICE 文档开发者版的 Linux 版本。

安装 ONLYOFFICE 文档

在基于 Debian 的发行版中安装还需要系统中存在 libstdc++6、NGINX 和 PostgreSQL。

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

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

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

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

安装依赖项

ONLYOFFICE 文档使用 NGINX 和 PostgreSQL 作为数据库。在 ONLYOFFICE 文档 安装时，系统存储库中的依赖项将通过 apt-get install 命令自动安装。

安装和配置 PostgreSQL：

安装您版本的 Ubuntu 中包含的 PostgreSQL 版本：

sudo apt-get install postgresql

PostgreSQL 安装完成后，创建 PostgreSQL 数据库和用户：

sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"
sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"

安装 redis：

sudo apt-get install redis-server

安装 rabbitmq：

sudo apt-get install rabbitmq-server

Ubuntu 18.04 需要安装 nginx-extras。可以使用以下命令完成：

sudo apt-get install nginx-extras

更改默认的 ONLYOFFICE 文档端口

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

为此，您需要更改 debconf 系统的默认端口，运行以下命令：

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

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

还有其他选项可用于 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

在 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-de

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

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

使用 HTTPS 运行 ONLYOFFICE 文档

在大多数情况下，通过 HTTPS 协议访问门户比通过默认使用的 HTTP 更安全。您可以轻松地使用安全连接运行 ONLYOFFICE 文档。请查看 此处以了解如何实现。

注册您的开发者版

如果您购买了 开发者版并收到了 license.lic 文件，您可以将其放置到您的安装中以获得软件的完整版本。

当您是基于 Debian 的 Linux 发行版用户时，license.lic 文件放置在以下文件夹中：

/var/www/onlyoffice/Data/license.lic

之后，您的 开发者版将被注册并具备全部功能。

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

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

这些选项包括：

• PostgreSQL 数据库选项

  • 设置 PostgreSQL 数据库主机地址（用实际安装的 PostgreSQL 服务器地址替换 <DB_HOST>）：

    echo onlyoffice-documentserver-de onlyoffice/db-host string <DB_HOST> | sudo debconf-set-selections

  • 设置 PostgreSQL 数据库用户名（用具有适当 PostgreSQL 数据库权限的用户的实际名称替换 <DB_USER>）：

    echo onlyoffice-documentserver-de onlyoffice/db-user string <DB_USER> | sudo debconf-set-selections

  • 设置 PostgreSQL 数据库用户密码（用具有适当 PostgreSQL 数据库权限的用户的实际密码替换 <DB_PASSWORD>）：

    echo onlyoffice-documentserver-de onlyoffice/db-pwd password <DB_PASSWORD> | debconf-set-selections

  • 设置 PostgreSQL 数据库名称（用实际的 PostgreSQL 数据库名称替换 <DB_NAME>）：

    echo onlyoffice-documentserver-de onlyoffice/db-name string <DB_NAME> | sudo debconf-set-selections

• Redis 选项

  • 设置 Redis 主机地址（用实际安装的 Redis 地址替换 <REDIS_HOST>）：

    echo onlyoffice-documentserver-de onlyoffice/redis-host string <REDIS_HOST> | sudo debconf-set-selections

• RabbitMQ 选项

  • 设置 RabbitMQ 主机地址（用实际安装的 RabbitMQ 地址替换 <RABBITMQ_HOST>）：

    echo onlyoffice-documentserver-de onlyoffice/rabbitmq-host string <RABBITMQ_HOST> | sudo debconf-set-selections

  • 设置 RabbitMQ 用户名（用具有适当 RabbitMQ 权限的用户的实际名称替换 <RABBITMQ_USER>）：

    echo onlyoffice-documentserver-de onlyoffice/rabbitmq-user string <RABBITMQ_USER> | sudo debconf-set-selections

  • 设置 RabbitMQ 用户密码（用具有适当 RabbitMQ 权限的用户的实际密码替换 <RABBITMQ_PWD>）：

    echo onlyoffice-documentserver-de onlyoffice/rabbitmq-pwd password <RABBITMQ_PWD> | sudo debconf-set-selections

• JWT 选项

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

  • 启用 JSON Web Tokens (JWT)：

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

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

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