mirror of
https://github.com/YuanDevTeam/Vole.git
synced 2026-11-07 00:05:27 +00:00
Add provider generations, automatic proxy groups, richer routing rules and live Controller configuration. Extend encrypted DNS, persistent fake-IP mappings and GeoData support. Add HTTP CONNECT, WireGuard, TrustTunnel, Mieru and MASQUE outbounds; expand TLS/ECH and transport compatibility. Add separately configured H1/H2 MITM and URL, header and body rewriting. Improve UDP association reuse, TCP delivery and H2/H3 scheduling while keeping memory bounded. Add Linux TUN route and system DNS management, MPTCP and TCP Brutal. Replace vendored dependencies with upstream libraries, update and pin Boring 5.4.0, and fix cross-platform builds and CI feature checks.
2.5 KiB
2.5 KiB
Vole 文档
本文档只维护当前契约、有效约束和发布边界。历史方案、阶段报告与已取消能力留在 Git 历史,不另建归档副本。行为以当前源码、测试和契约为准,不一致时一起修正。
配置与接口
- 配置协议:严格 YAML、节点、providers、动态与自动策略组、DNS 与规则。
- Mihomo 兼容原则与范围:互通要求、性能取舍、已实现能力及协议与平台边界。
- Invoke API:严格请求格式、核心软件版本与构建身份、生命周期、平台回调及内联配置。
- Controller:认证、组与资源、连接管理、规则/配置/DNS 诊断和 TUN 流量。
- 混合入站:同端口 HTTP 转发/隧道、SOCKS5 TCP/授权 UDP、监听及认证。
- 出站:HTTP(S) CONNECT、SOCKS5、AnyTLS、Trojan、VMess AEAD、Hysteria2、TUIC v5、SS 2022、WireGuard、TrustTunnel、Mieru、MASQUE。
- VLESS:传输、Vision、Encryption、REALITY、JLS、ECH。
- XHTTP 与 sing-mux:双腿、H1/H2/H3、连接池及复用。
- TLS 证书与指纹:证书 pin、ClientHello 模板、身份与缓存。
- REALITY 线协议:认证、密钥与失败边界。
运行与平台
- DNS 与 ICMP、GeoData。
- 资源策略:局部预算、所有权、取消和观测。
- TUN 平台、Windows VPN。
- TLS 依赖与发布:来源、provider、fork 与升级门禁。
- Windows 最小集成示例。
开发与验证
- 平台编译、离线回归与独立容器入口。
- CLI 与 tag 发布:五个参数、配置路径、共用内核入口和 CLI / FFI 统一发布。
- 测试隔离:所有网络服务端必须容器化。
- 验收边界:本地、CI、设备和发布证据分别记录。
- 领域上下文、架构决策。
- 工程 skills:Issue 跟踪、分类标签、领域流程。
配置字段由 config.yaml 维护;协议文档补充语义与限制,不复制阶段计划。
技术标识符保留原文,说明使用中文。AGENTS.md 只放跨任务约束与读取入口。