Skip to content
English下载

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]:作用、后端、各平台如何选择
TUNWindows 与 macOS:路由、排除路由、DNS 重定向
Linux eBPFLinux:要求、哪些流量被接管、未命中流量、排错

参考 ​

页面内容
CLICore 的命令行参数与 Profile 校验
控制接口应用和脚本使用的 MessagePack RPC 方法
工具通过控制接口提供的延迟测试等诊断工具

开始之前 ​

  • Profile 是 TOML 文件。 大多数段落里出现未知字段都会报错,写错一个字 Profile 就加载不了,而不是被悄悄忽略。 激活前先校验(见快速开始)。
  • 本地端口和增强模式是两回事。 本地端口只看得到使用它的程序;增强模式能看到无视代理设置的程序, 但运行期间会改动系统的路由或 DNS。
  • 应用设置不是 Profile 设置。 主题、窗口、托盘这些选项保存在应用里,Profile 只包含 Core 运行所需的内容。
  • 一次只改一层。 先让本地端口配合 FINAL,DIRECT 跑通,再加一个节点,再加规则,最后才开增强模式。 出问题时,日志会指出第一个错误。