feat: 一条 curl 自动装/升（未装安装、已装升级）

README.md

@@ -0,0 +1,127 @@
+# cellular-proxy
+
+轻量 **「走代理 = 走数据流量」**（无 frp，512MB 友好）。
+
+## 语义
+
+| 流量 | 出口 |
+|------|------|
+| **不走** 本代理 | 系统默认（通常 WiFi） |
+| **走** 本代理 | **一律数据网卡**（自动探测并 bind） |
+
+## ★ 一条命令（安装 / 升级通用）
+
+```bash
+curl -fsSL 'https://gitea.chickliu.fun/Hermes/cellular-proxy/raw/branch/main/install.sh' | sudo bash
+```
+
+| 机器状态 | 行为 |
+|----------|------|
+| **未安装** | 全量安装：探测网卡 → 下 sing-box → 启动 → 验证 |
+| **已安装** | 增量升级：保留密钥/网卡/账密，更新 UI/scripts，默认不重下二进制 |
+
+不需要记 `--upgrade` / `--install`，**同一条命令反复执行即可**。
+
+可选覆盖（首次安装常用）：
+
+```bash
+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` | 跳过启动或验证 |
+
+## 已装后的快捷方式
+
+装过一次后也可用：
+
+```bash
+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 |
+
+常用运维：
+
+```bash
+cpxy verify
+cpxy rebind
+cpxy status | logs
+cpxy auth --user u --pass p
+cpxy auth --show | --clear
+```
+
+- 代理：`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`。
+
+## 手动安装
+
+```bash
+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）：
+
+```text
+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`。