项目归档说明
2026.11.21
关注这个项目的朋友大概已经发现,Nekobox 在一年多前就已经基本进入停滞状态,距离上一次版本更新也过去了大半年。
归档最直接的原因其实很简单:我个人已经不再需要高强度使用这类工具了。虽然偶尔需要连一下节点时,相比其他客户端我依然习惯打开它,但“勉强够用”的状态已经无法支撑我投入大量精力去重构或大改(其他维护者也缺乏继续推进的动力)。
借着这次正式给项目画上句号的机会,梳理一下过往的开发经历,也顺便给后来者留一些关于这个圈子的个人观察与感悟。
上游与生态
过去这段时间,无论是 Android 底层生态还是 sing-box 上游,都发生了相当大的变化。跟进这些变动需要消耗巨大的时间与精力,而在我自身没有强需求的情况下,很难再维持高频适配。
另外想向前辈“世界”表达一下歉意。在 2023 年,我对她的一些做法有过不少公开评价。回过头看,那些言论确实欠妥。无论如何,她能够长期、稳定地维护 sing-box,单是这份坚持与执行力就非常难得,值得尊重。
项目后续与替代方案
目前我并没有找到合适且有意愿接手的维护者,这在很大程度上也受限于项目代码架构的陈旧。
社区里其实涌现过几个针对 Nekobox for Android 的 Fork,但维护方向与我预期的路线不太契合,这里就不做特定推荐了。
至于更早停更的 PC 版(Qt 版 sing-box GUI),此前我觉得 Throne 的实现思路很清晰,不过后续它在架构上选择将 Xray-core 也整合了进去,定位上就见仁见智了。
如今在 AI 工具的辅助下,各类客户端呈现出“一盒落、万盒生”的状态,社区百花齐放、各取所需,我认为这反而是更好的发展形态。
创作历程回顾
启动这个项目的初衷很纯粹,纯粹是以实际需求为导向:在当时的生态里,缺乏一个能将 sing-box 内核完整适配到手机端、同时具备高自由度的客户端(通俗点说,我当时想要一个基于 sing-box 内核的 v2rayNG)。
项目的最初定位偏向极客与高级玩家,希望将尽可能多的底层参数直接暴露在移动端供手动调优。受限于当时的环境,不少交互逻辑乃至部分底层代码直接参考了 shadowsocks-android SagerNet 和 v2rayNG。
但随着项目传播,大量非技术背景的普通用户开始涌入。我曾尝试过一些折中妥协,可这与项目最初偏硬核的定位产生了根本性冲突,这也是后来发布页上出现那些“劝退文案”的缘由。
2021 ~ 2022:混乱的探索与整合
当时 SagerNet 已经做了一部分探索工作(SagerNet 由世界主导,Nekobox 的前身 Matsuri 也是基于 SagerNet 的 Fork)。后来随着世界将重心转向 sing-box,SagerNet 逐渐停更。
2022 年我先启动了 PC 端的 nekoray (Qt)。sing-box 发布后,我认为它相比传统的 v2fly/xray 在架构上更优,便尝试将 nekoray 的内核替换为 sing-box。在 PC 端与 Android 端交叉开发的过程中,我发现两个平台在 sing-box 的内核对接逻辑上有相当高的复用空间。
客观而言,在那段时期 Clash 生态的成熟度更高(项目借鉴过 Clash 的 TUN 实现,sing-box 早期也参考了许多 Clash 的设计)。之所以没有选用 Clash 作为内核,一方面是当时 Clash 客户端生态已经相当拥挤,另一方面也是因为我个人对那一套体系相对陌生。
2023:高强度开发与疲劳期
在 PC 端验证了可行性后,我决定把 Android 端也全面转向 sing-box,这最终奠定了目前版本的基底(底层从 shadowsocks-android 演进到 sing-box,遗留历史确实不少)。
然而到了 2023 年下半年,长期高强度的开发、陡增的用户答疑成本,加之我个人在协同管理上的不成熟(曾短暂引入过一些不太契合的协助者),让我对这个项目产生了严重的倦怠感。从 2024 年开始,项目基本就转入了低活跃度与代管状态。
2025 ~ 2026:收尾
到了 2025 年,看着项目中积攒的历史债务,我还是希望能善始善终。借助当时逐步成熟的辅助编程工具,我把代码库中遗留的一批顽固历史 Bug 逐一排查修复,并尽可能同步了较新的内核,目标是交付一个相对稳定、故障率较低的收官版本。最后的改动在 2026 年春节期间打包发布,成为了该项目的最后一个正式版本。
关于代码架构的说明
Nekobox 的主体代码基本成型于 2021 至 2023 年间。在当时的开发条件下,很多实现为了快速落地功能,采用了不少权宜之计,甚至牺牲了代码规范与优雅度,这客观上导致了项目后期维护成本高、被外界戏称为“屎山”。
现在进入了 AI 辅助研发的阶段,重构与清理遗留代码的门槛已经大幅降低。对于有兴趣深入折腾的开发者来说,重新理清这些结构或许不再是一件那么痛苦的事。
圈子、生态与群体沟通
在这里也想给后来涉足相关领域工具开发的同学提一点参考建议。
关于服务提供方(机场生态)
这是一个高度碎片化、参差不齐的庞大群体。对于终端用户来说,订阅服务确实大幅降低了门槛;但对于独立客户端开发者而言,去适配那么多机场,去面对大量机场的用户的反馈,是一个极度消耗精力的黑洞。
关于用户体量与群体画像
软件只要稍有知名度,就会迅速吸引体量极其庞大的泛用户群体。这背后往往伴随着特殊的网络环境和信息差——大量缺乏常识的用户会直接涌入 Issue 区或群组,提出大量与客户端本身无关的问题,甚至带来难以预料的麻烦。
这并不是单纯的技术问题,背后的成因很复杂,可能与特定环境下的大众认知习惯和信息壁垒有关。当时我深受其累,在处理社群关系时也过于坚持技术思维,缺乏足够的包容度和管理技巧;回头反思,2023 年与世界产生的那些隔阂,根源很大程度上也是双方在“如何面对与管理海量泛用户”这一策略上的认知分歧。
给后来者的建议是:
做这类工具,“用户越多,麻烦通常呈指数级增加”。在决定立项或公开分发前,务必提前想清楚目标受众定位,尽早设立明确的沟通边界与反馈过滤机制(例如关闭 Issue 琐碎提问、严格限制讨论范围)。千万不要试图无底线地去迎合所有层级的用户,否则最终被消耗殆尽的一定是开发者自己的热情。
结语
如果未来的某一天,我对这个生态重新产生了纯粹的兴趣,或许会选择抛开所有历史包袱,从零开始搭建一个全新的轻量玩具。
但在可预见的短期内,应该不会再有这方面的计划了。感谢大家过去几年的关注与支持。