Powermouse

Powerful http(s) web proxy and flagship TitaniumNetwork proxy

Maintained by Divide#1335 on Discord

Installation:

Local Installation (Windows)

1. Install NodeJS and NPM from here.
2. Download this repo as a zip archive from here.
3. Extract the zip archive to its own directory (try the desktop).
4. Open the command line. Press Windows Key (superkey/command) + R. Type "cmd". Click enter.
5. Wait for a black box (cmd) to appear.
6. Type in cd , then either manually type the absolute location of the install directory, or simply drag the folder into the cmd. Then hit enter. Example:

cd C:\Users\john\Documents\powermouse

7. Now type the below code, then press enter.

npm install

8. If all packages were successfully installed, you will see no errors returned. If you have any issues with this process, refer to the troubleshooting section. If that does not help, message someone on the discord, or open a Github issue.
9. Once the installation is complete, in your terminal you can run the line below to start the proxy

npm start

10. The page will be available at http://127.0.0.1:8080/ or whatever you set it to in the config.json file. Note: this will only be accessible from your local computer. If you want to set this up for others to use (or you to use elsewhere), refer to the VPS Installation section.

Local Installation (MacOS)

1. Install NodeJS and NPM from here.
2. Download this repo as a zip archive from here.
3. Extract the zip archive to its own directory (try the desktop).
4. Open the terminal. Press Command (superkey/windows key) + Space. This should open spotlight. Type "terminal", and hit enter.
5. A white box will appear. Wait 1-10 seconds until there is a dollar sign ($) at the end of the last line.
6. Type in cd , then either manually type the absolute location of the install directory, or simply drag the folder into the cmd. Then hit enter. Example:

cd /Users/john/Desktop/powermouse

7. Now type the below code, then press enter.

npm install

8. If all packages were successfully installed, you will see no errors returned. If you have any issues with this process, refer to the troubleshooting section. If that does not help, message someone on the discord, or open a Github issue.
9. Once the installation is complete, in your terminal you can run the line below to start the proxy

npm

10. The page will be available at http://127.0.0.1:8080/ or whatever you set it to in the config.json file. Note: this will only be accessible from your local computer. If you want to set this up for others to use (or you to use elsewhere), refer to the VPS Installation section.

Local Installation (Linux)

These are the same instructions as VPS Installation, besides for instead of SSHing into a console, you just open a terminal with CTRL + ALT + T

VPS Installation (Linux)

1. SSH into your VPS. If on windows, you can do this via PUTTY. If on MacOS/Linux, you can use the ssh CLI. Refer to google if you are stuck here.
2. Install dependencies. Run the following command.

sudo apt install git curl -y && curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash - && sudo apt install nodejs -y 

3. Download Powermouse. Run the following command.

git clone https://github.com/titaniumnetwork-dev/powermouse.git

4. Install more dependencies. Run the following command.

cd powermouse && npm install

5. Edit the configuration file to listen on 0.0.0.0:80, instead of localhost.
6. Run Powermouse.

npm start

7. Run Powermouse in background: Enter the following command

screen npm start

Then press CTRL + A + D. You are now safe to exit the ssh connection.

Configuration:

Enabling SSL

1. Point a domain name at your VPS's IP address, using an A record.
2. Install certbot. Follow prompts.

sudo add-apt-repository ppa:certbot/certbot -y && sudo apt update -y && sudo apt install certbot -y 

3. Stop all webservers running on port 80 and 443 (including powermouse).
4. Get a certificate. Follow the prompts, and enter your domain name exactly.

certbot certonly --standalone

5. Move the certificates. Locate the new SSL files in your current directory (list all files in dir using ls). One should be default.crt and some should be default.key. If not, change the first occurence of "cert/default.key" in the command below, accordingly.

mv default.crt ssl/default.crt
mv default.key ssl/default.key

6. Edit the config.json. Set SSL to true. Restart powermouse.

Port Chaning

To change the port your instance is running on, in config.json there is a value named port and you can set it to what you need (http: 80, most nodejs apps: 8080, https: 443). If you wish to listen externally and not on localhost, change listenip to 0.0.0.0

Licensed under GNU General Public License v3.0