WAHA con Docker y Nginx usando subdominios

Este tutorial muestra la forma correcta y estable de levantar WAHA y exponerlo por Internet usando Nginx + HTTPS, soportando múltiples instancias mediante subdominios.

Decisión clave: subdominios, no subpaths. WAHA no soporta bien /waha1, /waha2.

Arquitectura final

• 1 servidor (VM)
• 1 Nginx como reverse proxy
• 1 contenedor WAHA por WhatsApp
• 1 subdominio por WAHA

Ejemplo:

• wasabi.cloud-ip.cc → web / landing
• waha1.wasabi.cloud-ip.cc → WAHA #1
• waha2.wasabi.cloud-ip.cc → WAHA #2

1️⃣ Requisitos

• Ubuntu (20.04+ recomendado)
• Nginx
• Dominio o subdominio
• Certbot (Let’s Encrypt)

2️⃣ DNS (subdominios)

En tu proveedor DNS agregá un registro A por cada WAHA:

Host                       Tipo   IP
wasabi.cloud-ip.cc         A      TU_IP_PUBLICA
waha1.wasabi.cloud-ip.cc   A      TU_IP_PUBLICA
waha2.wasabi.cloud-ip.cc   A      TU_IP_PUBLICA

Esperá unos minutos a que el DNS propague y listo.

3️⃣ Nginx – dominio raíz

El dominio principal NO corre WAHA. Se usa solo para web estática o landing.

server {
    server_name wasabi.cloud-ip.cc;

    root /usr/share/nginx/html;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }

    listen 443 ssl;
    ssl_certificate /etc/letsencrypt/live/wasabi.cloud-ip.cc/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/wasabi.cloud-ip.cc/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
}

4️⃣ Nginx – WAHA por subdominio

Crear un archivo por cada WAHA:

sudo nano /etc/nginx/sites-available/waha1

server {
    server_name waha1.wasabi.cloud-ip.cc;

    location / {
        proxy_pass http://127.0.0.1:3001;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

Activar el sitio:

sudo ln -s /etc/nginx/sites-available/waha1 /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

5️⃣ HTTPS con Certbot

sudo certbot --nginx -d waha1.wasabi.cloud-ip.cc

Certbot detecta Nginx, agrega SSL y configura HTTPS automáticamente.

6️⃣ Probar

• https://waha1.wasabi.cloud-ip.cc/
• https://waha1.wasabi.cloud-ip.cc/dashboard

Credenciales por defecto:

• Usuario: admin
• Password: demo123

7️⃣ Agregar más WAHA

Repetir el mismo proceso:

• DNS: waha2.wasabi.cloud-ip.cc
• Nginx: nuevo server {}
• Certbot

❌ Por qué NO usar /waha1

• WAHA redirige a /dashboard
• Rompe el login
• Requiere sub_filter
• Frágil ante actualizaciones

Regla de oro:
1 WAHA = 1 subdominio = 1 contenedor = 1 WhatsApp