NekoRay

Qt based Desktop cross-platform GUI proxy configuration manager (backend: sing-box)

Supports Windows / Linux / MacOS out of the box now. Windows7 is also supported, but requires some additional changes to run.

Notes on the new versions on Windows

The newest versions of Nekoray are built using the latest compilers and Qt releases, and so they need the latest vc_redist installed. If the app does not start and crashes, please make sure to update it. Also few anti-virus apps may identify the nekobox_core.exe as trojan, this is caused by the newely added code which can be used to alter the system DNS settings to hijack all dns requests to Nekoray to route them. Some apps may also report updater.exe as trojan, this is also a false alarm caused by updater having to delete the old Nekoray files and replacing it with the new ones, which is like what many viruses do to replace your files with encrypted ones for ransoming purposes.

How to run on Windows7

To run on Windows7, you will need to utilize VxKex. Some of Tun mode stacks might not work as well, please fallback to gVisor stack if you encountered this problem.

Compatiblity issues on Linux Distros

Since every Distro of Linux has its own set of libraries, you might need to manually install some packages in order for nekoray to run. Currently known libraries that might be missing: libxcb-cursor. Please make sure to install them if nekoray did not start.

Using Tun mode in MacOS

To use Tun mode in MacOS, you need to open the app as root.

Open the app like this:

sudo /Applications/nekoray.app/Contents/MacOS/nekoray

It will open a Nekoray instance with no configurations; if you have configured your Nekoray in normal mode, close the app and do this to copy them:

Note: Replace YOU with your username

sudo cp -r /Users/YOU/Library/Preferences/nekoray/ /private/var/root/Library/Preferences/nekoray

Now, you can open it with the first command.

GitHub Releases (Portable ZIP)

Proxy

• SOCKS (4/4a/5)
• HTTP(S)
• Shadowsocks
• VMess
• VLESS
• Trojan
• TUIC ( sing-box )
• NaïveProxy ( Custom Core )
• Hysteria ( Custom Core or sing-box )
• Hysteria2 ( Custom Core or sing-box )
• Custom Outbound
• Custom Config
• Custom Core

Subscription

We support widely used link formats(like Shadowsocks and v2rayN) as well as custom outbound and custom configs. The subscription file can contain commented lines(starting with // or #, empty lines are ignored as well), JSON strings(can be human-readable or compact) and import links(each link should be on a separate line).

Credits

Core:

• SagerNet/sing-box

Gui:

• Qv2ray
• Qt
• protobuf
• yaml-cpp
• zxing-cpp
• QHotkey