Degeneracy

Degeneracy is a functional and easy to use proxy site made to combat web filters such as iboss, Securly, Goguardian, and more!

Setup

git clone https://github.com/Degenerate0001/Degeneracy
cd Degeneracy
npm install
npm start

Configuration

Configure Degeneracy in config.json.

Default Config Example:

{
    "port": 8443,
    "ssl": false,
    "title": "Degeneracy",
    "prefix": "/go/",
    "codec": "xor",
    "blacklist": ["accounts.google.com"],
    "smokeprefix": "/web/"
}

Port: The port you want Degeneracy to listen on.
SSl: Set to true if you would like to use HTTPS (recommended for VPS)
Title: the title you want your tabs to be for Corrosion. (Does not affect icon)
Prefix: The prefix you want for Corrosion. (recomended that you keep it the same)
Codec: Basic encryption method for filter evasion in Corrosion. (Options include xor, base64, or plain. xor or base64 are recommended)
Blacklist: Sites that you want to block with Corrosion.
Smokeprefix: Prefix for smoke. (recommended that you keep it the same)

Note: For a VPS, it is highly recommended that you remove forceHttps: true from start.js if you are hosting on a VPS. It is only useful for Heroku and just breaks things without Heroku.

Persistance With PM2

I have listed PM2 as a method for persistance as it is easy to work with, and it offers server monitoring.

To get started, run the following commands:

npm i pm2 -g
pm2 start start.js
pm2 startup
pm2 save

Run the first command outside of the Degeneracy directory if you want to use PM2 for anything else.

Nginx

Set up Nginx to Serve Degeneracy and Obtain Letsencrypt Certificates using Certbot.

Run the following commands to install Nginx and Certbot (skip this step if you already have both installed):

apt install -y nginx python3 python3-venv libaugeas0
python3 -m venv /opt/certbot/
/opt/certbot/bin/pip install --upgrade pip
/opt/certbot/bin/pip install certbot certbot-nginx
ln -s /opt/certbot/bin/certbot /usr/bin/certbot

Note: each line above is a separate command.

Next, create the following file in /etc/nginx/sites-enabled/degeneracy.

server {
    root /var/www/path/to/webroot;
    server_name your.domain.com;
    location / {
        proxy_set_header Accept-Encoding "";
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Host $host:$server_port;
        proxy_set_header X-Forwarded-Server $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";   
        proxy_pass https://127.0.0.1:8443;  # change to http if ssl is set to false
        proxy_http_version 1.1; 
        proxy_set_header Host $host;
    }
    
    #location / { #uncomment if you would like to block Google and some other bots.
       #if ($http_user_agent ~ (Googlebot|damnbot|spider) ) {
           #return 403;
    #}

    listen 80;
}

Letsencrypt

Run these commands to get certificates for your site. Certbot will make this easy!

certbot --nginx -d <insert your domain here>
systemctl restart nginx

Now check and see if your server is running! If it is, then good job, if it isn't, sorry D:

To Do

Fix Tab Cloaking

i9bonsai / Degeneracy