NyameBox : lecture technique et limites du dépôt

Le cœur sing-box de NekoBox · 1

Le README identifie ce projet comme NyameBox, décrit dans les métadonnées du dépôt comme « The Original NekoBox Rebranded », et le présente comme un utilitaire proxy graphique Qt multiplateforme pour ordinateur de bureau. Le moteur proxy est sing-box ; le README remercie SagerNet/sing-box et la description du dépôt ajoute que l'utilitaire est propulsé par sing-box et thrift. Le README indique que Windows 11/10 (arm64, x86_64, x86) et Linux sont pris en charge dès l'installation. Un mode ligne de commande sing-box est annoncé en haut du README, avec `nekobox_core sing-box --help` comme moyen d'obtenir des informations supplémentaires. Les métadonnées du dépôt indiquent C++ comme langage principal.

NekoBox concentre la configuration dans une interface Qt et délègue le trafic à `nekobox_core` et au fork de sing-box cité dans le README. La liste de protocoles est large, mais la documentation ne classe pas chaque protocole par niveau de stabilité. Le mode TUN est le point de friction le plus concret. Sous Linux, le programme peut demander un mot de passe administrateur pour relancer le cœur; sous Windows, le README cite UAC et le réglage `gvisor`, avec l’adresse `168.19.0.1/24` comme exemple de changement. Repère qr243vbi-nekobox-deep-analysis, section 1.

Protocoles et profils importés · 2

Le README liste un large éventail de protocoles pris en charge : 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 et l'enchaînement de sorties. La section travaux listés note que plusieurs protocoles non pris en charge par sing-box en amont ont été ajoutés, citant mieru, juicity, trusttunnel, vless encryption, xhttp transport, kcp transport, amnezia et snell, et désigne un fork de sing-box sous qr243vbi/sing-box comme cœur. Le README n'explique pas comment chaque protocole est configuré dans l'interface graphique ni lesquels sont considérés comme stables.

Le mode TUN est le point de friction le plus concret. Sous Linux, le programme peut demander un mot de passe administrateur pour relancer le cœur; sous Windows, le README cite UAC et le réglage `gvisor`, avec l’adresse `168.19.0.1/24` comme exemple de changement. Le projet convient à un poste Windows 10 ou 11, ou Linux, qui a besoin d’importer des profils JSON et d’utiliser un mode TUN. Il convient moins à une équipe qui exige macOS, une interface terminal complète ou un calendrier pour les éléments de la liste travaux listés. Repère qr243vbi-nekobox-deep-analysis, section 2.

TUN, gvisor et privilèges · 3

Le README décrit la prise en charge des liens de partage, des tableaux JSON de sorties et du format de lien v2rayN, ainsi qu'une prise en charge limitée des formats Shadowsocks et Clash. Les abonnements JSON complets sont pris en charge pour les configurations sing-box et de type v2rayN ; les profils JSON importés conservent leurs règles de routage et DNS d'origine, fonctionnent avec les tests d'URL et les tests automatiques, et peuvent être utilisés avec le mode TUN. Les liens d'abonnement Happ sont pris en charge, y compris les liens `happ://` chiffrés, et des groupes d'abonnement peuvent être ajoutés depuis des liens profonds de navigateur avec les URL `nekobox://` et `v2raytun://`. Le README énumère également des fonctionnalités précises des abonnements JSON : import complet de configuration sing-box avec suppression des inbounds et ajout d'inbounds d'application locaux à l'exécution, conversion JSON de type V2Ray pour les sorties VLESS, VMess, Trojan, Shadowsocks, Hysteria, Hysteria2, TUIC, direct et block, conservation des règles de routage pour les profils JSON complets y compris les règles directes spécifiques aux profils en mode TUN, migration DNS pour les versions plus récentes de sing-box y compris la conversion de serveur fakeip, tests d'URL JSON complets et tests automatiques, et détection d'Hysteria2 à partir de JSON Hysteria v2 de type v2rayN/Happ.

