Editorial illustration of a shared VPN client engine linking computers and phones to remote servers

VPN protocol architecture analysis

What is ProTUN? Proton VPN’s shared WireGuard engine

ProTUN is the part of Proton VPN that connects each operating system to its shared Rust WireGuard core, libpvpnclient. Proton calls the wider client architecture Proton Protocols. It runs connection modes such as WireGuard and Stealth inside the apps.

Proton published the iOS 8.0.0 source release on November 3, 2026. The tagged app replaces the previous Go-based WireGuard extension with ProTUN and adds an advanced kill switch. On November 7, Apple’s US and Portuguese listings still showed 7.5.2. The macOS app is on a separate release track.

What Proton released

Proton published two launch articles and a public source repository. The technical article describes four names that are easy to collapse into one. The iOS source release shows how those components fit together.

Name Technical role Status
Proton Protocols The product name for the shared client architecture Out of beta on Windows. Present in the iOS 8.0 source release
ProTUN Operating-system wrapper around the Rust core Public source and tagged releases
libpvpnclient Rust implementation of WireGuard Used as a ProTUN dependency
LocalAgent Certificate-authentication and control channel Rewritten in Rust
muon Networking library for Proton API access Used by LocalAgent for tunnel authentication. Broader pre-tunnel routing is planned.

Client architecture

Where ProTUN fits in a Proton VPN connection

The solid path shows the VPN tunnel. The dashed path shows Proton’s plan for broader API access before the tunnel starts.

  1. App layer Proton VPN app Windows, Android, iOS, iPadOS, or Linux GUI
  2. OS adapter ProTUN Wraps the shared core for each operating system
  3. Tunnel core libpvpnclient Rust implementation of WireGuard
  4. Selected transport WireGuard or Stealth UDP, TCP, or the obfuscated Stealth path
Control channel

LocalAgent

Handles Proton's certificate-based authentication and connection control alongside the tunnel core. The iOS 8.0 source configures muon for LocalAgent’s authentication work.

Pre-tunnel API path Planned phase two

muon

Intended to help apps reach Proton's API when DNS or server-name blocking prevents the first connection.

ProTUN adapts the engine to the operating system. libpvpnclient implements WireGuard, which Stealth carries over an obfuscated transport.

Why Proton is replacing wireguard-go

Proton's apps previously used the official Go implementation, wireguard-go. Proton says that code did not integrate cleanly with Kotlin on Android, Swift on Apple platforms, and the other native layers used by its apps. The result was more platform-specific glue, harder debugging, and slower feature work.

A shared core can reduce that duplication. One implementation can receive a fix once and expose it through thin operating-system adapters. It also gives engineers a common place to test edge cases and add transport behavior. Those are sensible architecture goals. They are not benchmark results.

Proton also says Rust should improve safety and performance. Rust can prevent several classes of memory errors when code stays within its safe subset, but language choice does not prove the absence of logic errors, unsafe blocks, dependency flaws, or protocol mistakes. A public assessment would provide stronger evidence than the implementation language alone.

What changed in Proton VPN 8.0 for iPhone and iPad?

The iOS 8.0.0 tag embeds a ProTUN packet-tunnel extension. Its Swift package pins a checksummed ProTUN 3.0.5 XCFramework. The Swift adapter hands Apple’s tunnel file descriptor, connection configuration and a socket binder to the Rust wrapper. In iOS 7.5.2, the project built the Go extension and stripped the ProTUN extension from Release builds. Proton’s 8.0 notes also list an interactive globe and NetShield counters that persist between app sessions. iOS 8.0.0 release notes, 8.0.0 package manifest, 7.5.2 build configuration.

What the Rust engine changes

The public ProTUN 3.0.5 tag declares pvpnclient ~4.4.1 from Proton’s Rust registry. In the 4.4.1 source, libpvpnclient calls Proton’s BoringTun fork for the WireGuard handshake and packet encryption. The wrapper handles the OS-facing work, including polling sockets and telling the core when network connectivity changes. In the iOS adapter, Apple network path updates feed into that same Rust connection. This gives Proton a common place to change reconnection logic across platforms. ProTUN manifest, libpvpnclient 4.4.1 source archive, Apple network path handling.

The app still offers WireGuard UDP, WireGuard TCP and Stealth. Smart Protocol selects among eligible connection options. The iOS code supplies the server’s available transports and ports, then narrows them when a specific transport is selected. Sharing the engine makes changes to transport selection easier to reuse. Stealth is still the obfuscated WireGuard transport, and its effectiveness depends on what a network blocks. Transport configuration, Proton’s protocol guide.

Standard, Advanced and local network access

Both modes use Apple’s includeAllNetworks setting for a VPN connection. Standard is intended to block traffic during an unexpected drop and releases the block when you deliberately disconnect. In Advanced, disconnecting an armed tunnel switches it in place to a configuration with zero peers. The app can also start a tunnel in that state. Traffic that iOS routes into it has no VPN server to go to. Disconnect handling, Tunnel configuration.

With Allow LAN connections enabled, the code sets excludeLocalNetworks even for the zero-peer tunnel. Local connections bypass the VPN, which is how the release can allow compatible LAN devices and CarPlay with either kill-switch mode. The tagged app defaults this setting on for paid users and gates it on Free. Advanced also clears the configurable exclusions for Apple push notifications, carrier services and attached-device traffic where the OS supports those flags. Apple still exempts some system traffic, including DHCP and captive-portal negotiation. LAN settings and plan eligibility, Advanced exclusions, Apple’s VPN routing rules.

What the public source establishes

