如何在 Ubuntu 上安装 ONLYOFFICE 文档 8.0

通过使用社区版，您有能力在您自己的服务器上部署 ONLYOFFICE 文档，从而使在线编辑器与 ​​ONLYOFFICE 协作平台​​​或​​其他热门系统​​进行无缝集成。

ONLYOFFICE 文档是什么

ONLYOFFICE 文档是一个功能强大的文档编辑器，支持处理文本文档、电子表格、演示文稿、可填写表单、PDF 和电子书，可多人在线协作，支持 AI 集成。它具有丰富的插件库，并且支持自行开发上传插件。

ONLYOFFICE 文档开发者版可以无缝地适应您的网络应用，支持多种流行的编程语言和开发框架，包括JavaScript、Python、Java、C# 等。为前端框架也提供现成的组件样本 (Angular, React, Vue 等)。

ONLYOFFICE 文档最新版

最近 ONLYOFFICE 发布了 8.0 版本，最新版本的在线编辑器提供了多种实用性改进：

• 可填写的 PDF 表单
• 改进表单创建和填写
• 单变量求解
• 图表向导
• 显示协作用户头像
• PPT动画主题颜色
• 更新插件界面设计
• 辅助功能：优化的屏幕朗读器
• 支持双向文字

阅读​​这篇文章​​，了解更多关于 ONLYOFFICE 文档 8.0 新功能。

这份指南将为您提供在机器上安装 ONLYOFFICE 文档社区版的 Ubuntu 版本的详细步骤。

在 Ubuntu 上安装ONLYOFFICE 文档 8.0

系统需求

• CPU：双核，主频2 GHz或更高
• 内存RAM：2 GB或更多
• 硬盘HDD：至少40GB空间
• 额外需求：至少4GB交换内存
• 操作系统OS：64位Debian、Ubuntu操作系统或其他内核版本号为3.13版本或更高的Linux发行版。

额外依赖项：

• PostgreSQL：12.9以上
• NGINX：1.3.13以上
• libstdc++6：4.8.4以上
• RabbitMQ

安装 ONLYOFFICE 文档

在Debian以及基于Debian的Linux发行版上面安装，需要​​libstdc++6​​​、​​NGINX​​​以及​​PostgreSQL​​，这些软件的安装指南以及它们的依赖项的安装配置详见这些软件的官方网站。

而随着ONLYOFFICE 文档一起安装到计算机上的还有下面这些依赖项：

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

在Ubuntu 14.04 LTS及以上版本的系统中安装ONLYOFFICE 文档会自动安装这些依赖项，而更老的版本则需要手动安装配置这些软件。

安装依赖项

ONLYOFFICE 文档使用​​NGINX​​​和​​PostgreSQL​​作为数据库，使用apt-get install命令安装ONLYOFFICE 文档的过程中，会自动在操作系统的系统软件仓库repository中寻找并自动安装上这两个工具。

手动安装并配置PostgreSQL

安装Ubuntu系统所匹配的版本的PostgreSQL：

sudo apt-get install postgresql

注意：如果想从PostgreSQL软件源安装其它版本，请参考​​官方PostgreSQL手册指南​​

注意：用户名必须是ONLYOFFICE，密码任意指定。

sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice;"
sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH password 'onlyoffice';"
sudo -i -u postgres psql -c "GRANT ALL privileges ON DATABASE onlyoffice TO onlyoffice;"

安装redis

如果是安装企业版或开发版，则需要安装依赖项redis，而安装社区版则不需要安装redis

sudo apt-get install redis-server

手动安装并配置rabbitmq

sudo apt-get install rabbitmq-server

Ubuntu的14.04 LTS以前版本可能还有其它的依赖项需要安装。

Ubuntu的18.04版本需要安装nginx-extras：

sudo apt-get install nginx-extras

改变ONLYOFFICE 文档默认的端口号

默认的，ONLYOFFICE 文档在80端口号上接听传入的连接请求，从4.3版本开始支持使用者改变这个端口号，比如在服务器上安装部署时为其他服务让出该端口号：

注意：修改端口号请确认在操作系统、防火墙里面放行修改的端口号的入栈出栈，查看ONLYOFFICE使用的端口号的​​完整列表​​

改变端口号需要修改debconf系统的默认端口配置，命令如下：

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

请在上述命令中的​​<PORT_NUMBER>​​写为你指定的端口号

警告

如果想把 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，需要在​​/etc/apt/sources.list​​​配置文件中添加​​contrib​​​，更多细节请参阅​​Debian文档​​

