NekoRay官网下载与使用教程：停更后怎么配置全局代理

NekoRay已经停止维护，但原作者的GitHub仍可下载历史安装包。 电脑版最后一版是4.0.1，适用于Windows与Linux；解压后看到 nekobox.exe 属于正常情况，因为项目后期也叫NekoBox for PC。它只负责连接你提供的节点，安装软件本身不会得到免费线路。

如果你只是想第一次导入机场订阅，建议先确认服务商是否仍支持这个旧客户端。已经有可用配置、需要重装或弄懂全局代理的人，可以直接按下面的步骤操作。

NekoRay官网与GitHub在哪里？先看停止维护时间

最后发版是2024年12月12日，仓库归档是2025年3月17日。 “NekoRay最新版”现在仍指4.0.1，不是2026年又发了新版本。官网写明电脑版不再维护，安卓项目则有自己的仓库与版本号，不能把两者的更新状态混在一起。原仓库归档说明

搜索结果里的“官网”“支持所有平台”等标题不能代替项目归属。认准上表的作者账号；其他网站即使提供同名文件，也不能据此当成原作者的新官网。

NekoRay下载：Windows、Linux与历史兼容包

下列文件均从 MatsuriDayo/nekoray官方GitHub Release资产 获取，本站镜像保留原文件名。2026年10月18日重新下载原文件，并从本站下载域名回读，比对SHA-256一致。校验说明的是镜像与来源一致，不代表在所有系统上都做过运行测试。

4.0.1：最后正式版，按系统选一个

Windows包需要完整解压，不能只把主程序拖出来运行。Linux这三个包是不同分发方式，不用全部安装。官方并未为4.0.1提供Windows 32位、原生ARM64或macOS安装包；Linux发行版兼容性也没有广泛保证。

旧系统和旧教程：3.17与3.26不要混选

Win7～Win8.1用户看3.17专用包；需要保留3.x双内核环境的人才考虑3.26。 后者不是Win7兼容包，也不是更安全、更推荐的新版本。4.x取消了Xray，照着旧教程寻找“切换Xray”会找不到。4.0.1变更 · 官方系统兼容表

这里收录最后正式版、两类有明确用途的历史兼容包，以及下文安卓独立项目的全部四种架构；更早的每一个历史版本没有逐版镜像，仍可从上面的官方历史列表查找。

NekoRay使用教程：Windows从下载到第一次连接

下面以全新解压的4.0.1中文界面为准。先准备有效订阅链接，或者自己服务器的单节点分享链接；机场的登录网址、购买页面网址不能代替订阅。

第一步：解压并打开正确的程序

1. 下载上表的4.0.1 Windows ZIP，右键选择“全部解压”，放进一个固定且有写入权限的文件夹，例如你自己创建的 D:\Apps\NekoRay。
2. 打开解压目录，双击 nekobox.exe。不要双击 nekobox_core.exe，那是后台内核，不是操作窗口。
3. 第一次先保留默认设置，不要同时打开其他代理软件接管网络。窗口关掉后也可能仍在任务栏右下角托盘运行，需要退出时从程序菜单选择退出。
4. 如果提示缺少 VCRUNTIME 或 MSVCP 等DLL，按官方README的指引安装微软Visual C++ x64运行库，不要去不明网站单独找DLL文件。官方README

旧用户升级前，先通过“首选项 → 打开配置目录”找到并备份配置，再把4.0.1解压到新目录。不要直接覆盖唯一一份旧环境；3.x配置与4.x变动较大，旧的 nekoray.exe 也可能残留，让你误以为打开了新版。

第二步：把订阅导进去，看见节点列表

1. 在机场后台找到“复制订阅链接”。如果提供多种格式，先选服务商标注适用于NekoRay/NekoBox的格式；通用V2Ray或兼容的Clash节点订阅也可以尝试。
2. 回到NekoRay，点“服务器 → 从剪贴板添加”，或在主窗口按 Ctrl+V。
3. 检测到订阅网址后，在弹窗里选 “作为订阅（创建新组）”，确认。这样软件会保存订阅地址，以后才能更新节点。
4. 等待请求结束。出现一个新的分组标签，并在表格中看见节点名称、类型和地址，才算导入成功。
5. 日后节点变动，切到该分组，使用“服务器 → 当前分组 → 更新订阅”。订阅更新失败时先看日志，不要急着删掉还可以使用的全部节点。

