Sign inSign up

erkintop/rug-panel

By erkintop

•Updated 9 months ago

Lightweight WireGuard VPN Management Panel

Image
Networking
0

2.1K

erkintop/rug-panel repository overview

⁠Rug-Panel

Lightweight WireGuard VPN Management Panel

Simple and fast web interface for managing WireGuard VPN server.

Screenshot

ā šŸš€ Quick Start

⁠1. Create docker-compose.yml
services:
  rug-panel:
    image: erkintop/rug-panel:latest
    container_name: rug-panel
    restart: unless-stopped
    
    cap_add:
      - NET_ADMIN
      - SYS_MODULE
    
    ports:
      - "8000:8000/tcp"    # Management panel
      - "51820:51820/udp"  # WireGuard VPN
    
    environment:
      - SECRET_KEY=CHANGE_ME_GENERATE_RANDOM_KEY
      - LANGUAGE=en  # or ru
    
    volumes:
      - ./data:/app/data
      - /lib/modules:/lib/modules:ro
    
    sysctls:
      - net.ipv4.ip_forward=1
      - net.ipv4.conf.all.src_valid_mark=1
⁠2. Start Container
# Generate SECRET_KEY
python -c "import secrets; print(secrets.token_urlsafe(32))"

# Replace CHANGE_ME_GENERATE_RANDOM_KEY in docker-compose.yml

# Start
docker compose up -d
⁠3. Open Panel
  • URL: http://YOUR_SERVER_IP:8000
  • Login: admin
  • Password: admin

āš ļø Change password after first login!

āš ļø Network interface (WAN) for docker is eth0

ā šŸ“‹ Features

  • āœ… WireGuard client management via web interface
  • 🌐 QR code generation for mobile devices
  • šŸ“Š Real-time client status monitoring
  • šŸŒ Multilingual support (Russian/English)
  • šŸ”’ JWT authentication via httpOnly cookies
  • ⚔ Optimized performance

ā šŸ”§ Environment Variables

VariableDefaultDescription
SECRET_KEYāš ļø REQUIREDJWT encryption key
LANGUAGEruInterface language (ru or en)
PANEL_PORT8000Web panel port
WG_PORT51820WireGuard UDP port
DEFAULT_DNS77.88.8.8, 8.8.8.8DNS for clients
DEBUGfalseDebug mode

ā šŸ“š Documentation

Full documentation: GitHub - Rug-Panel⁠

ā šŸ“„ License

Apache License 2.0 - see LICENSE⁠

ā šŸ› Support

Issues: GitHub Issues⁠


Developed by Erkin⁠

Tag summary

Content type

Image

Digest

sha256:0d05c736c…

Size

76 MB

Last updated

9 months ago

docker pull erkintop/rug-panel