客户端 & 使用教程
选你的系统看分步教程 · 都是免 root / 免越狱 / 普通用户能完成
Windows
推荐客户端
配置步骤
- 1下载并解压
从 GitHub releases 下载最新版 (.zip), 解压到任意目录。无需安装。
📸 截图占位: 下载 release 页 → 选 nekoray-*-windows64.zip - 2首次启动
运行 nekoray.exe (或 v2rayN.exe)。Windows Defender 可能弹安全提示, 点「仍要运行」。
📸 截图占位: Defender 提示 → 更多信息 → 仍要运行 - 3添加订阅
菜单栏「程序」→「订阅设置」→「添加」→ 粘贴你的订阅 URL → 保存。然后「更新订阅」。
📸 截图占位: 订阅设置弹窗 + URL 输入框 - 4选节点 + 连接
节点列表里双击任意节点设为当前。右下角任务栏图标右键 → 「系统代理」→ 「自动配置」。浏览器现在走代理了。
📸 截图占位: 节点列表 + 系统代理菜单 - 5验证
浏览器开 google.com 或 youtube.com 试试。能打开 = 成功。打不开看「故障排查」。
- • 推荐用 Edge / Chrome 测试 (而不是 IE)
- • Windows 7 需要先装 .NET Framework 4.7+
macOS
推荐客户端
配置步骤
- 1安装
Stash 直接 App Store 购买安装。ClashX Meta 从 GitHub 下载 dmg 后拖到 Applications。
📸 截图占位: App Store / dmg 安装 - 2首次启动权限
首次会弹「需要管理员密码」配置系统代理。输入密码授权即可 (只这一次)。
- 3添加订阅
Stash: 右上角图标 → 设置 → 订阅 → + → 粘贴 URL → 保存。 ClashX Meta: 配置 → 远程配置管理 → 添加 → 粘贴 URL。
📸 截图占位: Stash 订阅页 / ClashX 远程配置 - 4选节点 + 开启代理
左侧节点组里点任意节点。然后 Stash 总开关打开 (绿色) / ClashX 「设置为系统代理」打勾。
📸 截图占位: 总开关 ON - 5验证
Safari / Chrome 开 youtube.com。能打开 = 成功。
- • App Store Stash 必须用 中国区 以外账号 (例如 美区 / 港区)
- • M1/M2/M3 Mac 都原生支持
iOS / iPad
推荐客户端
配置步骤
- 1下载 (需 美区 / 港区 App Store)
Shadowrocket 在中国区下架了。你需要切到 美区或港区 Apple ID 才能下载。设置 → Apple ID → 注销 → 用美区账号登 App Store 重新下。
📸 截图占位: App Store 美区切换 - 2复制订阅 URL
在 Carlos Proxy 用户中心首页, 点「📋 复制」按钮把订阅 URL 复制到剪贴板。
📸 截图占位: Carlos Proxy dashboard → 复制 - 3添加到 Shadowrocket
打开 Shadowrocket → 右上角 + → 「添加订阅」(自动识别剪贴板 URL, 点确认)。
📸 截图占位: Shadowrocket + 按钮 → 添加订阅 - 4更新订阅 + 选节点
订阅列表 → 下拉刷新 → 看到节点出现 → 点任意节点设为当前。
📸 截图占位: 订阅更新 + 节点列表 - 5开启代理
首页顶部「未连接」开关 → 滑到开。首次会弹 VPN 权限授权, 同意即可。
📸 截图占位: VPN 权限 + 开关 - 6验证
Safari 开 google.com。能打开 = 成功 🎉
- • iOS 首次连接会弹「Carlos Proxy 想添加 VPN 配置」, 点 允许 + 输 Face ID/密码
- • iPad 一模一样
- • Shadowrocket 不支持 hy2 协议的 obfs, 我们订阅会自动给 Shadowrocket 用 vless+reality
Android
推荐客户端
配置步骤
- 1下载 APK / Play 安装
NekoBox 从 GitHub 下 .apk 直装。Surfboard 走 Google Play。
📸 截图占位: GitHub release apk / Play Store - 2允许安装未知来源
若装 apk 提示「未知来源」, 设置 → 应用 → 特殊访问 → 安装未知应用 → 浏览器/文件管理器 → 允许。
📸 截图占位: 未知来源开关 - 3添加订阅
NekoBox: 主页 → 右上角 ⋮ → 群组 → 添加 → 类型选 远程订阅 → 粘贴 URL → 保存。
📸 截图占位: NekoBox 群组管理 - 4更新 + 选节点
群组里点你刚加的, 下拉刷新更新订阅。回主页选任意节点。
- 5开启代理
主页右下角悬浮按钮 → 启动。首次弹 VPN 权限, 同意。
📸 截图占位: 启动按钮 + VPN 权限 - 6验证
Chrome 开 youtube.com 试试。
- • MIUI / EMUI / OPPO 等定制系统可能需要在「电池」里把 NekoBox 设为 不限制后台
- • Android 8+ 才支持完整功能
Linux
推荐客户端
配置步骤
- 1安装 sing-box
Debian/Ubuntu: sudo apt install sing-box Arch: sudo pacman -S sing-box 或下二进制: https://github.com/SagerNet/sing-box/releases
📸 截图占位: 终端安装 - 2拉订阅配置
用 curl 拉 sing-box 格式订阅: curl -o ~/.config/sing-box/config.json https://baas.tmnt.vip:8443/<token>/clash.yaml (注: clash.yaml 是 Clash 格式; Carlos Proxy 也提供 sing-box JSON 格式 → /sub.json, Phase 2 上线)
- 3运行
前台测试: sing-box run -c ~/.config/sing-box/config.json 后台 systemd: sudo systemctl enable --now sing-box
- 4设置浏览器代理
Firefox/Chrome 设置 → 网络 → SOCKS5 127.0.0.1:7890 (Clash 默认端口)
- 5验证
curl -x socks5://127.0.0.1:7890 https://google.com 应该 200
- • 服务器场景推荐 sing-box CLI 直跑, 桌面场景用 NekoRay
- • WSL2 也可以装, 但需 Windows 主机配代理转发