explaingit

palemoky/cn-check

Analysis updated 2026-05-18

91TypeScriptAudience · generalComplexity · 3/5Setup · moderate

TLDR

China Access Check is a browser tool that scores whether your network setup would be flagged as coming from mainland China, using IP location, latency, timezone, and other signals.

Mindmap

mindmap
  root((cn-check))
    What it does
      Detects China network signals
      Weighted scoring
      Cross-signal checks
    Tech stack
      TypeScript
      Cloudflare Workers
      JavaScript
    Use cases
      Test VPN or proxy setup
      Understand leak signals
      Self-host for privacy
    Signals
      IP location
      Latency
      DNS resolver
      WebRTC leaks

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Check whether your current VPN or proxy setup is convincingly hiding a mainland China network location.

USE CASE 2

Understand which specific signals, like DNS resolver location or WebRTC leaks, are exposing your real network origin.

USE CASE 3

Self-host the tool on your own Cloudflare account for privacy since it stores no data.

USE CASE 4

Deploy the optional DNS-probe companion service on a VPS to add resolver-location detection to the score.

What is it built with?

TypeScriptCloudflare WorkersJavaScript

How does it compare?

palemoky/cn-checkdabberman456/finance-mcp-appryderwe/sollin-music-desktop
Stars919191
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity3/52/52/5
Audiencegeneralgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Core tool deploys with npm and wrangler, the optional DNS-resolver check needs a separate self-hosted VPS service.

No license information is stated in the README.

In plain English

China Access Check is a browser tool that tells you whether your current network setup would be flagged as coming from mainland China by sites like ChatGPT, Claude, or LinkedIn. It reproduces the detection tricks those sites commonly use, scores each one, and gives you a combined verdict about which signals your connection is leaking. It runs on Cloudflare Workers as static pages plus a small edge API, and it stores no data about you. The tool checks a long list of signals and weights each one by how reliable it is. These include where your IP address is geographically registered, whether commonly blocked sites like Google or YouTube are reachable, how fast your connection reaches mainland Chinese sites versus international ones, your browser's timezone and language settings, which DNS resolver you are using, whether your device blocks the Taiwan flag emoji the way mainland Chinese devices often do, and whether WebRTC leaks your real IP address. Physical network delay in particular is hard to hide with a VPN, since it reflects your actual distance from a server rather than what your IP claims. Each check produces a confidence score that gets multiplied by its weight and added up, and the tool also cross-checks signals against each other. For example, if your IP looks foreign but your connection to mainland Chinese sites is unusually fast while connections to US sites are unusually slow, that combination raises suspicion that you are using a proxy that only routes some of your traffic. The final score from 0 to 100 sorts results into rough categories, from very likely to be identified as mainland Chinese to basically undetectable. The project is a Cloudflare Worker with a native JavaScript frontend and no external dependencies for its scoring logic. Setup is npm install followed by a local dev server or a Cloudflare deploy command, with a one-time wrangler login the first time you deploy. One detection check, the DNS resolver check, is optional and requires deploying a small companion service on your own VPS, if it is not configured, that check is simply skipped and does not affect the rest of the score.

Copy-paste prompts

Prompt 1
Explain how China Access Check scores IP location, latency, and timezone signals to detect a mainland China connection.
Prompt 2
Walk me through deploying this Cloudflare Worker project with npm install and npm run deploy.
Prompt 3
What is the optional dns-probe service in this repo and why does it need to run on my own VPS?
Prompt 4
Summarize the known limitations of this detection tool, like ad-blockers and full-traffic VPN proxies.

Frequently asked questions

What is cn-check?

China Access Check is a browser tool that scores whether your network setup would be flagged as coming from mainland China, using IP location, latency, timezone, and other signals.

What language is cn-check written in?

Mainly TypeScript. The stack also includes TypeScript, Cloudflare Workers, JavaScript.

What license does cn-check use?

No license information is stated in the README.

How hard is cn-check to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is cn-check for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.