【工具】Configurable-HTTP-Proxy 使用指南
文章目录
- 基础用法
- 安装与启动
- 关键配置选项
- 路由管理实战
- 通过API管理路由
- 路由查询参数
- 错误处理配置
- 自定义错误页面
- 动态错误处理
- 高级功能应用
- 主机路由模式
- SSL高级配置
- 超时控制
- 生产环境最佳实践
- 安全配置
- 监控与日志
- 常见问题解决
- 代理不启动
- 路由不生效
- SSL证书问题
- 典型应用场景
- JupyterHub集成
- 微服务网关
- 开发环境多项目代理
Configurable-HTTP-Proxy (CHP) 是一个强大的动态 HTTP 代理工具，专为需要灵活路由管理的场景设计。本文将深入介绍其核心用法，帮助您快速掌握这一工具。
基础用法
使用方法示例：CHP 使用示例
安装与启动
安装方法：
# 全局安装
npm install -g configurable-http-proxy# 或从源码安装
git clone https://github.com/jupyterhub/configurable-http-proxy
cd configurable-http-proxy
npm install
基本启动：
configurable-http-proxy --port 8000
此命令启动代理服务器，监听8000端口
关键配置选项
| 选项 | 说明 | 示例 |
|---|---|---|
--default-target | 设置默认目标 | --default-target=http://localhost:8888 |
--ip | 公共接口IP | --ip=0.0.0.0 |
--api-port | 管理API端口 | --api-port=8001 |
--ssl-key/--ssl-cert | SSL配置 | --ssl-key=key.pem --ssl-cert=cert.pem |
--host-routing | 启用主机路由 | --host-routing |
--log-level | 日志级别 | --log-level=debug |
路由管理实战
通过API管理路由
设置认证令牌：
export CONFIGPROXY_AUTH_TOKEN=your_secret_token
路由操作示例：
# 获取所有路由
curl -H "Authorization: token $CONFIGPROXY_AUTH_TOKEN" \
http://localhost:8001/api/routes# 添加新路由
curl -X POST -H "Authorization: token $CONFIGPROXY_AUTH_TOKEN" \
http://localhost:8001/api/routes/user1 \