Advanced Reverse Proxy Manager

A modern, dockerized reverse proxy management system with enterprise-grade features and an intuitive web interface for managing proxies, SSL certificates, and advanced configurations.

Features

• 🚀 Modern Web Interface - React-based SPA with real-time updates
• 🔒 SSL Management - Automated Let's Encrypt integration with DNS challenges
• ⚡ High Performance - Custom-compiled Nginx with advanced modules
• 📊 Monitoring & Analytics - Real-time metrics and comprehensive logging
• 🔧 Advanced Configuration - Load balancing, WebSocket support, custom headers
• 🛡️ Security First - WAF capabilities, rate limiting, access control
• 🐳 Fully Dockerized - Easy deployment with Docker Compose
• 🔄 API-First Design - Complete REST API for automation

Installation and Setup

Follow these installation and setup instructions to get started:

1. Clone the repository:

git clone https://github.com/ersinkoc/reverse-proxy-manager.git
cd reverse-proxy-manager

2. Copy the environment file:

cp backend/.env.example backend/.env

3. Start the services:

docker-compose up -d

4. Access the web interface at https://localhost:81

Usage Instructions

Once the installation is complete, you can start using the system immediately.

Default credentials:

• Email: admin@example.com
• Password: password123

Architecture

The system consists of several containerized services:

• App Container - Node.js backend API and React frontend
• Nginx Container - Custom-built Nginx with advanced modules
• PostgreSQL - Primary database for configuration storage
• Redis - Session management and caching
• Certbot - Automated SSL certificate management

Development

Prerequisites

• Docker and Docker Compose
• Node.js 18+ (for local development)
• npm or yarn

Local Development

1. Install dependencies:

npm install

2. Start the development servers:

# Terminal 1 - Backend
cd backend
npm run dev

# Terminal 2 - Frontend
cd frontend
npm run dev

3. Start the required services:

docker-compose up postgres redis

Building

# Build all containers
docker-compose build

# Build specific service
docker-compose build app

API Documentation

The API documentation is available at /api/docs when the application is running.

Authentication

All API endpoints (except /api/v1/auth/*) require authentication using JWT tokens.

# Login
curl -X POST http://localhost:81/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@example.com","password":"password123"}'

# Use the returned token
curl -H "Authorization: Bearer YOUR_TOKEN" \
  http://localhost:81/api/v1/proxies

Configuration

Environment Variables

Key environment variables in backend/.env:

• DATABASE_URL - PostgreSQL connection string
• REDIS_URL - Redis connection string
• JWT_SECRET - Secret for JWT token generation
• LETSENCRYPT_EMAIL - Email for Let's Encrypt certificates

Nginx Configuration

Custom Nginx configurations can be placed in nginx/conf.d/. The system automatically reloads Nginx when changes are detected.

Security

• All data is encrypted at rest and in transit
• Multi-factor authentication support (coming soon)
• Role-based access control (RBAC)
• Comprehensive audit logging
• Regular security updates

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

• Issues: GitHub Issues