更新升级包管理器缓存：

sudo apt-get update

安装​​mscorefonts​​

sudo apt-get install ttf-mscorefonts-installer

安装ONLYOFFICE 文档

sudo apt-get install onlyoffice-documentserver

如果是安装开发版，则对应的安装命令：

sudo apt-get install onlyoffice-documentserver-de

如果是安装企业版，则对应的安装命令：

sudo apt-get install onlyoffice-documentserver-ee

注意：安装过程中会提问PostgreSQL的ONLYOFFICE用户密码，请输入在上面PostgreSQL安装配置过程中设定的ONLYOFFICE用户密码

然后ONLYOFFICE 文档就会作为一个服务进程运行起来，这个软件包将会像任何其他deb软件包一样自动更新。

现在你可以在本地打开浏览器在地址栏内输入http://localhost打开ONLYOFFICE 文档的欢迎页面，这里就可以看到更进一步的向导，如何启用文档示例、使用​​提供的API​​把在线编辑器集成到你的网页应用中去。

把ONLYOFFICE 文档连接到ONLYOFFICE Groups，请参考这篇​​指南​​

使用https运行ONLYOFFICE 文档

大多数情况下，使用https协议比默认原装的http协议更加安全，ONLYOFFICE 文档可以很方便的改为启用https协议进行连接，​​参考指南在这里​​

企业版、开发版需要执行注册操作

如果你付费购买了企业版或开发版，就会收到注册文件license.lic，将其放置在安装路径下，即可解锁全部功能，使用基于Debian的Linux发行版，该文件应存入：

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

如此即可注册企业版或开发版并开启全部功能

ONLYOFFICE 文档安装中的更多配置选择项

ONLYOFFICE 文档的安装允许使用更多的debconf配置项目，这些配置项目非常有用，比如你计划安装到多个服务器上。

这些配置项目包括：

• PostgreSQL数据库配置项目：

• 设置PostgreSQL数据库主机地址（使用真实安装PostgreSQL服务器的地址来修改替换​​<DB_HOST>​​）：

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

• 设置PostgreSQL数据库用户名（配置了正确的恰当的PostgreSQL数据库权限的真实用户名修改替换​​<DB_USER>​​）：

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

• 设置PostgreSQL数据库用户密码（配置了正确的恰当的PostgreSQL数据库权限的用户的真实密码替换​​<DB_PASSWORD>​​）：

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

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

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

• Redis配置项目

• 如果安装的是企业版或者开发版则需要配置Redis，而安装社区版不需要配置Redis，设置Redis主机地址（使用真实安装Redis的地址来修改替换​​<REDIS_HOST>​​）；

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

• RabbitMQ配置项目

• 设置RabbitMQ 主机地址（使用RabbitMQ的真实地址替换​​<RABBITMQ_HOST>​​）：

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

• 设置RabbitMQ用户名（使用配置了正确恰当的RabbitMQ权限的真实用户名来修改替换​​<RABBITMQ_USER>​​）：

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

• 设置RabbitMQ用户密码（使用配置了正确恰当的RabbitMQ权限的用户的真实密码来修改替换​​<RABBITMQ_PWD>​​）：

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

• JWT配置项目
  可以使用​​​debconf-set-selections​​来关闭掉ONLYOFFICE 文档自动升级后自动重写重置local.json文件中自定义配置参数的特性。

• 启用JSON网络令牌JWT：

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

• 设置一个JWT密钥，用您自己的值替换​​<JWT_SECRET>​​：

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

开始使用

首先，我们来看最终用户使用的文档协同编辑界面：

​ONLYOFFICE 文档在各个平台上保持了高度的一致性，用户界面可以无缝转换，使用户能够轻松切换到其他主流办公软件的操作界面。其他幻灯片编辑器和表格编辑器的界面与此处展示的界面风格完全相似，只是色彩方面略有不同。因此，在此省略了其他界面的展示。

接下来，对于负责维护和升级 ONLYOFFICE 文档服务器端的工作人员来说，日常操作是有迹可循的。例如，如果需要添加额外的字体，只需执行 ONLYOFFICE 文档自带的脚本工具​​documentserver-generate-allfonts.sh​​​。至于 ONLYOFFICE 文档的各种配置、维护和升级的具体操作细节，您可以​​查看官方帮助页面​​获取更多信息。

相关链接

ONLYOFFICE 文档 8.0 新功能介绍：文章 / 视频

了解 ONLYOFFICE 文档开发者版

如何采用WOPI协议将Office整合到自己项目中