Repository navigation
specola v0.2.2-beta
This beta rebuilds the desktop interface around routing, simplifies the TOML profile format, and adds server deployment tools. Only the Linux x86_64 GCC build is published for this release.
Breaking changes: profile format
Profiles written for 0.2.1 must be updated. Core rejects unknown top-level tables.
[rule] list = [...]becomes[route] rules = [...].- Rule sets, GeoIP and GeoSite move under
[route]as inline tables, for examplerule-set = [{ name = "private", type = "local", behavior = "domain" }]andgeoip = { type = "local" }. [metadata]and[[proxy-provider]]are no longer accepted.- Enhanced mode uses
backend = "tun"orbackend = "ebpf"with inlinetun = { ... }orebpf = { ... }settings. - DNS settings are simplified, with
listener,nameserver-proxy,hostsandipv6options. - Nested
[proxy.tls]tables are written inline astls = { enabled = true }. - GeoIP, GeoSite and rule sets without a
pathare loaded from the Specola configuration directory (~/.config/specolaon Linux).
Convert Clash / mihomo YAML profiles with the Clash to Specola converter.
Proxy
- Hysteria2 and TUIC can be chained through a dialer proxy.
Desktop interface
- Overview: redesigned with a route distribution bar, the selected proxy group and node, live throughput and Top traffic by host, outbound or process.
- Sidebar: Monitor, Routing and Servers groups, a collapsible layout, live Core status, and alerts for new errors.
- Connections and Logs: separate pages with filtering, connection details, process routing, and a 10,000-entry log buffer.
- Proxies, Groups, Rules and DNS: dedicated pages with latency, traffic, group member selection, a rules editor with reordering, and DNS query and cache views.
- Profiles: subscription and local groups, usage details, and first-run guidance.
- Servers: SSH deployment and server monitoring with history charts.
- Settings: searchable categories, Core connection management, and version diagnostics.
- System tray: the tray now opens a single popup with route controls, traffic history and proxy selection. On macOS the native menu no longer opens alongside it.
- Shortcuts: configurable shortcuts cycle the route mode and turn proxying on or off. They are global on macOS and Windows, and work in the app window on Linux.
- Launch at login can be enabled under Settings → General.
- Core status: when Core is missing, stopped or failed, pages that need Core show what happened, the locations searched, and actions to start Core, search again, or choose the executable.
- System fonts are used throughout the interface.
Packaging
- Linux archive:
specola-0.2.2-linux-x86_64-gcc.tar.gz.
Getting started and limitations
- This is a beta prerelease.
- Update existing profiles to the new format before loading them.
- Import a TOML profile and activate it manually after launching the application.
- eBPF and TUN require the appropriate system permissions.
- Release packages do not include GeoIP / GeoSite datasets. Place them in the Specola configuration directory when your rules need them.
- Several workflows still show a pending state until Core support is available, including proxy deletion, rule destination probing, subscription and module operations, and in-app update downloads.