Skip to content

Releases

Lightning-Proxy-5.2

Choose a tag to compare

@Kaasplank1234 Kaasplank1234 released this 18 Nov 12:36
c2f810c

⚡ Lightning Proxy 5.2

Lightning Proxy is a desktop client for VLESS REALITY profiles and compatible HTTPS subscriptions. Version 5.2 brings a redesigned interface to macOS, with builds for Windows and Linux. Use TUN to route traffic from desktop apps, or Local Proxy to route traffic from individual apps.

Download the right build

Choose the file for your device under Assets.

Device Download
Mac with an Apple chip · macOS 11 or later Lightning-Proxy-5.2-macOS-AppleSilicon.dmg
Mac with an Intel processor · macOS 11 or later Lightning-Proxy-5.2-macOS-Intel.dmg
Windows 10 or 11 · x64 Lightning-Proxy-5.2-Windows-x64.zip
Linux · x64 Lightning-Proxy-5.2-Linux-x64.tar.gz

On a Mac, open Apple menu → About This Mac. If you see an Apple chip such as M1 or M2, choose Apple Silicon. If you see an Intel processor, choose Intel.

Install

macOS

  1. Download the matching DMG from Assets and open it in Finder.
  2. Drag Lightning Proxy into Applications. If Finder asks whether to replace an older copy, choose Replace.
  3. Eject the mounted disk image. In Finder, open Applications and double-click Lightning Proxy.
  4. If macOS asks whether you want to open an app downloaded from the internet, click Open. If it says the developer can’t be verified or Apple can’t check the app, follow the steps below.

If macOS blocks the first launch

Lightning Proxy 5.2 is distributed outside the App Store and isn’t Apple-notarized. Use these steps only for a copy you trust and downloaded directly from this release.

  1. Dismiss the alert after trying to open the app.

  2. Open the security panel for your macOS version.

    macOS version Where to look
    macOS 13 Ventura or later Apple menu → System Settings → Privacy & Security, then scroll to Security.
    macOS 11 Big Sur or macOS 12 Monterey Apple menu → System Preferences → Security & Privacy → General.
  3. Find the message about Lightning Proxy and click Open Anyway if it appears. Confirm the prompt and authenticate if asked. If the button is missing, try opening the app again and return to the security panel right away.

  4. After approval, open Lightning Proxy from Applications as usual.

Apple Support · Safely open apps on your Mac

If macOS says the app is damaged

Download the matching DMG again from Assets, then replace the copy in Applications and try again. If the same alert returns, report the exact message, your macOS version, and whether you used the Intel or Apple Silicon build. If macOS reports that the app will damage your computer, leave it blocked and report the alert.

First-time permission for TUN

When you first enable TUN or System Proxy, Lightning Proxy may request administrator approval to install its networking helpers. This prompt can appear after the app has already opened.

Windows

  1. Extract the entire ZIP to a folder.
  2. Open Lightning Proxy.exe from that folder. Keep the other files alongside it.
  3. When enabling TUN, approve the Windows administrator prompt if it appears.

Linux

  1. Extract the archive and open a terminal in the extracted folder.
  2. Install GTK 3 and WebKitGTK through your distribution’s package manager if either is missing.
  3. Run ./lightning-proxy.
  4. For TUN, run ./Setup-Tunnel.sh once from the extracted folder. Setup requires administrator access, and TUN requires /dev/net/tun.

Connect for the first time

  1. Import a vless:// profile or a compatible HTTPS subscription URL from your provider.
  2. Select the profile you want to use.
  3. Pick a connection mode and press Connect.
  4. Wait for the app to report the connection status before opening the apps you want to use.

Your imported profiles are saved locally and will be available after you close and reopen Lightning Proxy.

Choose a connection mode

Mode When to use it
TUN Use it for device-wide TCP and UDP routing, including apps that have no proxy settings of their own.
Local Proxy Use it when you want to configure an individual app. Enter 127.0.0.1 as the host and use port 10808 for SOCKS5 or 10809 for HTTP.
System Proxy · macOS Use it for apps that follow macOS proxy settings. Lightning Proxy restores your previous settings when you disconnect.

Troubleshooting

What you see What to check
The Mac app won’t open Check the processor type in About This Mac, then follow the macOS opening instructions for the alert you see.
The connection engine stops Quit Lightning Proxy and reopen it. On Windows and Linux, confirm that you extracted the entire archive and kept the bundled files together.
The gateway is reachable, but the tunnel times out Reimport your current subscription or request an updated profile from your provider. A successful TCP connection to the gateway only confirms that the server port is reachable.
Local Proxy works, but TUN doesn’t Check that the system approved the tunnel setup. On Linux, confirm that you ran ./Setup-Tunnel.sh and that /dev/net/tun exists.
A desktop app still can’t connect Confirm that Lightning Proxy is connected in TUN mode, then reopen the affected app. If the problem continues, report which app and operating system you’re using.

Need more help?

Visit the Lightning Proxy website for step-by-step installation instructions, help choosing a connection mode, and troubleshooting tips.

Report a problem

Open an issue on GitHub and include your operating system, processor type, Lightning Proxy version, connection mode, and exact error message. Remove subscription URLs, full VLESS links, and credentials from any screenshots or logs you share.

Made by Cheesy Studios.