Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

thurgio

thurgio 是一个代理配置管理工具——一个现代化的、基于 Rust 构建的 surgio 替代品。它可以聚合多个代理源,应用过滤和转换规则,并将结果渲染为 Clash、Surge、sing-box、V2RayN、SIP002 及其他代理客户端格式的输出文件。


主要特性

  • 多源聚合 — 从 Clash、Clash.Meta、V2RayN、SIP002、Surge、QX、Loon、SIP008、SSD、Telegram 或本地文件获取代理(ruleset.yaml 远程规则集自动物化)。
  • 协议支持 — 25 种代理协议(SS、SSR、VMess、VLESS、Trojan、Hysteria(2)、TUIC、WireGuard、SOCKS5、HTTP、Snell、AnyTLS、ShadowTLS、Juicity、Naive、Ssh、Mieru 等)。
  • 过滤与重命名 — 关键字(前缀/后缀/包含/列表)、正则和代理类型过滤器 + filter/rename 模板过滤器(_rules 上下文)+ ruleset 命名规则集;支持正则反向引用的重命名规则。
  • 表情模式 — 根据检测到的国家/地区自动添加旗帜表情前缀,可全局或按订阅源配置(启用/禁用/去除)。
  • 模板引擎Tera 模板(Jinja2/Django 语法),30+ 内置过滤器(clash/surge/qx/loon/mellow/mixed/sibox/stash/clashr/js/sort_nodes/clash_groups/surge_groups/ruleset 等)+ get_env/now 自定义函数;tpl=auto 按 User-Agent 自适应输出。
  • 热重载 — 配置文件(thurgio.yaml + 5 个 sibling)和模板目录变更时自动重新构建;ruleset 远程 URL 条目更新管线自动拉取。
  • HTTP API — 内置 Axum 服务器,支持按作用域(Read/Admin)划分的令牌认证、provider/snippet 渲染(tpl=auto)、订阅商店/健康/流量元数据/延迟/UDP/GEO/解锁探测、SSE 构建通知和 Prometheus 指标。
  • 安全性 — 作用域令牌、可选的 TLS、IP 速率限制、并发限制、CORS 配置(热重载)。
  • 自包含 — 单一二进制文件,使用嵌入式 SQLite 数据库持久化(无需外部数据库服务器,WAL 多进程共享)。

快速开始

cargo install thurgio
thurgio init
thurgio build

详细说明请参阅快速开始指南


链接


致谢