如果你拿到的是 ss://、vmess://、vless:// 或 trojan:// 开头的单节点链接，也能从剪贴板添加，但它不会自动变成可更新的机场订阅。订阅通常含账户凭据，不要把完整链接贴到公开论坛或截图里。

能读取Clash订阅中的节点，不等于完整导入Clash的策略组和分流规则。 节点进来以后，本机的路由仍要自己设置。机场给的订阅如果包含旧内核不支持的协议或参数，也可能只导入一部分。官方订阅格式说明 · 4.0.1导入逻辑

第三步：启动节点，再让浏览器走代理

1. 在节点列表里点选一个节点，右键选择 “启动”。先选普通单节点，不要一上来调链式代理。
2. 勾选主窗口的 “系统代理”。只启动节点却没有让应用使用代理，浏览器可能仍走原来的连接。
3. 打开浏览器访问你需要的网站。主窗口也有“URL测试”按钮，可以辅助检查节点是否能够完成请求；测试通过不代表所有网站都能访问。
4. 如果打不开，先换一个节点重试，再看下文排错表。一次只改一项，才能知道是哪一步解决了问题。
5. 不用了先取消“系统代理”，再停止节点并退出。若程序异常退出后网页全部打不开，检查Windows“设置 → 网络和Internet → 代理”里是否残留指向本机的手动代理设置。

这个阶段先让浏览器正常访问，再决定是否需要TUN，通常更容易排查。

NekoRay全局代理怎么开？三个开关分别管什么

“开了全局，但某个软件还是不走代理”经常是把两件事混在一起：流量有没有进入NekoRay，以及进入以后走哪条线路。

日常使用：绕过局域网和大陆

点 “首选项 → 路由设置 → 预设 → 绕过局域网和大陆”，然后保存。全新配置下，它会把匹配中国大陆及局域网规则的请求设为直连，其余默认走代理。规则库有覆盖范围，并不是按网站语言判断国内外。

临时全局：把已接管流量交给代理

点 “首选项 → 路由设置 → 预设 → 全局”，保存后重启代理使设置生效，并确认节点已启动、系统代理已勾选。此时连国内网站也可能经过所选节点，延迟、流量消耗和登录地区都会受影响；用完可切回上面的绕过预设。

如果你以前填写过“自定义路由（全局）”或TUN绕过规则，先检查这些设置，不要把预设“全局”理解成抹掉所有自定义例外。4.0.1源码同时保留全局与绕过预设，菜单名和作用可在路由设置源码核对。

某个应用不理系统代理：再考虑Tun模式

先停止节点、取消系统代理，再勾选 “Tun模式”，按程序提示授予所需的管理员权限，重新启动节点。Windows下若提示权限不足，可退出软件后右键 nekobox.exe，选择“以管理员身份运行”，再重试。不要同时开多个客户端的TUN争用网络路由。

TUN能扩大接管范围，但不承诺绝对覆盖所有流量。希望已接管流量默认走节点，还需要配合“全局”路由；希望国内直连，则配合绕过预设。出现断网，先停TUN恢复到刚才能工作的系统代理方案，再查日志。

NekoRay Linux安装与配置：DEB、AppImage怎么选

先在终端运行 uname -m：本页4.0.1预编译文件面向 x86_64。如果显示 aarch64 或 arm64，不要强装这些x64包；它们不是树莓派或ARM电脑的原生版本。

Debian/Ubuntu系：让包管理器处理依赖

下载DEB后，在保存文件的目录打开终端，运行：

sudo apt install ./nekoray-4.0.1-2024-12-12-debian-x64.deb

./ 表示安装当前文件夹里的包。输入系统密码后，APT会检查依赖；如果报告依赖不可满足，先停下来核对发行版版本，别直接强制安装。安装完成后在应用菜单里搜索NekoBox或NekoRay启动。

