Windows

This section describes how to install v2rayA on Windows. It should be noted that currently only one-click configuration system proxy is supported on Windows, not transparent proxy.

Use the installation package#

Method 1: Automatic installation through WinGet#

WinGet is a package manager launched by Microsoft for Windows 10 and newer operating systems.

winget install --id v2rayA.v2rayA

Method 2: Manually run the installer#

Download the installation package for Windows from GitHub Releases , such as installer_windows_inno_x64_2.0.1.exe , and follow the instructions to complete the installation.

Instructions#

After installing v2rayA through the installation package, v2rayA will run as a service. By default, it will start automatically. You can also manage the start and stop of v2rayA in the “Service” tab of the task manager. You can open the management page by running the desktop shortcut or directly visiting http://127.0.0.1:2017 .

Install binaries through Scoop#

Install v2rayA#

You need to install Scoop first, then you can install v2rayA from scoop.

Add Scoop repo:

scoop bucket add v2raya https://github.com/v2rayA/v2raya-scoop

Update Scoop information:

scoop update

Install:

scoop install v2raya

V2Ray core will be installed as a dependency package.

Run v2rayA#

Running in the foreground#

Open a CMD or PowerShell window and run:

v2rayaWin --lite

Running in the background#

Use the start-v2raya command run v2rayA, and use the stop-v2raya command to shut down v2rayA.

Auto-start#

Copy start-v2raya.cmd in scoop\shims directory to the “Startup” folder (usually located at C:\Users\YourUserName\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup ). Example commands are as follows:

Copy-Item -Path '~\scoop\shims\start-v2raya.cmd' -Destination '~\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup'

Manual installation#

Download v2rayA#

Download the binary for Windows (generally named like v2raya_windows_amd64_1.5.6.2.exe) from GitHub Releases or GitHub Action, then rename it to v2raya.exe (be careful not to lose the extension on Windows).

Download V2Ray Core#

Install V2Ray: https://www.v2fly.org/guide/install.html

After downloading the compressed package, unzip it.

Run v2rayA#

Suppose both v2rayA and v2ray are placed in D:\v2rayA :

D:\v2rayA\v2raya.exe --lite --v2ray-bin D:\v2rayA\v2ray.exe

Other Information#

The following assumes that v2rayA is installed through scoop, if it is installed manually, please pay attention to modify the path.

Run as a service (using WinSW)#

Using WinSW, you can run v2rayA as a service and start it automatically. Download WinSW and rename it to winsw.exe , put it in a directory you think is appropriate, and then create a new v2raya-service.xml in the same directory:

<service>
  <id>org.v2raya.v2raya</id>
  <name>v2rayA</name>
  <description>This service runs v2rayA.</description>
  <executable>C:\Users\YourHomeDir\scoop\apps\v2raya\current\v2rayaWin.exe</executable>
  <arguments>--lite</arguments>
  <log mode="roll"></log>
  <env name="V2RAYA_LOG_FILE" value="%v2raya.log%"/>
  <delayedAutoStart>true</delayedAutoStart>
  <onfailure action="restart" delay="10 sec"/>
  <onfailure action="restart" delay="20 sec"/>
  <serviceaccount>
    <username>.\YourUserName</username>
    <password>YourPassword</password>
    <allowservicelogon>true</allowservicelogon>
  </serviceaccount>
</service>

The username here is the username you see in Computer Management, not the full username you see in Control Panel or System Settings. The password is your local account password or Microsoft account password.

If v2rayA is manually installed, then you need to specify the --v2ray-bin parameter, or add v2ray to the path.

Save the file, then run (requires administrator privileges):

.\winsw.exe install .\v2raya-service.xml

Run as a service (using NSSM)#

Use NSSM - the Non-Sucking Service Manager to run v2rayA as a service and start it automatically. Download NSSM and place it in a suitable directory or use scoop to install NSSM.

scoop install nssm

Then install a service called v2raya as an administrator:

nssm install v2raya

At this time, an NSSM window will pop up: Path is v2rayA path C:\Users\YourHomeDir\scoop\apps\v2raya\current\v2rayaWin.exe ; Srartup directory can be left blank, and the default is the directory where v2rayA is located; Arguments fill in --lite --v2ray-bin C:\Users\YourHomeDir\scoop\apps\v2ray\current\v2ray.exe .

Other parameters that may be used: --log-file v2raya.log will generate a log file in Srartup directory and display it on the front end.

Finally run as administrator:

nssm start v2raya

nssm remove v2raya # delete service
nssm edit v2raya # Edit service
nssm start/stop/restart v2raya # start, stop, restart service

Running in background (hide window via PowerShell):#

Start-Process "v2rayaWin.exe" -Arg "--lite" -WindowStyle Hidden

If you want to output the log at the front end while running in the background, you need to specify the output file of the log in the parameter (here the specified working directory is %temp% directory of the current user), you can use the following powershell command:

Start-Process "v2raya.exe" -WorkingDirectory "~\AppData\Local\Temp" -Arg "--log-file v2raya.log" -WindowStyle Hidden

Run in the background (using ConEmu)#

ConEmu is a terminal program under Windows. Right-clicking the minimize button on its window can make it minimize the window to the tray area. In the PowerShell session in ConEmu, use the command mentioned in the [Direct Run]({{< ref “#Direct Run” >}}) item to run v2rayA.

system proxy#

Turn on system proxy#

v2rayA currently only supports system proxy on Windows, you can enable System Proxy in the web interface to enable it.

Let the UWP application go through the proxy#

Reference content: https://github.com/Qv2ray/Qv2ray/issues/562

Windows has the problem that UWP applications cannot connect to the Internet after the system proxy is turned on. This is because for security reasons, UWP applications are not allowed to access the local loopback address by default, and most proxies will listen to the loopback address in order to provide socks and http proxy Entrance. In order to circumvent this problem, we need some tools, such as Fiddler’s Enable Loopback Utility or the open source project Loopback Exemption Manager . Alternatively, you can do this in bulk with the following PowerShell command, open a PowerShell window with administrator privileges, and run:

Get-ChildItem -Path Registry::"HKCU\Software\Classes\Local Settings\Software\Microsoft\Windows\CurrentVersion\AppContainer\Mappings\" -name | ForEach-Object {CheckNetIsolation.exe LoopbackExempt -a -p="$_"}

Reset password under Windows#

v2rayA installed by Scoop#

v2raya --reset-password

Replace the command with v2raya-unstable or v2raya-git according to the package you installed, and you need to restart v2rayA after password reset.

v2rayA installed by the inno installation package#

Open a PowerShell window with administrator privileges, and run:

sc.exe stop v2rayA
${env:V2RAYA_CONFIG} = 'C:\Program Files\v2rayA'
&'C:\Program Files\v2rayA\bin\v2raya.exe' --lite --reset-password
sc.exe start v2rayA