fscarmen

fscarmen/sing-box

Shell GPL-3.0 DevOps

Sing-box 全家桶 --- 一键多协议脚本。支持 Reality、Hysteria2 、TUIC 、Trojan 、Shadowsocks 、 AnyTLS 、ShadowTLS 、 Vmess 、 VLESS 、NaiveProxy,搭配 Argo 隧道等,多客户端订阅(Clash / V2rayN / Throne / ShadowRocket / SFA ),无须域名、功能强大、配置灵活。

5k stars
1k forks
active
GitHub +41 / week

5k

Stars

1k

Forks

2

Open issues

3

Contributors

AI Analysis

Sing-box is a comprehensive one-click installation suite for deploying multiple proxy protocols (Reality, Hysteria2, TUIC, Trojan, Shadowsocks, and others) on VPS infrastructure, with built-in support for Argo tunneling and multi-client subscription formats (Clash, V2rayN, ShadowRocket, etc.). It serves network administrators and users in regions requiring circumvention infrastructure, providing domain-free deployment and flexible protocol configuration. This tool is specialized for proxy ser...

DevOps DevOps Tool Discovery value: 4/10
Documentation 7/10
Activity 9/10
Community 8/10
Code quality 5/10

Inferred from signals mentioned in the README (tests, CI, type safety) — not a review of the actual code.

Overall score 7/10

AI's overall editorial judgment — not an average of the bars above, can weigh other factors too.

proxy-infrastructure multi-protocol tunnel-automation vps-deployment circumvention-tool
Actively maintained Niche/specialized use case Production ready
Deep Analysis · Based on README and public signals
1w ago

Shell-based sing-box deployment toolkit for multi-protocol proxy servers with subscription management

fscarmen/sing-box is a shell script wrapper that automates deployment and configuration of sing-box proxy servers, supporting multiple protocols (Reality, Hysteria2, TUIC, Trojan, Shadowsocks, etc.) with CDN integration via Argo Tunnel. Targets users in regions requiring circumvention infrastructure who need rapid, multi-protocol server setup without domain ownership. Adoption appears concentrated in Chinese-speaking communities; 4,927 stars reflects moderate popularity within a specialized ecosystem of similar tools.

Origin

Created September 2023, entering its third year of active development. Part of a larger ecosystem of sing-box wrapper scripts (competing repos show similar patterns). Recent activity (last push June 27, 2026) indicates ongoing maintenance. Appears to have evolved from simpler deployment scripts by adding progressively more features: CDN support, post-install modifications, protocol expansion, and performance optimizations.

Growth

Gained 65 stars in 7 days (as of June 30, 2026), indicating modest but steady interest. Growth appears driven by feature additions (v1.3.14 released May 29, 2026) rather than viral adoption. Ecosystem context shows 5–6 competing similar-quality projects (yonggekkk/sing-box-yg with 9,379 stars is substantially larger), suggesting the category has not consolidated around a single tool. No evidence of growth acceleration or mainstream adoption outside niche communities.

In production

Adoption not verified through explicit documentation. No case studies, deployment counts, or organizational endorsements mentioned. Star count (4,927) and fork count (1,032) suggest non-trivial usage, but these metrics do not distinguish between active deployments and exploratory forks. Presence of multiple similar competing projects (yonggekkk/sing-box-yg at 9,379 stars, argosbx at 5,366) with higher star counts suggests fragmented adoption across similar tools rather than consolidation around any single project. Chinese-language README and references suggest primary user base is Chinese-speaking.

Code analysis
Architecture

Based on README: shell script that generates sing-box JSON configurations, manages firewall rules (UFW/iptables), orchestrates protocol-specific setup flows, and exports client-specific subscription formats (Clash, V2rayN, ShadowRocket, etc.). Appears modular with separate logic paths for different protocols and installation scenarios. README describes performance optimization in v1.3.6 involving bash namerefs and pre-scanned lookup maps, suggesting attention to subprocess overhead in repeated string operations. No source code inspection possible; architecture inferred from README task descriptions.

Tests

Not documented in README. No mention of test suites, CI/CD, or validation framework. This is typical for deployment scripts in this ecosystem but represents a risk for reproducibility.

Maintenance