这个DEB实际依赖Qt5相关库。 不能只看发布说明的Qt升级概述，就让Linux用户一律去装Qt6。较新的发行版可能改变了包名或库版本，这也是旧包不保证兼容的原因之一。

AppImage：先给执行权限，再运行

在AppImage所在目录打开终端，执行：

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

遇到FUSE、动态库或显示环境错误，先保留终端报错，按当前发行版文档处理；AppImage也不是完全不依赖系统环境。不要为了能启动就把整台系统的安全设置关闭。

ZIP：适合需要保留独立目录的用户

完整解压 linux64.zip，进入其中的 nekoray 文件夹。包内包含 nekobox、nekobox_core、launcher 和随包运行库；使用随包环境时从该目录执行 ./launcher。旧文档中的主程序名 ./nekoray 不适用于这里的4.0.1包。

进入界面后，导入订阅与路由设置基本沿用Windows步骤。不过Linux桌面环境和应用对系统代理的支持各不相同；终端程序未必跟随桌面代理。TUN还需要权限与相关系统组件，优先按程序提示处理，不能把“窗口打开了”当作TUN已成功接管。项目Linux运行说明（部分命令仍是旧版）

NekoRay安卓、APK下载：真正对应的是NekoBox

原版NekoRay没有名为NekoRay的官方安卓APK。 同一作者体系的安卓客户端叫 NekoBox for Android，是独立项目，不能拿电脑版4.0.1的版本号来判断它是否最新。截至本次核对，其最新正式版是1.4.2，官方四个架构的APK如下。

这四个文件来自NekoBox for Android官方1.4.2发布页，同样完成本站镜像回读SHA-256比对。安装包支持Android 5.0及以上，安卓4.4不适用。详细的手机导入、VPN授权与分流步骤看NekoBox安卓新手教程。

配置失败怎么查？先按现象分开处理

4.0.1的sing-box内核停在 1.9.7-neko1。AnyTLS等后来的能力不能因为其他新版sing-box客户端支持，就推断旧NekoRay也支持。反过来，4.x移除了Xray，并不等于连所有VLESS节点都不支持：协议名称、传输参数和内核版本要一起看。

常见问题

NekoRay停止维护后还能用吗？

已有节点和配置兼容时仍可能使用，但不会因为GitHub还能下载就恢复维护。新出现的协议、系统兼容问题和缺陷都不能指望原项目继续修复；新装用户优先选择服务商当前支持的维护中客户端。

NekoRay PC版为什么打开后叫NekoBox？

NekoRay后期也叫NekoBox for PC，4.x主程序改为nekobox.exe。这不代表下载成安卓版；Windows文件是ZIP，安卓文件是另一个项目发布的APK。

NekoRay全局代理是不是勾选系统代理就行？

不是。系统代理负责让遵循它的应用把请求交进来；全局路由决定进入内核后的默认去向。不遵循系统代理的程序可能需要单独设置代理或使用TUN，TUN本身也仍受路由和绕过规则影响。

NekoRay配置能直接照搬Clash吗？

不能按完整配置照搬。NekoRay可以解析部分Clash格式订阅里的节点，但不等于复制其策略组、规则和全部新协议能力。导入后仍要检查节点兼容性并设置本机路由。

现在新装，或准备购买订阅，该怎么选

想保留类似NekoRay的图形配置习惯，可以了解作者下载页列出的Throne项目与官方发布页。它是继续开发的独立分支，不是原版NekoRay突然恢复更新；安装与迁移要按Throne自己的说明，先备份旧配置。

只想导入机场提供的Clash订阅，可以看Clash Verge Rev下载与教程；需要Xray配置能力，可看v2rayN教程。这与原作者发布说明给普通订阅用户的选型方向一致。

购买前让服务商明确提供当前可用的客户端名称、订阅格式与节点协议。如果必须沿用NekoRay 4.0.1，要问清楚服务商现在是否仍有对应教程和兼容节点；仅凭“支持VLESS”或“支持Clash订阅”还不足以保证可用。先确认你的客户端能连接，再考虑套餐，能少走一轮买完才发现导不进的弯路。