介绍
Nekoray 是一个开源的代理客户端项目，提供了基于 Qt 的跨平台 GUI，主要用于配置和管理代理工具，比如 V2Ray、Xray 等。这是一个针对网络代理用户友好的图形化前端，旨在简化代理工具的配置和使用流程。
Github 项目地址：https://github.com/MatsuriDayo/nekoray
Nekoray 的主要特点
- 跨平台支持：
- Nekoray 基于 Qt 开发，支持 Windows 和 Linux 平台，能够为不同系统的用户提供一致的使用体验。
- 用户友好的界面：
- 提供直观的图形化用户界面，便于用户快速添加、编辑和管理代理配置文件。
- 支持主流代理工具：
- 内置对 V2Ray 和 Xray 的支持，通过 JSON 配置文件加载代理规则。
- 兼容 Shadowsocks、VMess、VLESS 等多种协议。
- 便携性：
- 项目提供便携版本，用户可以在无需安装的情况下直接运行，尤其适合对环境修改有限制的场景。
- 开放源码：
- Nekoray 完全开源，代码托管在 GitHub 上，用户可以自由查看、修改和编译代码。
- 日志与调试功能：
- 提供详细的连接日志，方便用户排查网络问题。
- 附带实用功能：
- 支持分流配置、DNS 解析设置等高级功能。
- 支持自定义图标和主题，提升用户个性化体验。
支持的协议
- SOCKS (4/4a/5)
- HTTP(S)
- Shadowsocks
- VMess
- VLESS
- Trojan
- TUIC ( sing-box )
- NaïveProxy ( Custom Core )
- Hysteria2 ( Custom Core or sing-box )
- Custom Outbound
- Custom Config
- Custom Core
支持的订阅
- 原始格式: 一些广泛使用的格式 (如 Shadowsocks、Clash 和 v2rayN)
下载与安装
注意哈，主程序更名 nekobox.exe （自动升级可能无法删除旧版，需要手动删除。新装没有问题）建议丢弃之前 3.X 版本的程序和数据，完全删除程序和配置后重新安装。
nekoray 便携格式，无安装器。下载压缩包后将压缩包里面整个文件拖出来即可。
- Github 项目仓库地址：https://github.com/MatsuriDayo/nekoray/releases
- 本站收藏的版本(3.26)：点击查看 (密码: 5BjpBxwCmm)
使用教程
步骤 1：准备配置文件
首先需要一个 vmess 节点或者订阅节点的链接，如何获取订阅节点
- 如果机场用户，复制 Shadowsocks, Clash 和 v2rayN 订阅地址都可以。
- 如果你的机场不支持 Shadowsocks, Clash 和 v2rayN 订阅格式，或者不是机场的用户可以使用订阅转换工具进行转换。
如果没有订阅链接，本站中有一篇文章提供了免费的 vmess 节点（不是所有地区都可以使用），首先复制文章中免费的 vmess 节点。
复制免费的 vmess 节点后，再进入 订阅转换工具 进行转换，模式选择”基础模式“就行，vmess 地址粘贴到订阅链接方框处，然后点生成订阅链接，再点复制订阅。
步骤 2：导入节点或通过订阅链接下载配置
1.通过 vmess 链接获取节点信息
打开 nekobox.exe 后，点击左上角”程序”，再点击从剪切板添加。
2.如果你是机场用户可以通过订阅链接获取节点信息
打开 nekobox.exe 后，点击首选项，点击分组。
点击新建分组:
- 名称：随便填写
- 类型：选择订阅
- URL：粘贴订阅链接
添加完成后需要点一下更新订阅
步骤3：配置规则和启动代理
1.先选中一个节点，点击左上角”程序”，点击”当前服务器”，然后勾选节点。
2.启动代理，点击左上角”程序”，点击”系统代理”，然后”启用系统代理”。这就是连接上了。可以试试访问一下 Google 是否成功。
3.默认的规则是全局模式，所有域名（国内和海外）都会走代理，会导致访问国内的内容非常卡，所以需要一个规则让国内域名不走这个代理。nekoray 里面预设了绕过局域网和大陆的规则。
如何设置绕过局域网和大陆的代理模式，首先点击首选项里面的”路由设置”。
点击建议路由，在预设里面点击”绕过局域网和大陆“，最后点确认即可。
常见问题
1. 无法连接到代理服务器
- 问题表现：代理配置完成后，无法正常连接到目标服务器。
- 可能原因：
- 服务器地址或端口配置错误。
- 用户 ID 或协议配置不正确。
- 防火墙阻止了连接。
- 服务器侧代理配置有误。
- 和服务器时间不一致
- 解决建议：
- 检查配置中的服务器地址、端口、用户 ID 等是否与服务提供者提供的信息一致。
- 确保本地网络能够访问代理服务器（例如使用
ping或telnet测试）。 - 检查本地或服务器的防火墙设置，确保代理端口未被阻挡。
- vmess 节点需要和服务器时间一致，建议核对系统时间是否和北京时间一致。
2. 部分网站加载缓慢或无法访问
- 问题表现：部分国内或国际网站访问正常，但特定网站加载缓慢甚至失败。
- 可能原因：
- DNS 配置问题导致域名解析缓慢或错误。
- 路由规则未正确匹配。
- 服务器负载较高。
- 解决建议：
- 启用 Nekoray 的 DNS 配置功能，尝试使用公共 DNS 服务（如 Google DNS、Cloudflare DNS）。
- 检查路由规则是否正确，例如跳过中国大陆 IP 和域名的规则是否设置准确。
- 测试更换代理服务器，查看是否为服务器问题。
3. 日志显示连接被拒绝或超时
- 问题表现：日志中频繁出现
connection refused或timeout错误。 - 可能原因：
- 目标服务器不在线或端口未开放。
- 网络不稳定导致连接失败。
- 解决建议：
- 在日志界面查看详细的错误信息，定位问题。
- 尝试更换网络或重新启动 Nekoray。
- 检查服务器是否可以通过其他工具（如 telnet 或 curl）访问。
4. Nekoray 无法启动或崩溃
- 问题表现：软件打开后直接崩溃或无法加载界面。
- 可能原因：
- Qt 环境缺失或版本不匹配。
- 配置文件损坏。
- 解决建议：
- 确保使用的是官方提供的最新版本。
- 删除或重命名配置文件（通常是
config.json），让软件生成新的默认配置。 - 如果是 Linux 系统，确保相关 Qt 依赖已安装。
5. 配置导入/导出失败
- 问题表现：导入订阅链接或配置文件后没有生效。
- 可能原因：
- 订阅链接或配置文件格式不正确。
- 网络问题导致订阅更新失败。
- 解决建议：
- 确保订阅链接有效，并且使用的是支持的格式（如 Clash 或 V2Ray 格式）。
- 手动更新订阅并查看日志确认订阅更新是否成功。
使用建议
1. 保持 Nekoray 更新
- 定期前往 GitHub 仓库 下载最新版本，以获得最新功能和修复。
2. 优化 DNS 设置
- 在“设置”中配置公共 DNS（如
1.1.1.1或8.8.8.8），提高解析速度并避免域名污染。
3. 调整路由规则
- 根据自己的使用场景调整路由规则，例如：
- 经常访问国外网站时，可以设置默认代理。
- 经常访问国内网站时，可以设置默认直连。
4. 查看官方文档与教程
- 官方文档中有许多详细的功能说明，可以帮助您快速上手并解决常见问题。
5. 使用日志功能排查问题
- 启用详细日志，监控网络流量情况，以便更快定位问题。
6. 备份配置文件
- 在配置完成后，备份
config.json文件，以便恢复或在其他设备中使用相同配置。
7. 加入社区交流
- 如果遇到复杂问题，可以到 GitHub Issues 或 Telegram 群组与开发者和用户交流，获取支持。
