Header Injector Proxy README

Header Injector Proxy README

site icon
2025.04.23 0
TypeScript开发工具HTTP代理开发效率
该VS Code扩展运行一个本地HTTP代理服务器,允许根据路径前缀将请求路由到不同的后端目标URL。对于每个目标,可以配置自动注入自定义头部(如用于授权的API密钥)到传出请求中。
View on GitHub

Overview

基本能力

产品定位

该VS Code扩展是一个本地HTTP代理服务器,主要用于开发过程中对API请求的路由和头部注入。

核心功能

  • 本地HTTP代理:在可配置的本地端口上运行一个简单的HTTP代理服务器。
  • 基于路径的路由:配置多个目标后端,根据最长匹配的pathPrefix将请求路由到相应的目标URL。
  • 头部注入:为每个目标配置API密钥(或任何值)、头部名称和头部值前缀,自动添加到代理到该目标的请求中。
  • 配置UI:通过VS Code活动栏中的专用视图管理代理目标,无需手动编辑settings.json
  • 状态栏指示器:在VS Code状态栏中显示代理服务器的当前状态(开/关,端口)。
  • 自动重启:当相关配置设置更改时,代理自动重启。

适用场景

  • 开发过程中需要将请求路由到不同的后端服务。
  • 需要在请求中自动注入授权头部(如API密钥)的场景。
  • 需要在不修改代码的情况下动态更改请求目标和头部信息的场景。

工具列表

  • Node.js:运行扩展主机和打包工具vsce的必需工具。

常见问题解答

  • 目前仅支持代理HTTP请求,不支持从客户端代理HTTPS请求。
  • 不支持Websocket代理。
  • 路径重写(如转发前剥离pathPrefix)尚未实现。
  • UI中的添加/编辑/删除功能可能尚未实现。

使用教程

使用依赖

安装Node.js:

# 在Ubuntu上安装Node.js
sudo apt update
sudo apt install nodejs

# 验证安装
node --version

安装教程

  1. 在VS Code中搜索并安装Header Injector Proxy扩展。
  2. 打开VS Code设置(Ctrl + ,),搜索headerInjectorProxy进行配置。

调试方式

  1. 启动代理服务器后,可以在VS Code状态栏查看代理状态。
  2. 使用以下命令测试代理是否正常工作:
curl http://localhost:8088/service-alpha

确保请求被正确路由并注入头部信息。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。