跳转到内容
蜻蜓映射

Windows 故障排查

Windows 上的内网穿透客户端有一个常见敌人：安全软件。本页覆盖最高频的几类问题与处理路径。

安装时被安全软件拦截

Section titled “安装时被安全软件拦截”

部分国产安全软件（360 系列、电脑管家等）会把陌生 exe 拦截或静默删除。处理：

  1. 在弹窗里选择「允许本次操作」或「允许程序所有操作」
  2. 如果安装包被直接删除，先临时退出安全软件，安装完成后再启动
  3. 安装完成后，按下面 添加白名单 把蜻蜓映射的安装目录信任，避免后续误杀

客户端显示「离线」

Section titled “客户端显示「离线」”

控制台「客户端」页显示设备「离线」时，按顺序排查：

1. 查看客户端运行状态

Section titled “1. 查看客户端运行状态”
  1. 在系统托盘找到蜻蜓映射图标，右键打开主界面
  2. 点击右上角的调试图标
  3. 在弹出窗口里查看「服务状态」

2. 如果服务状态是 STOP

Section titled “2. 如果服务状态是 STOP”

直接在调试窗口里点「重启客户端」按钮即可。如果重启反复失败，进入下一步。

3. 看启动日志找根因

Section titled “3. 看启动日志找根因”

调试窗口里能直接看到客户端最近一次启动的错误堆栈，常见错误：

错误关键字 含义 处理
access denied / permission 文件被安全软件锁定 添加白名单后重启服务
dial tcp ... i/o timeout 网络异常 检查本机能否访问 api.beesdc.com
token invalid token 失效 控制台「设置 → 重置 token」后重装

4. 找不到安装目录？

Section titled “4. 找不到安装目录？”

在客户端主界面点击头像 → 查看日志，会直接打开安装目录所在的资源管理器窗口，照着路径加白名单即可。

提交映射时报「系统错误，请稍后重试」

Section titled “提交映射时报「系统错误，请稍后重试」”
  1. 启动客户端主界面
  2. 点击右上角调试图标
  3. 在调试窗口查看启动期间是否有报错（多半与上面的离线问题同源）

修复客户端后，回到 Web 控制台重新提交即可。

添加白名单（信任区）

Section titled “添加白名单（信任区）”

把蜻蜓映射安装目录加入安全软件白名单，能一劳永逸地避免「文件被锁定」「客户端突然消失」「服务自动停止」等问题。

下面给出 5 种主流安全软件的步骤。

Windows 安全中心（Windows 10 / 11 自带）

Section titled “Windows 安全中心（Windows 10 / 11 自带）”
  1. 开始菜单搜索「Windows 安全中心」并打开
  2. 左侧选择「病毒和威胁防护」
  3. 在「病毒和威胁防护设置」下点「管理设置」
  4. 滚到底部，点「添加或删除排除项」
  5. 点「添加排除项」→「文件夹」→ 选择蜻蜓映射安装目录 → 确认

360 杀毒

Section titled “360 杀毒”
  1. 右击系统托盘里的 360 杀毒图标 → 设置
  2. 进入「文件白名单」→ 「添加目录」
  3. 选择蜻蜓映射安装目录

360 安全卫士

Section titled “360 安全卫士”
  1. 主界面右上角「安全操作中心」
  2. 「信任区」→ 「添加信任目录」
  3. 选择蜻蜓映射安装目录

腾讯电脑管家

Section titled “腾讯电脑管家”
  1. 右击托盘图标 → 打开管家
  2. 「病毒查杀」→ 「信任区」
  3. 「添加文件夹」→ 选择蜻蜓映射安装目录

火绒安全

Section titled “火绒安全”
  1. 右击托盘里的火绒图标 → 「信任区」
  2. 点「添加文件夹」
  3. 选择蜻蜓映射安装目录

仍未解决？

Section titled “仍未解决？”

把调试窗口里的错误堆栈截图发给客服，并附上：

  • Windows 版本（按 Win + R，输入 winver）
  • 客户端版本（主界面右上角「关于」）
  • 安全软件名称与版本