v2rayNCommunity guide
← Back to blog
Installation·7 min read·21 / 30

Install v2rayN on macOS: architecture and Gatekeeper

Choose Apple Silicon or Intel first, then handle unsigned-app prompts only after confirming the download came from the official repository.

Steps

  1. Open About This Mac. M-series Macs use macos-arm64; Intel Macs use macos-64. Recheck the current minimum macOS version in release notes.
  2. Download the official DMG or ZIP and place the app in Applications. Avoid third-party 'pre-signed' mirrors.
  3. If official documentation addresses a damaged-app warning, verify the source and run `xattr -cr /Applications/v2rayN.app`, then allow it in Privacy & Security.
  4. Test system proxy, DNS and sleep recovery before granting additional TUN permissions.

Why this matters

Architecture-specific binaries and Gatekeeper quarantine are separate issues. Verifying provenance before removing quarantine preserves both usability and security.

How to verify

The app launches, About shows the correct architecture, settings persist and exiting restores system proxy.

Things to watch

xattr removes quarantine metadata. Use it only for a file you verified; never disable Gatekeeper globally as a routine fix.

Official references

v2rayN Releases↗Release files introduction↗