Files
cellular-proxy/README.md
T
Hermes 8835646d34 feat: cellular-proxy 一键安装 — 走代理一律数据出口
- sing-box 单进程 bind 数据网卡
- mixed HTTP+SOCKS + 中文静态面板
- install.sh 支持 curl | sudo bash
- 512MB 友好 MemoryMax 默认 96MB
2026-07-21 10:56:27 +00:00

2.5 KiB
Raw Blame History

cellular-proxy

轻量 「走代理 = 走数据流量」 方案(无 frp,512MB 友好)。

语义(重要)

流量 出口
不走 本代理 系统默认(通常 WiFi
本代理(HTTP/SOCKS 一律数据网卡(运营商流量)
客户端 → mixed:7890 → sing-box → bind_interface=数据网卡 → 运营商
系统直连 → 仍走 WiFi

一键安装

# 最简(会生成随机面板密钥;装完后请改 CELLULAR_IFACE
curl -fsSL 'https://gitea.chickliu.fun/Hermes/cellular-proxy/raw/branch/main/install.sh' | sudo bash

# 推荐:指定数据网卡 + 面板密钥 + 代理账号
curl -fsSL 'https://gitea.chickliu.fun/Hermes/cellular-proxy/raw/branch/main/install.sh' | sudo bash -s -- \
  --iface wwan0 \
  --secret '你的面板密钥' \
  --user proxy \
  --pass '你的代理密码'

# 本地源码安装(不拉 Gitea
sudo bash install.sh --local /path/to/cellular-proxy --iface wwan0
选项 说明
--iface 数据网卡名
--secret 面板 PANEL_SECRET
--user / --pass 代理鉴权
--port / --panel-port 默认 7890 / 9090
--memory MemoryMax MB,默认 96
--skip-start 只装不启

装完验证:

sudo cpxy verify
# 期望:直连 IP(WiFi) ≠ 代理 IP(数据)
  • 代理:LAN-IP:7890HTTP + SOCKS5
  • 面板:http://LAN-IP:9090/

手动安装

git clone https://gitea.chickliu.fun/Hermes/cellular-proxy.git
cd cellular-proxy
cp config/settings.conf.example config/settings.conf
# 编辑 CELLULAR_IFACE / PANEL_SECRET / PROXY_USER / PROXY_PASS
sudo ./scripts/install.sh

资源占用

  • 单进程 sing-box
  • 中文面板:内置静态 HTML(~20KB)
  • 默认 MemoryMax=96MBLOG_LEVEL=warn

管理

cpxy detect | generate | start | stop | restart | status | verify | logs

改配置后:sudo cpxy generate

配置摘要

config/settings.conf.example

  • CELLULAR_IFACE — 数据网卡
  • PROXY_MIXED_PORT — HTTP+SOCKS 端口
  • PROXY_USER / PROXY_PASS — 代理鉴权
  • PANEL_PORT / PANEL_SECRET — 中文面板
  • ENABLE_DNS — DNS 也从数据出
  • MEMORY_MAX_MB — 内存上限

安全

局域网 0.0.0.0 时请设代理密码 + 面板 secret,防火墙限制来源网段。 REQUIRE_CELLULAR_IFACE=true 避免数据断开时静默走 WiFi。

License

MIT(脚本与配置)。sing-box 遵循上游许可证。