Ngrok可执行文件被Microsoft Defender标记为潜在风险软件的问题求助

一、开发环境下Ngrok的白名单配置步骤 #

1. 恢复被隔离的Ngrok文件 #

• 打开Windows Defender安全中心，进入「病毒和威胁防护」页面
• 点击「保护历史记录」，找到标记为PUA/Ngrok!MTB的ngrok.exe记录
• 选择该记录，点击「允许」，将文件恢复到原目录

2. 添加Ngrok到Defender排除项 #

• 回到「病毒和威胁防护」，点击「病毒和威胁防护设置」下的「管理设置」
• 滚动到「排除项」模块，点击「添加或删除排除项」
• 选择以下任一方式添加排除：
  • 排除单个文件：点击「添加排除项」→「文件」，选中恢复后的ngrok.exe
  • 排除整个文件夹：点击「添加排除项」→「文件夹」，选择存放Ngrok的目录（适合后续更新Ngrok版本时无需重复配置）
• 若为企业开发环境，需联系IT部门通过组策略配置全局排除，避免个人设置被企业安全策略覆盖

二、替代Ngrok的机器人端点隧道工具 #

以下工具均适配Microsoft Bot Framework的本地机器人连接需求：

• LocalTunnel：开源免费，命令行操作简洁，支持自定义子域名，无需注册即可使用
• Cloudflare Tunnel：稳定性高，支持长期隧道配置，适合持续开发测试场景，需关联Cloudflare账号使用
• Serveo：无需安装客户端，通过SSH命令即可快速创建隧道，轻量便捷，适合临时测试
• LoopBack：本地反向代理工具，可自定义端口转发规则，需手动配置与Bot Framework的端口映射

三、额外优化建议 #

• 重新下载官方最新版Ngrok：确保使用的是官方发布的未篡改版本，避免旧版文件被Defender误判
• 调整Defender PUA检测级别：在「病毒和威胁防护设置」中找到「潜在不受欢迎应用程序」，可将检测级别改为「仅发出警告」（仅建议开发环境使用）
• 验证Bot Framework启动命令：确认Ngrok的端口映射命令符合官方文档要求，比如映射本地机器人默认端口ngrok http 3978 --host-header=localhost:3978

内容的提问来源于stack exchange，提问作者Deena T