机场博客JICHANGBOKE.ORG

NekoRay 使用教程与停更说明

已停止维护sing-box 内核开源免费GPL-3.0

NekoRay 也叫 NekoBox for PC,是基于 Qt 的桌面代理客户端。仓库已在 GitHub 归档,作者写明不再维护,最后版本是 2024 年 12 月的 4.0.1。不建议新装,还在用的人可以换到 v2rayN。

作者 塔台君更新
×

NekoRay 已经停止维护。本站不提供它的下载入口,网上流传的安装包来源不明,有被植入恶意代码的风险。

还没装的话,直接用接替它的 v2rayN。下面的教程留给还在用旧版本的人参考。

官方来源

许可证
GPL-3.0

NekoRay 的 README 标题写的是 NekoBox For PC,两个名字指同一个软件。它由 MatsuriDayo 开发,仓库建于 2022 年 5 月,界面用 Qt 写,致谢名单里有 Qv2ray。它是代理配置管理器,协议交给背后的内核去跑。按 README 的记录,3.10 之前用 v2ray-core,3.10 到 3.26 用 Xray,4.x 换成了 sing-box

现在的状态

它已经停更。打开仓库能看到 GitHub 的归档标记,简介改成了一句话,不再维护,自寻替代品。最后一个正式版 4.0.1 发布于 2024 年 12 月 12 日,那天之后再没有提交,本站 2026 年 9 月 18 日核对时仍是这样。社区里有个延续项目叫 Throne,README 标题注明 Formerly Nekoray,9 月 17 日还在发版,本站暂时没有收录它。

停更的客户端不会再跟进新协议,内核出了安全问题也没人修,所以本站不给它提供下载入口,下面的图文步骤只留给还在用旧版的人对照。要换的话,v2rayN 同样支持 sing-box 和 Xray 内核,也吃分享链接订阅,迁移起来改动小。习惯 Clash 订阅的人可以看 Clash Verge Rev,更多选择在 Windows 客户端对比Linux 客户端对比里。

适合

  • 还在用 NekoRay 旧版,想确认它是否停更的人
  • 准备迁移,需要对照旧界面把节点和订阅导出来的人

要注意

  • 仓库已归档,作者在简介里写明不再维护,今后不会有安全更新
  • 本站不提供下载入口,网上流传的安装包来源不明,不要装
  • 4.x 只保留 sing-box 后端,按 3.x 写的内核选择步骤已经对不上

NekoRay Windows 使用教程

截图版本 3.26

NekoRay 的 GitHub 仓库在 2025 年 3 月 17 日被作者归档,简介写着不再维护,自寻替代品,新装的人请换 v2rayNClash Verge Rev。下面的步骤留给还在用旧版的人,截图是 2023 年 12 月的 3.26 版。它解压即用,流程是选内核、建订阅分组、更新订阅、测速、启动节点、勾系统代理。

开始前准备

  • 已经解压好的 NekoRay 旧版文件夹,截图里用的是 nekoray-3.26-2023-12-09-windows64 这个包
  • 机场的订阅链接,官方 README 写明它认 Shadowsocks、Clash 和 v2rayN 这几种常见格式
  • 系统里装有微软 C++ 运行库,缺的话启动时会提示 DLL 缺失

