Repository navigation
Upgrade required
After updating, open the VPN panel and run Update setup, or run make install from your checkout. Updating the plugin clone alone does not replace installed root helpers and trusted modules.
Existing profiles, keys, subscriptions, favourites and recent connections are retained. Old protection-cache records become unverified until refreshed or retested.
Highlights
- INCY Desktop subscriptions alongside Happ: server groups, refresh, headless connect/disconnect and xray-based ping. Validated with INCY Desktop 3.9.0 and bundled Ferrum 26.10.13; the app and plugin cannot own a tunnel simultaneously.
- Profile management improvements: delete VLESS/Shadowsocks keys, manage OpenVPN autostart and disconnect orphan WireGuard/AmneziaWG interfaces.
- Copy exit IP from the connection summary and faster cache-only status polling.
Security and reliability
- Endpoint bootstrap uses authenticated, uplink-bound DNS sockets restricted to configured IPv4 upstreams. Ordinary application and shared systemd-resolved DNS receive no kill-switch exception.
- WireGuard, AmneziaWG and OpenVPN share one endpoint snapshot between firewall rules and private numeric runtime profiles. No public DNS fallback or automatic DNS-settings rewrite is introduced; unsupported strict DoT/local-proxy configurations fail explicitly.
- INCY native code runs as the desktop user; fixed root-owned brokers provide narrowly validated network operations.
- WG/AWG SaveConfig preserves original hostnames, IPv6 interface addresses and peer AllowedIPs while retaining native changes. Recovery refuses to overwrite replacement credentials and retains private recovery data on conflict.
- Protection checks and Happ/INCY actions distinguish subscriptions even when server names match.
- Bootstrap permissions follow resolver changes during switching; failed setup remains fail-closed.
- OpenVPN detects standard systemd units without helper PID files. Managed autostart units use the fixed PID/DNS lifecycle and optional IPv6 boot guard.
- DNS probe cancellation no longer waits for stuck libc lookups. Uninstall cleans managed boot/service drop-ins before deleting its helper and aborts if cleanup fails.
Compatibility notes
- OpenVPN option names must be plain: quoted or escaped option names are rejected; quoted hostname arguments remain supported.
- Tunnels remain IPv4-only. The optional IPv6 guard disables IPv6 rather than tunnelling it.
- NetworkManager VPNs remain outside the plugin-managed kill switch.
- INCY configurations containing Shadowsocks temporarily disable TUN sniffing to avoid a reproduced external-TUN-FD HTTP/TLS stall. Domain rules requiring sniffed names may not match; IP-based rules and kill-switch separation are unchanged. VLESS-only configurations retain sniffing.
Full changes: CHANGELOG.md.