NyameBox：以 sing-box 为核心的 Qt 代理客户端
该项目围绕「qr243vbi/nekobox」构建，面向真实业务场景提供可复用的开源实践方案，支持稳定落地与可扩展的项目实践。
秒懂
- 它是什么？
- qr243vbi/nekobox 提供跨平台 Qt 图形界面、sing-box 命令行模式、多种协议和订阅导入路径，README 也列出尚未完成的系统集成。
- 适合谁用？
- 适合需要在 Windows 或 Linux 桌面上管理 sing-box 配置，并且愿意按发行包和协议逐项测试的用户。不适合把 README 的协议清单直接当作每个平台都稳定支持的保证。
- 能商用吗？
- 可以，但有条件。GPL-3.0 是 copyleft 许可证：如果你分发包含它的软件，就必须以同一许可证公开该软件的源代码。只在内部运行、不对外分发，则不会触发这项义务。
- 还在维护吗？
- 在维护。仓库最近一次提交在 10 天前。
- 用什么语言写的？
- 主要是 C++（依据 GitHub 的语言统计）。
以上回答依据项目的 GitHub 数据（最近同步于 2026年9月14日）和我们的分析，不构成法律意见。
开源项目深度解析
围绕 sing-box 构建 · qr243vbi-nekobox-deep-analysis
README 将这个项目标识为 NyameBox，仓库元数据将其描述为"The Original NekoBox Rebranded"，并定位为一个基于 Qt 的桌面跨平台图形界面代理工具。代理引擎是 sing-box，README 对 SagerNet/sing-box 表示了致谢，仓库描述还补充说该工具由 sing-box 和 thrift 驱动。README 声明 Windows 11/10（arm64、x86_64、x86）和 Linux 开箱即用。README 开头宣布了 sing-box 命令行模式，并给出 `nekobox_core sing-box --help` 作为获取更多信息的方式。仓库元数据将主要语言列为 C++。
项目核验记录：qr243vbi-nekobox-deep-analysis 应固定当前提交和运行环境，围绕 README 明确给出的命令、文件和输出建立最小测试。记录安装命令的完整输出，保留配置文件、依赖锁定信息、版本号和错误日志。检查功能时先使用最小输入，再逐步加入真实数据；比较运行前后的文件、网络请求、终端输出和退出状态。遇到文档没有说明的行为，不把它写成支持承诺，而是把观察到的结果与对应版本一起保存。对于升级，应使用同一输入重跑旧版和新版，逐项比较结果，特别检查权限、缓存、网络连接、导入导出、错误处理和恢复路径。这样才能把这个项目的 README 说明转成可复核的工程记录。
详细核验方案：qr243vbi-nekobox-deep-analysis 的使用者应先建立隔离目录，记录仓库提交、默认分支、依赖版本和操作系统。按照 README 中与本项目对应的安装命令创建最小运行实例，保存命令输出、退出码、配置文件和生成文件。随后用项目自己的核心输入做一次成功案例，再故意改变一个参数或移除一个依赖，观察错误是否明确、状态是否可恢复、日志是否指出具体文件和步骤。若项目涉及网络、同步、权限、插件、编译器、订阅、日历或浏览器页面，应分别记录请求地址、权限提示、缓存位置、导入前后的数据和恢复后的结果。对两个版本使用同一组输入，比较输出、警告、耗时和资源占用；不要以仓库星标或 README 形容词替代这些项目级证据。这样形成的记录可以回答它适合谁、哪条能力已经被验证、哪条能力仍然只在文档中出现，也能在升级失败时回到具体配置和日志。
针对 qr243vbi-nekobox-deep-analysis 的复核还应保留具体证据链：记录安装前的环境、安装后的版本、首次启动的退出状态、核心配置、生成文件和日志路径。用一个最小案例确认主流程，再用一个边界案例确认失败处理。涉及浏览器时检查控制台和网络面板，涉及同步时比较两端状态，涉及编译时保存缓存与生成物，涉及代理或权限时记录路由、DNS、管理员提示和核心进程状态，涉及自动化时检查任务顺序与实际摘要。升级前后使用同一个输入重跑，按字段比较结果，不把未经运行的 README 描述写成已经发生的体验。
追加核对：保存本次项目的输入、输出和日志，按命令退出码确认成功或失败，随后用同一版本重复一次，比较结果是否一致。
协议覆盖 · qr243vbi-nekobox-deep-analysis
README 列出了大量受支持的协议：SOCKS、HTTP(S)、Shadowsocks、Trojan、VMess、VLESS、Hysteria 1、Hysteria 2、TUIC、AnyTLS、ShadowTLS、Mieru、Juicity、TrustTunnel、Naive、Wireguard、AmneziaWG、Tailscale、SSH、Tor、Snell、Custom Outbound、Custom Config、Extra Core 以及链式出站。未完成事项 部分指出，上游 sing-box 不支持的几个协议已经被加入，包括 mieru、juicity、trusttunnel、vless encryption、xhttp transport、kcp transport、amnezia 和 snell，并指向 qr243vbi/sing-box 这个 sing-box 分支作为核心。README 没有解释每个协议在图形界面中如何配置，也没有说明哪些协议被认为是稳定的。
订阅导入格式 · qr243vbi-nekobox-deep-analysis
README 描述了对分享链接、出站 JSON 数组和 v2rayN 链接格式的支持，以及对 Shadowsocks 和 Clash 格式的有限支持。完全 JSON 订阅支持 sing-box 和 v2rayN 风格配置；导入的 JSON 配置会保留原有的路由和 DNS 规则，可用于 URL 测试和自动测试，也可与 TUN 模式一起使用。Happ 订阅链接受支持，包括加密的 `happ://` 链接，也可以通过浏览器深链接使用 `nekobox://` 和 `v2raytun://` URL 添加订阅组。README 还列出了具体的 JSON 订阅功能：完整导入 sing-box 配置并在运行时去除入站、添加本地应用入站；针对 VLESS、VMess、Trojan、Shadowsocks、Hysteria、Hysteria2、TUIC、direct 和 block 出站进行 V2Ray 风格 JSON 转换；保留完整 JSON 配置的路由规则，包括 TUN 模式下的配置文件专属直连规则；针对较新 sing-box 版本的 DNS 迁移，包括 fakeip 服务器转换；完整的 JSON URL 测试和自动测试；以及从 v2rayN/Happ 风格的 Hysteria v2 JSON 中检测 Hysteria2。
分发包渠道 · qr243vbi-nekobox-deep-analysis
README 列出了几条分发途径。GitHub Releases 提供便携 ZIP、Windows 安装程序和 AppImage，其中 AppImage 支持从 5.6.10 版本开始。软件包管理器条目包括 Scoop（`scoop bucket add extras` 和 `scoop install extras/nekobox`）、openSUSE（`sudo zypper install -y nekobox`）、FreeBSD（`sudo pkg install -y nekobox`）、ArchlinuxCN（安装前需要先添加 archlinuxcn 仓库和密钥）以及一个 Ubuntu PPA（`sudo add-apt-repository ppa:miamosagernaki/nekobox`）。README 还提供了面向 openSUSE、Mageia、Debian、Raspbian、Ubuntu、openEuler 和 Arch 的 OBS 仓库链接，面向 RedHat、Fedora、Centos 和 Almalinux 的 COPR 仓库链接，以及名为 nekobox 和 nekobox-git 的 AUR 软件包。WinGet 和 Chocolatey 在 README 中只是标题，下面没有命令或链接；来源没有确定这些软件包是否已经存在。
FAQ 中记录的配置问题 · qr243vbi-nekobox-deep-analysis
FAQ 涵盖了几个常见的配置问题。对于 TUN 模式失败，README 建议打开 tun 设置，将堆栈设为 gvisor，或更换 tun 地址（例如 168.19.0.1/24）。对于 Windows 7、8 和 8.1，建议先安装 VxKex-NEXT，然后以 VxVex 模式启动 NekoBox。"msvcp140.dll not found"错误被归因于 Microsoft Visual C++ Redistributable 缺失或损坏，并附有微软官方页面链接。README 说明 Windows 上不需要以 UAC 模式运行；如果选择了 TUN 模式且程序尚未以管理员权限运行，nekobox_core 会在 UAC 确认后重启。在 Linux 上，不需要设置 SUID 位，但如果未配置，选择 TUN 模式且程序未以 root 运行时，NekoBox 会请求一次管理员密码来以特权重启 nekobox_core。FAQ 还指出，低于 5.10.41 的版本在启用系统代理时被强制退出，可能无法重置代理；对于低于 5.10.40 的版本，解决方法是重新打开应用，启用系统代理，再禁用它。
未完成事项 清单中的未完成工作 · qr243vbi-nekobox-deep-analysis
README 的 未完成事项 部分列出了维护者尚未完成的事项：命令行工具、nekobox_core 的 OpenRC/runit/systemd 集成、终端界面、远程控制、支持 sing-box 和 Qt 支持的所有平台（macOS 和 iOS 除外）、添加更多上游 sing-box 不支持的协议（README 表示目前已添加：mieru、juicity、trusttunnel、vless encryption、xhttp transport、kcp transport、amnezia、snell，位于核心分支中）、用声明式界面替换静态界面来编辑代理，以及"找到世界上最好的数据库存储"。README 没有给出这些事项的时间表或优先级，也没有说明哪些命令行工具仍然缺失，尽管开头已经宣布了 sing-box 命令行模式。
编辑结论
适合需要在 Windows 或 Linux 桌面上管理 sing-box 配置，并且愿意按发行包和协议逐项测试的用户。不适合把 README 的协议清单直接当作每个平台都稳定支持的保证。先用目标版本导入一份脱敏 JSON，检查路由和 DNS 是否保留，再分别测试 URL、TUN、系统代理、权限重启和核心日志；Windows 还要确认 Visual C++ 运行库。
社区笔记