3步搞定Hoppscotch浏览器插件REST请求失败【免费下载链接】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 浏览器插件里调试接口点 Send转两秒控制台抛 CORS Error 或 Network Error。请求没毛病是浏览器把它拦了。咱们把 Hoppscotch Agent 接上做本地中继把这个 REST 请求放通。失败现场还原场景大概是这样的你在 Hoppscotch 里填好一个内部 API 的地址点发送。按钮转圈然后控制台抛出CORS error: No Access-Control-Allow-Origin或者干脆是一个 Network Error。换个环境重试结果一样。根因一句话浏览器的同源策略只允许页面访问同源或被明确授权的地址。你从本地浏览器插件发出的请求打向内网 API 或局域网服务全被这道门槛挡在半路请求根本没到目标。核心思路就一个在浏览器和目标 API 之间架一个本地中继叫 Hoppscotch Agent。浏览器只跟 localhost 说话这被浏览器允许Agent 替你收请求、转发给真正的 API、再把结果带回来。CORS、受限的 Header都在它那一侧消化。Agent 接上之后请求链路变成浏览器 → localhostAgent→ 目标 API。Hoppscotch 的请求界面本身不变它到底替你干了什么Agent 干的活很聚焦每条一句话说清CORS 中转浏览器到 localhost 是被允许的Agent 替你转发到真实 APICORS 报错消失自定义 Header 放行浏览器限制你加的头比如 User-Agent它原样发出去双向 TLSmTLS要求双向证书校验的内网 API客户端证书交给它代理路由公司网络要求出站走代理它支持配代理并带认证局域网直连localhost、192.168.x.x 这类内网地址直接打通你不需要改任何业务代码。请求照旧写在 Hoppscotch 里只是把拦截器换一下。从零跑通的三步装等托盘图标出现从官方发布页下载最新 Agent跑安装程序按提示走完安装过程不用做任何配置。成功信号系统托盘里出现 Hoppscotch 图标Windows 在右下角macOS 在右上角。右键这个图标能看到当前注册状态、也能把窗口调出来。不想装用便携版解压后直接运行可执行文件托盘图标一样会出现。连把 OTP 注册走完打开 Hoppscotch Web 端进Settings → Interceptors选中Agent点注册。Agent 窗口会弹出来显示一个 6 位验证码。把这个码填进 Web 端的 OTP 输入框点确认。成功信号Web 端显示注册完成Agent 一侧显示掩码后的认证密钥哈希。之后两边走加密通道通信不用重复注册。按需扩展只有两样东西值得碰域名覆盖配置默认对全部域名生效域名为*可以给特定域名单独加一条代理打开代理开关填地址形如http://proxy.example.com:8080记住一个数字Agent 默认监听9119端口别让它被挡住。验把那个失败的重发一遍切回之前失败的那个请求点 Send。成功信号响应区返回了真实状态码控制台不再刷 CORS 错误。证书和代理按需才配如果你的 API 没有这些需求直接跳过这一节。自定义 CA 证书目标 API 用的是公司内网 CA 时系统默认不信任它握手会失败。到 Agent 的域名配置里选中目标域名在 CA Certificates 处上传证书文件确认 Verify Peer 处于开启状态。客户端证书mTLS有些内网 API 要求客户端也出示证书。在 Client Certificates 弹窗里选格式PEM证书和私钥分两个文件上传PFX单文件带密码就填密码配置按域名保存同一个域名不用配第二遍。代理公司网络要求走代理打开代理开关填 URL 即可例如http://proxy.example.com:8080需要的话再补用户名密码。卡住了先往这几个方向看弹出Agent not detected先确认系统托盘里有没有 Hoppscotch 图标。没有图标就是进程没起来把它启动。图标在、弹窗还在而且切换拦截器被卡住时先停掉 Agent重启浏览器再重新注册一次。9119 端口被防火墙拦表现是 Agent 明明开着握手却始终建不起来。先确认防火墙规则没拦这个端口再看是不是别的程序占了它。还不行就翻 Agent 的日志找绑定失败的记录端口被占时会写得清清楚楚。OTP 过期验证码有寿命。填完提示过期就重新点一次注册Agent 窗口会给出新码。顺便确认 Agent 窗口处于聚焦、可见状态看不到码多半是窗口被挡在后面了。Safari 对 localhost 的特殊处理macOS 上的 Safari 对 localhost:9119 有额外的 CORS 检查注册经常走到一半卡住。换 Chrome 或 Firefox 先把注册走完连接是持久的之后再用 Safari 也不受影响。收尾自查关屏之前过一遍这三条托盘有 Agent 图标Web 端 Interceptors 里 Agent 显示已注册之前失败的那个请求重发能返回真实状态码200 还是 4xx 都行控制台不再出现 CORS重启电脑后 Agent 自动拉起请求依旧走通不需要重新注册想深挖的话配置在这些地方Windows%APPDATA%\io.hoppscotch.agent\macOS~/Library/Application Support/io.hoppscotch.agent/Linux~/.config/io.hoppscotch.agent/延伸阅读Agent 源码就在仓库的packages/hoppscotch-agent/目录下。下次点发送你看到的是转出来的 200而不是红色的 CORS 报错。【免费下载链接】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），仅供参考
3步搞定Hoppscotch浏览器插件REST请求失败【免费下载链接】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 浏览器插件里调试接口点 Send转两秒控制台抛 CORS Error 或 Network Error。请求没毛病是浏览器把它拦了。咱们把 Hoppscotch Agent 接上做本地中继把这个 REST 请求放通。失败现场还原场景大概是这样的你在 Hoppscotch 里填好一个内部 API 的地址点发送。按钮转圈然后控制台抛出CORS error: No Access-Control-Allow-Origin或者干脆是一个 Network Error。换个环境重试结果一样。根因一句话浏览器的同源策略只允许页面访问同源或被明确授权的地址。你从本地浏览器插件发出的请求打向内网 API 或局域网服务全被这道门槛挡在半路请求根本没到目标。核心思路就一个在浏览器和目标 API 之间架一个本地中继叫 Hoppscotch Agent。浏览器只跟 localhost 说话这被浏览器允许Agent 替你收请求、转发给真正的 API、再把结果带回来。CORS、受限的 Header都在它那一侧消化。Agent 接上之后请求链路变成浏览器 → localhostAgent→ 目标 API。Hoppscotch 的请求界面本身不变它到底替你干了什么Agent 干的活很聚焦每条一句话说清CORS 中转浏览器到 localhost 是被允许的Agent 替你转发到真实 APICORS 报错消失自定义 Header 放行浏览器限制你加的头比如 User-Agent它原样发出去双向 TLSmTLS要求双向证书校验的内网 API客户端证书交给它代理路由公司网络要求出站走代理它支持配代理并带认证局域网直连localhost、192.168.x.x 这类内网地址直接打通你不需要改任何业务代码。请求照旧写在 Hoppscotch 里只是把拦截器换一下。从零跑通的三步装等托盘图标出现从官方发布页下载最新 Agent跑安装程序按提示走完安装过程不用做任何配置。成功信号系统托盘里出现 Hoppscotch 图标Windows 在右下角macOS 在右上角。右键这个图标能看到当前注册状态、也能把窗口调出来。不想装用便携版解压后直接运行可执行文件托盘图标一样会出现。连把 OTP 注册走完打开 Hoppscotch Web 端进Settings → Interceptors选中Agent点注册。Agent 窗口会弹出来显示一个 6 位验证码。把这个码填进 Web 端的 OTP 输入框点确认。成功信号Web 端显示注册完成Agent 一侧显示掩码后的认证密钥哈希。之后两边走加密通道通信不用重复注册。按需扩展只有两样东西值得碰域名覆盖配置默认对全部域名生效域名为*可以给特定域名单独加一条代理打开代理开关填地址形如http://proxy.example.com:8080记住一个数字Agent 默认监听9119端口别让它被挡住。验把那个失败的重发一遍切回之前失败的那个请求点 Send。成功信号响应区返回了真实状态码控制台不再刷 CORS 错误。证书和代理按需才配如果你的 API 没有这些需求直接跳过这一节。自定义 CA 证书目标 API 用的是公司内网 CA 时系统默认不信任它握手会失败。到 Agent 的域名配置里选中目标域名在 CA Certificates 处上传证书文件确认 Verify Peer 处于开启状态。客户端证书mTLS有些内网 API 要求客户端也出示证书。在 Client Certificates 弹窗里选格式PEM证书和私钥分两个文件上传PFX单文件带密码就填密码配置按域名保存同一个域名不用配第二遍。代理公司网络要求走代理打开代理开关填 URL 即可例如http://proxy.example.com:8080需要的话再补用户名密码。卡住了先往这几个方向看弹出Agent not detected先确认系统托盘里有没有 Hoppscotch 图标。没有图标就是进程没起来把它启动。图标在、弹窗还在而且切换拦截器被卡住时先停掉 Agent重启浏览器再重新注册一次。9119 端口被防火墙拦表现是 Agent 明明开着握手却始终建不起来。先确认防火墙规则没拦这个端口再看是不是别的程序占了它。还不行就翻 Agent 的日志找绑定失败的记录端口被占时会写得清清楚楚。OTP 过期验证码有寿命。填完提示过期就重新点一次注册Agent 窗口会给出新码。顺便确认 Agent 窗口处于聚焦、可见状态看不到码多半是窗口被挡在后面了。Safari 对 localhost 的特殊处理macOS 上的 Safari 对 localhost:9119 有额外的 CORS 检查注册经常走到一半卡住。换 Chrome 或 Firefox 先把注册走完连接是持久的之后再用 Safari 也不受影响。收尾自查关屏之前过一遍这三条托盘有 Agent 图标Web 端 Interceptors 里 Agent 显示已注册之前失败的那个请求重发能返回真实状态码200 还是 4xx 都行控制台不再出现 CORS重启电脑后 Agent 自动拉起请求依旧走通不需要重新注册想深挖的话配置在这些地方Windows%APPDATA%\io.hoppscotch.agent\macOS~/Library/Application Support/io.hoppscotch.agent/Linux~/.config/io.hoppscotch.agent/延伸阅读Agent 源码就在仓库的packages/hoppscotch-agent/目录下。下次点发送你看到的是转出来的 200而不是红色的 CORS 报错。【免费下载链接】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），仅供参考
![[光学原理与应用-521]：对光的错误理解与纠偏](http://pic.xiahunao.cn/yaotu/[光学原理与应用-521]：对光的错误理解与纠偏)
