故障排除

常见问题

问： 我想将服务器解决方案安装到本地服务器上。我可以在哪里下载最新版本？

答： 最新的服务器解决方案可以在 Github 和 SourceForge 上下载。

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

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

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

答： 系统要求如下：

• CPU：双核 4 GHz 或更高
• 内存：至少 8 GB，但取决于主机操作系统。更多更好
• 硬盘：至少 40 GB 的可用空间
• 操作系统：Microsoft Windows Server 2016 或更高版本

问： 我已经将服务器解决方案安装到我的服务器上，但我不确定我使用的是什么版本。我该如何检查？

答： 您可以通过以下方式检查确切的版本号：

1. 打开 web.studio/web.appsettings.config 文件
2. 查看 <add key="web.install-url" value="http://service.onlyoffice.com/install/email.ashx?v=77" /> 参数，特别是 v= 后面的数字

问： 我安装了社区服务器以及控制面板和文档，然后卸载了文档，现在控制面板无法工作。

答： 您需要重置与文档的连接路径并在 IIS 中重启社区服务器。执行以下步骤：

1. 转到 C:\Program Files (x86)\Ascensio System SIA\CommunityServer\WebStudio\ 文件夹，并使用文本编辑器打开 web.appsettings.config 文件。

   清除以下键的值并保存更改。

   <add key="files.docservice.url.public" value="" />
   <add key="files.docservice.url.internal" value="" />
   <add key="files.docservice.url.portal" value="" />

2. 在门户设置中重置编辑器连接设置：

   转到 http://127.0.0.1/Management.aspx?type=17 页面并点击重置按钮。

3. 在 IIS 中重启 ONLYOFFICE Server 网站：

   转到“开始” > “Windows 管理工具”，运行“Internet 信息服务 (IIS) 管理器”。在 IIS 管理器中，展开“连接”面板上的“网站”部分。右键点击列表中的 ONLYOFFICE Server 网站，然后选择“管理网站” > “重新启动”选项。

安装问题

问： 我需要安装说明。我可以在哪里找到它们？

答： 安装说明可以在我们帮助中心的安装部分找到。

问： 我想在 Windows Server 2012 上安装服务器解决方案。可以吗？

答： 是的，您可以在 Windows Server 2012 上安装服务器解决方案，但您需要对其设置进行一些更改以使服务器解决方案运行：

1. 转到 C:\Windows\System32\inetsrv\config\applicationHost.config
2. 找到 <sectionGroup name="system.webServer"> 部分
3. 将 <section name="handlers" overrideModeDefault="Deny" /> 更改为 <section name="handlers" overrideModeDefault="Allow" />
4. 将 <section name="modules" overrideModeDefault="Deny" /> 更改为 <section name="modules" overrideModeDefault="Allow" />

问： 我使用的是旧的服务器解决方案。我该如何迁移到最新版本？

答： 有关如何将 ONLYOFFICE Workspace 升级到最新版本的详细说明可以在这篇文章中找到。

请在开始迁移过程之前不要忘记备份您的门户数据。

问： 我收到以下错误：“‘/’应用程序中的服务器错误。索引超出范围。必须是非负数且小于集合的大小”。我该如何解决这个问题？

答： 请尝试在 web.appsettings.config 文件中的 core.machinekey 键中添加符号，使其包含 8 个或更多符号。

问： 我收到以下错误：“{SQL_ERROR}: {SQL_STATE: HY000} 指定的键太长；最大键长度为 1000 字节”。我该如何解决这个问题？

答： 我们建议您安装 mysql-essential-5.1.58-win32，或者您需要更改数据库服务器的设置，以便允许使用长键。

问： 我刚刚将服务器解决方案安装到我的计算机上，但找不到其文件夹。您能告诉我在哪里可以找到它们吗？

答： 默认情况下，7.5 之前的版本安装在以下目录中：C:\ProgramData\TeamLab，7.5 版本安装在 C:\Program Files (x86)\TeamLab Server 目录中，7.7 版本安装在 C:\Program Files\Ascensio System SIA\ONLYOFFICE 目录中。

问： 我下载了源代码。但我不知道如何使用 Visual Studio 2010 开始使用它。我做错了什么？

答： 服务器解决方案由多个小项目组成，而不是一个可以使用 Visual Studio 打开的单一项目。这些项目使用以下 .bat 文件编译：redistributable\asc\BuildAndDeploy.bat。我们使用 Visual Studio 2012。

配置问题

问： 当我第一次尝试启动 ONLYOFFICE Workspace 时，localhost 不可用，ONLYOFFICE 网站无法运行并返回 进程无法访问文件，因为它正被另一个进程使用。（HRESULT 异常：0x80070020） 错误。如何解决这个问题？

答： 可以通过两种方式解决此错误：

1. 在 Internet 信息服务（IIS）中将 ONLYOFFICE 网站切换到另一个端口；
2. 或者从 IIS 中的 80 端口删除所有其他网站（如果有的话）。

您还可以尝试禁用正在运行的 Skype。

问： 我想将我的门户从 HTTP 切换到 HTTPS。我该如何做？

答： 将您的证书以 PEM 格式放置在安装服务器解决方案的计算机上。在服务器解决方案的 config.js 文件中使用斜杠（ / ）指定此文件的完整路径。然后重启 OnlyOfficeRouter 服务。

