Specola 手册
Specola 按规则为电脑上的网络连接分流。你在一个 TOML 文件(即 Profile)里写好节点、代理组和规则, Specola 就会根据连接的目标地址、发起连接的程序或连接的来源,把它送往 DIRECT、REJECT、某个节点或代理组。
连接通过两条路进入 Specola:
- 本地端口(
[general] port,默认7890):本机上的一个 HTTP + SOCKS5 代理。程序或系统代理设置指向它, 流量才会进来。 - 增强模式:不依赖任何代理设置,直接接管流量。Windows 和 macOS 用 TUN 虚拟网卡,Linux 用 eBPF。
Specola 不提供代理服务器。你需要添加自己运营或有权使用的服务器。
两个进程
| 进程 | 职责 | 源码 |
|---|---|---|
Core(Windows 上是 specola-service.exe,macOS / Linux 上是 specola-core) | 加载 Profile,运行本地端口、增强模式、DNS、规则、代理协议和健康检查。不依赖应用也能单独运行。 | src/ |
| Specola 应用 | 用 Qt Quick(QML)写的桌面界面。启动或连接 Core,编辑 Profile,查看连接和日志。 | gui/qml/ |
应用从不直接调用 Core 的内部代码,所有操作都经由控制接口:在本机命名管道(Windows)或 Unix 套接字 (macOS、Linux)上跑 MessagePack RPC;Profile 设置了 api-listen 时还可以走 TCP。 脚本也可以用同一套接口。详见架构和控制接口。
在 Windows 上,安装版应用把 Core 作为 specola-service Windows 服务运行;在 macOS 和 Linux 上, 应用把 Core 作为自己的子进程启动。
支持的平台
| 平台 | 本地端口 | 增强模式 | 说明 |
|---|---|---|---|
| Windows 10 及以上 | 支持 | TUN(Wintun) | Core 以 Windows 服务运行,应用无需管理员权限即可开启增强模式 |
| macOS | 支持 | TUN(utun) | TUN 需要 Core 以 root 运行 |
| Linux | 支持 | eBPF(内核 5.17+、cgroup v2、BTF) | eBPF 需要 Core 以 root 运行;Linux 版还可以作为路由器网关运行 |
Core 可以在这三个平台上构建。你的平台目前有哪些安装包,请以下载页为准。
手册结构
入门
| 页面 | 内容 |
|---|---|
| 快速开始 | 一份三个平台都能加载的入门 Profile;校验、激活;让程序走本地端口;开启增强模式 |
| 工作原理 | 一条连接的完整经历:入口、进程、DNS、嗅探、规则、代理组、拨号、统计;重新加载时保留什么 |
| 架构 | Core 与应用两个进程、控制接口、Core 内部各部分、Windows 服务、数据目录、Profile 如何变成运行中的配置 |
编写 Profile
| 页面 | 内容 |
|---|---|
| 基础配置 | [general]:路由模式、本地端口与协议、局域网访问、日志、api-listen |
| 代理 | [[proxy]]:各种节点类型及其字段 |
| TLS | 节点的 tls 表:服务器名、ALPN、证书、Reality |
| 传输层 | VMess / VLESS 的 transport 表:raw、WebSocket、HTTP、HTTPUpgrade、gRPC |
| 代理组 | [[proxy-group]]:select、url-test、fallback、load-balance 与健康检查 |
| 代理链 | dialer-proxy:经由一个节点连接另一个节点 |
| 分流规则 | [route]:规则类型、先匹配先生效、规则集、GeoIP 与 GeoSite、bypass、按入口区分的 FINAL |
| 进程规则 | 按程序分流:各平台的名称与路径、include-children、Linux eBPF 的特殊之处 |
| DNS | [dns]:Fake-IP 与真实 IP 模式、上游、hosts、DNS 监听 |
| 嗅探 | [sniffer]:从被接管连接的 HTTP / TLS 中读出主机名 |
| 模块 | 叠加在 Profile 之上的文件,用来在多个 Profile 之间共享改动 |
| Provider | 用什么代替节点 Provider 和规则 Provider |
| 订阅 | 从 URL 下载 Profile 的现状,以及现在该怎么做 |
| 完整配置 | 所有字段汇总 |
增强模式
| 页面 | 内容 |
|---|---|
| 增强模式 | [enhanced-mode]:作用、后端、各平台如何选择 |
| TUN | Windows 与 macOS:路由、排除路由、DNS 重定向 |
| Linux eBPF | Linux:要求、哪些流量被接管、未命中流量、排错 |
参考
| 页面 | 内容 |
|---|---|
| CLI | Core 的命令行参数与 Profile 校验 |
| 控制接口 | 应用和脚本使用的 MessagePack RPC 方法 |
| 工具 | 通过控制接口提供的延迟测试等诊断工具 |
开始之前
- Profile 是 TOML 文件。 大多数段落里出现未知字段都会报错,写错一个字 Profile 就加载不了,而不是被悄悄忽略。 激活前先校验(见快速开始)。
- 本地端口和增强模式是两回事。 本地端口只看得到使用它的程序;增强模式能看到无视代理设置的程序, 但运行期间会改动系统的路由或 DNS。
- 应用设置不是 Profile 设置。 主题、窗口、托盘这些选项保存在应用里,Profile 只包含 Core 运行所需的内容。
- 一次只改一层。 先让本地端口配合
FINAL,DIRECT跑通,再加一个节点,再加规则,最后才开增强模式。 出问题时,日志会指出第一个错误。
