Publicar un sitio estático en Dokploy con nginx

El Dockerfile mínimo para servir HTML con nginx, cómo subirlo a Dokploy sin repositorio Git usando la opción Drop, y cuándo conviene Application o Docker Compose.

U12 3 min de lectura

Este mismo sitio es un conjunto de archivos HTML servidos por nginx dentro de Dokploy. Antes de llegar acá publiqué otros sitios más chicos, como una página de políticas de privacidad, y el procedimiento es siempre el mismo. Lo dejo escrito.

El Dockerfile mínimo

Para una carpeta site/ con HTML, CSS e imágenes, alcanza con esto:

FROM nginx:1.27-alpine
COPY site/ /usr/share/nginx/html/

La imagen oficial de nginx ya sirve lo que haya en /usr/share/nginx/html por el puerto 80. No hace falta nada más para empezar.

Si el sitio se genera con una herramienta como Astro o Hugo, se puede compilar dentro del mismo Dockerfile en dos etapas:

FROM node:22-alpine AS build
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM nginx:1.27-alpine
COPY nginx.conf /etc/nginx/conf.d/default.conf
COPY --from=build /app/dist/ /usr/share/nginx/html/

La imagen final solo tiene nginx y los archivos generados. Node queda en la etapa de construcción y no viaja a producción.

Una configuración de nginx que valga la pena

La configuración por defecto funciona, pero conviene agregar compresión, caché para los archivos estáticos y una página 404 propia:

server {
    listen 80;
    root /usr/share/nginx/html;
    index index.html;

    gzip on;
    gzip_types text/css application/javascript image/svg+xml application/xml text/plain;

    location ~* \.(css|js|woff2|svg|png|jpg|webp)$ {
        expires 30d;
        add_header Cache-Control "public";
    }

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

    error_page 404 /404.html;
}

No hace falta configurar HTTPS en nginx: el certificado lo maneja Traefik, que está delante.

Subirlo sin repositorio: Drop

Dokploy puede desplegar desde GitHub, GitLab, un registro de imágenes o directamente desde un archivo ZIP. Esa última opción se llama Drop y es práctica para sitios chicos que no viven en un repositorio.

  1. Creá un proyecto y adentro una aplicación de tipo Application.
  2. En General → Provider, elegí Drop.
  3. Armá un ZIP con el Dockerfile en la raíz. En Windows, con PowerShell:
Compress-Archive -Force -Path Dockerfile, site -DestinationPath $env:TEMP\sitio.zip
  1. Arrastrá el ZIP, guardá, y Dokploy construye y despliega.
  2. En Build Type, dejá Dockerfile.

Cuidado con lo que metés en el ZIP. Si la carpeta del proyecto tiene archivos con claves o tokens, armá el ZIP solo con lo necesario. Lo que subís queda guardado en el servidor.

Cada cambio posterior es volver a subir el ZIP. Para algo que se actualiza seguido, conviene conectar un repositorio Git y activar el despliegue automático con cada push.

El dominio

En la pestaña Domains de la aplicación:

  • Host: el nombre, por ejemplo sitio.ejemplo.com.ar.
  • Container Port: 80.
  • HTTPS: activado, con Let’s Encrypt como proveedor.

Si tenés un registro DNS comodín (como explico en esta guía), no hace falta crear nada en el DNS. Traefik pide el certificado la primera vez que alguien entra.

El detalle del LXC

Si tu Dokploy corre dentro de un contenedor LXC, antes de desplegar andá a Advanced → Swarm Settings → Endpoint Spec y poné {"Mode":"dnsrr"}. Sin eso, Traefik responde 502. La explicación completa está en esta guía.

¿Application o Docker Compose?

  • Application: un solo contenedor construido desde una fuente. Ideal para sitios estáticos y aplicaciones simples. Dokploy maneja el dominio y el certificado desde su interfaz.
  • Docker Compose: varios servicios que trabajan juntos (una aplicación con su base de datos, por ejemplo). Le pasás un docker-compose.yml y lo levanta tal cual.

Para un sitio estático, Application es lo más directo.

Verificar

curl -I https://sitio.ejemplo.com.ar/

Tiene que devolver HTTP/2 200. Si da 404, revisá que los archivos hayan quedado en la carpeta correcta dentro de la imagen. Si da 502, revisá el modo dnsrr. Si el certificado no se emite, revisá que el puerto 80 llegue desde internet: Let’s Encrypt lo necesita para validar.