Release 下载NekoRay · GitHub Release 历史版本 · 三路反代镜像
最新正式版4.0.1本区块同步 NekoRay 的官方 GitHub Release，并为最近版本生成 三路反代镜像加速下载通道。 默认展开最新正式版；如果项目只有预发布版，会在版本旁单独标注。下载按钮会先进入本站确认页，可继续下载或复制真实链接。
怎么挑：Windows 优先 .exe / .msi；macOS 优先 .dmg；Linux 选 .deb / .rpm / .AppImage；Android 选 .apk；带 .sig / .asc / .sha256 的是校验文件，不是安装包。
下载慢：从右侧三路反代列里挑一个能通的点开；复制按钮复制真实目标链接，方便放进下载器。
为控制页面体积，本页只展示最近 5 个版本、每版最多 48 个文件；完整历史请查看 MatsuriDayo/nekoray Releases。
4.0.12024-12-124 个文件正式版
| 文件 / 平台 | 大小 | 官方直链 | 反代 · ghproxy.net | 反代 · ghfast.top | 反代 · mirror.ghproxy.com |
|---|---|---|---|---|---|
nekoray-4.0.1-2024-12-12-debian-x64.debLinux | 12.5 MB | 下载 | 加速 | 加速 | 加速 |
nekoray-4.0.1-2024-12-12-linux-x64.AppImageLinux | 42.7 MB | 下载 | 加速 | 加速 | 加速 |
nekoray-4.0.1-2024-12-12-linux64.zipLinux | 43.5 MB | 下载 | 加速 | 加速 | 加速 |
nekoray-4.0.1-2024-12-12-windows64.zipWindows | 39.8 MB | 下载 | 加速 | 加速 | 加速 |
Release 说明：https://github.com/MatsuriDayo/nekoray/releases/tag/4.0.1
4.0-beta42024-10-094 个文件预发布版
| 文件 / 平台 | 大小 | 官方直链 | 反代 · ghproxy.net | 反代 · ghfast.top | 反代 · mirror.ghproxy.com |
|---|---|---|---|---|---|
nekoray-4.0-beta4-2024-10-09-debian-x64.debLinux | 13.4 MB | 下载 | 加速 | 加速 | 加速 |
nekoray-4.0-beta4-2024-10-09-linux-x64.AppImageLinux | 44.3 MB | 下载 | 加速 | 加速 | 加速 |
nekoray-4.0-beta4-2024-10-09-linux64.zipLinux | 45.1 MB | 下载 | 加速 | 加速 | 加速 |
nekoray-4.0-beta4-2024-10-09-windows64.zipWindows | 41.4 MB | 下载 | 加速 | 加速 | 加速 |
Release 说明：https://github.com/MatsuriDayo/nekoray/releases/tag/4.0-beta4
4.0-beta32024-07-134 个文件预发布版
| 文件 / 平台 | 大小 | 官方直链 | 反代 · ghproxy.net | 反代 · ghfast.top | 反代 · mirror.ghproxy.com |
|---|---|---|---|---|---|
nekoray-4.0-beta3-2024-07-13-debian-x64.debLinux | 12.8 MB | 下载 | 加速 | 加速 | 加速 |
nekoray-4.0-beta3-2024-07-13-linux-x64.AppImageLinux | 43.0 MB | 下载 | 加速 | 加速 | 加速 |
nekoray-4.0-beta3-2024-07-13-linux64.zipLinux | 43.8 MB | 下载 | 加速 | 加速 | 加速 |
nekoray-4.0-beta3-2024-07-13-windows64.zipWindows | 40.0 MB | 下载 | 加速 | 加速 | 加速 |
Release 说明：https://github.com/MatsuriDayo/nekoray/releases/tag/4.0-beta3
3.262023-12-094 个文件正式版
| 文件 / 平台 | 大小 | 官方直链 | 反代 · ghproxy.net | 反代 · ghfast.top | 反代 · mirror.ghproxy.com |
|---|---|---|---|---|---|
nekoray-3.26-2023-12-09-debian-x64.debLinux | 19.1 MB | 下载 | 加速 | 加速 | 加速 |
nekoray-3.26-2023-12-09-linux-x64.AppImageLinux | 51.5 MB | 下载 | 加速 | 加速 | 加速 |
nekoray-3.26-2023-12-09-linux64.zipLinux | 52.1 MB | 下载 | 加速 | 加速 | 加速 |
nekoray-3.26-2023-12-09-windows64.zipWindows | 40.9 MB | 下载 | 加速 | 加速 | 加速 |
Release 说明：https://github.com/MatsuriDayo/nekoray/releases/tag/3.26
3.252023-11-254 个文件正式版
| 文件 / 平台 | 大小 | 官方直链 | 反代 · ghproxy.net | 反代 · ghfast.top | 反代 · mirror.ghproxy.com |
|---|---|---|---|---|---|
nekoray-3.25-2023-11-25-debian-x64.debLinux | 19.1 MB | 下载 | 加速 | 加速 | 加速 |
nekoray-3.25-2023-11-25-linux-x64.AppImageLinux | 51.4 MB | 下载 | 加速 | 加速 | 加速 |
nekoray-3.25-2023-11-25-linux64.zipLinux | 52.1 MB | 下载 | 加速 | 加速 | 加速 |
nekoray-3.25-2023-11-25-windows64.zipWindows | 40.8 MB | 下载 | 加速 | 加速 | 加速 |
Release 说明：https://github.com/MatsuriDayo/nekoray/releases/tag/3.25
本页加速下载用到的 3 个 GitHub 反代镜像
| 反代 | 前缀 | 说明 |
|---|---|---|
ghproxy.net | https://ghproxy.net/ | 老牌备份 |
ghfast.top | https://ghfast.top/ | 新生快线 |
mirror.ghproxy.com | https://mirror.ghproxy.com/ | 子域名 |
反代是第三方公益服务，单个通道可能临时挂掉，多挑几个再判断网络是否有问题。所有反代均为 HTTPS，文件内容与 GitHub 原始 Release 字节一致，可放心做 SHA256 校验。
GitHub 仓库简介：不再维护，自寻替代品。 Qt based cross-platform GUI proxy configuration manager (backend: sing-box) · 许可 GPL-3.0 · ⭐ 15,397
NekoRay 适合两类人：已经在 Windows 上有可用配置、只想排查订阅或日志的人；以及需要读懂旧教程里“NekoRay / NekoBox / sing-box”关系的人。它不适合从零开始搭新环境，原因很简单：官方仓库在 2025-03-17 被归档，4.0.1 Release 停在 2024-12-12。
做一件事：打开 NekoRay 的版本信息或 Release 来源，确认你运行的是官方 4.0.1，而不是来源不明的改包。后面的判断都建立在这个版本限制上。
NekoRay、NekoBox、sing-box 到底谁负责什么？
| 名称 | 官方来源 | 负责什么 | 现在的状态 |
|---|---|---|---|
| NekoRay | MatsuriDayo/nekoray | 桌面 Qt 图形界面、订阅与配置管理 | 仓库已归档，只读 |
| NekoBox for Android | MatsuriDayo/NekoBoxForAndroid | Android 代理工具链，README 写明 Core: SagerNet/sing-box | 仓库未归档 |
| sing-box | SagerNet/sing-box | 真正执行入站、出站、DNS、路由、日志的核心 | 官方仍维护 |
NekoRay 不是一个协议本身。它是把节点、订阅、路由和系统代理开关包装成桌面 UI，底层连接由 sing-box 处理。
这个限制很重要：NekoRay UI 里能看到一个协议名称，不代表它支持 sing-box 最新文档里的所有字段。4.0.1 Release 写明使用 sing-box 1.9.7-neko1，所以遇到新字段报错时，按这个内核版本判断，不要直接拿最新版 sing-box 文档套进去。
2026 年还该继续用 NekoRay 吗？
| 你的情况 | 建议 | 理由 |
|---|---|---|
| Windows 上已有配置，日常只用少量节点 | 可以短期保留 | 4.0.1 仍能运行旧配置，迁移成本不一定划算 |
| 准备新装一个桌面客户端 | 不建议从 NekoRay 开始 | 仓库已归档，后续问题没有官方修复节奏 |
| 使用 macOS | 换客户端 | 4.0.1 Release 写明 macOS 不再支持 |
| Linux 桌面用户 | 谨慎保留 | README 写 Windows / Linux out of the box，但 4.0.1 Release 又提示 Linux 构建不保证 |
| Android 用户 | 看 NekoBox for Android | 这是独立 Android 项目，不等于桌面 NekoRay |
| 订阅包含很新的协议字段 | 优先换仍维护的客户端 | NekoRay 4.0.1 的内核限制固定在 sing-box 1.9.7-neko1 |
NekoRay 的价值在“旧配置能跑、Qt 界面清楚、日志可见”。它的问题也很明确：仓库只读以后，协议兼容、运行库兼容、系统代理适配都不会像活跃项目那样迭代。
官方 4.0.1 Release 哪些信息最影响使用？
4.0.1 Release 有几条对排错很关键：
- 主程序改名为
nekobox.exe，所以 Windows 用户看到这个文件名不一定是下错包。 - 旧 3.x 安装和数据建议完整清理后再重装，直接覆盖容易留下旧配置问题。
- 不再支持 Xray core，NekoRay 4.x 的核心限制更集中在 sing-box。
localhostDNS 写法不再工作，Release 说明里提到localDNS 改由 sing-box 处理。- Qt 升级到 6.7.2；Windows 7 和 macOS 不再支持。
- 内置 sing-box 版本写为
1.9.7-neko1。
如果你的旧教程还在说“切到 Xray core”“macOS 直接下载 NekoRay”“DNS 填 localhost”，那篇教程已经不适合 4.0.1。
订阅和节点应该怎么导入？
分清三种输入，不要把它们都叫“配置”：
| 输入类型 | 常见样子 | 在 NekoRay 里先怎么处理 | 失败时看哪里 |
|---|---|---|---|
| 分享链接 | vless://、vmess://、trojan://、ss://、hysteria2://、tuic:// | 按单节点导入或从剪贴板导入 | 协议字段、端口、SNI、Reality 参数 |
| 订阅 URL | https://... 的长链接 | 放到订阅管理里更新 | 返回内容是否为 HTML、401、403、过期提示 |
| sing-box JSON | 以 { "log": ... }、inbounds、outbounds、route 等结构开头 | 当作核心配置理解，不要当普通分享链接 | JSON 字段是否属于 1.9.7-neko1 可识别范围 |
| Clash / Mihomo YAML | proxies:、proxy-groups:、rules: | 不要直接假设 NekoRay 可完整解析 | 更适合 Mihomo 系客户端 |
最可靠的导入顺序是：先导入一个单节点，确认核心能启动；再导入订阅 URL；最后再处理规则和 DNS。这样出错时能知道是节点、订阅返回内容，还是路由规则导致的问题。
如果订阅商只给一种链接，而你需要在 NekoRay、Mihomo、v2rayN 多端之间复用，选购前就要确认格式支持。已经在多端维护配置的人，可以用兼容 Clash / Singbox / V2Ray 的订阅承载这些客户端之间的订阅同步，前提是你先比对客户端支持的导出格式。
core 和协议限制怎么判断？
sing-box 官方配置文档把配置拆成 log、dns、inbounds、outbounds、route 等模块；出站文档列出 direct、block、SOCKS、HTTP、Shadowsocks、VMess、Trojan、WireGuard、Hysteria、VLESS、ShadowTLS、TUIC、Hysteria2、AnyTLS、Tor、SSH、DNS、Selector、URLTest、Naive 等类型。
NekoRay 4.0.1 只能按它内置的 sing-box 分支理解这些类型。判断方法不是看最新版文档有没有这个协议名，而是看三个细节：
- NekoRay 4.0.1 的 Release 是否提到该能力。
- 你的订阅字段是否属于 sing-box 1.9.7-neko1 时代已经支持的字段。
- 日志里报的是“未知字段”“未知出站类型”，还是连接层超时。
“未知字段”和“未知出站类型”通常是版本限制问题；连接超时、TLS 握手失败、认证失败更像节点参数或远端服务问题。两类问题的处理方向完全不同。
日志应该看哪几行？
不要只看状态栏的“已连接”或“失败”。NekoRay 这类 GUI 客户端排错时，核心日志比按钮状态更有价值。
| 日志表现 | 更可能的原因 | 做的动作 |
|---|---|---|
address already in use | 本地端口被占用 | 换本地 HTTP / SOCKS 端口，或关闭另一个代理客户端 |
unknown field | 配置字段高于内置 sing-box 能力 | 删除该字段，或换支持该字段的新客户端 |
unknown outbound type | 协议类型不被当前核心识别 | 确认订阅是否用了新协议或转换错误 |
failed to parse | JSON / URL 格式损坏 | 重新复制订阅，避免浏览器自动转义字符 |
connection refused | 远端端口拒绝连接或本地代理端口填错 | 用同一节点在另一个客户端交叉测试 |
i/o timeout | 连接握手超时 | 检查服务器地址、端口、系统时间和 DNS |
| Windows 提示缺 DLL | 缺 Microsoft C++ runtime | 按 README 提示安装微软运行库后重启客户端 |
日志只需要抓失败前后 20 行。长时间开 debug 会把无关 DNS 查询、规则匹配和连接尝试都刷出来，反而难定位。
常见故障按什么顺序排？
导入后没有节点
在浏览器里打开订阅 URL，看返回的第一屏是什么。如果出现登录页、套餐到期提示、HTML 页面或 403/404，NekoRay 没有任何节点可解析。
如果返回内容看起来是 YAML，确认它是不是 Clash / Mihomo 格式。NekoRay 不是 Mihomo 客户端，proxies: 和 rules: 能不能完整转成 sing-box 配置，取决于具体导入逻辑和字段。
节点存在但核心启动失败
先禁用 TUN、系统代理和复杂路由，只保留一个节点启动。核心启动失败通常不是“节点质量”问题，而是本地配置无法被 sing-box 解析。
重点看日志里第一条 parse error。后面的错误多半是连锁反应。
显示连接但浏览器不走代理
检查浏览器是否使用系统代理。有些浏览器、开发工具或终端会绕开系统代理，必须单独设置 HTTP / SOCKS 代理地址。
如果你只开启了核心连接，但没有开启系统代理或 TUN，浏览器流量不会自动进入 NekoRay。
TUN 开启后断网
先关 TUN，确认普通系统代理能用。TUN 失败常见原因是权限不足、虚拟网卡异常、DNS 冲突或路由规则过宽。
Windows 上先用管理员权限启动一次；Linux 上确认当前用户有没有创建 TUN 设备和修改路由的权限。
旧 3.x 升级到 4.0.1 后异常
4.0.1 Release 明确建议移除旧 3.x 安装和数据后再重装。直接覆盖旧目录时，旧核心路径、旧 DNS 写法和旧路由字段可能一起被带进来。
升级前先备份订阅 URL、单节点分享链接和自定义规则。备份完成后，再清理旧数据并重新导入。
下载和安全检查怎么做？
只从 MatsuriDayo/nekoray 的 GitHub Releases 下载 NekoRay 4.0.1。仓库已经只读，任何声称“新版 NekoRay 5.x”的第三方包，都要先比对来源、发布时间和发布者。
下载后做 5 个检查：
- Release 页面域名是
github.com/MatsuriDayo/nekoray。 - 版本号是官方 Release 里能看到的 tag，例如
4.0.1。 - Windows 主程序名可能是
nekobox.exe，这点和 4.0.1 Release 说明一致。 - 压缩包解开后不要直接覆盖旧 3.x 数据，备份再清理。
- 第一次运行前不要导入陌生人给的整包配置，用一个自己确认来源的节点测试。
NekoRay 已归档不等于立刻不能用；它的真实风险是问题不会再由官方持续修补。用于长期桌面环境时，把它当旧工具管理：少装来源不明的包，少导入不明配置，保留迁移出口。
什么时候该迁移？
出现下面任一情况，就不建议继续在 NekoRay 上花时间：
- 你的订阅依赖新协议字段，日志反复出现
unknown field。 - 你要在 macOS 上使用桌面客户端。
- 你需要团队统一 Windows / macOS / Linux 三端配置。
- 你依赖复杂 DNS、TUN、规则集和自动更新。
- 你不想维护一个已归档项目的运行库和系统兼容问题。
迁移时先导出三样东西：订阅 URL、单节点分享链接、自定义路由规则。订阅和分享链接通常可以直接导入新客户端；自定义路由规则往往要手工改写成 Mihomo YAML 或 sing-box JSON。Windows / macOS / Linux 可对照 Clash Verge Rev、Mihomo Party 和 Hiddify 的导入方式分别迁移。