yonggekkk

yonggekkk/sing-box-yg

Shell GPL-3.0 DevOps

Sing-box精装桶五合一协议VPS专用脚本:三大独家功能!自签/acme双证书切换、Argo固定临时双隧道(可共存)、Psiphon赛风VPN(30个国家)分流功能。Hostuno三合一代理脚本

9.5k stars
3k forks
active
GitHub +95 / week

9.5k

Stars

3k

Forks

1

Open issues

1

Contributors

AI Analysis

Sing-box-yg is a shell-based installation script for deploying multiple proxy protocols (Vless, Vmess, Hysteria2, Tuic, AnyTLS) on VPS or Serv00/Hostuno platforms. It specializes in zero-knowledge deployments for users unfamiliar with proxy configuration, supporting IPv4/IPv6, multiple architectures, and advanced features like Argo tunneling, certificate switching, and Psiphon VPN splitting across 30 countries. This tool is narrowly targeted at users seeking self-hosted proxy infrastructure w...

DevOps DevOps Tool Discovery value: 3/10
Documentation 8/10
Activity 10/10
Community 9/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-deployment sing-box vps-automation shell-script tunnel-management
Actively maintained Well documented Niche/specialized use case GPL-3.0 licensed Popular Beginner friendly Production ready
Deep Analysis · Based on README and public signals
2w ago

Chinese-language shell script bundles five proxy protocols on VPS with Argo tunnel and Psiphon integration

sing-box-yg is a one-click VPS deployment script that installs and manages five coexisting proxy protocols (Vless-Reality, Vmess-WS/Argo, Hysteria2, TUIC-v5, AnyTLS) on top of the sing-box core. It targets Chinese-speaking users who need censorship circumvention infrastructure on personal VPS or free hosting platforms like Serv00/Hostuno. Key differentiators include dual certificate management, Cloudflare Argo tunnel integration (both fixed and temporary), Psiphon VPN routing across 30 countries, and fully localized subscription generation without third-party converters. Maintained by a single author ('yongge') with an active blog, YouTube channel, and Telegram community.

Origin

Created in October 2023 as sing-box gained traction as an alternative to Xray/V2Ray cores. The project grew rapidly alongside the wider sing-box ecosystem, with the author also maintaining the related ArgoSBX project.

Growth

Growth appears driven by the author's active YouTube tutorials and Telegram community targeting Chinese users seeking reliable self-hosted circumvention. Steady star accumulation (94 stars in 7 days as of evaluation date) and 2,964 forks suggest sustained grassroots adoption. Tutorials covering beginner-friendly setup lowered the barrier significantly.

In production

No formal production deployment case studies exist. However, 9,349 stars, 2,964 forks, an active Telegram group, and a YouTube channel with multiple tutorial videos targeting real deployment scenarios suggest substantial real-world usage among individual Chinese-speaking users running personal VPS instances. Adoption scale is likely in the tens of thousands of individual deployments but cannot be independently verified.

Code analysis
Architecture

Appears to be a single-entrypoint shell script (sb.sh / serv00.sh) that downloads, configures, and manages sing-box binaries. Likely uses template-based JSON config generation for each protocol. Argo tunnel integration likely shells out to cloudflared. Psiphon integration is likely handled via a bundled or downloaded binary. Architecture is script-orchestration rather than a standalone application.

Tests

not documented in README

Maintenance

Last push was 2026-06-13, approximately 14 days before evaluation date. This indicates active, recent maintenance. The README references multiple recent protocol additions (AnyTLS added in a recent update) and continued video tutorials into 2025-2026, suggesting the author is actively tracking upstream sing-box changes.

Honest verdict

ADOPT IF: you are a Chinese-speaking individual user deploying a personal VPS for censorship circumvention who wants multiple protocols, Argo CDN bypass, and Psiphon fallback in a single automated script with good tutorial support. AVOID IF: you need enterprise-grade deployment tooling, infrastructure-as-code integration, multi-server management, or are operating in a jurisdiction where simply running such scripts creates legal exposure. MONITOR IF: you are building tools or services targeting the Chinese circumvention user base and want to understand what protocol combinations and UX patterns have real-world traction.

Independent dimensions

Mainstream potential

2/10

Technical importance

5/10

Adoption evidence

5/10

Risks
  • Single-maintainer dependency: the entire project depends on one author (yongge); abandonment or burnout would leave users without updates as upstream sing-box evolves.
  • Legal and platform risk: Serv00 free hosting accounts have a documented risk of being banned for running proxy scripts per the README itself; the circumvention use case creates jurisdictional risk for users in China.
  • Security auditability: shell scripts that download and execute binaries (cloudflared, Psiphon, sing-box) from external sources are difficult for end users to audit; supply chain risk is real but not quantifiable without code review.
  • Upstream coupling: the script is tightly coupled to specific versions and behaviors of sing-box, cloudflared, and Psiphon; breaking changes upstream can break the script with no graceful fallback.
  • No automated testing: absence of documented tests means regressions from frequent updates may reach users before being caught, particularly given the multi-protocol complexity.
Prediction

Likely to remain a well-maintained niche tool with stable to modest growth, closely tracking sing-box upstream releases, as long as the author remains active. Mainstream potential is structurally limited by its narrow geographic and use-case focus.

0 found this helpful

Newsletter

Get analyses like this every Monday

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

Languages

No language breakdown available.

Information

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

Stars over time

Loading…

No commit data available.

Contributors over time

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

Loading…

Open issues

No open issues — clean slate.

Open pull requests

No open pull requests.

Top contributors

Contributor data not available yet.

Recent releases

No releases published yet.

Similar repos

eooce

eooce/Sing-box

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

4.9k Shell DevOps
fscarmen

fscarmen/sing-box

Sing-box is a comprehensive one-click installation suite for deploying multiple...

5k Shell DevOps
yonggekkk

yonggekkk/argosbx

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

5.4k Shell DevOps
233boy

233boy/sing-box

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

4.2k Shell DevOps
jasonwong1991

jasonwong1991/easy_proxies

Easy Proxies is a sing-box-based proxy pool manager for Go that aggregates...

1.6k Go DevOps
vs. alternatives
fscarmen/sing-box

Similar sing-box wrapper script with 4,897 stars. sing-box-yg differentiates with more bundled features (Psiphon, dual Argo tunnels, dual certs) and more extensive tutorial ecosystem, at the cost of increased script complexity.

yonggekkk/argosbx

The author's own sibling project (5,349 stars) described as lighter and faster. sing-box-yg is the feature-heavy 'premium' variant while argosbx targets users wanting minimal setup.

mack-a/v2ray-agent

Larger project (21,133 stars) covering V2Ray/Xray ecosystem. More mature and widely referenced, but targets a different core (Xray vs sing-box) and does not include Argo or Psiphon features.

alireza0/s-ui

Web UI panel for sing-box (9,294 stars). Targets users who prefer a GUI management interface rather than CLI scripts. Different operational model but overlapping user base.

eooce/Sing-box

Directly cited in the README as a source for the Serv00 component. Serves similar free-hosting deployment use cases; sing-box-yg extends it with additional protocol and routing features.