如何在 Ubuntu 上将 ONLYOFFICE Docs 与 Redmine 集成

发表 admin at 2025年2月28日

类别

未分类

标签

在此页

第 1 步：安装 ONLYOFFICE 文档
第 2 步：安装集成应用
第 3 步：配置集成应用
第 4 步：在 Redmine 中使用 ONLYOFFICE Docs

ONLYOFFICE Docs 是在 GNU AGPL v3.0 下分发的开源办公套件。它包括基于 Web 的查看器和协作编辑器，用于与 OOXML 格式高度兼容的文本文档、电子表格和演示文稿。

ONLYOFFICE Docs可以与Nextcloud、ownCloud、Seafile、Alfresco、Plone等各种云服务集成，也可以嵌入到您自己的解决方案中。这些编辑器也可以用作完整生产力解决方案 ONLYOFFICE Workspace 的一部分。

Redmine 是一个免费的开源项目管理和问题跟踪工具，包括每个项目的维基和论坛、时间跟踪和灵活的基于角色的访问控制。借助集成的 ONLYOFFICE Docs，您可以直接从 Redmine 编辑和共同创作办公文档。

在本教程中，我们将学习如何使用集成应用程序连接 ONLYOFFICE Docs 和 Redmine 实例。

请注意，ONLYOFFICE 与 Redmine v.4.0.0 或更高版本兼容。

第 1 步：安装 ONLYOFFICE 文档

为了能够在 Redmine 中编辑文档，您需要一个 ONLYOFFICE Docs（文档服务器）实例，它可以从 Redmine 和任何终端客户端解析和连接。 ONLYOFFICE Docs 还必须能够直接发布到 Redmine。
安装最新版本的套件及其所有依赖项的最简单方法是使用 Docker 运行以下命令：

sudo docker run -i -t -d -p 80:80 --restart=always onlyoffice/documentserver

您可以在 HowtoForge 教程中找到详细说明。

第 2 步：安装集成应用程序

下载适用于 Redmine 的 ONLYOFFICE 连接器。从 GitHub 克隆 master 分支：

git clone https://github.com/ONLYOFFICE/onlyoffice-redmine

或下载并解压缩最新的存档版本：

wget https://github.com/ONLYOFFICE/onlyoffice-redmine/archive/refs/tags/v1.0.0.tar.gz

tar -xvzf v1.0.0.tar.gz

您还可以从 Redmine 插件目录获取该应用程序。

插件子目录必须命名为 onlyoffice_redmine。将克隆的 onlyoffice-redmine 或解压缩的 onlyoffice_redmine-x.y.z 文件夹重命名为 onlyoffice_redmine。

mv onlyoffice-redmine onlyoffice_redmine
mv onlyoffice-redmine-1.0.0 onlyoffice_redmine

然后，确保 Redmine 实例已停止并将 onlyoffice_redmine 插件目录放入 redmine/plugins 文件夹中。

转到 Redmine 根目录并安装依赖项：

cd redmine
bundle install
Initialize/update the database:
RAILS_ENV=production bundle exec rake db:migrate
RAILS_ENV=production bundle exec rake redmine:plugins:migrate NAME=onlyoffice_redmine

完成后，重新启动 Redmine 实例。

第 3 步：配置集成应用程序

安装连接器后，通过 Redmine 界面对其进行配置。转到管理 -> 插件 -> ONLYOFFICE Redmine 插件 -> 配置。指定以下设置：

已安装的 ONLYOFFICE 文档服务器的 URL 和端口。
启用 JWT 的密钥，保护您的文档免遭未经授权的访问。您还需要在 ONLYOFFICE 文档服务器配置文件中指定相同的密钥以启用验证。
编辑器自定义设置（如有必要）。

第 4 步：在 Redmine 中使用 ONLYOFFICE Docs

您可以查看、编辑和协作处理上传到 Redmine 中的问题、文件、文档、Wiki 或新闻模块的文本文档、电子表格和演示文稿。对于每个模块，查看或编辑文件的访问权限取决于用户角色权限。

目前，您可以编辑和协作处理 DOCX、XLSX 和 PPTX 文件。

其他可供查看的格式：DOC、DOCX、DOCM、DOT、DOTX、DOTM、ODT、FODT、OTT、RTF、TXT、HTML、HTM、MHT、XML、PDF、DJVU、FB2、EPUB、XPS、XLS、XLSX , XLSM, XLT, XLTX, XLTM, ODS, FODS, OTS, CSV, PPS, PPSX, PPSM, PPT, PPTX, PPTM, POT, POTX, POTM, ODP, FODP, OTP。
至于协作功能，以下是可用的：实时和段落锁定共同编辑模式、跟踪更改、评论和内置聊天。
仅此而已！您现在可以使用 ONLYOFFICE Docs 直接在您的 Redmine 中编辑和共同创作办公文档。