如何在 Ubuntu 24.04 上安装 ONLYOFFICE 文档
在此页面上
- 先决条件
- 安装 PostgreSQL 和 RabbitMQ
- 创建 PostgreSQL 数据库和用户
- 安装 ONLYOFFICE 文档服务器
- 设置 UFW（简单防火墙）
- 使用 HTTPS 保护 ONLYOFFICE 文档服务器
- 验证 ONLYOFFICE 文档服务器安装
- 结论
ONLYOFFICE Docs 或 Document Server 是一个可以安装在本地服务器上的在线办公套件。它支持 ONLYOFFICE 协作平台和流行系统，例如 Nextcloud、OwnCloud、WordPress、Drupal、Odoo、SuiteCRM 等。 ONLYOFFICE 文档服务器可用作文档编辑器、电子表格编辑器、演示文稿编辑器和协作编辑器。它支持所有流行的格式：DOC、DOCX、TXT、ODT、RTF、ODP、EPUB、ODS、XLS、XLSX、CSV、PPTX 和 HTML。
本指南向您展示如何在 Ubuntu 24.04 服务器上部署 ONLYOFFICE 文档服务器，并使用 PostgreSQL 作为数据库，Nginx 作为反向代理。您还可以通过 Certbot 和 Letsencrypt 使用 HTTPS 保护 ONLYOFFICE 文档。
先决条件
在开始之前，请确保您具备以下条件：
- Ubuntu 24.04 服务器
- 具有管理员权限的非 root 用户
- 域名指向服务器IP地址
安装 PostgreSQL 和 RabbitMQ
ONLYOFFICE 文档服务器需要在您的 Ubuntu 服务器上安装 PostgreSQL 和 RabbitMQ。现在您将通过官方 Ubuntu 存储库安装 PostgreSQL 和 RabbitMQ 服务器。
首先，运行以下命令来更新包索引。
sudo apt update
现在，使用以下命令通过官方 Ubuntu 存储库安装 PostgreSQL 和 RabbitMQ 服务器。输入“Y”确认安装。
sudo apt install postgresql rabbitmq-server
安装完成后，使用下面的“systemctl”命令检查 PostgreSQL 服务器。
sudo systemctl is-enabled postgresql
sudo systemctl status postgresql您可以在下面看到状态为活动和已退出的 PostgreSQL。
最后，使用以下命令检查 RabbitMQ 服务器。
sudo systemctl is-enabled rabbitmq-server
sudo systemctl status rabbitmq-server如下所示，RabbitMQ 服务器也在运行。
创建 PostgreSQL 数据库和用户
PostgreSQL 和 Rabbit 启动并运行后，您将创建 ONLYOFFICE Docs 将使用的新 PostgreSQL 数据库和用户。在此示例中，您将使用命令行创建 PostgreSQL 数据库和用户。
运行以下命令创建一个新的 PostgreSQL 用户“onlyoffice”，密码为“onlyoffice”。
sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"现在创建一个新数据库“onlyoffice”，默认所有者为“onlyoffice”，内容如下：
sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"
最后，使用以下命令检查 PostgreSQL 服务器中的用户和数据库列表。
sudo -i -u postgres psql -c "\du"
sudo -i -u postgres psql -c "\l"您可以在下面看到用户“onlyoffice”和数据库“onlyoffice”可用。
安装 ONLYOFFICE 文档服务器
现在 PostgreSQL 数据库和 RabbitMQ 服务器已准备就绪，您可以开始安装 ONLYOFFICE 文档服务器。在这里，您将添加 ONLYOFFICE GPG 密钥和存储库，然后通过 APT 包管理器安装文档服务器。
使用以下命令将 ONLYOFFICE 的 GPG 密钥下载到您的 Ubuntu 系统：
curl -fsSL https://download.onlyoffice.com/GPG-KEY-ONLYOFFICE | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/onlyoffice.gpg现在运行以下命令为 Debian/Ubuntu 系统添加 ONLYOFFICE 存储库。
echo "deb [signed-by=/etc/apt/trusted.gpg.d/onlyoffice.gpg] https://download.onlyoffice.com/repo/debian squeeze main" | sudo tee /etc/apt/sources.list.d/onlyoffice.list
接下来，更新并刷新您的 Ubuntu 软件包索引，然后使用以下命令安装“onlyoffice-documentserver”软件包。默认情况下，ONLYOFFICE 也会安装 Nginx Web 服务器，它将用作反向代理。
sudo apt update && sudo apt install onlyoffice-documentserver输入“Y”继续安装。
输入数据库 postgreSQL 密码“onlyoffice”。
选择确定接受 TTF mscorefont 许可证。
选择是接受 EULA 许可条款。
安装完成后，ONLYOFFICE文档服务器将与Nginx Web服务器一起在默认HTTP端口80上运行。
使用以下命令检查 Nginx Web 服务器状态。
sudo systemctl is-enabled nginx
sudo systemctl status nginx您将看到 Nginx Web 服务器正在运行。
设置 UFW（简单防火墙）
在本部分中，您将启用 UFW（简单防火墙）并打开 SSH、HTTP 和 HTTPS 协议的端口。
在启用 UFW 之前，请运行以下命令来添加“OpenSSH”和“Nginx Full”的配置文件。这将为 Nginx Web 服务器的 SSH、HTTP 和 HTTPS 打开端口 22。
sudo ufw allow OpenSSH
sudo ufw allow 'Nginx Full'现在运行以下命令以启用 UFW。输入“y”继续，您将得到输出防火墙已激活并在系统启动时启用。
sudo ufw enable最后，使用以下命令检查 UFW 状态。
sudo ufw status您可以在下面看到 UFW 的状态为活动，并且“OpenSSH”和“Nginx Full”配置文件已启用。
使用 HTTPS 保护 ONLYOFFICE 文档服务器
配置 UFW 后，让我们通过 Certbot 和 Letsencrypt 使用 HTTPS 保护 ONLYOFFICE 文档服务器。确保您的域名已准备好并指向您的 Ubuntu 服务器 IP 地址。如果您在本地安装 ONLYOFFICE 文档服务器，则可以使用自签名证书。
首先，运行下面的“systemctl”命令来停止 Nginx Web 服务器。
sudo systemctl stop nginx现在使用下面的“apt”命令安装 Certbot。 Certbot 将用于从 Letscrypt 生成免费的 SSL/TLS 证书。
sudo apt install certbot -y安装完成后，运行下面的“certbot”命令为您的 ONLYOFFICE Document Server 安装生成新的 SSL 证书。请务必使用您的信息更改域名和电子邮件地址。
sudo certbot certonly --standalone -m [email --agree-tos --no-eff-email -d office.howtoforge.local该过程完成后，您的证书将在“/etc/letsencrypt/live/domain.com”目录中可用。 “fullchain.pem”是公钥，“privkey.pem”是您的私钥。
接下来，将 ONLYOFFICE 的默认 Nginx 模板复制到“/etc/onlyoffice/documentserver/nginx/ds.conf”文件。
sudo cp -f /etc/onlyoffice/documentserver/nginx/ds-ssl.conf.tmpl /etc/onlyoffice/documentserver/nginx/ds.conf使用以下“nano”编辑器命令编辑“/etc/onlyoffice/documentserver/nginx/ds.conf”。
sudo nano /etc/onlyoffice/documentserver/nginx/ds.conf将“ssl_certificate”更改为“fullchain.pem”证书的路径，将“ssl_certificate_key”更改为“<privkey.pem' 证书。
ssl_certificate /etc/letsencrypt/live/office.howtoforge.local/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/office.howtoforge.local/privkey.pem;完成后，保存文件并退出编辑器。
现在运行以下命令来验证您的 Nginx 语法并确保没有错误。然后，使用“systemctl”命令再次启动 Nginx Web 服务器。
sudo nginx -t
sudo systemctl start nginx如果您具有正确的 Nginx 语法，您将看到诸如“测试成功 - 语法正常”之类的输出。
最后，运行以下脚本以在 ONLYOFFICE 文档服务器上应用 HTTPS。这样，您的 ONLYOFFICE 将在安全的 HTTPS 连接上运行。
sudo bash /usr/bin/documentserver-update-securelink.sh
验证 ONLYOFFICE 文档服务器安装
访问您的域名（例如 https://office.howtoforge.local/）以访问您的 ONLYOFFICE 文档服务器安装。如果成功，您将看到确认信息，例如已安装 ONLYOFFICE Docs Community Edition。
从这里，您可以将 ONLYOFFICE Document Server 集成到您的文件服务器（例如 Nextcloud 和 ownCloud）、CMS（例如 WordPress 和 Drupal）或 CRM（例如 Odoo 和 SuiteCRM）。
结论
恭喜！您已在 Ubuntu 24.04 服务器上完成 ONLYOFFICE 文档服务器的安装。您的 ONLYOFFICE 文档服务器与 PostgreSQL 数据库和 Nginx Web 服务器一起运行。最后，您还通过 Certbot 和 Letsencrypt 使用 HTTPS 保护 ONLYOFFICE。