1. 首页
  2. 机场客户端下载与教程
  3. NekoRay教程
纳兰迦 · 机场客户端下载与教程

NekoRay下载与使用教程

已经归档停更的 Qt 桌面客户端,原作者写明不再维护,新手别装

  • 老牌客户端,装之前先看正文里的现状说明

NekoRay 已经停更了。2026-11-19 我打开它的官方仓库 MatsuriDayo/nekoray,页面顶上挂着归档提示,仓库在 2025 年 3 月 17 日被作者设成只读,简介的头一句是“不再维护,自寻替代品”。最后一次发布停在 2024 年 12 月 12 日。谁来接手,作者没有指定,仓库首页和简介里我都没找到后继项目的说明。

纳兰迦

雷达扫了一圈,这个仓库没有动静了,换一个。

它本身是一个用 Qt 写的桌面代理配置管理器,开源,许可证 GPL-3.0,免费。仓库首页现在的标题是 NekoBox For PC,写着后端用 sing-box,开箱即用的系统只有 Windows 和 Linux。最后一版的发布说明讲得更直接,内核不再支持 Xray,Win7 和 macOS 用户请放弃,还说它是给有基础的人调试节点用的工具,机场用户建议换别的软件。

我不建议新手装它。停更的客户端,内核不会再跟着新协议更新,出了安全问题也没人修。在 Windows 上想要同一类用法,也就是节点表格、分组订阅、Xray 和 sing-box 可选,装还在更新的 v2rayN。想省事就看 Clash Verge Rev 或 FlClash,几种客户端的差别写在客户端怎么选里。下面的步骤留给电脑上已经装着它、暂时还要用的人。

Windows 上怎么用 NekoRay

官方的安装包在那个归档仓库的发布页上。Windows 选文件名以 windows64.zip 结尾的压缩包,没有安装程序,解压就用。仓库首页提醒过,启动时提示缺少 DLL 就去装微软的 C++ 运行库。

本站这组截图截的是 2023 年 12 月的 3 系列。那时主程序叫 nekoray.exe,内核能在 Xray 和 sing-box 里二选一。最后一版把主程序改名成 nekobox.exe,内核只剩 sing-box,你看到的界面和截图会有出入。订阅链接从你自己的机场后台复制,还没有订阅就先看2027机场推荐。

  1. NekoRay Windows 第 1 步 NekoRay 软件图标
    1NekoRay 软件图标

    解压后文件夹里的主程序用的是这个图标,一个从纸箱里探出头的蓝发猫耳小人。双击它启动。

  2. NekoRay Windows 第 2 步 NekoRay 主界面与日志区域
    2NekoRay 主界面与日志区域

    主窗口上方一排按钮依次是程序、首选项、服务器、推广、文档、更新,右边有“Tun 模式”和“系统代理”两个勾选框。底部显示本地端口,Socks 是 127.0.0.1:2080,HTTP 是 127.0.0.1:2081,左下角写着“未启动”。

  3. NekoRay Windows 第 3 步 首次设置选择 Xray 或 sing box 内核
    3首次设置选择 Xray 或 sing box 内核

    3 系列头一回运行会弹这个窗口让你选内核。最后一版只剩 sing-box,这里就选 sing-box,窗口上也写了以后可以改。

  4. NekoRay Windows 第 4 步 Windows Defender 允许网络访问
    4Windows Defender 允许网络访问

    头一回运行时 Windows 防火墙会弹一次警报。看一眼“路径”那一行,确认它指向你解压的文件夹,再点“允许访问”。

  5. NekoRay Windows 第 5 步 首选项中的分组入口
    5首选项中的分组入口

    机场订阅要先建分组。点上方的“首选项”,再点下拉菜单头一项“分组”。

  6. NekoRay Windows 第 6 步 分组面板新建分组
    6分组面板新建分组

    分组窗口里一开始只有一个“默认”分组。点左下角的“新建分组”。

  7. NekoRay Windows 第 7 步 编辑分组并填写订阅 URL
    7编辑分组并填写订阅 URL

    “名称”随便起一个,“类型”选“订阅”。把从你自己的机场后台复制的订阅链接粘到 URL 一栏,点“确定”。

  8. NekoRay Windows 第 8 步 分组面板更新订阅
    8分组面板更新订阅

    回到分组窗口,新分组那一行多出一个“更新订阅”按钮,点它。右下角的“更新所有订阅”是给同时有好几个订阅的人用的。

  9. NekoRay Windows 第 9 步 订阅更新后的节点列表
    9订阅更新后的节点列表

    关掉分组窗口,主界面“默认”旁边多了一个以分组名命名的标签,点它,节点列表就出来了。下方日志里每个 [+] 开头的行是一个刚导入的节点。

  10. NekoRay Windows 第 10 步 执行 URL Test 延迟测速
    10执行 URL Test 延迟测速

    在节点列表里点右键,选“当前分组”,再选“Url Test”,跑完后“测试结果”一列会出现延迟数字。挑一个数字小的节点,选中后按回车启动,右键菜单里的“启动”是同一个动作。

  11. NekoRay Windows 第 11 步 开启系统代理
    11开启系统代理

    勾上按钮栏右边的“系统代理”,窗口标题最前面出现“系统代理”几个字,浏览器从这时起走代理。不用的时候把这个勾取消。

下载和官方仓库

官方仓库是 https://github.com/MatsuriDayo/nekoray,已经归档,只读。发布页 https://github.com/MatsuriDayo/nekoray/releases 上的旧版本还能下载。最后一版有四个文件,Windows 用的是以 windows64.zip 结尾的那个,其余三个是给 Linux 的 debian-x64.deb、linux-x64.AppImage 和 linux64.zip。

本站不提供安装包。别去其他下载站找所谓的新版 NekoRay,原仓库归档以后官方没有再发过任何东西。版本号我这里不写,以官方发布页为准。还没装的人直接看 v2rayN,其他系统到机场客户端下载与教程里找。

常见问题

NekoRay 还在更新吗

不更新了。官方仓库在 2025 年 3 月 17 日归档,简介写着不再维护,最后一次发布是 2024 年 12 月 12 日。这几条是我 2026-11-19 在仓库页面上核对到的。

NekoRay 停更后用什么替代

Windows 和 Linux 上我会换成 v2rayN。它同样是节点表格加分组订阅的用法,Xray 和 sing-box 两个内核都带,仓库还在发新版。想换成 Clash 系的界面,看 Clash Verge Rev。原作者只留下一句让大家自己找替代品,没有点名任何项目。

NekoRay 和 NekoBox 是同一个软件吗

桌面端是同一个。NekoRay 仓库首页现在的标题就是 NekoBox For PC,最后一版把主程序的文件名也从 nekoray.exe 改成了 nekobox.exe。

NekoRay 提示缺少 DLL 打不开怎么办

去装微软的 C++ 运行库,这是仓库首页写的办法,装完再启动。装了还是打不开的话,我的建议是别在一个停更的软件上继续花时间。

TO BE CONTINUED下一个客户端 Clash for Windows教程