常见问题与故障排查
连接问题
SSH / SFTP 一直连接超时
排查顺序：
- 先用 Telnet 连通性 测试目标端口是否可达
- 检查手机网络是否有代理 / VPN 设置干扰
- 确认服务器 IP / 端口填写正确、没有改错 SSH 端口
- 服务器安全组是否放行对应端口（云服务器必须手动配置）
- 如果用移动数据，试试 Wi-Fi，排除运营商网络问题
密钥认证失败
- 确认导入的私钥文件与服务器
~/.ssh/authorized_keys中的公钥配对 - 私钥如果有密码短语，在连接配置中填写
- 某些旧版本 Android 可能不支持 ed25519 密钥，RSA 密钥兼容性更好
- 更新应用到最新版
FTP 能连但 SFTP 连不上
FTP 用的是 FTP 服务端（如 vsftpd），SFTP 用的是 SSH 服务端。两者是不同的服务，需要分别确保运行。大多数云服务器 SSH 默认已开启，SFTP 也就能用。但自建 FTP 服务器不一定提供 SFTP。
HTTP 测试问题
HTTP 请求返回乱码
响应体中文乱码通常是服务器返回的编码与客户端解析不一致。查看响应头中的 Content-Type，确认字符集（charset），然后在请求头中添加 Accept-Charset: utf-8 提示服务器返回 UTF-8 编码。
JSON 响应格式化失败
格式化失败一般有两种原因：响应不是 JSON（可能返回了 HTML 错误页面），或 JSON 语法本身有问题。查看响应头的 Content-Type 字段确认返回格式。
终端问题
SSH 终端输入延迟
SSH 终端是实时交互的，输入延迟直接反映手机到服务器的网络延迟。解决方法：
- 切换到延迟更低的网络（Wi-Fi 通常比移动数据好）
- 在应用设置中提高终端刷新间隔，降低实时渲染频率
- 如果延迟持续超过 300ms，只做紧急操作，其他回电脑处理
特殊字符在终端显示异常
某些终端控制字符、Unicode 符号或中文字符在小屏幕上可能渲染错位。推荐：
- 终端中尽量只用英文命令和路径
- 必要时缩小文字大小避免换行
应用本身问题
监控任务在后台停止了
Android 系统会杀掉长时间后台运行的应用。解决方法：
- 把 Web Tools 设为「不受电池优化限制」
- 在系统设置的应用详情页允许「自启动」和「后台活动」
- 把 Web Tools 锁定在最近任务列表中
应用闪退
可能原因：
- 版本过旧：更新到最新版
- 存储不足：清理存储空间
- 与手机系统版本不兼容：Web Tools 需要 Android 8.0+
数据问题
导出的连接配置无法在新手机导入
连接凭证导出文件中的加密密钥与原设备绑定。直接迁移加密文件会导致解密失败。建议：
- 在旧手机导出时使用密码保护
- 在新手机手动重新输入连接配置（推荐做法，最稳妥）
- 如果一定要迁移，导出的文件格式可能随版本变化，注意版本匹配
卸载后连接配置丢失
这是正常行为——卸载应用会清除应用私有目录下的所有数据。解决：
- 卸载前用导出功能备份连接配置
- 安装新版后从备份文件恢复
寻求帮助
- 开发者邮箱：support@blindzone.org
- 应用内反馈入口：设置 → 关于 → 反馈
- RuStore 和 Google Play 的应用评价区也有开发者回复