cellular-proxy

轻量 「走代理 = 走数据流量」（无 frp，512MB 友好）。

语义

流量	出口
不走 本代理	系统默认（通常 WiFi）
走 本代理	一律数据网卡（自动探测并 bind）

★ 一条命令（安装 / 升级通用）

curl -fsSL 'https://gitea.chickliu.fun/Hermes/cellular-proxy/raw/branch/main/install.sh' | sudo bash

机器状态	行为
未安装	全量安装：探测网卡 → 下 sing-box → 启动 → 验证
已安装	增量升级：保留密钥/网卡/账密，更新 UI/scripts，默认不重下二进制

不需要记 --upgrade / --install，同一条命令反复执行即可。

可选覆盖（首次安装常用）：

curl -fsSL 'https://gitea.chickliu.fun/Hermes/cellular-proxy/raw/branch/main/install.sh' | sudo bash -s -- \
  --iface wwan0 \
  --secret '面板密钥' \
  --user proxy \
  --pass '代理密码'

选项	说明
（无参数）	自动：未装→安装，已装→升级
--force-install	已装也强制全量安装
--force-binary	升级时强制重下 sing-box
--ui-only	只更新 9090 面板
--rebind	升级时重新探测数据网卡
--verify	升级后做出口验证（升级默认跳过）
--iface	强制指定数据网卡
--secret	面板密钥（默认随机；升级不改已有）
--user / --pass	代理鉴权
--port / --panel-port	默认 7890 / 9090
--memory	MemoryMax MB，默认 96
--skip-start / --skip-verify	跳过启动或验证

已装后的快捷方式

装过一次后也可用：

sudo cpxy upgrade              # 等同再跑上面那条 curl（增量）
sudo cpxy upgrade --ui-only
sudo cpxy upgrade --force-binary
sudo cpxy upgrade --verify

保留	默认跳过	会更新
settings.conf / PANEL_SECRET / 代理账密	重下 sing-box（已存在则复用）	UI 面板
CELLULAR_IFACE 绑定	重新探测网卡	scripts / cpxy / systemd
端口与 MemoryMax	出口公网验证	重生 config.json 并 restart

常用运维：

cpxy verify
cpxy rebind
cpxy status | logs
cpxy auth --user u --pass p
cpxy auth --show | --clear
cpxy watch status   # WWAN 自动监控
cpxy watch once     # 手动跑一轮检查

重拨 / rep=0x01 自愈

层级	做法
绑定（推荐）	默认 BIND_SOURCE_IP=false：只 bind_interface=wwanX，不 pin 私网源 IP，重拨换地址通常不用 regenerate
监控	cellular-proxy-watch：ip monitor 事件 + 60s 轮询；网卡改名/掉线/仍 pin 了 stale IP 时自动 generate
兜底 timer	每 2 分钟 oneshot 再检查一次
手动	cpxy rebind && cpxy verify

关监控：ENABLE_CELLULAR_WATCH=false 后 cpxy upgrade，或 cpxy watch stop。
若必须 pin 源 IP：BIND_SOURCE_IP=true（依赖 watch 同步，否则会再次 stale）。

• 代理：LAN-IP:7890（HTTP + SOCKS5）
• 面板：http://LAN-IP:9090/ui/（密钥在安装结束输出 / settings.conf）
• UI 可直接配置代理账号密码（管理 API 默认 9091，与面板 secret 相同）

自动探测逻辑（摘要）

按分数选择，优先：

1. 驱动像蜂窝/USB 拨号：qmi_wwan、cdc_mbim、cdc_ether、rndis_host 等
2. 名称含：wwan / wwp / usb / enx / ppp / rmnet / ccmni …
3. 不是 系统默认路由网卡（默认通常是 WiFi）
4. 多默认路由时取次要默认口
5. 回退：任意非默认且有 IPv4 的物理网卡

探测失败会直接报错并提示用 --iface。

手动安装

git clone https://gitea.chickliu.fun/Hermes/cellular-proxy.git
cd cellular-proxy
sudo ./scripts/install.sh   # 同样会自动探测并绑定

资源

• 单进程 sing-box
• 中文静态面板（animal-island-ui 视觉 token，单文件无 React）
• 默认 MemoryMax=96MB

二进制从哪里下？

优先 Gitea Release 预置包（一键安装默认走 Gitea，无需访问 GitHub）：

https://gitea.chickliu.fun/Hermes/cellular-proxy/releases/download/bin-v1.11.7/sing-box-1.11.7-linux-amd64.tar.gz
https://gitea.chickliu.fun/Hermes/cellular-proxy/releases/download/bin-v1.11.7/sing-box-1.11.7-linux-arm64.tar.gz
https://gitea.chickliu.fun/Hermes/cellular-proxy/releases/download/bin-v1.11.7/sing-box-1.11.7-linux-armv7.tar.gz

下载顺序：Gitea 整包 → Gitea 分片合并（兜底） → GitHub 代理(https://git.86482425.xyz) → 直连 GitHub。

代理账号密码

方式	命令 / 入口
UI	http://LAN-IP:9090/ui/ → 面板 secret → 代理账号密码
CLI	sudo cpxy auth --user u --pass p
安装时	--user / --pass

管理 API：POST http://LAN-IP:9091/proxy-auth，Header Authorization: Bearer $PANEL_SECRET。