ONLYOFFICE¶

在这篇文章中

• ONLYOFFICE. 主要功能
• 部署功能
• 部署 ONLYOFFICE 后的入门指南
• 访问 Web 界面
• JWT 密钥配置
• 启用测试示例
• 使用 API 订购带有 ONLYOFFICE 的服务器

本文内容： - ONLYOFFICE. 主要功能 - 部署功能 - 部署 ONLYOFFICE 后的入门指南 - 访问 Web 界面 - JWT 密钥配置 - 启用测试示例 - 使用 API 订购带有 ONLYOFFICE 的服务器

ONLYOFFICE. 主要功能¶

• 实时文档编辑： 功能齐全的 DOCX、XLSX、PPTX 编辑器，具备协作编辑功能；
• 兼容 Microsoft Office 格式： 完全支持 MS Office 格式，包括复杂的格式设置；
• 协作编辑： 多用户同时编辑文档并跟踪更改；
• 嵌入式评论和聊天： 直接在编辑器界面内讨论文档的工具；
• 版本控制： 跟踪更改历史，并可恢复到以前的版本；
• 插件和集成： 通过插件扩展功能，并与流行的存储系统集成；
• 安全性： 支持 JWT 令牌以保护 API，并在传输过程中加密数据；
• 开发者 API： 用于与自定义应用程序集成的 REST API；
• 移动支持： 适用于平板电脑和智能手机的自适应界面。

部署功能¶

部署 ONLYOFFICE 后的入门指南¶

在支付订单后，系统将向注册时指定的电子邮件发送服务器就绪通知。通知中将包含 VPS IP 地址以及用于连接的登录名和密码。我们的客户通过 服务器管理面板和 API — Invapi 管理设备。

授权数据可以在服务器控制面板的 Information >> Tags 选项卡或发送的电子邮件中找到：

• 访问 ONLYOFFICE Web 界面面板的链接：位于 webpanel 标签中；
• 管理服务器的登录名 和 密码：在服务器交付时通过电子邮件发送。

访问 Web 界面¶

检查 ONLYOFFICE 功能¶

1. 打开 Web 浏览器并访问 webpanel 标签中的链接；

2. 您应该看到 ONLYOFFICE 欢迎页面：

   

3. 要检查编辑器功能，请使用内置示例（参见“启用测试示例”部分）。

检查服务状态¶

要检查容器状态，请在服务器上运行以下命令：

docker ps

CONTAINER ID   IMAGE                          STATUS        PORTS                    NAMES
527cd331a316   jonasal/nginx-certbot:latest   Up 19 hours                           nginx-nginx-1
e32700b1ac75   onlyoffice/documentserver      Up 19 hours   0.0.0.0:8080->80/tcp    onlyoffice-docs

JWT 密钥配置¶

查看当前 JWT 密钥¶

JWT 密钥用于保护 Document Server API。要查看其当前值：

sudo docker exec e32700b1ac75 /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

JWT 令牌结构¶

ONLYOFFICE 使用三种类型的 JWT 密钥用于不同目的：

• secret.inbox.string - 用于从外部系统到 ONLYOFFICE 的传入请求；
• secret.outbox.string - 用于从 ONLYOFFICE 到外部系统的传出请求；
• secret.session.string - 用于内部会话和组件之间的交互。

更改 JWT 密钥¶

要更改 JWT 密钥，请按照以下步骤操作：

1. 创建配置备份：

   docker exec onlyoffice-docs cp /etc/onlyoffice/documentserver/local.json /etc/onlyoffice/documentserver/local.json.backup
   

2. 登录到 OnlyOffice 容器：

   docker exec -it onlyoffice-docs /bin/bash
   

3. 编辑配置文件：

   nano /etc/onlyoffice/documentserver/local.json
   

4. 找到 services.CoAuthoring.secret 部分并更改值：

   "secret": {
     "inbox": {
       "string": "your_unique_secret_for_incoming_requests"
     },
     "outbox": {
       "string": "your_unique_secret_for_outgoing_requests"
     },
     "session": {
       "string": "your_unique_secret_for_sessions"
     }
   }
   

5. 保存文件并退出编辑器（Ctrl+X，然后 Y，然后 Enter）；
6. 重启容器以应用更改：

   docker restart onlyoffice-docs
   

7. 检查服务是否正确启动：

   docker logs onlyoffice-docs --tail 100
   

启用测试示例¶

ONLYOFFICE 包含用于测试文档编辑器的内置示例。默认情况下，它们是禁用的。

激活示例¶

要启用测试示例，请执行以下命令：

启动示例服务：

sudo docker exec e32700b1ac75 sudo supervisorctl start ds:example

sudo docker exec e32700b1ac75 sudo sed 's,autostart=false,autostart=true,' -i /etc/supervisor/conf.d/ds-example.conf

1. 在浏览器中打开：https://your-domain/welcome/；
2. 您将看到一个包含编辑器示例的页面；
3. 点击任何文档类型进行测试：
   • Document - 用于创建文本文档；
   • Spreadsheet - 用于创建电子表格；
   • Presentation - 用于创建演示文稿；
   • PDF form - 用于处理 PDF 表单。

使用 API 订购带有 ONLYOFFICE 的服务器¶