REST 请求发不出去Hoppscotch 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 请求浏览器控制台却刷出一串 CORS 报错自定义请求头被悄悄剥掉连本机跑的服务都连不上——这些都不是你请求写错了而是浏览器的安全策略在拦截。 什么是 Hoppscotch Agent装在本地为什么能解决问题Hoppscotch Agent 是一个跑在本地、跨平台的 HTTP 中继程序它站在浏览器插件和目标 API 中间浏览器组装好请求后不再亲自发给 API而是交给监听在本机 9119 端口的 Agent由 Agent 完成发送并把响应递回来。正因为真正发请求的是本地进程不受浏览器沙箱约束原来会被浏览器挡掉的 CORS 报错、自定义头被过滤、连不上 localhost 的问题就都消失了顺带还能用到浏览器做不到的能力比如客户端证书认证、代理路由和 HTTP Digest 认证。浏览器与 Agent 之间会建立加密通道身份通过一次性的 6 位注册验证码完成校验你的请求不会经过任何第三方服务器。想翻翻实现细节的话可以看看 Agent 源码。 安装 Hoppscotch Agent 并注册验证码到手就跑通注册的前提是本地先有一个跑起来的 Agent 进程所以顺序是先安装再换验证码下载安装获取对应系统的最新 Agent 安装包运行安装程序完成后它会自动启动系统托盘里出现 Hoppscotch 图标。不想安装就用便携版解压后直接运行即可代价是没有开机自启和自动更新。切换拦截器打开 Hoppscotch 网页端进入 Settings → Interceptors把拦截器切到 Agent。发起注册点击注册按钮Agent 窗口会弹出一个 6 位验证码。填入验证码把这串数字填进页面的 OTP 输入框。注意注册验证码有效期有限过期了就回到上一步重新发起。确认成功点确认后Agent 窗口显示一段掩码认证密钥哈希说明当前浏览器实例注册成功。从这一刻起这个实例发出的 REST 请求都经由本地 9119 端口中转。不确定端口是否真的在监听可以在终端敲一条命令验证curl http://localhost:9119/handshake️ 按域名调开关证书、代理与验证控制跑通之后大部分时候用默认设置就够了但一旦碰到内网系统、自签证书或公司代理就得按域名微调。Agent 的设置分为全局默认对应*域和单域覆盖在域名管理弹窗里添加具体域名后只改那个域的开关即可。开关作用什么时候开Verify HostSSL 握手中是否校验主机名自签证书的主机名和 API 域名对不上时Verify Peer是否校验对端证书目标服务的证书不是公共 CA 签发时CA 证书上传自定义 CA 证书参与验证内网环境有自建的证书颁发机构时客户端证书配置双向 TLS 用的客户端证书API 要求 mTLS 双向认证时代理代理地址加账号密码目标 API 必须经公司代理才能访问时两个容易踩的点客户端证书支持.pem证书和私钥分开上传和.pfx/.pkcs12单文件、带密码两种格式代理 URL 要写全协议前缀http://或https://代理认证支持 NTLM 这类常见协议。 Agent 未检测到、注册失败、OTP 过期排错速查表出问题时先对着这张表过一遍绝大多数故障都能在这里对号入座现象可能原因处理办法弹出Agent 未检测到Agent 没在运行看系统托盘里有没有 Hoppscotch 图标拦截器切换被卡住检测弹窗拦截了切换重启浏览器并在更改拦截器设置前先停掉 Agent端口不通防火墙拦了 9119放行 9119 端口后重新验证 handshakeSafari 上注册失败macOS 的 Safari 对 localhost:9119 有访问控制问题换 Chrome 或 Firefox 完成注册提示无法启动注册浏览器安全策略或扩展冲突无痕模式试一次或逐个禁用扩展页面上没有 OTP 输入框Agent 窗口没有聚焦把 Agent 窗口切到前台让 6 位验证码显示出来OTP 过期注册验证码有时效重新发起注册流程证书配置不生效格式不对、过期、私钥与证书不匹配或域名没覆盖到目标确认是 .pem 或 .pfx 格式且未过期核对私钥是否匹配证书检查域名覆盖是否包含目标 API 主机名如果发现配置丢了或想手动翻配置Agent 的文件按平台存放Windows 在%APPDATA%\io.hoppscotch.agent\macOS 在~/Library/Application Support/io.hoppscotch.agent/Linux 在~/.config/io.hoppscotch.agent/。排证书和代理相关的疑难时同平台下的 logs 目录例如 Linux 的~/.local/share/io.hoppscotch.agent/logs/里有更具体的错误记录。发请求前核对这三项系统托盘里有没有 Hoppscotch 图标Agent 在运行Agent 窗口的注册列表里当前实例是否已注册9119 端口有没有被防火墙拦住浏览器能否访问 localhost:9119三项都打钩后请求还是发不出去那多半是目标 API 本身的问题该回头看接口了。【免费下载链接】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），仅供参考 REST 请求发不出去？Hoppscotch Agent 本地中继修复教程
REST 请求发不出去Hoppscotch 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 请求浏览器控制台却刷出一串 CORS 报错自定义请求头被悄悄剥掉连本机跑的服务都连不上——这些都不是你请求写错了而是浏览器的安全策略在拦截。 什么是 Hoppscotch Agent装在本地为什么能解决问题Hoppscotch Agent 是一个跑在本地、跨平台的 HTTP 中继程序它站在浏览器插件和目标 API 中间浏览器组装好请求后不再亲自发给 API而是交给监听在本机 9119 端口的 Agent由 Agent 完成发送并把响应递回来。正因为真正发请求的是本地进程不受浏览器沙箱约束原来会被浏览器挡掉的 CORS 报错、自定义头被过滤、连不上 localhost 的问题就都消失了顺带还能用到浏览器做不到的能力比如客户端证书认证、代理路由和 HTTP Digest 认证。浏览器与 Agent 之间会建立加密通道身份通过一次性的 6 位注册验证码完成校验你的请求不会经过任何第三方服务器。想翻翻实现细节的话可以看看 Agent 源码。 安装 Hoppscotch Agent 并注册验证码到手就跑通注册的前提是本地先有一个跑起来的 Agent 进程所以顺序是先安装再换验证码下载安装获取对应系统的最新 Agent 安装包运行安装程序完成后它会自动启动系统托盘里出现 Hoppscotch 图标。不想安装就用便携版解压后直接运行即可代价是没有开机自启和自动更新。切换拦截器打开 Hoppscotch 网页端进入 Settings → Interceptors把拦截器切到 Agent。发起注册点击注册按钮Agent 窗口会弹出一个 6 位验证码。填入验证码把这串数字填进页面的 OTP 输入框。注意注册验证码有效期有限过期了就回到上一步重新发起。确认成功点确认后Agent 窗口显示一段掩码认证密钥哈希说明当前浏览器实例注册成功。从这一刻起这个实例发出的 REST 请求都经由本地 9119 端口中转。不确定端口是否真的在监听可以在终端敲一条命令验证curl http://localhost:9119/handshake️ 按域名调开关证书、代理与验证控制跑通之后大部分时候用默认设置就够了但一旦碰到内网系统、自签证书或公司代理就得按域名微调。Agent 的设置分为全局默认对应*域和单域覆盖在域名管理弹窗里添加具体域名后只改那个域的开关即可。开关作用什么时候开Verify HostSSL 握手中是否校验主机名自签证书的主机名和 API 域名对不上时Verify Peer是否校验对端证书目标服务的证书不是公共 CA 签发时CA 证书上传自定义 CA 证书参与验证内网环境有自建的证书颁发机构时客户端证书配置双向 TLS 用的客户端证书API 要求 mTLS 双向认证时代理代理地址加账号密码目标 API 必须经公司代理才能访问时两个容易踩的点客户端证书支持.pem证书和私钥分开上传和.pfx/.pkcs12单文件、带密码两种格式代理 URL 要写全协议前缀http://或https://代理认证支持 NTLM 这类常见协议。 Agent 未检测到、注册失败、OTP 过期排错速查表出问题时先对着这张表过一遍绝大多数故障都能在这里对号入座现象可能原因处理办法弹出Agent 未检测到Agent 没在运行看系统托盘里有没有 Hoppscotch 图标拦截器切换被卡住检测弹窗拦截了切换重启浏览器并在更改拦截器设置前先停掉 Agent端口不通防火墙拦了 9119放行 9119 端口后重新验证 handshakeSafari 上注册失败macOS 的 Safari 对 localhost:9119 有访问控制问题换 Chrome 或 Firefox 完成注册提示无法启动注册浏览器安全策略或扩展冲突无痕模式试一次或逐个禁用扩展页面上没有 OTP 输入框Agent 窗口没有聚焦把 Agent 窗口切到前台让 6 位验证码显示出来OTP 过期注册验证码有时效重新发起注册流程证书配置不生效格式不对、过期、私钥与证书不匹配或域名没覆盖到目标确认是 .pem 或 .pfx 格式且未过期核对私钥是否匹配证书检查域名覆盖是否包含目标 API 主机名如果发现配置丢了或想手动翻配置Agent 的文件按平台存放Windows 在%APPDATA%\io.hoppscotch.agent\macOS 在~/Library/Application Support/io.hoppscotch.agent/Linux 在~/.config/io.hoppscotch.agent/。排证书和代理相关的疑难时同平台下的 logs 目录例如 Linux 的~/.local/share/io.hoppscotch.agent/logs/里有更具体的错误记录。发请求前核对这三项系统托盘里有没有 Hoppscotch 图标Agent 在运行Agent 窗口的注册列表里当前实例是否已注册9119 端口有没有被防火墙拦住浏览器能否访问 localhost:9119三项都打钩后请求还是发不出去那多半是目标 API 本身的问题该回头看接口了。【免费下载链接】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），仅供参考