NekoRay 使用教程：下载、导入订阅、分组与路由设置与常见错误

NekoRay 是一款基于 Qt 的开源代理客户端，支持 Windows 和 Linux，内部使用 sing-box 作为代理内核（早期版本还可以切换到 Xray 内核）。它的界面和 v2rayN 有些相似：左侧是分组，右侧是节点列表，支持 Shadowsocks、VMess、VLESS、Trojan、Hysteria2、TUIC 等常见协议，导入通用订阅即可使用。

先说明：项目已停止维护

NekoRay 的原作者已经停止维护这个项目，官方仓库也不再发布新版本。这意味着：

• 新协议、新的传输方式和内核更新不会再跟进，部分较新的节点配置可能无法识别；
• 发现的 Bug 和安全问题不会再有官方修复；
• 随着操作系统更新，未来可能出现兼容性问题。

如果你是第一次挑选客户端，更建议直接使用仍在维护的替代品：

替代客户端	适用平台	特点
Clash Verge Rev	Windows / macOS / Linux	使用 Clash 订阅，界面简洁，适合新手
v2rayN	Windows 为主	使用通用订阅，协议支持广，和 NekoRay 的使用习惯最接近
Mihomo Party	Windows / macOS / Linux	同样基于 Mihomo 内核，功能较丰富

如果你已经在用 NekoRay 且一切正常，短期内继续使用问题不大。下面完整讲解它的使用方法，方便老用户查阅。不同版本的菜单位置会有差异，名称和本文略有不同时，按功能含义找到对应选项即可。

下载

NekoRay 只应从项目官方 GitHub 仓库的 Releases 页面下载：

1. 打开 Releases 页面，选择最后一个正式版本（不要选 Pre-release 测试版）；
2. Windows 用户下载文件名中带 windows64 之类字样的压缩包；
3. Linux 用户下载对应的 Linux 压缩包，部分版本也提供 .deb 包或 AppImage，以发布页为准。

停更后网上出现了不少打着“NekoRay 最新版”“汉化增强版”旗号的修改版，来源无法核实，可能捆绑恶意程序。官方版本本身支持简体中文，没有必要使用这些版本。

安装

NekoRay 是免安装软件：

• Windows：把压缩包解压到固定目录，例如 D:\Apps\nekoray，路径中尽量不要有中文和空格。进入目录双击 nekoray.exe 运行。首次运行如果 Windows 防火墙弹窗，允许访问网络即可。
• Linux：解压到自己的用户目录，运行目录中的启动脚本或可执行文件；如果是 .deb 包，用系统的软件包管理器安装。部分桌面环境需要额外安装 Qt 相关依赖，按报错提示补齐即可。

部分版本首次启动时会询问使用哪个内核，如有此提示，选择 sing-box 即可。界面语言可以在首选项的基本设置中切换为简体中文。

导入订阅

NekoRay 使用的是通用订阅（Base64 编码的节点链接合集）。在机场后台复制订阅时，优先选择“通用订阅”或“V2Ray / v2rayN 订阅”。订阅格式的区别可以看机场订阅是什么。

1. 打开顶部「首选项」菜单，进入分组设置；
2. 新建一个分组，把分组类型设为订阅；
3. 填写分组名称，在订阅地址（URL）中粘贴机场的订阅链接；
4. 保存后回到分组列表，对该分组执行更新订阅；
5. 主界面会出现一个新的分组标签页，里面就是机场的全部节点。

订阅链接相当于账号凭证，不要截图或分享给他人。如果怀疑泄露，到机场后台重置后再重新导入。

添加节点

如果只有单个节点的分享链接（如 ss://、vmess://、vless://、trojan://、hysteria2:// 开头）：

1. 复制链接；
2. 在 NekoRay 主界面的节点列表空白处按 Ctrl + V，或在「服务器」菜单里选择从剪贴板添加；
3. 节点会出现在当前分组中。

「服务器」菜单里还可以手动新建各协议的配置、扫描屏幕二维码。

