· Platform Setup · About 8 minutes

v2rayN macOS installation: Fix “Apple Could Not Verify” and Grant Network Permissions

Fix the “Apple could not verify” warning when opening v2rayN on macOS, allow the app in Privacy & Security, and learn how to handle system proxy and network extension prompts.

At a glance

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.

  1. 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.

  2. 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.

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

  4. 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.

  5. 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.

macOS 13
Uses the name “System Settings”
macOS 15
From this version onward, Control-clicking is no longer the way to bypass this type of verification block

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

Recommended

In 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.

Download the client