# fivesheep/chnroutes

scripts help chinese netizen, who uses vpn to combat censorship, by modifying the route table so as routing only the censored ip to the vpn

Repository: https://github.com/fivesheep/chnroutes
Canonical: https://ross.abutalabs.com/products/chnroutes
Language: Python
License Family: other
Last push: 2018-09-06T08:02:57+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 5144, "days_push": 2918, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3101, forks 616 (observed 2026-08-28T04:07:43.583571+00:00)

## What it is
chnroutes is a set of Python scripts that generate route table commands from the APNIC delegated list, so VPN users in China can route only censored (foreign) IPs through the VPN while accessing domestic Chinese IPs directly. It supports OpenVPN, PPTP, and third-party router firmware like OpenWRT, DD-WRT, and Tomato.

## Use cases
- split VPN traffic so only blocked sites go through the tunnel
- speed up access to Chinese websites while using a VPN
- generate route scripts for OpenVPN from APNIC IP lists
- set up selective routing on a router for the whole LAN
- reduce VPN bandwidth usage by bypassing domestic traffic
- configure PPTP VPN routing on OS X, Linux, or Windows

## When to choose
- you use a VPN as default gateway in China and want domestic traffic to bypass it
- you run OpenVPN or PPTP and can execute generated route scripts
- you want whole-network split tunneling via an OpenWRT/DD-WRT/Tomato router

## When to avoid
- you need a maintained tool - the project has had no releases since 2018 and IP lists have grown far larger
- your VPN client or platform doesn't support custom route or up/down scripts
- you want a modern proxy-based solution (e.g. rule-based proxies) instead of route-table manipulation
- adding thousands of routes is too slow on your device, such as low-end Android

## Facets
- artifact type: cli-tool
- maturity: abandoned
- function: networking, vpn, cli, developer-tools
- domain: privacy, censorship-circumvention, networking
- platform: windows, python, cli
- tags: chnroutes, split-tunneling, route-table, openvpn, pptp, apnic, great-firewall, router-firmware, command-line, linux, macos, android

## Member repositories
- fivesheep/chnroutes (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:43.583571+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:46:21.192098+00:00, confidence not recorded.
  - readme: https://github.com/fivesheep/chnroutes (fetched 2026-08-28T04:07:43.583571+00:00, sha 99659255fced)
- Data as of 2026-08-30T08:39:29.467469+00:00.
