Install v2ray-core

step 1: Add official tap

brew tap v2ray/v2ray

step 2: Install v2ray-core:

brew install v2ray-core

Update v2ray-core

step 1: update tap

brew update

step 2: update v2ray-core

brew upgrade v2ray-core

Uninstall v2ray-core

step 1: uninstall core

brew uninstall v2ray-core

step 2: untap official formula

brew untap v2ray/v2ray


once you installed, you can run command via v2ray to run v2ray-core.

The defualt config file location is:/usr/local/etc/v2ray/config.json

step 1: edit the default config:

vim /usr/local/etc/v2ray/config.json

step 2: run v2ray-core without starting at login.

brew services run v2ray-core

or run v2ray-core and register it to launch at login via:

brew services start v2ray-core


To have launchd start v2ray/v2ray/v2ray-core now and restart at login:

  brew services start v2ray/v2ray/v2ray-core

Or, if you don't want/need a background service you can just run:

  v2ray -config=/usr/local/etc/v2ray/config.json

==> Summary

🍺  /usr/local/Cellar/v2ray-core/4.19.1: 7 files, 34MB, built in 9 minutes 46 seconds