适合这些人
- 电脑上还装着 NekoRay 或 nekobox.exe,想弄清楚要不要换、换哪个
- 机场新上了 AnyTLS 之类的节点,旧客户端连不上,想知道是不是客户端太老
用之前要知道
- 2025 年 3 月 17 日仓库被归档,简介写的是「不再维护,自寻替代品」,往后不会再有安全修复
- 这里不放下载按钮。网上还能搜到的安装包来路没法核对,新装不如直接装还在维护的客户端
- 4.0.1 内置的内核停在 sing-box 1.9.7-neko1,sing-box 1.12.0 才加入的 AnyTLS 用不了
- 4.0 系列改用 Qt 6.7.2 编译,不再支持 Windows 7 和 macOS
2024 年 12 月发完 4.0.1,2025 年 3 月归档
NekoRay 出自 MatsuriDayo,仓库建于 2022 年 5 月,用 C++ 和 Qt 写,README 的标题叫 NekoBox For PC。它只管界面和配置,连接交给内核去跑,3.10 以前用 v2ray-core,3.10 到 3.26 用 Xray,4.x 只剩 sing-box。
4.0.1 是它的最后一版,发布于 2024 年 12 月 12 日,主程序从这一版起改名 nekobox.exe。2025 年 3 月 17 日仓库被归档,简介开头换成了「不再维护,自寻替代品」。我在 2026 年 9 月 20 日又看了一次,仍是这个状态。
旧版还能打开,缺的是后续修补
归档不会让装好的程序马上失效,麻烦在以后。4.0.1 内置的内核是 sing-box 1.9.7-neko1,sing-box 到 1.12.0 才有 AnyTLS,机场换上这类节点,NekoRay 只能干瞪眼。安全漏洞同样没人补,本站因此不提供它的下载入口。停更客户端的风险,这篇讲得更细。
换 v2rayN,或者看社区延续版 Throne
本站列的接替者是 v2rayN。它同样能调 sing-box,另外带着 Xray,读的也是分享链接订阅,把机场订阅重新导入一次就能用,步骤见它的 Windows 教程。
想留在熟悉界面的人,可以看 GitHub 上的 Throne。它的 README 在 FAQ 里交代了来历,NekoRay 作者 2023 年 12 月起就基本放下了项目,Throne 要接着原来的路子做下去。它 2026 年 9 月发了 1.3.0 正式版,本站还没有写它的教程。
Windows 图文教程
NekoRay 3.26 Windows 用法,订阅、测速到系统代理
NekoRay 已经停更,本站不提供下载,这份教程只给电脑上还留着旧版的人对照。截图是 2023 年 12 月的 3.26 版,从首次启动选内核讲到勾上系统代理,最后说怎么把订阅搬到 v2rayN。
开始之前
- 电脑里还留着的 NekoRay 旧版,整个文件夹放在不需要管理员权限就能写入的位置
- 机场给的订阅链接。README 写的是能读 Shadowsocks、Clash、v2rayN 几种常见格式
- 打算长期用的话,先看本页上方的停更说明,新装请直接选 v2rayN
确认手里的旧版,缺运行库先补上
NekoRay 没有安装程序,解压出来的文件夹就是全部。截图里的包解压在 D 盘,文件夹名是 nekoray-3.26-2023-12-09-windows64。本站不提供下载,也不建议再去网盘找安装包。双击提示 DLL 缺失时,README 给的办法是装微软的 C++ 运行库。4.0.1 起主程序改名 nekobox.exe,内核只剩 sing-box。
认准纸箱猫图标,双击启动
认图标最快,蓝头发、戴猫耳的小人蹲在纸箱里,那就是 nekoray.exe,双击启动。NekoRay 把配置存在自己的文件夹里,备份或者换电脑时拷走整个文件夹即可,首选项菜单末尾的打开配置目录能直接跳到存配置的地方。

首次设置里选一个内核
第一次运行会先弹出首次设置,第一行提示看来您是第一次使用该软件,请选择内核,第二行小字说这些设置可以稍后更改,选错了也能回头改。底下的按钮从上到下是 Xray、sing-box、退出。4.x 以后只剩 sing-box,拿不准就选它。

认识主窗口和底部的两个端口
选完内核进入主窗口,窗口标题的括号里写着 3.26-2023-12-09。工具栏六个按钮从程序排到更新,右侧两个勾选框是 Tun 模式和系统代理。列表按类型、地址、名称、测试结果、流量分列,下方有日志和连接两个标签。最底下一行,左边的未启动说明还没有节点在跑,中间列着 Socks 端口 2080 和 HTTP 端口 2081。

防火墙弹窗里勾专用网络,点允许访问
弹窗标题是 Windows 安全中心警报,名称和发布者都写着 nekoray,路径指向刚才解压的文件夹。下面两个勾选框决定放行到哪类网络,截图只勾了公用网络,Windows 自己在括号里注明这一项不推荐。家里的网络勾专用网络就够了,再点允许访问。

从首选项菜单打开分组
订阅的入口藏在首选项里。点工具栏第二个按钮首选项,菜单最上面的分组就是它。截图的日志区此时写着导入了 0 个配置,列表也是空的,还没有任何节点。改本地端口要去同一个菜单里的基本设置,改分流规则去路由设置。

在分组窗口点新建分组
这个窗口列出所有分组,现在只有一行,粉色的基本 (0) 后面跟着默认两个字,括号里是节点数,手动添加的节点放在这里。点左下角的新建分组,给订阅单独开一个。旁边的更新所有订阅,等订阅加进来以后再用。

