Hoppscotch 插件发不出 REST 请求本地 Agent 中继完整修复指南【免费下载链接】hoppscotchOpen-Source API Development Ecosystem • https://hoppscotch.io • Offline, On-Prem Cloud • Web, Desktop CLI • Open-Source Alternative to Postman, Insomnia项目地址: https://gitcode.com/GitHub_Trending/ho/hoppscotch用 Hoppscotch 浏览器插件发 REST 请求点出去半天没回音多半不是接口的问题而是浏览器把请求拦在了门外。这篇带你用本地 Agent 中继把发不出去的请求跑通。 先看现象REST 请求到底卡在哪先别急着重启。插件请求失败通常长这样请求一直转圈或者直接报 CORS、连接被拒绝。这类失败有个共同点——请求压根没到你的目标接口而是在浏览器这一层就被卡住了。所以排查第一步不是改代码而是确认请求到底发出去没有。为什么浏览器自己发不了浏览器出于安全考虑对跨域请求目标域名和当前页面不同卡得很严这就是 CORS 机制。插件环境限制更多带不了客户端证书、某些自定义请求头会被悄悄改掉、访问 localhost 也有访问控制。说白了浏览器像个看门太严的管家你本来合法的请求它也要盘问一遍盘问不过就拦下。️ Agent 工作原理本地中转站怎么绕开限制Hoppscotch Agent 是在本地跑的一个 HTTP 中继服务监听 9119 端口。它像个架在你电脑和接口之间的中转站浏览器把请求交给 AgentAgent 用本地网络直接去请求目标接口绕开 CORS需要双向 TLS客户端和服务器互相验证证书时它替你出示客户端证书浏览器不让带的自定义请求头走它就能原样发出去访问 localhost、内网地址也能走通支持挂代理路由代理还能带认证账号。部署 Agent 上线三步安装很直接从官方发布页下载最新版 Hoppscotch Agent双击运行安装程序按向导走完。装完它自动启动系统托盘里会冒出一个图标。看到托盘图标说明中转站开门了。配置文件在这几处Windows 是%APPDATA%\io.hoppscotch.agent\macOS 是~/Library/Application Support/io.hoppscotch.agent/Linux 是~/.config/io.hoppscotch.agent/。 建立连接6 位 OTP 验证码怎么填光让 Agent 跑起来不够还得让 Web 端认得它。进 Settings → Interceptors选 Agent 拦截器点注册。Agent 窗口会显示一个 6 位验证码OTP填进 Web 端。填对后界面显示一个掩码的认证密钥哈希连接就建好了。注意 OTP 会过期。输的时候如果已经失效重新发起一次注册就行别硬试。⚡ 进阶能力 9119 端口连不上怎么办按域名覆盖配置。Agent 支持全局默认域名写*加特定域名单独设。每个域名能单独配 SSL/TLS校不校验主机名、校不校验对端证书、上传自定义 CA 或客户端证书代理能填 URL 和认证账号。出问题了查这几处托盘没图标Agent 没跑先拉起来。9119 端口连不上多半防火墙拦了放行它。拦截器切不动、弹窗卡住重启浏览器切换前先停掉 Agent。Safari 连 localhost 有问题它访问控制严换浏览器试试。找不到 OTP 输入框点一下 Agent 窗口聚焦验证码才显示。想深入看实现源码在 packages/hoppscotch-agent/。跑通之后插件发 REST 请求就不再被浏览器卡脖子。核对四项Agent 在托盘跑着、9119 端口没被拦、OTP 注册完成了、证书对着目标域名配好了。齐了请求基本就能顺利出去。【免费下载链接】hoppscotchOpen-Source API Development Ecosystem • https://hoppscotch.io • Offline, On-Prem Cloud • Web, Desktop CLI • Open-Source Alternative to Postman, Insomnia项目地址: https://gitcode.com/GitHub_Trending/ho/hoppscotch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考