问： 我想更改我的门户的域名。我该如何做？

答： 您可以在设置 - 常规选项卡的 DNS 设置 - 自定义域名字段中，或在 tenants_tenants 表的 mappeddomain 字段中分配域名。

问： 我无法在 ONLYOFFICE Workspace 中使用全文搜索。我该如何设置？

答： 要在 ONLYOFFICE Workspace 中设置全文搜索，您需要执行以下操作：

1. 从官方网站下载 sphinx 版本 2.2.10

2. 将下载的压缩档案文件解压到某个地方，例如 C:\Program Files\Sphinx-2.2.10

3. 将 Sphinx 的 bin 目录路径（例如 C:\Program Files\Sphinx-2.2.10\bin）添加到系统（而非用户）PATH 环境变量中。

   具体方法如下：转到控制面板 > 系统 > 高级系统设置。在打开的对话框中，点击环境变量...，选择 PATH 变量，然后点击编辑。在打开的窗口中选择新建，输入新变量的名称（例如 sphinx），并使用相应的按钮浏览其路径。然后保存结果。

4. 将 OnlyofficeIndex 的启动类型从 disabled 更改为 automatic 并运行它。

   转到控制面板 > 管理工具 > 服务，找到 OnlyofficeIndex 服务，右键点击它，然后选择属性。在打开的对话框中，使用下拉菜单选择自动启动类型，点击确定并启动该服务。

由于许可限制，Windows 不支持自动安装。

问： 电子邮件通知发送出现问题。我收到的消息包含托管服务器解决方案的服务器名称（PC 名称），而不是我添加的自定义 DNS 名称。如何解决？

答： 请在 web.appsettings.config 文件中添加 <add key="web.host" value="<YOUR_DOMAIN>"/> 字符串。

问： 我将域名添加到 web.appsettings.config 文件中。如果我在 80 端口上运行网站，它可以工作。我如何为不同的端口定义？

答： 您可以在 web.appsettings.config 文件中添加以下字符串：<add key="web.host" value="http://<DOMAIN>:<PORT>"/>。

问： 我已经成功配置并测试了 SMTP 设置，但电子邮件通知不起作用。这是为什么？

答： 显然您的网络有问题。请尝试检查它。为此，请转到开始 >> 运行，输入 cmd 命令。然后在打开的黑色窗口中输入 ping notify.onlyoffice.com 或 ping mail.onlyoffice.org 并按 Enter 键。如果之后您的 IP 地址没有显示，则您的网络有问题。

问： Talk 无法工作。我该如何解决这个问题？

答： 确保 OnlyofficeJabber 服务正在运行并已添加到防火墙和杀毒软件例外中。端口 5222 和 5280 必须打开。

问： 邮箱无法连接到邮件模块或未收到连接邮箱的邮件。我该如何解决这个问题？

答： 确保 OnlyofficeMailAggregator 服务正在运行并已添加到防火墙和杀毒软件例外中。此外，请确保以下端口已为外发请求打开：

• SMTP：25，465
• IMAP：143，993
• POP3：110，995

问： 关于门户事件的通知未收到电子邮件地址。我该如何解决这个问题？

答： 确保 OnlyofficeNotify 服务正在运行并已添加到防火墙和杀毒软件例外中。确保端口 25 已为外发请求打开。

问： OnlyofficeAutoreplay 服务无法工作。我该如何解决这个问题？

答： 确保端口 25 已为入站请求打开。还要确保您正确设置了 DNS MX 记录。

问： 我想在服务器解决方案的代码中更新一些内容，使其看起来像我想要的那样。应该有一个解决方案文件来查看一个排列良好的项目。我在哪里可以找到该解决方案文件？

答： 没有解决方案文件，但您可以自己创建并手动添加项目。项目编译顺序可以在这里找到：_ci\projects\build.proj。

使用问题

问： 我需要备份我的门户数据。我该如何做？

答： 您可以通过 MySQL 创建数据库备份。或者，您可以通过从以下目录复制数据来手动创建数据备份：

• Data\Files\
• Data\Mail\
• web.studio\addons\mail\Data
• web.studio\data\
• web.studio\Products\Community\Modules\Blogs\Data\
• web.studio\Products\Community\Modules\Bookmarking\Data\
• web.studio\Products\Community\Modules\Forum\Data\
• web.studio\Products\Community\Modules\News\Data\
• web.studio\Products\Community\Modules\PhotoManager\Data\
• web.studio\Products\Community\Modules\Wiki\Data\
• web.studio\Products\CRM\Data\
• web.studio\Products\Projects\Data\

问： 我尝试从我的 Android 手机访问门户，但失败了。为什么？

答： 服务器解决方案不支持移动访问，因此您无法从 Android 手机和 iOS 设备访问您的门户，如果您使用 SaaS 解决方案则可以。

问： 从 6.0 迁移到 6.5 后，项目模块卡在加载图标上。我该如何解决这个问题？

答： 首先尝试清除您的浏览器缓存——在 6.5 版本中更新了一些 Java 脚本，如果缓存中保存了先前版本的脚本，可能会导致问题。

问： 在使用服务器解决方案时，我遇到了这里未提到的问题。我该怎么办？

答： 欢迎访问我们的开发者论坛以找到您有任何问题的答案。您还可以在 Github 问题部分描述您的问题，社区成员将尝试帮助您。