macOS
Intel · DMG
Download ↗Import a VLESS REALITY profile, choose how to route your traffic, and connect. Built for macOS, Windows, and Linux.
Choose your platformIntel · DMG
Download ↗Apple Silicon · DMG
Download ↗x64 · ZIP
Download ↗x64 · TAR.GZ · Local Proxy and TUN
Download ↗x64 · Local Proxy
Download Flatpak ↗Version 5.2 · Hosted on GitHub Releases
Route TCP and UDP traffic device-wide, including traffic from apps without their own proxy settings. First-time setup may require administrator permission.
Configure each app to use 127.0.0.1:10808 for SOCKS5 or 127.0.0.1:10809 for HTTP.
Use the macOS proxy settings for compatible apps. Lightning Proxy restores those settings when you disconnect.
This release is not Apple-notarized. If the alert says the developer can’t be verified or Apple can’t check the app, only proceed if you trust the copy you downloaded directly from GitHub Releases.
Click Open Anyway if it appears for Lightning Proxy and confirm. If it’s missing, try opening the app again and return to the security panel.
App reported as damaged? Download the matching DMG again and replace the copy in Applications. Report the exact alert if it returns. If macOS says the app will damage your computer, leave it blocked.
First time using TUN or System Proxy? The app may ask for administrator approval to install its networking helpers.
Windows SmartScreen may warn about or block the unsigned installer. If the ZIP contains Lightning Proxy.exe alongside several other files, you have the portable package. Keep the files together and launch the EXE from the extracted folder.
Choose Flatpak for an app-menu installation with Local Proxy, or TAR.GZ for device-wide TUN.
Install Flatpak and curl if you need them. Run the commands for your distribution.
sudo apt update
sudo apt install flatpak curl
sudo pacman -Syu --needed flatpak curl
Open the Flatpak download in a compatible software center, or download and install it in a terminal. Flatpak can fetch the required GNOME runtime from Flathub during installation.
mkdir -p "$HOME/Downloads"
cd "$HOME/Downloads"
curl -fL --retry 3 -o Lightning-Proxy-5.2-Linux-x64.flatpak \
https://github.com/Kaasplank1234/Lightning-Proxy/releases/download/Download/Lightning-Proxy-5.2-Linux-x64.flatpak
flatpak install --user ./Lightning-Proxy-5.2-Linux-x64.flatpak
Open Lightning Proxy from your application menu or run:
flatpak run io.github.Kaasplank1234.LightningProxy
Debian or Ubuntu
sudo apt update
sudo apt install curl tar python3 python3-gi gir1.2-gtk-3.0 gir1.2-webkit2-4.1 iproute2
Arch Linux or Manjaro
sudo pacman -Syu --needed curl tar python python-gobject gtk3 webkit2gtk-4.1 iproute2
mkdir -p "$HOME/Downloads" "$HOME/.local/opt"
cd "$HOME/Downloads"
curl -fL --retry 3 -o Lightning-Proxy-5.2-Linux-x64.tar.gz \
https://github.com/Kaasplank1234/Lightning-Proxy/releases/download/Download/Lightning-Proxy-5.2-Linux-x64.tar.gz
tar -xzf Lightning-Proxy-5.2-Linux-x64.tar.gz -C "$HOME/.local/opt"
cd "$HOME/.local/opt/Lightning-Proxy"
Keep the extracted files together. Start the app from its folder or use the full path from any directory:
"$HOME/.local/opt/Lightning-Proxy/lightning-proxy"
Close Lightning Proxy and check that /dev/net/tun exists:
ls -l /dev/net/tun
If the device is missing, try loading the TUN module and check again:
sudo modprobe tun
ls -l /dev/net/tun
Once the device is available, run the setup as your regular user. The script requests administrator approval when needed.
cd "$HOME/.local/opt/Lightning-Proxy"
./Setup-Tunnel.sh
Open Lightning Proxy again and select Device Tunnel in Settings.
To revoke TUN authorization for your account, run:
cd "$HOME/.local/opt/Lightning-Proxy"
./Setup-Tunnel.sh --remove
vless:// profile or compatible HTTPS subscription from your proxy provider.Imported profiles are saved locally and available when you reopen the app.
TCP reachability confirms that the gateway port responds. Import a fresh subscription or ask your provider for an updated profile if the tunnel still times out.
Check whether you approved tunnel setup. On Linux, confirm that you ran the setup script and that /dev/net/tun exists.
Quit and reopen Lightning Proxy. If you use an extracted package, check that all bundled files are together. When reporting a bug, include your OS, app version, connection mode and exact error. Keep profile links and subscription URLs private.