NekoRay 使用教程（2024版，已停更）

软件介绍

NekoRay

跨平台代理客户端，协议支持广（含 Hysteria 2），内置测试工具。

NekoRay（4.0 后更名为 NekoBox for PC）是一个基于 Qt/C++ 开发的跨平台代理客户端，后端用的是 sing-box 核心。它出自 MatsuriDayo 团队之手——这个团队也是安卓端热门软件 NekoBox for Android 的作者，算是同一套生态。本文以 Windows 版做演示。

一句话概括： 它是 PC 端支持协议最全的图形化代理客户端之一。除了 SSR 这类已经过时的协议，市面上主流的协议它基本都支持——VMess、VLESS、Trojan、Shadowsocks、Hysteria 2、TUIC、WireGuard、ShadowTLS……你能想到的它几乎都能跑。

项目背景： NekoRay 最早发布于 2022 年，当时市面上 Clash 系客户端一派独大，但 Clash 系只认 Clash 格式的配置文件。而 NekoRay 走的是图形化配置路线——你不需要写 YAML，直接在界面上填服务器地址、端口、协议，对习惯了 v2rayN 操作逻辑的用户来说更直观。

不过到了 2024 年底，作者宣布项目存档停更。GitHub 上 15,453 颗 Stars，下载量超 180 万，说明曾经有很多人在用。但现在核心不再更新，bug 不会再修，建议新用户选择其他活跃维护的替代品。

|技术特性： |- 基于 Qt 6.7 框架，原生界面性能好，内存占用比 Electron 类客户端低 |- 后端使用 sing-box 核心（4.x 版本），之前也支持过 Xray 核心 |- 支持 Windows 10+ 和 Linux（Debian/Arch 等），不再支持 Windows 7、macOS |- 完全免安装——下载 ZIP 解压就能用，不写注册表、不留系统垃圾，放 U 盘里随身带走

下载安装

下载链接

👉 NekoRay GitHub Releases

如果你不知道下载哪个文件，GitHub 上有个 安装包说明，简单介绍了各文件的区别。

各平台文件对照：

Windows 安装

1. 下载 windows64.zip
2. 解压到任意目录（建议不要放在系统盘以外的移动硬盘）
3. 运行 nekobox.exe（4.x 版本主程序名，旧版叫 nekoray.exe）

如果提示 DLL 缺失，需要安装 微软 C++ 运行库。

首次运行时 Windows 防火墙可能会弹出提示，点击 允许访问 即可。

Linux 安装

Debian/Ubuntu：

sudo dpkg -i nekoray-4.0.1-2024-12-12-debian-x64.deb

通用（AppImage）：

chmod +x nekoray-4.0.1-2024-12-12-linux-x64.AppImage
./nekoray-4.0.1-2024-12-12-linux-x64.AppImage

通用（ZIP 版）：

unzip nekoray-4.0.1-2024-12-12-linux64.zip
cd nekoray
./launcher

Arch Linux： 可以通过 AUR 安装：yay -S nekoray

使用教程

界面一览

NekoRay 的界面设计走的是"工具风"，不像 Clash 系那样有漂亮的仪表盘，功能按钮都直接摆在明面上，属于"功能第一，美观第二"的类型。

主窗口分几个区域：

• 顶部菜单栏： 程序、首选项、服务器等主要功能入口
• 中间区域： 服务器列表，显示类型、地址、名称、延迟测试结果
• 右上角： Tun 模式和系统代理开关，一键开启
• 底部面板： 日志和连接信息，可查看运行状态

导入订阅

这是用 NekoRay 的第一步，把机场给你的订阅链接加进去：

1. 点击顶部菜单 首选项 → 分组
2. 在分组管理窗口点击 新建分组
3. 分组类型选择 订阅，填写分组名称
4. 在"URL"栏粘贴你的订阅链接
5. 点击 确定 保存
6. 右键该分组，选择 更新订阅，服务器列表会自动加载

支持的订阅格式：

• ✅ Clash 格式（推荐，一般带流量信息）
• ✅ V2rayN 格式
• ✅ Shadowsocks 格式
• ✅ 通用分享链接及 Base64 编码格式
• ❌ SSR 格式（不支持）
• ❌ 苹果应用自创格式（不支持）

选节点并测试延迟

服务器加载到列表后，需要测试一下各节点的延迟，挑个快的用：

1. 选中一个或多个节点（按住 Ctrl 可以多选）
2. 点击顶部右侧的 URL 测试 按钮
3. 等几秒钟，列表的"测试结果"列会显示每个节点的延迟数值
4. 数值越低越好——100ms 以内很快，200~300ms 正常，不可用 就是连不上
5. 双击节点，或者右键 → 启动 即可选中使用

开启代理

选中节点后，需要通过系统代理让浏览器的流量走代理：

1. 确认已选中一个节点（双击或右键 → 启动）
2. 在顶部右侧勾选 系统代理 开关
3. 勾选后标题栏会显示当前使用的节点名称，说明代理已生效

验证方法： 浏览器访问 http://ip.sb 或 https://www.google.com，如果能正常打开说明代理配置正确。

开机自启（小白可选）： 点击顶部 程序 → 跟随系统启动，这样每次开机 NekoRay 会自动运行。

三种代理模式

NekoRay 虽然没有 Clash 系那种"规则/全局/直连"一键切换按钮，但通过路由设置可以实现同样的效果：

