第一步：基础检查（最常见的原因）
这些是首先应该检查的地方,能解决大部分问题。
（图片来源网络，侵删）
检查网络连接
这是最根本的前提。
- 确认电脑网络： 确保您的电脑已成功连接到互联网，可以尝试打开浏览器访问一个网站（如
www.baidu.com或www.google.com）。 - 确认服务端网络： 如果您在公司或学校等内网环境中，请确认网络策略是否允许访问 inode 服务器的地址和端口，有时防火墙或代理会阻止连接。
检查用户名和密码
输入错误是导致认证失败最常见的原因。
- 核对大小写： 确保用户名和密码中的大小写与您注册或管理员提供的一致，Linux/Unix 系统对大小写敏感。
- 检查特殊字符： 如果您的密码中包含特殊字符（如
!@#$%^&*），请确保输入正确。 - 重置密码： 如果您怀疑密码遗忘或错误，请通过官方渠道（如官网的“忘记密码”功能或联系管理员）重置密码。
检查服务器地址和端口
确保客户端配置的服务器信息和服务器端实际运行的信息完全一致。
- 地址： 是 IP 地址（如
168.1.100）还是域名（如inode.example.com）？请确认其准确性。 - 端口： 默认端口是什么？是
22(SSH) 还是其他自定义端口？请确认端口号无误。 - 来源： 最好从您的系统管理员或 inode 官方文档中获取准确的服务器地址和端口信息。
第二步：客户端与服务端的检查
如果基础检查没有问题,我们需要深入到客户端和服务器端的配置。
（图片来源网络，侵删）
检查客户端日志
这是诊断问题的关键！日志文件会记录连接失败的具体原因。
- 日志位置： 通常在客户端的安装目录下，文件名可能为
inode_client.log,debug.log,trace.log等，您需要查找该目录下的日志文件。 - 查看错误信息： 打开日志文件，寻找以
ERROR,FATAL,FAILED等开头的行，常见的错误信息有：Connection timed out/连接超时：通常是网络不通或防火墙问题。Permission denied (publickey,password)：认证失败，用户名、密码或密钥错误。Network is unreachable：网络不可达，检查本地网络。No route to host：路由问题，防火墙可能阻止了目标端口。Authentication failed：直接提示认证失败。
检查服务器端状态和日志
问题也可能出在服务器端。
- 确认服务运行： 登录到 inode 服务器，检查其服务是否正在运行，如果是通过
systemd管理的服务，可以执行systemctl status inode-server(或类似的服务名) 来查看状态。 - 检查服务器日志： 查看服务器的日志文件，看是否有来自您客户端 IP 的连接尝试记录，以及失败的原因，在 Linux 系统上，系统日志通常位于
/var/log/目录下，如messages,auth.log,secure等。 - 检查服务器防火墙： 服务器上的防火墙（如
iptables,firewalld, 或云服务商的安全组）可能阻止了您的 IP 地址或客户端使用的端口。- 临时关闭测试： 为了快速排查，可以临时关闭服务器防火墙（注意：这有安全风险，测试后请务必重新开启！），然后尝试连接，如果可以连接，则说明是防火墙规则的问题，需要添加正确的入站规则来放行该端口。
检查本地防火墙和杀毒软件
您自己电脑上的安全软件也可能阻止连接。
- Windows Defender 防火墙：
- 打开“控制面板” -> “系统和安全” -> “Windows Defender 防火墙”。
- 点击“允许应用或功能通过 Windows Defender 防火墙”。
- 在列表中找到您的 inode 客户端程序，确保其“专用”和“公用”网络复选框都已勾选，如果找不到，可以点击“允许其他应用”手动添加。
- 第三方杀毒软件/防火墙： 暂时禁用您安装的第三方安全软件（如 360、腾讯电脑管家、诺顿等），然后尝试连接，如果可以连接，说明是该软件拦截了程序的网络访问，您需要在其设置中添加该客户端程序到信任列表或白名单中。
第三步：高级排查
如果以上步骤都无法解决问题,可以尝试更深入的检查。
（图片来源网络，侵删）
使用网络工具诊断
可以使用 ping 和 telnet (或 nc) 命令来定位问题。
-
Ping 测试：
- 打开命令提示符（Windows）或终端（macOS/Linux）。
- 输入
ping [服务器IP地址]，ping 192.168.1.100。 ping不通： 说明网络层（IP层）连接有问题，请检查网络配置、路由器和防火墙。ping通： 说明 IP 层连接正常，问题可能出在传输层（端口）或应用层（认证）。
-
Telnet/Netcat 测试：
- 这个命令可以测试特定端口是否开放。
- 在 Windows 上，可能需要手动启用“Telnet 客户端”。
- 输入
telnet [服务器IP地址] [端口号]，telnet 192.168.1.100 22。 - 如果屏幕黑一下然后出现光标或登录提示： 说明端口是开放的，连接可以建立，问题可能在于客户端的认证或配置。
- 如果提示
Connecting To 192.168.1.100...Could not open connection to the host, on port 22: Connect failed： 说明该端口被防火墙或其他网络设备阻止了。
检查代理设置
如果您处在需要通过代理服务器的网络环境中（如公司内网），客户端可能没有正确配置代理。
- 检查客户端设置： 查看 inode 客户端是否有代理服务器配置选项，并填写正确的代理地址和端口。
- 检查系统代理： 检查操作系统的代理设置（Windows 的“设置”->“网络和 Internet”->“代理”），确保客户端没有被系统代理影响。
总结与行动清单
遇到连接问题时,请按以下清单操作：
- [ ] 确认电脑和服务器网络都正常。
- [ ] 仔细核对用户名和密码（注意大小写）。
- [ ] 确认客户端配置的服务器地址和端口完全正确。
- [ ] 【关键步骤】 找到并阅读客户端的日志文件，找出具体的错误信息。
- [ ] 暂时关闭电脑上的防火墙和杀毒软件，测试连接。
- [ ] 如果可能，联系服务器管理员确认服务状态和防火墙规则。
- [ ] 使用
ping和telnet命令进行网络诊断。 - [ ] 检查是否需要配置代理。
如果所有步骤都尝试过仍然无法解决,建议您：
- 截图或复制粘贴 客户端的错误界面和关键的日志内容。
- 联系 inode 的官方技术支持，并提供这些详细信息，他们能更专业地帮助您定位问题。