本站首推教程要用到机场订阅,还没有的话可以用 星岛梦-六年老牌专线,也可以到 机场推荐榜 里自己比。这是推广链接

  1. 已停止维护,不建议新装

    NekoRay 的仓库在 2025 年 3 月 17 日归档,作者在简介里写着不再维护,自寻替代品,最后一个版本是 4.0.1,此后不会再有修复。新装请换 v2rayN,手里是 Clash 订阅就换 Clash Verge Rev。下面的步骤只留给已经装了旧版的人。

  2. 双击 nekoray.exe 启动

    NekoRay 是便携软件,没有安装器。解压出来的文件夹里有一个 nekoray.exe,图标是纸箱里探出头的蓝发猫耳小人。双击它启动。配置就存在程序目录里,首选项菜单的打开配置目录可以直接打开,所以文件夹要放在一个固定、可写的位置。

    NekoRay 的程序图标,一个蓝发猫耳小人从纸箱里探出头
  3. 看懂主界面和日志区

    标题栏括号里是版本号,截图是 3.26-2023-12-09。上面一排按钮是程序、首选项、服务器、推广、文档、更新,右边有 Tun 模式和系统代理两个勾选框。中间是节点列表,下面是日志。底部是本地监听端口,Socks 2080,HTTP 2081。左下角的未启动是说还没节点在跑。

    3.26 版主界面,节点列表为空,底部显示两个本地监听地址
  4. 首次启动选择内核

    第一次打开会弹出首次设置窗口,让你在 Xray 和 sing-box 之间选一个内核,窗口里写着这些设置可以稍后更改。节点以 VMess、Trojan、Shadowsocks 为主的话两个都能用,节点里有 Hysteria2 或 TUIC 就选 sing-box。

    首次设置对话框提示选择内核,下方有 Xray、sing-box 和退出三个按钮
  5. 在防火墙弹窗点允许访问

    内核启动后,Windows 安全中心可能弹出警报,说防火墙阻止了 nekoray 的部分功能,路径指向你解压的文件夹,点允许访问。这个弹窗管的是别的设备能不能连进来,只在本机用,点取消也不影响上网。截图里勾的是公用网络,家里的网络一般算专用网络,按自己的情况勾。

    安全中心警报弹窗,程序名是 nekoray,允许访问按钮被红框标出
  6. 从首选项打开分组

    NekoRay 把订阅叫分组。点工具栏的首选项,下拉菜单第一项就是分组,点进去。菜单里其余几项是基本设置、路由设置、Tun 设置、热键设置和打开配置目录,改本地端口在基本设置里,改分流规则在路由设置里。

    首选项下拉菜单展开,第一项分组被红框标出
  7. 点新建分组

    分组窗口里默认只有一个叫默认的基本分组,括号里的数字是节点数,它用来放手动添加的节点。订阅要单独建一个分组。点左下角的新建分组。右下角的更新所有订阅,以后可以一次刷新全部机场。

    分组窗口里只有默认分组,左下角的新建分组按钮被红框标出
  8. 填名称和订阅 URL

    名称随便起。类型一栏要选订阅,下面才会有 URL 输入框。把机场的订阅链接粘贴进 URL,跳过自动更新不要勾,点确定。订阅链接等同于账号,发截图给别人之前记得把它遮住。

    编辑分组对话框,名称和订阅 URL 两处有红字标注,确定按钮被标出
  9. 点更新订阅拉取节点

    回到分组窗口,新建的订阅分组出现在列表里,名称下面显示订阅地址。点这一行右边的更新订阅,NekoRay 会去下载并解析节点,完成后括号里的数字从 0 变成节点数。数字一直是 0,多半是链接打不开或者格式不认,到主界面的日志里看报错。

    分组窗口里新增一个订阅分组,右侧的更新订阅按钮被红框标出
  10. 切到订阅分组看节点

    关掉分组窗口,主界面的默认标签旁边多了一个以分组名称命名的标签,点它。列表每行是一个节点,列出类型、地址和名称。日志区里一行行带加号的记录,就是这次更新新增的节点,最后一行写着删除了几个配置。

    主界面切到订阅分组标签,列表里是 VMess 和 Trojan 节点,地址已打码
  11. 对当前分组做 Url Test

    在节点列表里点右键,选当前分组,再选 Url Test,快捷键是 Ctrl+Shift+U。它让每个节点去访问测试网址,把延迟写进测试结果一列,比 Tcp Ping 更能说明节点能不能用。测完挑延迟低的节点,选中后按回车启动,右键菜单里的启动是同一个操作。

    节点右键菜单展开到当前分组子菜单,Url Test 一项被红框标出
  12. 勾选系统代理

    节点启动以后,勾上工具栏右边的系统代理,标题栏前面会多出系统代理几个字,浏览器开始走代理。截图左下角还写着未启动,这种状态下勾了也上不了网,要先回上一步启动一个节点。旁边的 Tun 模式会接管所有程序的流量,需要管理员权限才能开。

    标题栏带系统代理字样,工具栏右侧的系统代理勾选框已勾上并被标出