导入后，选中节点并右键，可以进行延迟测试（URL 测试），超时的节点暂时不要用。双击节点，或右键选择启动，即可让该节点生效。窗口底部会显示当前运行的节点和本地监听端口（默认的混合端口通常是 2080，以实际显示为准）。

更新订阅

• 手动更新：在分组标签上右键，或在首选项的分组设置里选择更新订阅；
• 自动更新：分组设置中可以设置订阅自动更新的间隔，一般设为一天一次即可。

如果首次更新失败，可能是订阅地址被网络干扰，可以稍后重试，或者先手动导入一个可用的单节点、启动后再更新订阅。

系统代理

在「程序」菜单中勾选系统代理（部分版本叫“启用系统代理”），NekoRay 会把操作系统的代理设置指向自己的本地端口，浏览器等遵循系统代理的软件随即走代理。

需要注意：

• Linux 上系统代理的效果取决于桌面环境，GNOME、KDE 等支持较好，部分轻量桌面不生效，可以在浏览器中手动设置 HTTP 或 SOCKS 代理为 127.0.0.1 和本地端口；
• 退出程序前最好先关闭系统代理，避免异常退出后系统代理残留导致无法上网。

TUN 模式

命令行工具、游戏和部分桌面软件不读取系统代理，这时可以使用 TUN 模式。TUN 会创建一张虚拟网卡，在系统层面接管流量。

1. Windows：关闭 NekoRay，右键 nekoray.exe 选择以管理员身份运行；
2. Linux：创建虚拟网卡需要 root 权限或相应的网络管理能力，首次开启时程序会请求授权；
3. 在「程序」菜单中勾选 TUN 模式（部分版本叫“VPN 模式”）；
4. 开启后可以关闭系统代理，避免两套机制重复。

TUN 模式的参数（如网络栈类型）在首选项的 TUN 设置里，一般保持默认即可。如果开启后无法上网，先关闭 TUN 确认节点本身可用，再检查是否有管理员权限、是否有其他代理软件或 VPN 同时运行。

规则模式

NekoRay 通过“路由”决定哪些流量走代理。打开首选项中的路由设置，可以看到预设的路由方案，以及自定义直连、代理、阻止列表的编辑框。

日常推荐使用“绕过中国大陆”类型的方案：国内域名和 IP 直连，其他流量走代理。这类规则依赖 geosite / geoip 数据文件，如果分流明显不准，可以尝试更新这些数据文件。由于项目已停更，内置规则数据也可能比较旧，这是推荐迁移到替代客户端的原因之一。

如需让某个网站固定直连或固定走代理，可以在自定义规则里按域名添加，保存后重启当前节点使其生效。

全局模式

把路由方案切换为全局代理（或清空所有直连规则）即为全局模式，所有流量都会经过当前节点。适合临时排查“某个网站是否因为规则未命中而打不开”，但国内网站也会绕道海外，速度变慢、流量消耗增加，排查完请切回规则模式。流量如何扣除可以参考机场流量怎么算。

常见错误

现象	可能原因	解决方法
更新订阅后没有节点	复制了 Clash 格式订阅，或订阅已过期	改用通用订阅链接；登录机场后台检查套餐
部分节点导入失败或无法连接	项目停更，不支持较新的协议参数	换用仍在维护的客户端，如 v2rayN、Clash Verge Rev
测速全部超时	套餐到期、流量用完或本机时间不准	检查机场后台；同步系统时间
开启 TUN 失败	没有管理员或 root 权限	以管理员身份运行，Linux 下授予相应权限
关闭程序后无法上网	系统代理残留	重新打开程序关闭系统代理，或在系统网络设置中手动关闭
Linux 上系统代理不生效	桌面环境不支持自动设置	在浏览器或应用中手动填写本地代理端口，或改用 TUN
杀毒软件报毒	内核程序被误报	确认来自官方 GitHub 后添加信任
国内网站变慢	处于全局模式	切回绕过大陆的路由方案

如果长期遇到兼容性问题，建议直接迁移。更多客户端可以在 Windows 客户端教程和 Linux 客户端教程中挑选。

下一步

• 寻找优质机场：机场推荐
• 获取免费节点：每日免费机场
• 领取折扣码：机场优惠码