The ProTUN wrapper is public under GPL-3.0. The public 3.0.5 tag matches the version named by the Swift package, which downloads a prebuilt binary. The tag has no Cargo.lock to pin all Rust dependencies. We checked the downloaded 4.4.1 core archive against Proton’s registry checksum. The archive contains source but no license file, and its manifest declares neither a license nor a repository. The wrapper’s license alone cannot answer how the core may be reused or establish that a build reproduces the distributed binary.

Our August build check used ProTUN v2.2.1. That tag passed cargo check --lib using public dependencies. For 3.0.5 we inspected source. The release tags are the relevant references because the repository’s default branch has a different history.

What our August audit search established

Our August 14 search located no public dedicated ProTUN or libpvpnclient report in Proton’s security material, the repository, auditor indexes or technical coverage. Proton’s app audit index links to reports announced in December 2025, before the implementation reviewed here. A dedicated assessment would need to identify the ProTUN or libpvpnclient version reviewed and describe its scope. Proton’s app audit index.

What has shipped, and what is still planned?

Proton’s October 21 roadmap says Proton Protocols has left beta on Windows. The November 3 iOS 8.0.0 GitHub release is a separate milestone from store distribution. On November 7, Apple listed 7.5.2 in the US and Portugal, while Proton’s iOS support changelog still described 8.0 under TestFlight. October roadmap, US App Store, Portuguese App Store, iOS and iPadOS changelog.

The shared repository contains a macOS ProTUN target. The macOS 6.5.2 project still embeds the older Go-based WireGuard extension, and its ProTUN feature gate is off on macOS. Proton lists ProTUN and Advanced kill switch as upcoming work for Mac. macOS 6.5.2 build configuration, ProTUN feature gate, macOS changelog.

Linux Stealth is available: Proton’s Linux GUI release notes record its introduction with the Proton Protocols beta in version 4.18.0. The current protocol support guide says Linux users must enable Proton Protocols for Stealth and Smart Protocol. Android also has an architecture toggle; iOS and iPadOS early-access builds use it automatically.

What the architecture can change

A censor can block the VPN tunnel or stop the app from reaching Proton’s API before a tunnel exists. Stealth addresses the tunnel side. On the API side, the tagged iOS adapter configures muon for LocalAgent, and the Rust code passes cached API authentication into that component and handles muon certificate-refresh errors. This is evidence of muon use in tunnel authentication. The broader pre-tunnel API routing and eventual replacement of alternative routing are goals described separately in Proton’s technical announcement. iOS LocalAgent configuration, ProTUN authentication errors, Proton’s technical announcement.

Proton says the redesign lays groundwork for post-quantum cryptography. The WireGuard code we reviewed used the BoringTun-derived implementation, and we found no deployed post-quantum key exchange in the reviewed iOS path. Transport obfuscation changes what a network can recognize. It provides a different property from quantum resistance.

The new connection loop and path-change handling give Proton tools for improving reliability. The launch material gives no matched iPhone or iPad comparison for reconnection success, throughput, latency or battery drain. Measuring those outcomes would require the same device, VPN server, transport and network conditions on both versions. The source alone also cannot establish leak behavior during handovers, sleep or restart.

Our VPN protocol comparison records ProTUN separately from Stealth. The VPN protocol transparency report explains how we distinguish public source from independent assessment. For the broader concepts, see how VPN protocols and implementations fit together.

Primary sources

Proton Protocols and ProTUN: FAQ

No. Proton describes it as a client-side VPN architecture based on WireGuard. The selectable tunnel and transport can still be WireGuard UDP, WireGuard TCP or Stealth. The new work changes the shared client engine that implements and manages those connections.

ProTUN is Proton's operating-system wrapper around libpvpnclient. It adapts the shared Rust WireGuard core to each operating system and handles platform tasks such as tunnel and socket I/O.

libpvpnclient is Proton's Rust implementation of WireGuard. The 4.4.1 source uses Proton’s fork of Cloudflare BoringTun for WireGuard handshakes and packet encryption.

No public dedicated ProTUN or libpvpnclient assessment was located in our search completed on August 14, 2026. Proton has published audits of its apps, but the older reports do not establish an independent review of this 2026 implementation.

Proton describes post-quantum support as future work. Our iOS 8.0 source review found no evidence of a deployed post-quantum WireGuard key exchange.

Proton says it has left beta on Windows. Android and the Linux GUI have an early-access toggle. iOS and iPadOS use it in the 8.0.0 source release and TestFlight builds. On November 7 the US and Portuguese App Store listings still showed 7.5.2, and Proton’s macOS 6.5.2 release still used the Go WireGuard extension.

Compare VPNs beyond the protocol name

Check independent assessments, app maintenance, leak protection, platform support, and logging evidence before choosing a service.

Proton VPN Logo
★ 4.7

Proton VPN

75% OFF
$2.49 /mo equivalent
Provider reference $9.99/mo equivalent

Proton VPN is a Swiss-based service with open-source apps, Secure Core multi-hop routes and a published no-logs policy. The paid plan supports up to 10 devices and suits readers who put transparency and privacy controls ahead of the lowest price.

  • 20,000+ servers in 140+ countries
  • 10 simultaneous connections
Get Proton VPN deal →

Includes at least a 30‑day money‑back guarantee – test it on your own network and cancel if it does not fit your needs.

NordVPN Logo
★ 4.7

NordVPN

74% OFF +3 Months Free
$2.99 /mo equivalent
Provider reference $11.59/mo equivalent

NordVPN combines broad server coverage with NordLynx, independently reviewed no-logs controls and extra privacy tools such as Double VPN. It is a strong all-round option for streaming, travel and everyday privacy across up to 10 devices.

  • 8,400+ servers in 126 countries
  • NordLynx (WireGuard) protocol
Get NordVPN deal →

Includes at least a 30‑day money‑back guarantee – test it on your own network and cancel if it does not fit your needs.