womginx
womginx copied to clipboard
Proxy using wombat + nginx
Womginx
Fastest proxy using only nginx as the backend server
Before you deploy to Heroku, read the following: Heroku decided that this repository violates the ToS, so directly clicking the button below if you're in the main repository will result in an error. Forked repositories may work, though this is not guaranteed. Regardless, I am NOT responsible if your Heroku account gets suspended because of deploying this application. Proceed at your own risk.
Demo: https://womginx.arph.org
~~Heroku Docker demo: https://womginx.herokuapp.com~~ taken down for now. If you need one, deploy one using the button above or use the demo link.
Site compatibility
What works:
- recaptcha
- discord with actual login credentials (no qr code required)
- websocket sites
- sites that have cookies
What doesn't work:
- react sites
- sites that depend on window.location and are minified
- YouTube UI (however, you can watch a video like https://proxysite.com/main/https://www.youtube.com/watch?v=vidid and it will work)
Prerequisites
You need one thing and one thing only: nginx.
Ok maybe not just that, you'll need the following:
- nginx
- certbot
- nodejs (for building wombat)
- a (sub)domain
- a vps
Installation (more simple and contained)
- Install Docker
- Install docker-compose
- Clone this repo by running
git clone https://github.com/binary-person/womginx
-
cd womginx
then edit go and editdocker-compose.yml
- To disable safe browsing, delete the line that says
SAFE_BROWSING
- To change the port, edit
80:80
tonewport:80
- Don't pay attention to
PORT=80
as changing that only changes the port inside the docker container. Only weird environments like Heroku need it. - To bind the port locally, do
127.0.0.1:80:80
(do this if you're hosting multiple things and you're using a reverse proxy like nginx or caddy) - If you are using a reverse proxy, set the
x-forwarded-for
as womginx's rate limiter relies on this header when running in a container. So for nginx, addproxy_set_header X-Forwarded-For $remote_addr;
- To disable safe browsing, delete the line that says
- then run
sudo docker-compose up -d
to start it -
sudo docker-compose down
to stop - If you want to update womginx to the latest version, run
git pull && sudo docker-compose up -d --build
Installation (more complex, direct, and permanent)
# assuming you are on Ubuntu/Debian
## Part 1 of installation ##
# update your repo list
sudo apt update
# 1. install nginx
sudo apt install nginx
# 2. install certbot and the nginx plugin
sudo apt install certbot python3-certbot-nginx
# 3. install nodejs (skip if you already have it)
curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -
sudo apt-get install nodejs
# 4. Get a (sub)domain with an A(AAA) record pointing to your VPS IP
# 5. Get an ssl certificate
sudo certbot --nginx certonly -n -d yourdomain.com
## Part 2 of installation ##
# 1. clone repo and wombat submodule
git clone --recursive https://github.com/binary-person/womginx
# 2. build wombat
cd womginx/public/wombat
npm install
npm run build-prod
# 3. replace 'womginx.arph.org' with 'yourdomain.com' in nginx.conf
cd .. # cd into public folder
sed -i -e 's/womginx.arph.org/yourdomain.com/g' ../nginx.conf
# 4. replace '/home/binary/womginx/public' with your public folder
sed -i -e "s/\/home\/binary\/womginx\/public/$(pwd | sed -e 's/\//\\\//g')/g" ../nginx.conf
# 5. make backup of original nginx.conf
sudo cp /etc/nginx/nginx.conf /etc/nginx/nginx.conf.backup
# 6. copy womginx nginx.conf to /etc/nginx/nginx.conf
sudo cp ../nginx.conf /etc/nginx/nginx.conf
# 7. restart the nginx server
sudo service nginx restart
Why did you want to use only nginx and burden yourself with nginx's "restrictive" and "esoteric" config?
I did it as a game, or, challenge, for myself to learn nginx and also to take advantage of nginx's resilience and speed for handling lots of requests, which is perfect for proxying.
It also was to deter nginx's restrictive reputation (in a community server I'm in).
Contributing
Contributions are welcome. Send in a pull request and I'll be more than happy to take a look.
Future plans
Make another client rewriting library similar to wombat but made with intent to be a proxy rewriting library and with the goal of ease of use for the server and the client.
License
This project is licensed under the AGPL license.
Wombat uses AGPL, and under the terms of that license, this project, therefore, is also required to be licensed under AGPL.