Beat censorship at its own game.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This repo is archived. You can view files and clone it, but cannot push or open issues/pull-requests.
SGrondin 60b38a1761 Cleanup completed 6 years ago
defs DNS hijacking (TCP) 6 years ago
lib Cleanup completed 6 years ago
src Cleanup completed 6 years ago
.gitignore Fixed some bugs 6 years ago
LICENSE Initial commit 6 years ago Cleanup completed 6 years ago
package.json Cleanup completed 6 years ago DNS hijacking works (UDP only) 6 years ago
settings.js Cleanup completed 6 years ago Initial commit 6 years ago Directory cleanup 6 years ago Parsing works 6 years ago

This is a work in progress.

It uncensors the web by using the same tools that oppressive governments use to censor it in the first place.

It works by forwarding all DNS lookups to Google (, That unblocks all sites that were blocked at the DNS level.

Sites blocked at the IP level are DNS-hijacked and then tunneled through the server, in MITM fashion. SSL data obviously can’t be decrypted nor tampered because only the legitimate site owners have the private key to do so. However, it can be passed through to evade an IP ban. Both encrypted and unencrypted data is only proxied, it’s never analyzed nor logged.

HTTP traffic is routed using the HTTP Host header. HTTPS traffic is routed using the SSL SNI extension.

It supports TCP for long/signed DNS packets.

There’s no logging/history whatsoever, other than traffic stats. No data that could be used to identify the source or content of a request is ever written to the hard drive.


  • IP-banned domains are only unblocked for the web (HTTP/HTTPS). However, DNS-banned domains are accessible using any protocol.
  • HTTPS routing relies on SNI, which is not available on Windows XP and some very old browsers (IE 6, Firefox 1, etc.).


  • Cleaner restart/reload
  • Support subdomain wildcards


Create the user nobody with minimal permissions.

Compile and install Node 0.10.x.

Compile and install nginx 1.4.x with ./configure --with-http_ssl_module --with-ipv6

Create the following server block inside of the main http block in nginx.conf:

server {
    listen [::]:80 default_server;
    listen 80 default_server;
    server_name _;
    access_log off;
    location / {
        proxy_pass http://$http_host$request_uri;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

Edit settings.js with the IPv4 and IPv6 addresses of your server and the domains you want to tunnel.

Then run it.


sudo ./ &


Modifications to .coffee and ._coffee files require recompilation.


Only the master process runs as root, the workers use user nobody.

Please reports bug here on Github, using the Issues system.

Pull requests are welcome.-