Le projet convient à un poste Windows 10 ou 11, ou Linux, qui a besoin d’importer des profils JSON et d’utiliser un mode TUN. Il convient moins à une équipe qui exige macOS, une interface terminal complète ou un calendrier pour les éléments de la liste travaux listés. NekoBox concentre la configuration dans une interface Qt et délègue le trafic à `nekobox_core` et au fork de sing-box cité dans le README. La liste de protocoles est large, mais la documentation ne classe pas chaque protocole par niveau de stabilité. Repère qr243vbi-nekobox-deep-analysis, section 3.

ZIP, AppImage et paquets · 4

Le README liste plusieurs voies de distribution. Les versions GitHub fournissent des ZIP portables, des installateurs Windows et des AppImages, la prise en charge AppImage commençant à la version 5.6.10. Les entrées de gestionnaires de paquets incluent Scoop (`scoop bucket add extras` et `scoop install extras/nekobox`), openSUSE (`sudo zypper install -y nekobox`), FreeBSD (`sudo pkg install -y nekobox`), ArchlinuxCN (avec instructions d'ajout du dépôt archlinuxcn et du trousseau de clés avant l'installation) et un PPA Ubuntu (`sudo add-apt-repository ppa:miamosagernaki/nekobox`). Le README fournit aussi des liens vers un dépôt OBS pour openSUSE, Mageia, Debian, Raspbian, Ubuntu, openEuler et Arch, un dépôt COPR pour RedHat, Fedora, Centos et Almalinux, et des paquets AUR nommés nekobox et nekobox-git. WinGet et Chocolatey n'apparaissent dans le README que comme titres, sans commandes ni liens en dessous ; la source n'établit pas si ces paquets existent déjà.

NekoBox concentre la configuration dans une interface Qt et délègue le trafic à `nekobox_core` et au fork de sing-box cité dans le README. La liste de protocoles est large, mais la documentation ne classe pas chaque protocole par niveau de stabilité. Le mode TUN est le point de friction le plus concret. Sous Linux, le programme peut demander un mot de passe administrateur pour relancer le cœur; sous Windows, le README cite UAC et le réglage `gvisor`, avec l’adresse `168.19.0.1/24` comme exemple de changement. Repère qr243vbi-nekobox-deep-analysis, section 4.

FAQ Windows et Linux · 5

La FAQ traite de quelques problèmes de configuration courants. En cas d'échec du mode TUN, le README suggère d'ouvrir les paramètres tun, de définir la pile sur gvisor ou de changer l'adresse tun (par exemple 168.19.0.1/24). Pour Windows 7, 8 et 8.1, il est recommandé d'installer VxKex-NEXT et de lancer NekoBox en mode VxVex. L'erreur « msvcp140.dll not found » est attribuée à une redistribution Microsoft Visual C++ manquante ou corrompue, avec un lien vers la page officielle de Microsoft. Le README indique que le mode UAC n'est pas nécessaire sous Windows ; si le mode TUN est sélectionné et que l'application ne tourne pas déjà avec des privilèges administrateur, nekobox_core redémarre après confirmation UAC. Sous Linux, définir le bit SUID n'est pas nécessaire, mais s'il n'est pas configuré, NekoBox demandera une fois un mot de passe administrateur pour redémarrer nekobox_core avec privilèges lorsque le mode TUN est sélectionné et que le programme ne tourne pas en root. La FAQ note aussi que les versions inférieures à 5.10.41 pouvaient laisser le proxy système non réinitialisé en cas de fermeture forcée alors que le proxy système était activé ; la solution pour les versions inférieures à 5.10.40 est de rouvrir l'application, d'activer le proxy système, puis de le désactiver.

