本文由AI翻译

故障排除

常见问题

问:我想在本地服务器上安装基于 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 <piblic_ip>
不要忘记将public_iplocal_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 分钟)。

在您自己的服务器上托管 ONLYOFFICE 工作区

文章: 标签:
浏览所有标签