Powermouse

Powerful http(s) web proxy and flagship TitaniumNetwork proxy

Maintained by Divide#1335 on Discord

Deploy to Heroku Deploy to Azure Run on Repl.it

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)

  11. Install NodeJS and NPM from here.
  12. Download this repo as a zip archive from here.
  13. Extract the zip archive to its own directory (try the desktop).
  14. Open the terminal. Press Command (superkey/windows key) + Space. This should open spotlight. Type "terminal", and hit enter.
  15. A white box will appear. Wait 1-10 seconds until there is a dollar sign ($) at the end of the last line.
  16. 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
  17. Now type the below code, then press enter. 
    npm install
  18. 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.
  19. Once the installation is complete, in your terminal you can run the line below to start the proxy 
    npm
  20. 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)

  21. 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.
  22. 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
  23. Download Powermouse. Run the following command. 
    git clone https://github.com/titaniumnetwork-dev/powermouse.git
  24. Install more dependencies. Run the following command. 
    cd powermouse && npm install
  25. Edit the configuration file to listen on 0.0.0.0:80, instead of localhost.
  26. Run Powermouse. 
    npm start
  27. 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

  28. Point a domain name at your VPS's IP address, using an A record.
  29. Install certbot. Follow prompts. 
    sudo add-apt-repository ppa:certbot/certbot -y && sudo apt update -y && sudo apt install certbot -y
  30. Stop all webservers running on port 80 and 443 (including powermouse).
  31. Get a certificate. Follow the prompts, and enter your domain name exactly. 
    certbot certonly --standalone
  32. 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
  33. 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