Dhorde 庚乾

在 Debian ARM64 上安装 ONLYOFFICE 文档开发者版

ONLYOFFICE 帮助中心中文文档 · 庚乾获授权转载 · 同步于 2026 年 11 月 6 日

本页目录

简介

开发者版允许您在本地服务器上安装 ONLYOFFICE 文档,并将在线编辑器与您的 Web 应用集成(请参阅详细功能列表)。本指南将向您展示如何在 64 位 ARM 架构的 Ubuntu 18.04 或 Ubuntu 20.04 上安装 ONLYOFFICE 文档 开发者版 版本 7.1 及更高版本。

系统要求

安装 ONLYOFFICE 文档

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

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

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

当您使用 Ubuntu 18.04 LTS 或 Ubuntu 20.04 LTS 时,这些依赖项会自动安装。

安装依赖项

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

安装和配置 PostgreSQL

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

sudo apt-get install postgresql
备注

如果您想从 PostgreSQL 存储库安装其他 PostgreSQL 版本,请参阅官方 PostgreSQL 文档以获取更多详细信息。

PostgreSQL 安装完成后,创建 PostgreSQL 数据库和用户:

备注

数据库用户必须命名为 onlyoffice。您可以指定任何密码。

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

安装 NGINX

sudo apt-get install nginx
重要

如果您计划在端口 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-de onlyoffice/ds-port select <PORT_NUMBER> | sudo debconf-set-selections

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

备注

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

警告

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

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

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

安装 ONLYOFFICE 文档

添加 GPG 密钥:

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys CB2DE8E5

添加 ONLYOFFICE 文档存储库:

echo "deb 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-de
备注

在安装过程中,您将被要求为 onlyoffice PostgreSQL 用户提供密码。请输入您在配置 PostgreSQL 时指定的 onlyoffice 密码。

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

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

使用 HTTPS 运行 ONLYOFFICE 文档

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

注册您的开发者版

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

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

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

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

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

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

这些选项包括:

原文与配图来自 ONLYOFFICE 帮助中心,著作权归原权利人。本站调整了页面排版和章节链接。查看官方原文

返回Linux 版本目录