Repolode
Submit
CleanIP

CleanIP/sh.cd

One-line bash script that runs a full server check-up: hardware and benchmarks, IP quality, and network latency and routing.

View on GitHubWebsite
Stars
248
Forks
10
Open issues
0
Last commit
4 days ago

What is it?

sh.cd is a bash check-up script from CleanIP. Run with one curl command, it tests a Linux or macOS server in three areas: hardware and performance (CPU and memory benchmarks, disk speed and SMART health on bare metal, virtualization type), IP quality (geolocation, risk scoring, streaming and AI service unlock status, mail port reachability), and network quality (NAT type, TCP tuning, latency to Chinese provinces and international regions, and backbone routing for China Telecom, Unicom and Mobile).

It is aimed at people choosing or operating VPS and dedicated servers, especially those who need to know how a machine performs from mainland China. The menu offers a full run or single sections, and flags such as -j for JSON output and -x for testing through a proxy give scripted control. Each run ends with a results page URL that can be shared or exported as Markdown; -P disables it.

Some checks need extra tools (sysbench, fio, and on physical machines smartmontools and dmidecode), which the script asks to install with the system package manager. Network tests go out to public speedtest and latency nodes, and the report data is submitted to sh.cd to generate the results page.

Key features

  • 01Runs hardware, IP quality, and network checks in one command with a menu or flags.
  • 02Tests CPU, memory, and disk performance, with SMART data on physical machines.
  • 03Checks IP risk scores, VPN/proxy/Tor flags, and streaming and AI service unlock status.
  • 04Measures latency to all Chinese provinces and to major international regions.
  • 05Identifies China backbone routes such as CN2 GIA, 163, and CN2 GT.
  • 06Generates a shareable results page with Markdown export.

Use cases

  • Vetting a new VPS or dedicated server before deploying to users in mainland China.
  • Checking whether an IP is clean enough for mail sending or streaming access.
  • Comparing hardware and network performance across several providers.
  • Archiving a machine's check-up as JSON for later comparison.

Topics

#server-benchmark#vps#network-testing#ip-quality#latency-test#bash#china-route#speedtest

FAQ

What is sh.cd?
One-line bash script that runs a full server check-up: hardware and benchmarks, IP quality, and network latency and routing. sh.cd is a bash check-up script from CleanIP. Run with one curl command, it tests a Linux or macOS server in three areas: hardware and performance (CPU and memory benchmarks, disk speed and SMART health on bare metal, virtualization type), IP quality (geolocation, risk scoring, streaming and AI service unlock status, mail port reachability), and network quality (NAT type, TCP tuning, latency to Chinese provinces and international regions, and backbone routing for China Telecom, Unicom and Mobile).
Is sh.cd free to use? What license does it have?
sh.cd is open source under the MIT license. Check the license terms before using it in commercial products.
Is sh.cd still maintained?
Actively maintained. The last commit to sh.cd was on Oct 15, 2026.
What can I use sh.cd for?
Vetting a new VPS or dedicated server before deploying to users in mainland China. Checking whether an IP is clean enough for mail sending or streaming access. Comparing hardware and network performance across several providers. Archiving a machine's check-up as JSON for later comparison.
Where can I get sh.cd?
The source code and installation instructions are on GitHub: https://github.com/CleanIP/sh.cd

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects