用MUSE耗时3小时开发了一个好玩的

我用gpt写了一个开发文档，直接把开发文档扔给MUSE 全自动完成

仓库地址:https://github.com/judy-gotv/RustProxyAdmin

RustProxyAdmin v7

多节点代理 / 端口转发 / 隧道管理面板（Rust + actix-web + SQLite），带订阅分发、流量配额、告警中心与 Web 管理后台。

功能一览

• 条目管理：落地代理（socks5 / http / ss）、端口转发（tcp / udp）、中转隧道（relay+tls / ws / wss），支持分组、标签、批量操作
• 多节点：Master + Worker 架构，节点心跳监控、配置自动下发、流量上报
• 订阅分发：为每条订阅生成 token 链接，支持 clash / sing-box / v2ray / ss / base64 等多种输出格式与自定义模板
• 导入订阅：从 URL 导入第三方订阅并解析成条目，导入记录可查
• 流量配额与生命周期：按条目/订阅设置流量配额与到期时间，超限或到期自动停用，支持手动延期/恢复、月度配额重置
• 统计：流量、连接数、在线节点、Top 条目（近 7 天）、节点/条目监控
• 日志：操作日志、访问日志、订阅访问日志，均可检索
• 告警中心：节点离线、配额预警、到期提醒；通知渠道支持 Telegram Bot / Webhook（HMAC 签名）/ SMTP 邮件，失败自动退避重试
• 多用户：admin / viewer 角色，viewer 只读；渠道密钥 AES-256-GCM 加密存储
• 可观测：Prometheus /metrics 端点

快速开始

1. 构建

需要 Rust 1.88+：

cargo build --release
# 二进制位于 ./target/release/rust_proxy_admin

2. 配置

复制 config.toml 按需修改（见下节），或直接用环境变量覆盖：

RPA__SERVER__BIND=127.0.0.1:8080 \
RPA__DB__URL="sqlite://data/data.db" \
RPA__SERVER__SECRET_KEY="换成你自己的随机密钥" \
./target/release/rust_proxy_admin

环境变量规则：RPA__ 前缀 + __ 分隔层级，例如 RPA__AUTH__INIT_PASSWORD 对应 [auth] init_password。
首次启动会自动创建管理员账号（[auth] init_username / init_password），上线前务必修改默认密码。

3. 打开后台

浏览器访问 http://127.0.0.1:8080/admin，用管理员账号登录。

配置说明（config.toml）

数据库迁移在启动时自动执行（migrations/）。

Worker 节点接入

1. 在后台「服务器节点」页新建节点，拿到该节点的 api_token。
2. 在节点机器上运行：

./rust_proxy_admin --mode worker \
  --master https://admin.example.com \
  --token <节点的 api_token>

Worker 会自动向 Master 注册心跳、拉取属于自己的条目配置并启动监听，上报流量与负载。

后台使用指南

订阅分发

在「订阅管理」新建订阅并勾选要包含的条目/分组，得到形如：

http://<public_base_url>/sub/<token>?format=clash

• format 可选：clash / sing-box / v2ray / ss / base64 等（可用模板自定义）
• 订阅支持到期时间与流量配额；超限/到期自动停用并返回提示
• 响应带 Subscription-Userinfo 头（upload/download/total/expire），客户端可显示剩余流量
• 订阅输出有 60 秒服务端缓存，高频刷新不打爆数据库

告警配置

1. 「告警中心 → 通知渠道」新建渠道：
   • Telegram：填 Bot Token 与 Chat ID（支持 socks5 代理）
   • Webhook：填 URL 与签名密钥，投递时带 HMAC-SHA256 签名
   • SMTP：填服务器、账号、收件人
   • 渠道密钥入库前 AES-256-GCM 加密（需配置 [server] secret_key）
2. 「告警规则」新建规则：选择事件类型（节点离线 / 配额预警 / 到期提醒 / 条目异常）、阈值、冷却时间，绑定渠道。
3. 「事件历史」查看 pending / sent / failed 状态；投递失败按 60s / 120s / 240s / 480s 退避重试，5 次后标记失败。

多用户与权限

• admin：全部权限，可管理用户。
• viewer：只读，所有写接口返回 403；订阅 token 与渠道密钥对 viewer 不可见。
• 在「账户设置」中增删用户、重置密码（重置后该用户所有会话立即失效）。
• 禁止删除自己、禁止把自己降级、禁止删除最后一个 admin。

安全建议

• 修改 [auth] init_password 默认密码；生产环境设置 [server] cookie_secure = true 并使用 HTTPS。
• 设置 [server] secret_key（或 RPA__SERVER__SECRET_KEY），使渠道密钥加密存储；更换密钥前先备份数据库。
• 如需公网暴露，建议放在反向代理后并配置 [server] trusted_proxies。
• 忘记密码时可用命令行重置（旧会话全部失效）：

  ./target/release/rust_proxy_admin reset-password --username admin --password '新密码'
  

常用接口

• 管理后台：GET /admin
• Prometheus 指标（需登录）：GET /metrics
• 订阅拉取：GET /sub/<token>?format=clash

目录结构

src/            # Rust 源码（handlers / services / models / worker …）
templates/      # Tera 模板（管理后台页面）
static/         # CSS / JS
migrations/     # SQLite 迁移（启动自动执行）
config.toml     # 默认配置

排错

• 端口被占用：改 [server] bind 或 RPA__SERVER__BIND。
• Worker 连不上 Master：检查 --master 地址与节点 api_token 是否正确，Master 日志看握手报错。
• 订阅返回空：检查订阅是否过期/超配额，或条目是否被停用。
• 页面数据不加载：打开浏览器开发者工具看 Console 与 Network 的报错信息。