跳到主内容

Proxium 部署踩坑实录:我用 host 网络才把多 IP 出网跑通

网上讲自建代理网关的教程,基本都停在「一条 docker run 起服务」。这条命令是真的,但它起的是个空壳:没有能改的管理员密码、没有第二个 IP 可出、也没有 HTTPS。真正花时间的不是装,是装完之后那三件事。

先说项目本身。koldakov/proxium 是自托管的 HTTP / SOCKS5 代理网关,MIT,Python 写的,账号、ACL、限速配额、出网 IP 池和 TLS 证书全放进一个 Web 后台加 REST API,不再靠改配置文件加重载。GitHub API 10 月 31 日查到 4 个 star、3.1 MB,建仓 2026 年 9 月 26 日,五周发了四个版本,最新 v0.3.0(2026-10-28)。4 个 star 不用美化:适合练手和内部小流量,不适合明天替掉生产环境的 Squid。

准备:环境与前置条件

PostgreSQL 支持 17 和 18,镜像自带 17。Redis 支持 7.4 和 8,低于 7.4 代理进程直接起不来——流量配额用的是带过期时间的 hash 字段,老版本没这能力(官方原文:the proxy doesn't start on it)。

标签三个:latest 是最后正式版,0.3.0 钉版本,edge 跟 main 走——官方明说 edge 不能上生产。

走源码要求 Python 3.14 以上加 uv。我本机没有 Docker、Python 3.13.14,两条路都够不上,所以下面全是照 README 与 docs/installation.md 静态核对的,没有实测数据;涉及运行时行为的地方我会注明。

步骤一:起容器,然后立刻处理管理员密码

docker run -d --name proxium -p 80:80 -p 8080:8080 -v proxium:/var/lib/proxium \
  -e SUPERUSER_CREATE=true -e SUPERUSER_EMAIL=admin@example.com -e SUPERUSER_PASSWORD=change-me \
  ikoldakov/proxium

80 是后台,8080 是代理口,卷里是全部状态,删容器不删数据。

第一个坑在这儿。SUPERUSER_CREATE=true 只在首次启动建管理员;之后改 SUPERUSER_PASSWORD 重启,库里的密码不变(官方原话:changing SUPERUSER_PASSWORD doesn't change the stored password)。改密码要进容器跑 proxium-manage changepassword admin@example.com;启动时漏了那个变量则一个管理员都没有,补 createsuperuser。

步骤二:开账号、配策略、算清撤销延迟

后台加一个 Basic 账号,密码只显示一次。拿到先验两条:

curl -x http://username:password@localhost:8080 https://ifconfig.me
curl -x socks5h://username:password@localhost:8080 https://ifconfig.me

都返回出口 IP 就算通。同一个口同时吃 HTTP 和 SOCKS5,靠首字节识别。

策略是它跟 Squid 最大的差别:连接数、上下行限速、按日 / 按月 / 总量配额,能按账号、客户端 IP、目标域名、时段分别设,改完几秒生效,已建立的连接不断。官方举的例子是「工作时段限 1 Mbit/s,GitHub 与 Atlassian 除外」。

第二个坑是撤销。删掉账号后它还能连 10 秒左右,鉴权走缓存,默认 TTL 10 秒可调。对外卖代理或做计费,这个窗口要算进去。

还有一条:明文 HTTP 和 SOCKS5 会把账号密码原样传出去,官方威胁模型里直接写了。客户端不在自己网段内就必须上 TLS。

步骤三:域名、HTTPS,以及多 IP 出网

后台证书四种模式:auto 走 Let's Encrypt(要 80 或 443 对公网可达)、internal 自签(离线环境)、files 挂自己的证书(cert.pem 与 key.pem 必须能被 UID 10001 读到,只给 root 会报「证书无效」)、off 交给前面的负载均衡或 Ingress。

第三件事是多 IP 监听与出网 IP 池。单 IP 单端口 -p 映射就行,端口范围也能映射;但只要涉及「从多个 IP 出去」或「监听多个 IP」,就必须换 host 网络:

docker run -d --name proxium --network host -e PROXY_LISTEN=10.0.0.0/29:10000-10999 \
  -v proxium:/var/lib/proxium ikoldakov/proxium

原因很实在:bridge 网络里容器看不见宿主机的那些 IP。官方对照表写明 -p 只支持端口和端口范围,多监听 IP 与出网 IP 池两项必须 --network host,而且只限 Linux。Docker Desktop 在 macOS / Windows 上跑的是虚拟机,加了也看不到本机 IP,官方建议这种场景别用 Docker,直接源码装。

冲「一个客户一个独立出口 IP」来的话,这是前置条件不是优化项。

结果校验

出口 IP 对不对:curl -x 走两种协议,出来的应该是后台给这个账号指定的出网 IP,不是宿主默认那个。两个不一致,说明出网模式(system / listener / pool)没设对。

内网是不是真挡住了:项目默认拦掉 loopback、私有网段和 169.254.169.254。拿代理去访问 http://169.254.169.254/ 应该被拒;放行了说明有人动过设置,给外部客户用的场景里这是重大风险,云上元数据里可能有临时凭据。

配额有没有落库:流量是按分钟批量写的,刚跑完测试立刻看图可能还是 0,等一两分钟。

用 compose 的话,admin 的健康检查探 unix socket,间隔 2s 重试 60 次,最多等 120 秒;proxy depends_on 的是 service_healthy,第一次 up 会干等一两分钟才起,别急着 Ctrl-C。compose 就四个服务(database / redis / admin / proxy),共 2670 字节。stop_grace_period: 50s,docker stop 记得加 --stop-timeout 40,否则默认 10 秒就掐。

站内 换掉官方 compose 才跑起来的低代码平台复盘 和 memos 从一条 docker 命令到数据落盘 讲的是同一类问题,值得先看。

常见问题

「4 个 star 能上生产吗?」不建议。五周四个版本,API 和数据结构都在动。替内部小团队的出口网关可以,替核心链路再等等。

「和 Squid、3proxy 怎么选?」要「改规则不用登服务器不用 reload」,Proxium 更顺;要「稳定跑五年不动」,Squid 还压着。官方 README 自己承认那三个是「solid engines」。

「Redis 挂了会怎样?」默认容忍 30 秒,客户端无感;超过 30 秒,受连接数和配额约束的新连接被拒,其他照走。Redis 回来是空的,各实例会把自己的连接与未落库流量写回去。

「能当反向代理用吗?」不能。它是正向代理,客户端主动配代理地址;不做入站转发,也不做 TLS 中间人,HTTPS 在它这里就是端到端隧道,只看得见目标域名和端口。

最后一句该说的:自建代理网关属于网络基础设施,部署和使用都要遵守所在地法律法规和你所在网络的管理规定,别拿它做未授权访问或绕过监管。站内 开源论坛系统本地部署 那篇里有张「从外到内先核环境」的排查表,排这类网络类故障时可以照搬。

相关阅读

分享到:

本文链接:https://www.biyeyuanma.cn/post/396.html

服务热线

加我微信

加我微信