Yoo趣儿

Yoo趣儿 › 探索分享 › 分享创造 › 借助 AI 用 Rust+Tauri 撸了一个代理管理工具 ...

借助 AI 用 Rust+Tauri 撸了一个代理管理工具

查看 9|回复 0
作者：fhy1994   
SSLProxyManager
仓库
  • GitHub: https://github.com/userfhy/SSLProxyManager-Tauri


    一个桌面代理管理工具，提供现代化的基于 Web 的管理界面，用于管理 HTTP/HTTPS 、WebSocket 和 Stream （ TCP/UDP ）反向代理。
    SSLProxyManager 基于 Tauri 2 + Rust，提供管理界面（前端：Vue 3 + Vite + Element Plus），用于配置与管理：
  • HTTP/HTTPS 反向代理
  • WebSocket （ WS/WSS ）反向代理
  • Stream （ TCP/UDP ）四层代理
  • 静态资源托管
  • 访问控制（局域网/白名单/黑名单）
  • 速率限制
  • 指标存储与查询
  • 请求日志与历史数据
  • 运行状态与日志查看
  • 仪表板实时统计

    功能概览

  • HTTP/HTTPS 代理（ rules/routes ）
  • 多监听节点（listen_addr / listen_addrs）
  • TLS （证书/私钥）
  • Basic Auth （支持可选头部转发）
  • 路由：Path 前缀匹配 + 可选条件（ Host / HTTP 方法 / 请求头）
  • 请求/响应体替换支持按 Content-Type 过滤（content_types）
  • Upstream 列表（权重）
  • proxy_pass_path 路径改写
  • 静态目录优先（static_dir）
  • Header 注入（set_headers）
  • 跟随重定向配置
  • HTTP/2 支持（可选）
  • 压缩支持（ gzip/brotli ）

  • WebSocket 代理（ ws_proxy ）
  • 每条 WS 规则可独立启用
  • WS 全局开关 ws_proxy_enabled（全局禁用时，WS 监听不会启动）
  • TLS 支持（ WSS ）
  • 基于路径的路由

  • Stream 代理（ TCP/UDP ，stream ）
  • listen_port 监听端口（ TCP 或 UDP ）
  • proxy_pass 绑定 upstream 名称
  • upstream 支持按客户端 IP 进行一致性选择（默认 hash_key = "$remote_addr"）
  • proxy_connect_timeout / proxy_timeout（字符串形式，例：300s）

  • 访问控制
  • IP 白名单/黑名单
  • 局域网访问控制（允许所有局域网）
  • HTTP 、WS 、Stream 代理独立控制

  • 指标与监控
  • 实时指标收集
  • 历史指标存储（ SQLite ）
  • 请求日志过滤与查询
  • 仪表板统计与图表
  • 实时日志查看器

  • 应用功能
  • 系统托盘集成
  • 系统启动自动运行
  • 单实例模式
  • 自动更新检查
  • 国际化支持（英文/中文）
  • 深色/浅色主题支持


    技术栈
  • 后端：Rust （ Tauri 2 ）、Axum 、Tokio 、SQLx
  • 前端：Vue 3 、Vite 、Element Plus 、ECharts 、Vue I18n

  • 核心库：
  • HTTP/WebSocket：Axum 、Hyper 、Tokio-Tungstenite
  • TLS：Rustls
  • 数据库：SQLite （通过 SQLx ）
  • 配置：TOML


    程序界面





    目录结构
  • src/：Rust 后端代码
  • frontend/：前端项目（ Vite ）
  • tauri.conf.json：Tauri 配置（ dev/build 命令、devUrl 、frontendDist 等）
  • config.toml：运行配置（开发模式下可放项目根目录）
  • config.toml.example：配置示例

    环境要求
  • Node.js + npm
  • Rust 工具链（ stable ）

    本地开发
    1) 安装前端依赖
    cd frontend
    npm install
    2) 启动 Tauri 开发模式
    在项目根目录执行：
    npm run tauri:dev
    该命令会根据 tauri.conf.json：
  • 先进入 frontend 并执行 npm run dev
  • 然后启动 Tauri 并加载 http://localhost:5173

    构建发布
    在项目根目录执行：
    npm run tauri:build
    该命令会：
  • 先进入 frontend 并执行 npm run build（产物：frontend/dist）
  • 再由 Tauri 进行打包

    配置说明（ config.toml ）
    项目使用 TOML 进行配置。
  • 开发模式（ debug ）：如果项目根目录存在 config.toml，优先读取它。
  • Linux 生产模式：默认位置 ~/.config/SSLProxyManager/config.toml


    建议直接参考 config.toml.example。

    1) HTTP/HTTPS 代理（ rules ）

  • [[rules]]：监听节点
  • listen_addr：监听地址，例如 :8888 或 0.0.0.0:1024
  • ssl_enable：是否启用 TLS
  • cert_file / key_file：证书与私钥路径
  • basic_auth_enable / basic_auth_username / basic_auth_password

  • [[rules.routes]]：路由
  • path：Path 前缀匹配
  • static_dir：静态目录（可选）
  • proxy_pass_path：转发路径改写（可选）
  • exclude_basic_auth：该路由是否跳过 Basic Auth （可选）
  • follow_redirects：代理端是否跟随上游 30x （可选）
  • [rules.routes.set_headers]：注入 Header （可选）
  • [[rules.routes.upstreams]]：上游列表（可选）


    2) WS 代理（ ws_proxy ）

  • **ws_proxy_enabled**：WS 全局开关（默认 true）
  • false：不会启动 WS 监听（即使某条 ws rule enabled=true ）
  • true：再按每条 ws rule 的 enabled 生效

  • [[ws_proxy]]：WS 监听规则列表
  • enabled：是否启用该规则
  • listen_addr：监听地址，例如 0.0.0.0:8800
  • ssl_enable：是否启用 TLS （ wss ）
  • cert_file / key_file：证书与私钥路径

  • [[ws_proxy.routes]]
  • path：Path 前缀
  • upstream_url：上游 WS 地址，例如 ws://127.0.0.1:9000



    3) Stream （ TCP/UDP ）代理（ stream ）
    Stream 用于四层代理：监听一个 TCP/UDP 端口并转发到上游。

  • [stream]
  • enabled：全局开关

  • [[stream.upstreams]]
  • name：upstream 名称（供 proxy_pass 引用）
  • hash_key：默认 $remote_addr（按客户端 IP 稳定选择上游）
  • consistent：当前作为配置项保留

  • [[stream.upstreams.servers]]
  • addr：host:port
  • weight / max_fails / fail_timeout：字段保留（可在后续增强策略）


  • [[stream.servers]]
  • enabled：是否启用
  • listen_port：监听端口
  • udp：false=TCP ，true=UDP
  • proxy_pass：引用 upstream 的 name
  • proxy_connect_timeout：例如 300s
  • proxy_timeout：例如 600s



    Nginx 示例对照
    你可以用下面的 Nginx stream 配置理解对应关系：
    stream {
        upstream sendimage {
            hash $remote_addr consistent;
            server 59.xx.xx.xx:8089 max_fails=1 fail_timeout=30s;
        }
        server {
            listen 50002;
            proxy_pass sendimage;
            proxy_connect_timeout 300s;
            proxy_timeout 600s;
        }
    }
    在本项目中等价配置可参考 config.toml.example 的 [stream] 片段。
    4) 全局配置
  • ws_proxy_enabled：全局启用/禁用 WebSocket 代理（默认 true）
  • http_access_control_enabled：启用 HTTP 访问控制（默认 true）
  • ws_access_control_enabled：启用 WebSocket 访问控制（默认 false）
  • stream_access_control_enabled：启用 Stream 代理访问控制（默认 true）
  • allow_all_lan：允许所有局域网 IP （默认 true）
  • auto_start：应用启动时自动启动代理服务（默认 true）
  • show_realtime_logs：在 UI 中显示实时日志（默认 false）
  • realtime_logs_only_errors：实时日志视图仅显示错误（默认 false）
  • stream_proxy：遗留字段（请使用 [stream].enabled 代替）
  • max_body_size：最大请求体大小（字节，默认 10485760 = 10MB ）
  • max_response_body_size：最大响应体大小（字节，默认 10485760 = 10MB ）
  • upstream_connect_timeout_ms：上游连接超时（毫秒，默认 5000）
  • upstream_read_timeout_ms：上游读取超时（毫秒，默认 30000）
  • upstream_pool_max_idle：连接池最大空闲连接数（默认 100）
  • upstream_pool_idle_timeout_sec：空闲连接超时（秒，默认 60）
  • enable_http2：启用 HTTP/2 支持（默认 false）

    5) 访问控制（白名单）

  • [[whitelist]]：IP 白名单条目
  • ip：IP 地址或 CIDR 表示法（例如：127.0.0.1 或 192.168.1.0/24）


    6) 指标存储

  • [metrics_storage]：指标存储配置
  • enabled：启用指标存储（默认 true）
  • db_path：SQLite 数据库文件路径（例如：/path/to/metrics.db）


    7) 更新配置

  • [update]：自动更新配置
  • enabled：启用更新检查（默认 true）
  • server_url：更新服务器 URL （为空则使用默认）
  • auto_check：自动检查更新（默认 true）
  • timeout_ms：更新检查超时（毫秒，默认 10000）
  • ignore_prerelease：忽略预发布版本（默认 true）


    界面功能
    应用程序提供了全面的基于 Web 的管理界面：
  • 仪表板：实时统计、指标图表和服务状态
  • 基础配置：全局设置和代理服务控制
  • HTTP/HTTPS 代理配置：配置反向代理规则和路由
  • WebSocket 代理配置：配置 WS/WSS 代理规则
  • Stream 代理配置：配置 TCP/UDP 四层代理
  • 访问控制：管理 IP 白名单/黑名单
  • 指标存储：查看和管理指标数据库
  • 请求日志：查询和过滤历史请求日志
  • 日志查看器：实时日志查看与过滤
  • 关于：版本信息和更新检查

    常见问题

  • Q: 前端开发服务器使用什么端口？
    A: 默认端口是 5173（见 tauri.conf.json 的 devUrl）。

  • Q: 如何更改前端 dev/build 命令？
    A: 修改根目录 tauri.conf.json 的 build.beforeDevCommand / build.beforeBuildCommand。

  • Q: 配置文件位于哪里？
    A: 开发模式下，如果项目根目录存在 config.toml，则优先读取。生产模式（ Linux ）下，默认位置是 ~/.config/SSLProxyManager/config.toml。

  • Q: 如何启用系统启动时自动运行？
    A: 在 config.toml 中设置 auto_start = true，应用启动时会自动启动代理服务。

  • Q: 可以将应用隐藏到系统托盘吗？
    A: 可以，点击关闭按钮会将窗口隐藏到系统托盘而不是退出。可以从托盘菜单退出。

  • Q: 如何查看历史指标？
    A: 在配置中启用指标存储，然后在 UI 中使用"指标存储"标签页查询历史数据。

  • Q: 如何配置访问控制？
    A: 使用"访问控制"标签页管理 IP 白名单/黑名单，或在 config.toml 中编辑 [[whitelist]] 条目。

    免责声明
    本项目仅用于学习与合法合规的网络代理/反向代理配置管理场景。使用本软件可能涉及网络访问控制、证书管理、流量转发等操作，存在但不限于数据泄露、服务中断、配置错误导致安全风险等潜在风险。你在使用本项目时需自行评估并承担全部风险与责任。
  • 合法合规：请确保你的使用行为符合当地法律法规及相关网络服务条款。禁止将本项目用于任何未授权的渗透、攻击、绕过访问控制、窃取数据、传播恶意软件、侵犯他人隐私或其他任何违法违规用途。任何因你使用本项目从事违法违规或未授权行为所产生的法律责任、行政处罚、第三方索赔及相关后果，均由你自行承担，作者与贡献者不承担任何责任。
  • 无担保：本项目按“现状”提供，不提供任何形式的明示或暗示担保（包括但不限于适用性、可靠性、准确性、可用性、无错误/无漏洞等）。
  • 责任限制：对于因使用或无法使用本项目导致的任何直接或间接损失（包括但不限于利润损失、数据丢失、业务中断、设备或系统损坏等），作者与贡献者不承担任何责任。

    如果你不同意上述条款，请勿使用、分发或基于本项目进行二次开发。
    许可证
    本项目采用 MIT 许可证 - 详见 LICENSE 文件。
    仓库
  • GitHub: https://github.com/userfhy/SSLProxyManager-Tauri

    贡献
    欢迎贡献！请随时提交 Pull Request 。
    • 返回列表
    您需要登录后才可以回帖 登录 | 立即注册

    AD1

    热门主题

    热门板块

    问与答分享发现分享创造奇思妙想分享邀请码商业推广优惠信息PythonPHPJavaJavaScriptNode.jsGo语言C++HTML

    公告

    标签|小黑屋|Yoo趣儿

    GMT+8, 2026-3-10 17:09 , Processed in 0.008490 second(s), 8 queries , Gzip On, MemCached On.

    Powered by Discuz! X3.2

    The happiest thing in the world is to strive for an ideal.

    返回顶部