svenstaro/proxyboi
svenstaro
一个超级简单的反向代理，支持TLS功能，可快速配置监听地址、自定义请求头和响应头，提供详细日志输出，适用于轻量级代理场景。
下载次数: 0状态：社区镜像维护者：svenstaro仓库类型：镜像最近更新：4 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这段话即可：
请先阅读并遵守：https://xuanyuan.cloud/agents.md
未读文档前不要生成 pull 命令或排错方案。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
proxyboi
镜像概述和主要用途
proxyboi 是一个超级简单的反向代理工具，支持TLS功能，旨在提供轻量级、易于配置的代理解决方案。它可以将客户端请求转发至指定的上游服务器，并支持自定义请求头、响应头、连接超时控制及详细日志输出，适用于快速搭建代理服务的场景。
核心功能和特性
- TLS支持：可配置TLS证书和密钥，实现加密代理通信
- 灵活监听：自定义监听地址和端口，默认监听
0.0.0.0:8080 - 日志控制：支持详细 verbose 日志（包含请求/响应数据）和静默模式
- 超时管理：可设置上游服务器连接超时时间（默认5秒，含DNS解析）
- 头信息自定义：支持添加额外请求头（发送至上游）和响应头（返回给客户端）
- 不安全连接选项：允许与上游服务器建立无效TLS证书的连接
使用场景和适用范围
- 本地开发环境中快速代理前端请求至后端服务
- 简单服务的反向代理需求，无需复杂配置
- 需要临时启用TLS加密的代理场景
- 轻量级服务转发，资源占用低
使用方法和配置说明
基本使用
简单代理
监听所有本地接口的8080端口，将请求代理至http://example.com：
bashproxyboi -l 0.0.0.0:8080 http://example.com
启用TLS
指定TLS证书和密钥，实现加密代理：
bashproxyboi -l 0.0.0.0:8080 --cert mycert.pem --key mykey.key http://example.com
详细日志
使用-v参数启用详细日志输出：
bashproxyboi -l 0.0.0.0:8080 http://example.com -v
Docker部署示例
基本Docker运行命令
bashdocker run -p 8080:8080 docker.xuanyuan.run/svenstaro/proxyboi http://example.com
带TLS配置的Docker运行
需将本地证书文件挂载至容器内：
bashdocker run -p 8080:8080 -v $(pwd)/certs:/certs docker.xuanyuan.run/svenstaro/proxyboi \ -l 0.0.0.0:8080 \ --cert /certs/mycert.pem \ --key /certs/mykey.key \ http://example.com
参数说明
位置参数
| 参数 | 说明 | 示例 |
|---|---|---|
<upstream> | 上游服务器地址（必填） | http://localhost:3000 |
标志参数（FLAGS）
| 参数 | 说明 |
|---|---|
-h, --help | 显示帮助信息 |
-k, --insecure | 允许与上游服务器建立无效TLS证书的连接 |
-q, --quiet | 静默模式（不输出任何日志） |
-v, --verbose | 详细日志模式（输出请求/响应数据） |
-V, --version | 显示版本信息 |
选项参数（OPTIONS）
| 参数 | 说明 | 默认值 | 示例 |
|---|---|---|---|
-l, --listen <listen> | 监听地址和端口 | 0.0.0.0:8080 | -l 127.0.0.1:8888 |
--response-header <response-headers>... | 添加额外响应头（返回给客户端） | - | --response-header "X-Proxy: proxyboi" |
--timeout <timeout> | 上游连接超时时间（秒，含DNS解析） | 5 | --timeout 10 |
--cert <tls-cert> | TLS证书文件路径 | - | --cert /path/to/cert.pem |
--key <tls-key> | TLS密钥文件路径 | - | --key /path/to/key.key |
--upstream-header <upstream-headers>... | 添加额外请求头（发送至上游） | - | --upstream-header "X-Forwarded-For: 1.2.3.4" |
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 proxyboi 镜像标签
docker pull docker.xuanyuan.run/svenstaro/proxyboi:<标签>
DockerHub 原生拉取命令
docker pull svenstaro/proxyboi:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"