Le mode TUN est le point de friction le plus concret. Sous Linux, le programme peut demander un mot de passe administrateur pour relancer le cœur; sous Windows, le README cite UAC et le réglage `gvisor`, avec l’adresse `168.19.0.1/24` comme exemple de changement. Le projet convient à un poste Windows 10 ou 11, ou Linux, qui a besoin d’importer des profils JSON et d’utiliser un mode TUN. Il convient moins à une équipe qui exige macOS, une interface terminal complète ou un calendrier pour les éléments de la liste travaux listés. Repère qr243vbi-nekobox-deep-analysis, section 5.

travaux listés sans échéance · 6

La section travaux listés du README liste des éléments que les mainteneurs n'ont pas terminés : outils en ligne de commande, intégration OpenRC/runit/systemd de nekobox_core, interface terminal, télécommande, prise en charge de toutes les plateformes supportées par sing-box et Qt (sauf macOS et iOS), ajout de protocoles non pris en charge par sing-box en amont (le README indique comme déjà ajoutés : mieru, juicity, trusttunnel, vless encryption, xhttp transport, kcp transport, amnezia, snell dans le fork de base), remplacement de l'interface statique par une interface déclarative pour éditer les proxys, et « trouver le meilleur stockage de base de données au monde ». Le README ne donne ni calendrier ni priorités pour ces éléments, et ne précise pas quels outils en ligne de commande manquent, alors que le mode ligne de commande sing-box est annoncé en haut.

Le projet convient à un poste Windows 10 ou 11, ou Linux, qui a besoin d’importer des profils JSON et d’utiliser un mode TUN. Il convient moins à une équipe qui exige macOS, une interface terminal complète ou un calendrier pour les éléments de la liste travaux listés. NekoBox concentre la configuration dans une interface Qt et délègue le trafic à `nekobox_core` et au fork de sing-box cité dans le README. La liste de protocoles est large, mais la documentation ne classe pas chaque protocole par niveau de stabilité. Repère qr243vbi-nekobox-deep-analysis, section 6.

GPL-3.0 et usage du client · 7

Le README déclare que l'utilisation du logiciel est soumise à la licence GPL-3, et les métadonnées du dépôt indiquent l'identifiant SPDX GPL-3.0. L'extrait de licence explique que la GPL est une licence copyleft garantissant la liberté de partager et de modifier le logiciel, exigeant que les destinataires reçoivent ou puissent obtenir le code source, exigeant que les versions modifiées soient marquées comme modifiées et déclarant qu'il n'y a aucune garantie pour ce logiciel libre. L'extrait ne mentionne pas de garanties de sécurité, d'engagements de support ni de conditions de garantie spécifiques au-delà de l'avertissement standard. Pour les problèmes, le README invite à écrire un ticket GitHub ou à contacter Matrix à @qr243vbi:matrix.org.

NekoBox concentre la configuration dans une interface Qt et délègue le trafic à `nekobox_core` et au fork de sing-box cité dans le README. La liste de protocoles est large, mais la documentation ne classe pas chaque protocole par niveau de stabilité. Le mode TUN est le point de friction le plus concret. Sous Linux, le programme peut demander un mot de passe administrateur pour relancer le cœur; sous Windows, le README cite UAC et le réglage `gvisor`, avec l’adresse `168.19.0.1/24` comme exemple de changement. Repère qr243vbi-nekobox-deep-analysis, section 7.

Conclusion éditoriale

Ce projet s’adresse à un lecteur dont le besoin correspond aux fonctions documentées de qr243vbi-nekobox-deep-analysis. Il ne convient pas aux scénarios laissés hors du README. Vérifiez d’abord NekoBox concentre la configuration dans une interface Qt et délègue le trafic à `nekobox_core` et au fork de sing-box cité dans le README. La liste de protocoles est large, mais la documentation ne classe pas chaque protocole par niveau de stabilité. puis confrontez ce point à la version et aux fichiers réellement utilisés.

Sources officielles

1. Official documentation
2. Official README
3. Project repository
4. Release notes