路由设置（规则代理）

想让国内网站直连、国外网站走代理，需要配置路由规则：

1. 点击顶部菜单 首选项 → 路由设置
2. 在打开的窗口中，切换到 简易路由 标签页
3. 在左下角 预设 下拉菜单中选择 绕过局域网和大陆
4. 点击 确定 保存

之后你还可以通过 管理路由规则 保存多套配置，在系统托盘的"当前路由规则"菜单里快速切换。比如存一套"全局"和一套"绕过大陆"，按需切换。

TUN 模式

TUN 模式比系统代理更"暴力"，它会接管系统的所有流量，包括那些不走系统代理的软件（比如游戏、命令行工具、UWP 应用）。

开启方法：

1. 在主界面右上角找到 Tun 模式 开关
2. 点击切换为开启状态（开关变蓝色）
3. 建议同时开启 流量探测（在路由设置中），让流量判断更准确
4. 可以开启 FakeDNS 加速 DNS 查询（在基本设置中）

目前支持在 Windows / Linux 自动配置 VPN，包括 TUN 接口和路由规则。

特色功能

相比其他 PC 端代理客户端，NekoRay 有几个比较独特的功能：

链式代理

这是 NekoRay 的核心差异化功能。你可以把多个代理服务器串起来，形成一个代理链。比如：

你的电脑 → ShadowTLS 节点（入口） → Shadowsocks 节点（出口） → 目标网站

设置方法：

1. 右键节点列表 → 手动输入配置 → 类型选择 链式代理
2. 点击 选择配置，依次选择链路中的节点
3. 可以用 交换 按钮调整顺序，垃圾桶 删除节点

链式代理的流量走向是从上到下，最后一个配置是出口。这种玩法在机场用户中不常见，但如果你有自己的服务器，喜欢折腾网络拓扑，这功能就很有意思。

核心切换（3.x 旧版）

在 3.x 版本中，NekoRay 支持在 Xray 和 sing-box 两个核心之间切换。4.0 版本移除了 Xray 支持，改为纯 sing-box。

设置位置： 基本设置 → 核心 → 选择核心

自定义出站 JSON

对于 GUI 界面不支持的特殊配置（如 WireGuard、完整配置的 ShadowTLS），可以直接写 JSON 出站配置。NekoRay 会把 JSON 合并到 sing-box 的配置中。

比如添加 WireGuard 出站：

{
  "type": "wireguard",
  "server": "你的服务器地址",
  "server_port": 12345,
  "local_address": ["10.0.0.2/32"],
  "private_key": "你的私钥",
  "peer_public_key": "对端公钥"
}

Clash API / Dashboard

NekoRay 支持启用 Clash API，配合 Clash Dashboard 面板查看流量和连接信息：

1. 基本设置 → 核心选项 → 启用 Clash API
2. 启动代理后，浏览器访问 http://127.0.0.1:9090
3. 也可以直接用现成的面板，如 Yacd-meta

不过注意，这个功能没有手机版 NekoBox 自带的 dashboard 那么方便，需要自己配置。

常见问题

Windows 上提示 DLL 缺失/无法运行？

安装 微软 C++ 运行库。这是 Qt 程序的通病，新装的 Windows 系统通常会缺少这个。

如何添加订阅？

首选项 → 分组 → 创建分组 → 分组类型：订阅，填入订阅 URL 后点确定，再右键更新即可。

为什么 macOS 用不了？

NekoRay 在 4.0 版本后不再支持 macOS。早期版本有 macOS 编译，但因为长期没人维护，编译困难且新系统上 bug 很多，作者已经放弃了。macOS 用户建议换用 Clash Verge Rev 或 FlClash。

CPU/内存占用高怎么办？

常见原因：

1. 路由和 DNS 配置错误造成回路
2. 网络不可用导致无限重试
3. 睡眠恢复后的程序异常

解决方法： 先关闭 TUN 模式试试。如果还不行，删除 config 目录重新配置。

如何卸载？

NekoRay 是绿色软件，删除整个程序目录即可完成卸载。配置数据在 nekoray/config 目录下，如果你要清空所有数据，也删掉这个目录。

支持 SSR 吗？

不支持。 作者明确说了不支持 SSR 格式。SSR 协议已经过时且不安全，如果你还在用 SSR 节点，建议换个机场。

如何检查更新？

由于网络问题，软件自带的检查更新可能失败。手动下载新版 zip，命名为 nekoray.zip 放在程序目录下，关闭主程序后运行 updater 即可升级。

NekoRay 和 NekoBox for Android 有什么关系？

同一个作者的作品。NekoBox for Android 是安卓端的代理客户端，基于 sing-box 核心，目前仍在更新（最新版 2026 年 2 月发布）。PC 端的 NekoRay 已经停更，但安卓端还在维护。

现在还有什么替代软件？

作者自己在 Releases 页面上推荐了：

• 机场订阅用户： Clash Verge Rev、FlClash、Mihomo Party
• Xray 核心用户： v2rayN

总结： NekoRay 是一款功能强大的 PC 端代理客户端，在协议支持广度上几乎没有对手。但项目已经停更，没有新功能也不会修 bug，所以只适合有基础、愿意折腾的用户，或者本来就是老用户在继续使用。新用户建议上 Clash Verge Rev 或 v2rayN，体验会更好。