跳到主要内容

故障排除

常见问题​

问： 我想在本地服务器上安装基于 Docker 的服务器。我该如何操作？

答： 最新的基于 Docker 的在线办公服务器可以在 Docker hub 上获取。请选择您想安装的版本：ONLYOFFICE 文档、ONLYOFFICE 协作空间或 ONLYOFFICE 邮件，并按照相应页面上的说明进行操作。

问： 在创建并进入门户后，我在人员模块中看到一个名为“假用户”的未知用户。在服务列表中还有一些 OnlyofficeHealthCheck 服务。为什么会这样，我需要做些什么吗？

答： 该用户和服务是即将推出的健康检查功能的一部分，该功能将在未来的版本中可用于门户。目前，它尚未启用，因此您可以选择保持现状或禁用 OnlyofficeHealthCheck 服务并将其从服务自动启动列表中移除。

问： 我需要什么系统才能安装服务器解决方案并成功使用它？

答： 系统要求如下：

  • CPU: 双核 2 GHz 或更高
  • 内存: 4 GB 或更多
  • 硬盘: 至少 20 GB 的可用空间
  • 交换分区: 至少 4 GB，但取决于主机操作系统。更多更好
  • 操作系统: amd64 Linux 发行版，内核版本 3.10 或更高
  • 附加要求
    • Docker：任何由 Docker 团队支持的版本

问： 我使用 Docker 服务安装了一个服务器版本，但遇到了一些与 DNS 服务器或自有名称解析相关的问题。可能是什么原因？

答： Docker 默认指定 Google DNS 服务器，服务器在每次进行网络请求时都会尝试联系它们。如果您的 ONLYOFFICE 协作空间、ONLYOFFICE 文档或 ONLYOFFICE 邮件不打算访问互联网，我们建议您将默认的 Docker DNS 地址更改为本地 DNS 服务器的地址。为此，请转到 /etc/default/docker 文件，并将以下行中的 IP 地址更改为您本地网络中 DNS 服务器的 IP 地址：

docker_OPTS="--dns 8.8.8.8"

对于基于 RPM 的操作系统，如 CentOS，配置文件可以位于此处：/etc/docker/daemon.json

问： 文档编辑器打开并显示界面，但文档本身未加载，一直显示加载进度。该怎么办？

答： 原因可能是计算机必须能够使用互联网回环访问来访问自己，即它必须能够从外部访问自己。您可以通过编辑 iptables 来允许它这样做，重定向如下：

iptables -t nat -A PREROUTING -d <public_ip> -j DNAT --to-destination <local_ip>
iptables -t nat -A POSTROUTING -s <local_ip> -j SNAT --to-source <public_ip>

不要忘记将 public_ip 和 local_ip 地址替换为实际的 IP 地址。

问： 我添加了自定义界面主题或更新了编辑器语言文件（修正了一些翻译），但服务器仍显示以前的值而不是正确的值。我如何同时重置所有用户的缓存？

答： 请按照以下步骤重置缓存： 找到 /etc/nginx/includes/ds-docservice.conf 和 /etc/nginx/includes/ds-spellchecker.conf 文件。文件中应该有构建日期和时间值。将这些值更改为其他值（任何值都可以，但主要是必须在所有地方相同），然后重启 NGINX：

sudo service nginx reload

缓存应为所有服务器用户重置。

备注

请注意，对于 Docker 安装，所有操作必须在容器内进行。

HTTPS 问题​

问： 我添加了自签名 SSL 证书，现在在打开 SSO 元数据页面、使用 WebDAV 和其他 node.js 服务时出现错误。该如何解决？

答： 如果您在使用自签名 SSL 证书时遇到获取 SSO 元数据、WebDAV 和其他 node.js 服务的问题，您可以尝试以下选项之一来解决此问题：

选项 1 - 为服务启动添加参数。

  1. 打开 onlyofficeSsoAuth.service 文件（在 CommunityServer 容器内）：

    nano /lib/systemd/system/onlyofficeSsoAuth.service

  2. 在 [Service] 块的末尾添加以下字符串，指定根证书的路径：

    Environment=NODE_EXTRA_CA_CERTS=/etc/rootCA.pem

  3. 重启服务：

    systemctl daemon-reload
    systemctl restart onlyofficeSsoAuth

选项 2 - 使用系统证书包。

  1. 打开 onlyofficeSsoAuth.service 文件（在 CommunityServer 容器内）：

    nano /lib/systemd/system/onlyofficeSsoAuth.service

  2. 在 [Service] 块中找到以下字符串：

    ExecStart=/usr/bin/node /var/www/onlyoffice/Services/ASC.SsoAuth/app.js UNIX.SERVER

    将其替换为以下内容：

    ExecStart=/usr/bin/node --use-openssl-ca /var/www/onlyoffice/Services/ASC.SsoAuth/app.js UNIX.SERVER

  3. 对于 CentOS，还需在 [Service] 块的末尾添加以下字符串，指定证书包的路径：

    Environment=SSL_CERT_FILE=/etc/pki/tls/certs/ca-bundle.trust.crt

  4. 重启服务：

    systemctl daemon-reload
    systemctl restart onlyofficeSsoAuth

Docker 问题​

问： 我在没有使用 docker stop id 命令停止 Docker 容器的情况下重启了服务器，现在我的服务器出现 ERR_TOO_MANY_REDIRECTS 错误。该如何解决？

答： 请编辑 /var/www/onlyoffice/WebStudio/web.appsettings.config 文件，删除最后一行：

<add key="web.warmup.type" value="basic" />

然后使用以下命令重启 monoserve：

sudo service monoserve restart

问： 我使用 Fedora Linux，进程在 Docker 容器内无法启动。有没有解决方法？

答： Fedora 和 RHEL/CentOS 用户应尝试使用 setenforce 0 命令禁用 SELinux。如果这解决了问题，您可以选择保持 SELinux 禁用状态（RedHat 不推荐），或者切换到使用 Ubuntu。

ONLYOFFICE 文档使用问题​

问： 停止 ONLYOFFICE 文档时发生数据丢失。如何防止数据丢失？

答： 由于操作特性，ONLYOFFICE 文档仅在所有编辑用户关闭文档后才会保存文档。为了避免数据丢失，当您需要停止 ONLYOFFICE 文档进行应用程序更新、服务器重启等操作时，必须强制断开 ONLYOFFICE 文档用户。为此，请在安装 ONLYOFFICE 文档的服务器上执行以下脚本：

sudo docker exec <CONTAINER> documentserver-prepare4shutdown.sh
备注

执行脚本可能需要较长时间（最多 5 分钟）。

备注

断开用户可能需要较长时间（最多 5 分钟）。