Windows 上常见的问题

双击 nekoray.exe 提示缺少 DLL,打不开

官方 README 给的办法是安装微软 C++ 运行库,也就是 Visual C++ Redistributable 的 x64 版本,到微软官网下载装好以后再打开。NekoRay 没有安装器,不会替你装这些依赖。

勾了系统代理,网页还是打不开

先看窗口左下角。写着未启动,说明还没有节点在跑,在列表里选一个节点按回车。节点启动了还不行,右键选当前分组里的 Url Test,测试结果一列没有数字的节点换掉。全部超时就回分组窗口点更新订阅。

更新订阅后节点数还是 0

到主界面日志区看最后几行。写着导入了 0 个配置,说明链接能打开但内容解析不了,README 列出的订阅格式是 Shadowsocks、Clash 和 v2rayN 这几种,换一条机场提供的其他格式链接再试。日志里是网络错误,说明订阅地址直连不通,要先连上一个能用的节点再更新。

NekoRay 常见问题

NekoRay 还能用吗

已经装好的旧版不会因为仓库归档就马上失效,但不建议继续用。最后一个版本 4.0.1 停在 2024 年 12 月 12 日,内核和界面都不会再更新。哪天内核曝出安全问题,或者机场换了新协议,旧版都跟不上。趁节点还能导出,早点换。

NekoRay 和 NekoBox 是什么关系

NekoRay 就是 NekoBox for PC,README 的标题直接这么写。同一个组织 MatsuriDayo 名下还有 NekoBox for Android,那是安卓上的另一个项目,2026 年 2 月还发过版。本页说的是电脑版,它已经停止维护。

NekoRay 停更后用什么代替

本站建议换 v2rayN。它同样是多内核桌面客户端,支持 sing-box 和 Xray,Windows、macOS、Linux 都有包,2026 年 9 月仍在每周更新。NekoRay 作者的原话是自寻替代品,没有指定接班项目。社区延续版 Throne 也在维护,只是本站还没有它的教程。

NekoRay 支持哪些协议

按 README 的列表,有 SOCKS、HTTP、Shadowsocks、VMess、VLESS 和 Trojan,TUIC 与 Hysteria2 通过 sing-box 支持,NaiveProxy 要外挂自定义内核。订阅能识别 Shadowsocks、Clash 和 v2rayN 几种常见格式。这份列表停在 2024 年底,不会再变长。

NekoRay 现在还能用吗

已经装好的旧版还能启动,节点照样能连。麻烦在后面,仓库 2025 年 3 月 17 日归档以后不会再有修复,内核停在当时的版本,机场上了新协议它就跟不上。还在用的人,建议把订阅搬到 v2rayNClash Verge Rev

NekoRay 和 NekoBox For PC 是什么关系

是同一个仓库里的同一个项目。作者 MatsuriDayo 在后期的 README 里把电脑端叫作 NekoBox For PC,介绍是基于 Qt 的跨平台代理管理器,后端用 sing-box,支持 Windows 和 Linux。这个仓库现在已经归档,两个名字指向的软件都不再更新。

从 NekoRay 换到别的客户端,订阅要重新买吗

不用重新买。订阅是机场给的,和客户端无关,到机场用户中心重新复制一次订阅链接,导入新客户端就行。换到 v2rayN 用通用订阅,换到 Clash Verge Rev 或 FlClash 用 Clash 订阅,机场面板里一般两种都有。