Lightning Proxy

Download
Lightning Proxy.

Import a VLESS REALITY profile, choose how to route your traffic, and connect. Built for macOS, Windows, and Linux.

Choose your platform
Illustrative app preview

Desktop downloads

View GitHub releases ↗

Version 5.2 · Hosted on GitHub Releases

Choose how your traffic is routed

TUN

Route TCP and UDP traffic device-wide, including traffic from apps without their own proxy settings. First-time setup may require administrator permission.

Local Proxy

Configure each app to use 127.0.0.1:10808 for SOCKS5 or 127.0.0.1:10809 for HTTP.

System Proxy macOS

Use the macOS proxy settings for compatible apps. Lightning Proxy restores those settings when you disconnect.

Installation instructions

Installation guide on GitHub ↗
macOS11 or later · Intel and Apple Silicon
  1. Open Apple menu → About This Mac. Download the Apple Silicon DMG if it lists an Apple chip, or the Intel DMG if it lists an Intel processor.
  2. Open the DMG in Finder, drag Lightning Proxy into Applications, and eject the disk image. Choose Replace if Finder asks about an older copy.
  3. Open the app from Applications. If macOS asks whether you want to open an app downloaded from the internet, click Open.

If macOS blocks the first launch

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.

  • macOS 13 or later — Open System Settings → Privacy & Security and scroll to Security.
  • macOS 11 or 12 — Open System Preferences → Security & Privacy → General.

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.

Apple’s guide to opening downloaded apps ↗

WindowsWindows 10 or 11 · x64
  1. Download the Windows ZIP from Downloads. Right-click it and select Extract All.
  2. Open Lightning Proxy Setup.exe, confirm the installation, and approve the Windows administrator prompt.
  3. Setup installs Lightning Proxy in Program Files and adds a Start menu shortcut. Use that shortcut to open the app.
  4. When enabling TUN, approve the Windows administrator prompt if it appears.

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.

Linuxx64 · Flatpak or TAR.GZ

Choose Flatpak for an app-menu installation with Local Proxy, or TAR.GZ for device-wide TUN.

Option 1 · Flatpak

Install Flatpak and curl if you need them. Run the commands for your distribution.

Debian or Ubuntu

sudo apt update
sudo apt install flatpak curl

Arch Linux or Manjaro

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

Option 2 · TAR.GZ

1. Install dependencies

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

2. Download and extract

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"

3. Start 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"

4. Enable Device Tunnel if needed

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

Make your first connection

  1. Import a vless:// profile or compatible HTTPS subscription from your proxy provider.
  2. Select the profile and choose your routing mode.
  3. Press Connect and check the connection status.

Imported profiles are saved locally and available when you reopen the app.

Troubleshooting

Gateway reachable, but the tunnel times out

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.

Local Proxy works, but TUN doesn’t

Check whether you approved tunnel setup. On Linux, confirm that you ran the setup script and that /dev/net/tun exists.

The connection engine stops

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.