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

Read the release notes ↗
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.
  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. Extract the entire ZIP to a folder.
  2. Run Lightning Proxy.exe from that folder and keep the bundled files alongside it.
  3. If Windows asks for administrator approval when you enable TUN, approve the request to start the tunnel.
Linuxx64 · GTK 3 and WebKitGTK
  1. Extract the TAR.GZ archive and open a terminal in the extracted folder.
  2. Install GTK 3 and WebKitGTK using your distribution’s package manager if they’re missing.
  3. Run ./lightning-proxy.
  4. For TUN, run ./Setup-Tunnel.sh once. Setup requires administrator access and TUN needs /dev/net/tun.

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. On Windows and Linux, check that you extracted the full package. When reporting a bug, include your OS, app version, connection mode and exact error. Keep profile links and subscription URLs private.