If macOS blocks v2rayN the first time you open it, check the download source, processor type, and exact warning. Only allow this app to open if you trust its source and macOS offers an “Open Anyway” option. Once the main window opens, configure the system proxy if needed. This guide also explains how to tell network extension permissions apart from VPN configuration requests and standard proxy settings, and how to restore your original settings if your connection drops.
First launch: Verify the source before allowing the app
Gatekeeper checks apps before they launch. “Apple could not verify the developer” or “Apple cannot check the app for malicious software” means macOS could not complete the relevant verification; it does not guarantee the app is safe. If you cannot verify the source, stop here. If you trust the download source, decide whether to accept the risk of allowing this app to open.
Check your processor
Open the Apple menu → About This Mac. If it lists an Apple chip, choose ARM64. If it lists a Processor, choose x64. Make sure you’re opening the installer you just downloaded, not an older copy in your Downloads folder.
Move the app to Applications
Open the downloaded DMG and drag v2rayN into Applications in Finder. After it finishes copying, open the copy from Applications rather than running it from the disk image. If macOS asks whether to replace an existing app, first decide whether you need to keep the older copy.
Read the warning carefully
If macOS blocks the first launch, note the app’s name and the full warning, then close the dialog. If macOS explicitly reports malware or says the app is damaged, stop using that file, cancel the installation, and get a fresh copy from a trusted source. Don’t treat those warnings as routine developer verification prompts.
Allow this app to open
On recent versions of macOS, go to Apple menu → System Settings → Privacy & Security, then scroll down to Security. Confirm the blocked app is v2rayN, click Open Anyway, authenticate if prompted, then click Open in the confirmation dialog. Button labels may vary by macOS version.
Confirm that it launches
Check that the v2rayN main window opens. If the app opens but reports an error only when connecting, troubleshoot using the client logs; don’t repeat the first-launch approval steps. If Open Anyway isn’t available, try opening it once from Applications, then check Settings again. On managed devices, contact your administrator.
The version numbers above identify the interface; they do not indicate the minimum macOS version supported by the current client. Don’t disable system protections to make the approval button appear, and don’t treat an exception for one app as advance approval for future updates.
Choosing between the system proxy and network extensions
Allowing an app to open and authorizing it to change network settings are separate steps. First, launch the client and select a configuration to test, then enable only one connection method. If a browser can’t open a webpage, this makes it easier to tell whether the core failed to start, the system proxy wasn’t set, or another network component took over traffic.
Start with the system proxy
RecommendedIn v2rayN, open the System Proxy menu at the bottom and select Set system proxy. This configures the macOS proxy settings for apps that follow the system proxy; apps that manage their own proxy or connect directly may not use it. If you’re only testing a browser, you don’t need to enable TUN at the same time.
Best for: Testing a connection for the first time and using apps that follow the system proxy
Use TUN only when needed
TUN uses a virtual network interface to receive traffic; its coverage depends on the routing configuration. Consider enabling it only if the system proxy doesn’t cover the app you need and your client build supports TUN. First-time setup may require additional permissions, but a permission prompt alone doesn’t prove that the client uses a system network extension.
Best for: After confirming the basic connection works, routing traffic from apps that don’t follow the system proxy
If macOS asks to add a VPN configuration or allow a network extension, check the app name in the prompt against the action you just took. Allow it only if you deliberately enabled the relevant feature, the name matches, and you understand how traffic will be handled. If an unfamiliar extension request appears while you’re only testing the standard system proxy, cancel it and check the TUN toggle and client logs. Follow your organization’s instructions on company- or school-managed devices.
Check proxy settings and permissions
System proxy
- In the client
- System Proxy → Set system proxy
- In macOS settings
- System Settings → Network → current connection → Details → Proxies
- Address and port
- The loopback address is usually
127.0.0.1; check the port against the client’s current local listening settings
Don’t enter the remote server’s address and port as the system proxy; this setting connects to the client running on your Mac.
Additional network permissions
- When prompted
- When you enable a feature that requires additional permissions
- Check extensions
- On macOS 15, check network extension entries under System Settings → General → Login Items & Extensions
- Check configurations
- If prompted to add a VPN configuration, search for “VPN” in System Settings and verify the name of the new entry
Network extension approval and VPN configurations are separate settings; respond only to the request related to the action you’re taking.
Before switching, note the current proxy settings for the network service, including enabled switches, server, and port—especially any automatic proxy settings managed by your organization. Before testing, check the core logs for startup failures or port conflicts, then retry the connection in your browser. After switching Wi-Fi networks or moving to Ethernet, check the newly active network service rather than relying on proxy settings left on the previous one.
Installation and connection FAQs
Why can’t I find “Open Anyway”?
First, confirm which copy of the app was blocked. Open the copy of v2rayN in Applications from Finder, then check the bottom of Privacy & Security. If the button still isn’t there, note your macOS version and the exact warning, and check whether device management restrictions apply. Don’t try to bypass warnings that say the app contains malware or is damaged.
Why does my browser work, but not the terminal?
The system proxy works only if an app uses it. Check whether the tools you run in Terminal have their own proxy settings or environment variables; don’t assume that a working browser means every app is proxied. If you need to route traffic from other apps, test TUN separately and note the difference before and after enabling it.
What if webpages still won’t load after I set the proxy automatically?
Restore your original proxy settings first and confirm that your basic network connection works. Restart v2rayN and check the logs for listening errors, then verify that the proxy port for the active network service matches the port listening on your Mac. If the settings and listener match, check for connection errors in the selected configuration. Repeatedly granting permissions won’t fix a remote connection issue.
I just denied a permission. Do I need to reinstall?
Not necessarily. If the main window opens, check whether you denied permission to change network settings or to add a network configuration, then trigger the relevant action again in the client. You can leave TUN off if you’re only testing a browser. If macOS says the setting is managed by your organization, share the exact message with your administrator.