故障排除

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

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

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

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

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

答：系统要求如下：

• CPU
  双核2 GHz或更高
• 内存
  至少2 GB，但取决于主机操作系统，更多更好
• 硬盘
  至少20 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服务器网站：

   转到开始 -> 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时，本地主机不可用，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. 将路径添加到bin Sphinx目录（例如C:\Program Files\Sphinx-2.2.10\bin）到系统（不是用户）PATH环境变量。

   这是通过以下方式完成的：转到控制面板 -> 系统 -> 高级系统设置 - 在打开的对话框中单击环境变量...按钮，选择PATH变量并单击编辑。在打开的窗口中选择新建，输入新变量的名称（例如sphinx），并使用适当的按钮浏览其路径。然后保存结果。

4. 将OnlyofficeIndex启动类型从禁用更改为自动并运行它。

   转到控制面板 -> 管理工具 -> 服务，找到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为入站请求打开。还要确保正确设置您的DNSMX记录。

问：我想在服务器解决方案的代码中更新一些内容，使其符合我的需求。应该有一个解决方案文件以查看项目的良好安排。我在哪里可以找到该解决方案文件？

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

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

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

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

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

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

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

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

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