Repository navigation
First public release of Zarp for Linux
What's inside
- WARP through zapret2. Zarp drives the official Cloudflare WARP client and finds a strategy that gets its MASQUE handshake through DPI, over QUIC (HTTP/3) or TLS (HTTP/2). zapret2 stays active while the tunnel is connected.
- Quick scan and Full scan, the same flow as on Windows. A working strategy must pass twice, with another WARP endpoint when test isolation is enabled. A connection counts only if real HTTPS traffic passes through the tunnel and packet processing is confirmed.
- Remembers verified strategies. The power button uses saved results on later connections. You can recheck selected strategies, filter by country or choose one manually in Settings.
- Your own VPN server. VLESS TLS / Reality, Trojan, Hysteria2 and VLESS XHTTP, from one link or an HTTPS subscription. Zarp tests compatible server-and-strategy pairs and keeps their outer connection protected by zapret2. The bundled sing-box handles the tunnel; Xray handles XHTTP through a local bridge.
- Routing and per-program proxy for your own server. Direct, Proxy and Block rules, GeoIP/GeoSite, local-network and country presets, and a choice of programs that use the server.
- Protected WARP setup. Device registration and WARP+ requests go through zapret2. On Ubuntu and Debian, Zarp can install the official WARP client after you accept its terms; if ordinary download attempts fail, it retries through zapret2.
- QUIC packet handling. A compact 1200-byte VK Initial preserves the complete authenticated ClientHello on small-MTU links. IP-fragment strategies account for the official WARP client's firewall.
- Native Linux desktop. An animated power button, separate settings window, log and system tray. The GUI runs as your ordinary user; a system service handles tunnels and packet interception, with polkit authorization.
- Nine interface languages. English, Русский, Español, Português, 中文, हिन्दी, Français, Deutsch and فارسی, switchable from the globe button.
Download
| System | Package |
|---|---|
| Ubuntu 26.04 | zarp-ubuntu-amd64.deb |
| Debian 13 | zarp-debian-amd64.deb |
| Fedora 44 | zarp-fedora-x86_64.rpm |
| Arch Linux | zarp-arch-x86_64.pkg.tar.zst |
Requirements
- Linux x86_64 with systemd: Ubuntu 26.04, Debian 13, Fedora 44 or current Arch Linux. Choose the package built for your distribution.
- Packet interception: NFQUEUE and cgroup v2. WARP mode needs
nft_socketorxt_cgroupwithiptables-nft. - Desktop authorization: a polkit authentication agent. Run the GUI as your ordinary user.
- WARP mode: the official Cloudflare WARP client. Zarp can install it on Ubuntu/Debian; install it separately on Fedora/Arch. WARP is not bundled. Your own server mode uses the included VPN engines.
Getting started
- Download and install your distribution's package. Installation commands.
- Start the service, then open Zarp from the application menu or terminal:
sudo systemctl enable --now zarp.service
zarp- Press the power button, or open Settings and start a Quick scan or Full scan. For your own server, paste a link or subscription in Server and endpoints before searching.
Verify the download
Download SHA256SUMS alongside your package and run:
sha256sum --check SHA256SUMS --ignore-missingPackage SHA-256:
130bbe00fd23ae1dd1958ee236a4a8895736dded000ca35a397cdfc54ce3279d zarp-ubuntu-amd64.deb
f35bc9583130df636b21cac945650f69f1bb566d07429e62b386cecf0c1b8b7f zarp-debian-amd64.deb
c29a923ef6f55af98b8b7fd3fbce7283dee619bec03d258df6c1298f815b0f02 zarp-fedora-x86_64.rpm
0e8f6adc9b44e8e7ffdeab3c7b93acac3bd961a13ad8b4040b903718a506245b zarp-arch-x86_64.pkg.tar.zst
Packages are currently unsigned. release-manifest.json records the source commit, package hashes and bundled engine versions.
Bundled engines
| Engine | Version |
|---|---|
| zapret2 | a414649c40845ada37a8b3316b0171cc1584a680 |
| sing-box | 1.13.14 |
| xray | 26.7.28 |
nfqws2 is built natively for each distribution. Runtime downloads are pinned and verified; zapret2 updates are checked before activation.
Before publication, CI installs each native package and runs Go/race, GUI tests as an ordinary user, runtime checks and packet tests in an isolated network namespace. The working strategies still depend on your network.
Full Changelog: https://github.com/ZarpVPN/Zarp-Linux/commits/v0.3.5