pac-proxy-cli 0.1.0

package/.env

@@ -0,0 +1,3 @@
+# 远程代理服务器地址（用于登录、PAC 同步等）
+# 面板通过 /api/config 读取此配置，前端不展示该地址
+PROXY_SERVER_URL=http://127.0.0.1:3890

package/README.md

@@ -0,0 +1,103 @@
+# PAC Proxy CLI
+
+本机 HTTP 代理 + Web 管理面板。可搭配本地 SOCKS5 使用，或连接远程代理服务器；支持 PAC 规则、系统代理一键设置与流量查看。
+
+---
+
+## 安装
+
+```bash
+npm install -g pac-proxy-cli
+```
+
+或使用 npx 直接运行（不全局安装）：
+
+```bash
+npx pac-proxy-cli start -s 127.0.0.1:1080
+```
+
+---
+
+## 使用方式
+
+### 方式一：上游为本地 SOCKS5
+
+本机已有 SOCKS5 代理（例如 `ssh -D 1080 user@server`）时，让本工具作为 HTTP 代理并打开管理面板：
+
+```bash
+pac-proxy start -s 127.0.0.1:1080
+```
+
+- HTTP 代理默认：`127.0.0.1:3893`
+- 面板默认：`http://127.0.0.1:3892`（启动后会自动打开浏览器）
+
+### 方式二：上游为远程代理服务器
+
+若你有可用的远程代理服务器地址：
+
+**命令行指定**  
+
+```bash
+pac-proxy start --server http://你的服务器地址:端口
+```
+
+此时流量会经该远程服务器转发；是否允许走代理由服务器端校验（例如仅特定账户可用）。
+
+---
+
+## Web 面板功能
+
+### 模式选择
+
+- **本地模式**：PAC 规则只保存在本机，无需登录。
+- **云端模式**：登录后可将 PAC 规则同步到远程服务器，并可从服务器拉取规则到本机。
+
+### 首页：系统代理
+
+- **应用系统代理（PAC）**：把系统代理设为当前面板提供的 PAC 地址（多数系统可自动配置）。
+- **清除系统代理**：取消系统代理设置。
+
+PAC 决定「哪些网站走代理、哪些直连」，规则在「PAC 规则」页管理。
+
+### PAC 规则
+
+- 新增、编辑、删除规则，按类型（按 Host / 按 URL / 默认）和顺序匹配。
+- **本地模式**：规则仅存本机，立即生效。
+- **云端模式**：可「从服务器拉取」、编辑后「保存到服务器」；拉取后在本机生效，需在首页重新「应用系统代理」以确保系统使用最新规则。
+- **复制 / 导出**：仅导出「走代理」且启用的规则（每行一个匹配模式），可粘贴或导入到 Shadowsocks 等客户端的自定义规则中使用。
+
+### 流量
+
+查看经本机代理的请求列表（方法、URL、状态码等元数据），便于排查或确认是否走代理。不记录 HTTPS 正文。
+
+---
+
+## 常用命令
+
+| 命令 | 说明 |
+|------|------|
+| `pac-proxy start` | 启动 HTTP 代理 + 面板。未指定 `-s` 时上游为远程服务器：优先用 `--server`，否则用 `.env` 的 `PROXY_SERVER_URL`；都未配置则需加 `-s` 指定 SOCKS5 |
+| `pac-proxy start -s <host:port>` | 指定上游为本地 SOCKS5（如 `127.0.0.1:1080`） |
+| `pac-proxy start --server <url>` | 指定上游为远程代理服务器地址；未指定时兜底使用 `.env` 的 `PROXY_SERVER_URL` |
+| `pac-proxy panel` | 仅启动 Web 面板，不启动代理 |
+
+**可选参数（start）：**
+
+- `-p, --port <数字>`：HTTP 代理端口，默认 3893
+- `--panel-port <数字>`：面板端口，默认 3892
+- `--server <url>`：上游远程代理服务器地址；为空时使用 `.env` 的 `PROXY_SERVER_URL`
+- `--no-open`：启动时不自动打开浏览器
+
+---
+
+## 配置说明
+
+- **PROXY_SERVER_URL**（在 `.env` 中）：远程代理服务器地址。使用「方式二」且未传 `--server` 时以该值为上游；面板的登录、PAC 同步也会连到该地址。
+- 修改端口或服务器地址后，需重新启动 `pac-proxy start` 或 `pac-proxy panel`。
+
+---
+
+## 注意事项
+
+- 设置系统代理时，部分环境可能需要管理员权限；若自动设置失败，请到系统设置中手动填写 PAC 地址（面板首页会显示）。
+- 使用远程服务器时，登录与代理权限由服务器端控制；本工具只负责转发请求与同步 PAC 规则。

package/bin/proxy.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+
+import 'dotenv/config';
+import { program } from 'commander';
+import { startProxyAndPanel } from '../src/cli/start.js';
+import { panelOnly } from '../src/cli/panel.js';
+
+program
+  .name('proxy')
+  .description('HTTP 代理与隧道 - CLI')
+  .version('0.1.0');
+
+program
+  .command('start')
+  .description('启动 HTTP 代理 + Web 管理面板（上游为本地 SOCKS5 或远程 Server）')
+  .option('-p, --port <number>', 'HTTP 代理端口', '3893')
+  .option('--panel-port <number>', 'Web 面板端口', '3892')
+  .option('-s, --socks <host:port>', '上游 SOCKS5 地址，如 127.0.0.1:1080（与远程服务器二选一）')
+  .option('--server <url>', '上游远程代理服务器地址；未指定时使用 .env 的 PROXY_SERVER_URL')
+  .option('--no-open', '不自动打开浏览器')
+  .action(startProxyAndPanel);
+
+program
+  .command('panel')
+  .description('仅启动 Web 管理面板（不启动代理）')
+  .option('-p, --port <number>', '面板端口', '3892')
+  .option('--no-open', '不自动打开浏览器')
+  .action(panelOnly);
+
+program.parse();

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "pac-proxy-cli",
+  "version": "0.1.0",
+  "description": "HTTP 代理与隧道 CLI + Web 管理面板",
+  "type": "module",
+  "files": [
+    "bin",
+    "src",
+    "public",
+    "README.md",
+    ".env"
+  ],
+  "bin": {
+    "pac-proxy": "./bin/proxy.js"
+  },
+  "scripts": {
+    "start": "node bin/proxy.js start",
+    "panel": "node bin/proxy.js panel"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "dotenv": "^16.6.1",
+    "express": "^4.21.0",
+    "open": "^10.0.0",
+    "socks": "^2.8.0"
+  }
+}