Skip to content

Nekoray

Before we begin, note that there are two installation options depending on your needs:

  • If you only need the proxy to work in a browser, any version of Nekoray will do.
  • If you need to proxy specific applications, we recommend using versions 3.24 or 3.25.

This is because in version 3.26, the "Whitelist Mode" in Tun Mode settings does not work. As a result, you won’t be able to proxy only specific applications.

Install

Installing and Configuring Nekoray

Here is a list of all available download links for Nekoray, categorized by operating system:

  • Nekoray for Windows (64-bit)
  • Nekoray for linux (64-bit, archive)
  • Nekoray for Linux (AppImage)
  • Nekoray for Debian/Ubuntu (64-bit, package .deb)
  • Nekoray for Android

Installing Nekoray on Windows

Next, we will look at the installation process for Nekoray on Windows. Some steps may vary depending on the system, but the overall process remains the same.

Step 1: Download Nekoray

Step 2: fter the download is complete, follow these steps:

  • Locate the downloaded file: nekoray-3.26-2023-12-09-windows64.zip.
  • Right-click on the file and select "Extract All…", or use an archiving tool like WinRAR or 7-Zip to extract the contents to a convenient location on your computer.

Step 3: Launching the Program

  1. Open the folder with the extracted files.
  2. Locate the file nekoray.exe.
  3. Double-click it to launch the program.

The program works out of the box. No installation is required.

Initial Setup of Nekoray

  1. Core Selection:

When you launch the program for the first time, make sure to select the sing-box core.

Nekorayselectcore

This is necessary for proper functionality. If you were not given this choice or selected something other than sing-box, you can check or change it in the settings:

  • Click on Settings
  • General Settings
  • Navigate to the Core tab
  • Select sing-box.
  1. Adding a Profile

  2. Copy the profile link for the VPN connection.

  3. Paste it into Nekoray using the shortcut Ctrl + V or through the menu:
    - Click on the Server button.
    - Select the option Add Profile from Clipboard.

AddProfileNekoray

Now we have three scenarios:

  1. If you only need to proxy the browser. This works for any version.

  2. If you need everything to be proxied, select "TUN Mode". We’ll go into more detail about configuring this below. This is only relevant for version 3.26.

  3. This scenario involves configuring TUN Mode for specific programs. This is only relevant for versions 3.24 and 3.25.

Scenario 1

System Proxy mode

  • Right-click on the profile.
  • Select Start.
  • At the top, you will see System Proxy Modeturn it on.

NekoProxy

Done.

Scenario 2

For 3.26 version

  1. Go to the Settings tab.
  2. Open TUN Mode Settings.
  3. Configure the following:
    - Stack: Mixed
    - MTU: 1500 (you can leave it at 9000, but we recommend 1500).
    - Mode TUN: Turn off.
    - Enable Whitelist Mode (although in version 3.26, it doesn’t work properly — or at all).

nekoraytunsettings

Next:

  • Right-click on the profile.
  • Select Start.
  • At the top, you will see TUN Mode — turn it on. You will be prompted to restart the program as an administrator. Confirm.

Nekoraytunmode

Done.

Scenario 3

  1. Go to the Settings tab.
  2. Open TUN Mode Settings.
  3. Configure the following:
    - Stack: Mixed
    - MTU: 1500 (you can leave it at 9000, but we recommend setting to 1500).
    - Mode TUN: Turn off.
    - Enable Whitelist Mode.

Now, in the second column, Proxy Processes, enter the processes you want to proxy.

Example:
Discord.exe
Updater.exe (for Discord)
firefox.exe
etc.

nekoraytunsettings

Next:

  • Right-click on the profile.
  • Select Start.
  • At the top, you will see TUN Mode — turn it on. You will be prompted to restart the program as an administrator. Confirm.

Nekoraytunmode

Done.

  • Google Chrome: chrome.exe
  • Yandex Browser: browser.exe
  • Mozilla Firefox: firefox.exe
  • Microsoft Edge: msedge.exe
  • Opera Browser: opera.exe
  • Safari (Windows): safari.exe
  • Brave Browser: brave.exe

Source

Aéza