类型选订阅,URL 栏贴订阅链接
编辑分组分成通用和订阅上下两块。名称随便起,类型保持订阅,下面的 URL 贴上机场的订阅链接,跳过自动更新那一格空着,然后点确定。订阅链接谁拿到都能用你的流量,截图外发前记得遮住。

按更新订阅,让 NekoRay 去拉节点
新分组出现在基本 (0) 下面,标着订阅 (0),右边比默认分组多了一个更新订阅按钮。按下去,NekoRay 就去下载节点,成功后括号里的数字会变成节点数。截图里名称和地址都打了码,你那边能看到自己填的内容。

关掉分组窗口,切到新标签看节点
订阅里的节点不会出现在默认标签下。关掉分组窗口后,主窗口列表上方多了一个标签,截图用红箭头指着它,点进去才看得到节点,协议有 VMess 和 Trojan 两种。下方日志里以 [+] 开头的每一行,都是这次新加进来的节点。

右键当前分组,跑一遍 Url Test
右键菜单里和测速有关的都收在当前分组下面。点开这个子菜单,第二项 Url Test 就是要用的,快捷键 Ctrl+Shift+U。第一项 Tcp Ping 只看端口能不能连上,Url Test 会借节点真的访问一次网页,结果更靠谱,数字写进测试结果那一列。同一个子菜单里还有删除不可用的配置,测完可以用它清掉超时的节点。

选中延迟低的节点,按回车启动
测试结果有数字的节点都能用,挑一个数字小的选中,按回车。也可以右键点启动,菜单上标的快捷键就是 Return。节点跑起来以后,窗口左下角不再显示未启动。要停下来就用右键菜单里的停止,快捷键 Ctrl+S。
勾上系统代理,看标题栏有没有变化
系统代理这一格勾上以后,标题栏最前面会加上 [系统代理],这是判断它开没开的最快办法。拿截图对照时留意左下角,它还写着未启动,也就是勾了代理却没有节点在跑,浏览器这时打不开网页。所以顺序是先启动节点,再勾系统代理。旁边的 Tun 模式管的是不读系统代理的程序,差别在这里。
![标题栏以 [系统代理] 开头,工具栏右侧系统代理已勾选并被红框标出,左下角仍显示未启动](/img/jiaocheng/nekoray/windows/11.webp)
打开网页,再看连接标签
浏览器打开一个平时需要代理的网站,能加载就说明成功。回到 NekoRay,点日志旁边的连接标签,刚才访问的网站会出现在列表里。想换节点,直接在列表里选另一个按回车,系统代理那一格保持勾着就行。
这一步卡住了
双击 nekoray.exe 没反应,或者弹出缺少 DLL 的提示
按 README 的说法,缺 DLL 就去装微软的 C++ 运行库。NekoRay 是便携包,这类系统依赖不会随包附带。运行库装好了还是打不开,说明这套旧文件本身有问题,本站建议直接换 v2rayN。
系统代理打了勾,浏览器还是转圈
按顺序查三处。标题栏有没有 [系统代理],没有就是勾选没生效。左下角是不是未启动,是的话选节点按回车。节点跑着却打不开网页,就右键当前分组跑 Url Test,全部没结果的话回分组窗口更新订阅。
点了更新订阅,新标签里一个节点都没有
去日志区看最后几行。有网络错误字样,是订阅地址没取到,换个网络,或者先让一个能用的节点跑起来再更新。取到了却一个都没导入,多半是格式不对,README 列的是 Shadowsocks、Clash、v2rayN 等常见格式,到机场后台换一条再试。
想从 NekoRay 搬到 v2rayN,要做哪些事
机场账号和订阅都不受影响。到用户中心复制一条分享链接格式的订阅,照 v2rayN 的 Windows 教程 添加,NekoRay 里的分组不用导出。v2rayN 能用以后,退出 NekoRay 并关掉它的系统代理,免得两个程序抢着改。
关于 NekoRay 的常见问题
NekoRay 是哪天停更的
4.0.1 是它的最后一个版本,发布于 2024 年 12 月 12 日,仓库的最后一次推送也在这一天。2025 年 3 月 17 日作者把仓库归档,改成只读,简介换成了「不再维护,自寻替代品」。此后没有新版本。
nekobox.exe 和 nekoray.exe 是同一个软件吗
是同一个。4.0.1 的更新说明写明主程序从这一版起改名为 nekobox.exe,之前叫 nekoray.exe,README 的标题写的也是 NekoBox For PC。两个文件名都指这个已经停更的电脑客户端。
Windows 7 上还能用 NekoRay 吗
4.0 系列用不了。4.0.1 的更新说明写明编译换成 Qt 6.7.2 以后放弃了 Windows 7 和 macOS,Win7 只能退回 3.x,那是更老的代码。社区延续版 Throne 的 README 把 Windows 7 列在支持的系统里,老电脑可以去它的发布页看看。
从 NekoRay 换到 v2rayN,节点要重新弄吗
重新导入一次机场订阅最省事。NekoRay 能读 Shadowsocks、Clash、v2rayN 几种订阅格式,v2rayN 最顺手的是分享链接那种。原来用的是 Clash 订阅,就到机场后台换一条分享链接格式的,再按 v2rayN 的教程添加。
Throne 和 NekoRay 是什么关系
Throne 由 throneproj 维护,README 的 FAQ 说 NekoRay 作者从 2023 年 12 月起基本放下了项目,Throne 要沿着原项目的方向继续做。它同样用 sing-box,支持 Windows、Linux 和 macOS,2026 年 9 月发了 1.3.0。
