Skip to content

Nekoray#

??? note "Sources" Aéza

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

This is because no matter what version of an original Nekoray, the "Whitelist Mode" in Tun Mode settings does not work for everyone in our team. 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 original 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 or older.

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.
    although in original versions of nekoray, whitelist/blocklist doesn’t work 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

Initial Setup of Nekoray fork#