Last push June 27, 2026 (3 days before analysis date) indicates active maintenance. Changelog entries span from May 29, 2026 back through January 2025, showing consistent updates every 1–3 weeks. Updates appear to address feature requests (Hysteria2 Realm, port hopping, certificate management), client compatibility (v2rayN link generation), and performance (concurrent process optimization). No evidence of unmaintained dependencies or security issue backlog in README.

Honest verdict

ADOPT IF: you operate VPS infrastructure in regions requiring circumvention, need rapid multi-protocol deployment without domain registration, and are comfortable with shell script automation and Chinese-language documentation. You should also verify that the Argo Tunnel integration aligns with your CDN provider strategy. AVOID IF: you require formal support, audit trails, enterprise SLAs, extensive test coverage, or English-primary documentation; or if you prefer managed, click-button deployment platforms over infrastructure-as-script. MONITOR IF: you are evaluating sing-box wrappers for production use; consider whether larger competing projects (yonggekkk variants) may have better long-term maintainability or feature parity before committing.

Independent dimensions

Mainstream potential

3/10

Technical importance

5/10

Adoption evidence

3/10

Risks
  • No documented test coverage or validation framework; shell scripts are prone to edge-case failures across Linux distributions and kernel versions.
  • Fragmented user base across multiple near-identical competing projects; if maintainer becomes unavailable, users may face decision paralysis about which fork to migrate to.
  • Heavy reliance on Argo Tunnel (Cloudflare) as a core feature; policy changes or rate-limiting by Cloudflare could break deployments without direct control.
  • Chinese-language primary documentation may create barriers for non-Chinese users seeking support or understanding configuration details.
  • Rapid protocol addition (AnyTLS, ShadowTLS, Naive) without mention of long-term stability testing; newer protocols may have immature client support or undiscovered failure modes.
Prediction

Likely to remain a functional, actively maintained tool within its niche (Chinese-speaking VPS operators and proxy enthusiasts) without achieving mainstream adoption outside specialized communities. Slow, steady feature additions suggest sustainability but limited growth potential. Marginal differentiation from competing wrappers may cause gradual user migration to larger ecosystem projects (yonggekkk variants) if those projects add equivalent features.

0 found this helpful

Newsletter

Get analyses like this every Monday

Free weekly digest of the most interesting open-source discoveries.

Languages

Shell
99.7%
Dockerfile
0.3%

Information

Language
Shell
License
GPL-3.0
Last updated
3d ago
Created
34mo ago
Analyzed with
anthropic/claude-haiku-4-5

Stars over time

Loading…

Contributors over time

Top 100 contributors only — repos with more will plateau at 100.

Loading…

Recent releases

No releases published yet.

Similar repos

yonggekkk

yonggekkk/sing-box-yg

Sing-box-yg is a shell-based installation script for deploying multiple proxy...

9.5k Shell DevOps
eooce

eooce/Sing-box

This is a specialized installation script for sing-box, a multi-protocol proxy...

4.9k Shell DevOps
233boy

233boy/sing-box

A one-command installation and management script for sing-box, a modern...

4.2k Shell DevOps
yonggekkk

yonggekkk/argosbx

ArgoSBX is a one-command proxy deployment script for Linux VPS and Docker...

5.4k Shell DevOps
fscarmen

fscarmen/ArgoX

ArgoX is a one-click deployment script for setting up Xray proxy servers...

1.9k Shell DevOps
vs. alternatives
yonggekkk/sing-box-yg (9,379 stars)

Substantially larger GitHub presence; likely represents market leader in this subcategory of sing-box wrappers. fscarmen/sing-box appears to serve similar use case with different feature prioritization or user community.

yonggekkk/argosbx (5,366 stars)

Also focuses on Argo Tunnel integration with sing-box. fscarmen/sing-box differentiates via post-install modification capabilities and protocol expansion (AnyTLS, ShadowTLS), but market share comparison unclear.

eooce/Sing-box (4,843 stars)

Comparable star count; likely serves overlapping market. Marginal differentiation suggests users may switch between similar projects based on specific feature needs or maintainer responsiveness.

Official sing-box (sagernet/sing-box)

fscarmen/sing-box is a high-level wrapper; it does not compete with the core sing-box project but rather sits atop it, abstracting configuration complexity for specific deployment scenarios.

233boy/sing-box (4,166 stars)

Another wrapper with lower star count; suggests fscarmen maintains competitive positioning but is not category leader.