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 。