Nekoray#
??? note "Sources" Aéza
Before we begin, note that there are two installation options depending on your needs:
- If you chose Reality method for your 3x-ui installation - you may use the original Nekoray.
- If you need to proxy specific applications, we recommend Mahdi-zarei's nekoray fork.
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
- Open the folder with the extracted files.
- Locate the file
nekoray.exe. - Double-click it to launch the program.
The program works out of the box. No installation is required.
Initial Setup of original Nekoray#
- Core Selection:
When you launch the program for the first time, make sure to select the sing-box core.
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.
-
Adding a Profile
-
Copy the profile link for the VPN connection.
- 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.
Now we have three scenarios:
-
If you only need to proxy the browser. This works for any version.
-
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 Mode — turn it on.
Done.
Scenario 2#
For 3.26 version
- Go to the Settings tab.
- Open TUN Mode Settings.
- 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
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.
