git404hub

what is gfw-router fr?

shivaism/gfw-router — explained in plain English

Analysis updated 2026-05-18

2GoAudience · ops devopsComplexity · 5/5Setup · hard

tl;dr

Config and build tooling that turns a Cudy WR3000 router into a firewall bypass proxy using ImmortalWrt and sing-box.

vibe map

mindmap
  root((repo))
    What it does
      Router firewall bypass
      Runs sing-box in RAM
    Tech stack
      Go
      ImmortalWrt
      sing-box
    Use cases
      Proxy router setup
      Subscription conversion
    Audience
      Network hobbyists
      Ops engineers
    Setup
      SSH configuration
      Firewall rules

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 make with this?

VIBE 1

Turn a Cudy WR3000 router into a GFW bypass proxy device

VIBE 2

Convert a Clash subscription into a sing-box config locally on the router

VIBE 3

Automate rebuilding sing-box and clash2singbox for a musl based router

VIBE 4

Set up a separate unproxied Wi-Fi network alongside the proxied one

what's the stack?

GoImmortalWrtsing-boxOpenWrt

how it stacks up fr

shivaism/gfw-routeranomalroil/1keyanshuman852/dasan-router-cli
Stars222
LanguageGoGoGo
Last pushed2019-05-17
MaintenanceDormant
Setup difficultyhardmoderatemoderate
Complexity5/53/53/5
Audienceops devopsops devopsops devops

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

how do i run it?

Difficulty · hard time til it works · 1day+

in plain english

This repository holds the configuration files, build scripts, and bundled source code needed to turn a specific home router, the Cudy WR3000 v1, into a device that can route internet traffic around government level internet filtering, sometimes called the Great Firewall. It builds on top of an existing open source router firmware called ImmortalWrt, combined with a proxy tool called sing-box. Because the router's onboard storage is small, most of the software it needs is not kept permanently on the device. Instead, only a few small support packages are installed to the router's flash storage, and the larger programs, sing-box and a helper tool called clash2singbox, are downloaded into the router's memory each time it starts up. Clash2singbox takes a subscription link, the kind of link some proxy services hand out, and converts it into a format sing-box understands, doing this conversion locally on the router itself so no outside service ever sees that subscription link. Both of these bundled programs are rebuilt from their original source code so they work correctly on this router's particular operating system, rather than using the official prebuilt versions, which are not compatible. The repository automates keeping clash2singbox updated every day, while updates to sing-box are handled more carefully, since a mismatched version could break the whole setup, so a weekly check simply opens an issue rather than updating things automatically. The README also walks through the full setup process: flashing the router with the correct firmware, installing a handful of required packages over a remote terminal connection, configuring the router's firewall so traffic can flow through the proxy, turning off a networking feature that would otherwise conflict with the proxy, and optionally setting up a second, completely separate Wi-Fi network that bypasses the proxy altogether. Overall, this project is a personal networking and infrastructure setup rather than an app you install and run. It requires an SSH connection to the router, familiarity with basic command line tools, and a supported router model to be useful.

prompts (copy fr)

prompt 1
Walk me through flashing ImmortalWrt onto a Cudy WR3000 router
prompt 2
Help me configure the firewall zone for sing-box's TUN interface
prompt 3
Explain why sing-box needs to be rebuilt with CGO_ENABLED=0 for this router
prompt 4
Help me set up a second unproxied SSID on this router

Frequently asked questions

what is gfw-router fr?

Config and build tooling that turns a Cudy WR3000 router into a firewall bypass proxy using ImmortalWrt and sing-box.

What language is gfw-router written in?

Mainly Go. The stack also includes Go, ImmortalWrt, sing-box.

How hard is gfw-router to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is gfw-router for?

Mainly ops devops.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.