Skip to content

rishabkumar7/linux-ssl-proxy-manager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 

Repository files navigation

Linux SSL Proxy Manager

A tool to easily setup SSL for localhost development on Linux.

Features

  • Automatic self-signed SSL certificate generation
  • Browser trust configuration
  • Nginx proxy configuration
  • Domain mapping in /etc/hosts
  • Simple CLI interface

Installation

  1. Download the script:
sudo curl -o /usr/local/bin/ssl-proxy-manager https://raw.githubusercontent.com/rishabkumar7/linux-ssl-proxy-manager/main/ssl-proxy-manager.sh
  1. Make it executable:
sudo chmod +x /usr/local/bin/ssl-proxy-manager
  1. Install dependencies:
sudo apt-get update
sudo apt-get install -y nginx openssl libnss3-tools

Usage

Add a new domain:

sudo ssl-proxy-manager add my.custom.local localhost 3000

Remove a domain:

sudo ssl-proxy-manager remove my.custom.local

List all configured domains:

sudo ssl-proxy-manager list

How It Works

  1. Certificate Generation: Creates self-signed SSL certificates for your custom domains
  2. Browser Trust: Configures Firefox, Chrome/Chromium, and system-wide certificate stores to trust your certificates
  3. Nginx Configuration: Sets up Nginx as a reverse proxy with proper SSL configuration
  4. Hosts File: Updates /etc/hosts to map your custom domains to 127.0.0.1

Troubleshooting

  • Certificate not trusted: Try restarting your browser after adding a new domain
  • Cannot access the domain: Make sure Nginx is running (sudo systemctl status nginx)
  • Permission denied errors: The script must be run with sudo privileges

Security Note

The certificates generated by this tool are self-signed and only intended for local development. They are not suitable for production environments.

Contributions

This project is under MIT License, feel free to open an issue and PR if you would like to make enhancement or fix an issue.

About

A tool to easily configure local SSL proxies on Linux.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages