Docker Compose

Ejecuta una instancia completa y gratuita de Status200 en un solo servidor Linux con Docker Compose. Esta página te lleva de un servidor recién creado a una instancia en marcha, y después trata HTTPS, el endurecimiento para producción, las copias de seguridad, las actualizaciones y la desinstalación. Para trabajar en el código de Status200, consulta Desarrollo local.

Cómo funciona#

Docker Compose ejecuta cada parte de Status200 como un contenedor en tu servidor. Todo el tráfico entra por el contenedor ingress, que lo dirige a la app. La aplicación guarda sus datos en PostgreSQL, ClickHouse y Valkey. Una sonda incluida ejecuta las comprobaciones de tus monitores y envía los resultados a través del ingress.

Para producción a gran escala, o cuando necesites alta disponibilidad, usa en su lugar el chart de Helm en Kubernetes: Docker Compose ejecuta una sola copia de cada servicio en un solo servidor.

Requisitos#

Elige el tamaño del servidor según lo que vayas a ejecutar en él. La telemetría (logs, métricas, trazas) es lo que determina la memoria y el disco; consulta Dimensionamiento y planificación de capacidad cuando conozcas tus volúmenes.

El mínimo para un homelab sirve para uso personal y experimental: hay quien ejecuta Status200 en una Raspberry Pi.

También necesitas:

• Docker con el plugin Docker Compose v2 (el comando docker compose).
• Git, para descargar Status200.
• Node.js y npm, que ejecutan los scripts npm start y npm run update que envuelven Docker Compose.
• Puertos 80 y 443 libres en el servidor. La tabla de abajo enumera cada puerto que Status200 usa en el host.

También hay un vídeo paso a paso de la instalación.

Instalar Status200#

1. Clona la rama release#

   La rama release contiene los archivos de la última versión.

   Bash

   git clone --depth 1 --single-branch --branch release https://git.wilix.dev/status200/status200.git
   cd oneuptime

2. Crea config.env#

   Todos los ajustes de Status200 están en config.env. Parte del ejemplo:

   Bash

   cp config.example.env config.env

3. Define el nombre de host#

   Abre config.env y define HOST con el nombre de dominio o la dirección IP que se usará para llegar a Status200, sin http://. Deja localhost solo para probar Status200 en tu propio ordenador.

   config.envINI

   HOST=status200.example.com

4. Genera secretos aleatorios#

   El archivo de ejemplo trae secretos de marcador que son públicos en GitHub. Sustituye cada uno por su propio valor aleatorio:

   Bash

   while grep -q "please-change-this-to-random-value" config.env; do
     sed -i "0,/please-change-this-to-random-value/{s/please-change-this-to-random-value/$(openssl rand -hex 32)/}" config.env
   done
   grep -c "please-change-this" config.env

   El último comando imprime 0: no queda ningún marcador. El bucle usa GNU sed, que tiene cualquier servidor Linux. Estos son los ajustes que rellena:

   Ajuste	Qué protege
   ONEUPTIME_SECRET	Las llamadas entre los propios servicios de Status200.
   ENCRYPTION_SECRET	Los secretos que guarda Status200, como tokens de integraciones y contraseñas SMTP, y los tokens de inicio de sesión que emite.
   DATABASE_PASSWORD, CLICKHOUSE_PASSWORD, VALKEY_PASSWORD	Los tres almacenes de datos.
   REGISTER_PROBE_KEY	El registro de sondas en tu instancia.
   GLOBAL_PROBE_1_KEY, GLOBAL_PROBE_2_KEY	Las sondas globales que puede ejecutar Docker Compose (probe-1 se ejecuta de forma predeterminada).
   STATUS200_RUNNER_KEY	El Runner incluido.
   GLOBAL_RUNNER_KEY	El Runner global incluido, que ejecuta los pasos JavaScript de todos los proyectos.

   Importante

   Define los secretos antes del primer arranque y mantenlos después. PostgreSQL solo toma su contraseña cuando crea su base de datos, y cambiar ENCRYPTION_SECRET más adelante hace ilegible cualquier valor cifrado con el anterior. Si DATABASE_PASSWORD sigue siendo el marcador en el primer arranque, npm start le da un valor aleatorio antes de que PostgreSQL cree su base de datos.

5. Inicia Status200#

   npmDocker CLI

   npm

   Bash

   npm start

   Docker CLI

   Bash

   (export $(grep -v '^#' config.env | xargs) && docker compose up --remove-orphans -d)

   El primer arranque tarda varios minutos: Docker descarga las imágenes y Status200 crea sus bases de datos. npm start espera a que responda cada parte y termina con Status200 is up!

6. Crea la primera cuenta#

   Abre http:// seguido de tu HOST (por ejemplo http://localhost) y regístrate. La primera cuenta de una instancia nueva pasa a ser su administrador principal, que puede abrir el Admin Dashboard en /admin.

   Cualquiera que pueda llegar a la página puede registrarse después de ti. Para impedirlo, abre el Admin Dashboard, ve a Ajustes > Autenticación y desactiva Permitir el registro. Las personas que invites a un proyecto pueden seguir creando su cuenta.

Configurar HTTPS#

Status200 sirve HTTP simple hasta que eliges una de las dos formas de añadir HTTPS:

Si pones páginas de estado o paneles en dominios personalizados, dejar que Status200 gestione TLS es la configuración más sencilla: el ingress pide y sirve él mismo los certificados de esos dominios.

Con HTTP_PROTOCOL=https, Status200 construye enlaces HTTPS, mantiene las cookies de inicio de sesión en HTTPS y pide a los navegadores que lleguen a tu HOST solo por HTTPS. Un navegador lo respeta durante un año, en todos los puertos de ese nombre, así que si HOST alguna vez tiene que responder de nuevo por HTTP simple, define HSTS_MAX_AGE_SECONDS=0 en config.env un tiempo antes: los navegadores olvidan la regla en su siguiente visita.

Dejar que Status200 obtenga un certificado#

1. Apunta tu dominio al servidor#

   Crea un registro DNS A (o AAAA para IPv6) para tu dominio, con la dirección IP pública del servidor como valor. Con un registro AAAA, activa también IPv6 para Status200: consulta Direcciones de los visitantes.

2. Activa la obtención de certificados#

   Define estos valores en config.env:

   config.envINI

   HOST=status200.example.com
   PROVISION_SSL=true
   HTTP_PROTOCOL=https

   HOST tiene que ser un nombre de dominio: Status200 no puede obtener un certificado para una dirección IP ni para localhost.

3. Reinicia con los nuevos ajustes#

   Bash

   npm start

4. Abre tu instancia por HTTPS#

   Abre https://status200.example.com. Status200 pide el certificado al arrancar y después lo revisa cada hora, y lo renueva cuando quedan menos de 30 días. Hasta que llega el primer certificado, normalmente en pocos minutos, el ingress sirve uno autofirmado temporal y tu navegador te avisa.

Usar tu propio proxy inverso#

Estos pasos ejecutan el proxy en el mismo servidor que Status200. Si tu proxy se ejecuta en otra máquina, sáltate el primer paso, apunta el proxy al puerto 80 de este servidor y, con el firewall de tu proveedor de nube, deja que solo el proxy llegue a los puertos 80 y 443: un visitante que llega a Status200 sin pasar por el proxy puede elegir la dirección con la que Status200 lo cuenta.

1. Saca el ingress de los puertos 80 y 443#

   El proxy necesita los puertos 80 y 443, así que mueve el ingress a otros puertos, publicados solo en la dirección de loopback 127.0.0.1 de este servidor, para que los visitantes lleguen a Status200 únicamente a través de tu proxy. La sonda y el Runner usan la red del host y llegan a Status200 a través de http://localhost, así que se mueven con él:

   config.envINI

   ONEUPTIME_HTTP_PORT=127.0.0.1:8080
   STATUS_PAGE_HTTPS_PORT=127.0.0.1:8443
   GLOBAL_PROBE_1_STATUS200_URL=http://localhost:8080
   ONEUPTIME_RUNNER_STATUS200_URL=http://localhost:8080

2. Indica a Status200 que está detrás de un proxy#

   config.envINI

   HOST=status200.example.com
   HTTP_PROTOCOL=https
   PROVISION_SSL=false
   TRUSTED_PROXY_HOPS=2

   HTTP_PROTOCOL=https hace que los enlaces que construye Status200 usen HTTPS. TRUSTED_PROXY_HOPS=2 cuenta tu proxy y el ingress de Status200, de modo que Status200 lee la dirección real del visitante para las listas de IP permitidas y los límites de tasa. Añade uno por cada proxy adicional que añada datos a X-Forwarded-For, como una CDN o un balanceador de carga.

3. Reinicia Status200 en los nuevos puertos#

   Bash

   (export $(grep -v '^#' config.env | xargs) && docker compose up --remove-orphans -d)
   bash Tests/Scripts/status-check.sh localhost:8080

   npm start comprueba http://localhost en el puerto 80, donde estará tu proxy, así que comprueba tú mismo el nuevo puerto. El script termina con Status200 is up!

4. Configura el proxy#

   CaddyNginx

   Caddy

   Caddyfile

   status200.example.com {
       reverse_proxy localhost:8080
   }

   Caddy obtiene y renueva el certificado él mismo, redirige HTTP a HTTPS y deja pasar las conexiones WebSocket. Recarga Caddy después de cambiar el archivo, por ejemplo con sudo systemctl reload caddy.

   Nginx

   /etc/nginx/conf.d/status200.confNginx

   map $http_upgrade $status200_connection_upgrade {
       default upgrade;
       ""      close;
   }
   
   server {
       listen 80;
       server_name status200.example.com;
       return 301 https://$host$request_uri;
   }
   
   server {
       listen 443 ssl;
       server_name status200.example.com;
   
       ssl_certificate     /etc/letsencrypt/live/status200.example.com/fullchain.pem;
       ssl_certificate_key /etc/letsencrypt/live/status200.example.com/privkey.pem;
   
       # The limits Status200's own ingress uses.
       client_max_body_size 50M;
       proxy_read_timeout 300s;
       proxy_send_timeout 300s;
   
       proxy_http_version 1.1;
       proxy_set_header Host $host;
       proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
       proxy_set_header X-Forwarded-Proto $scheme;
       proxy_set_header Upgrade $http_upgrade;
       proxy_set_header Connection $status200_connection_upgrade;
   
       location / {
           proxy_pass http://127.0.0.1:8080;
       }
   
       # MCP clients keep a stream open.
       location /mcp {
           proxy_pass http://127.0.0.1:8080;
           proxy_buffering off;
           proxy_read_timeout 86400s;
           proxy_send_timeout 86400s;
       }
   }

   Las rutas de los certificados son donde Certbot guarda un certificado de Let's Encrypt; usa las rutas de tu propio certificado si viene de otro sitio. Comprueba el archivo y recarga Nginx con sudo nginx -t && sudo systemctl reload nginx.

   Ambos envían X-Forwarded-Proto, que le dice a Status200 que un visitante llegó por HTTPS. Cualquier otro proxy tiene que enviarlo también, o las cookies de inicio de sesión de las páginas de estado y los paneles en tus dominios personalizados no se mantienen en HTTPS.

5. Abre tu instancia a través del proxy#

   Abre https://status200.example.com. Deberías ver la página de inicio de sesión de Status200, servida con el certificado de tu proxy.

Direcciones de los visitantes#

Status200 cuenta a cada visitante por la dirección desde la que se conecta: los límites de inicio de sesión, los demás límites por dirección y las listas de IP permitidas de las páginas de estado y los paneles la leen todos. Dos configuraciones necesitan un ajuste para que esa dirección sea la del propio visitante:

Sin IPv6 en la red de Status200, Docker entrega a Status200 cada visitante que llega por IPv6 desde una dirección propia, y Status200 los cuenta a todos como un solo visitante: los inicios de sesión fallidos de una persona pueden bloquear a las demás. Activar IPv6 requiere Docker Engine 27 o posterior (docker version muestra la tuya).

1. Activa IPv6#

   Crea docker-compose.override.yml junto a docker-compose.yml, o añade esto al que ya tienes; npm start y npm run update lo leen:

   docker-compose.override.ymlYAML

   networks:
     oneuptime:
       enable_ipv6: true

2. Reinicia Status200#

   Bash

   npm stop
   npm start

   Status200 se detiene y vuelve a arrancar con IPv6 en su red. Tus datos se conservan. Docker no puede eliminar una red a la que todavía está conectado un contenedor propio, como un proxy inverso: desconéctalo antes de la red de Status200 y vuelve a conectarlo después. Si npm start se detiene con has active endpoints, desconéctalo y vuelve a ejecutar npm stop y npm start.

3. Comprueba la red#

   Bash

   docker network ls --quiet --filter name=_oneuptime | xargs docker network inspect | grep EnableIPv6

   Muestra "EnableIPv6": true,.

Cuando varias personas inician sesión desde una misma dirección de red privada, la página Estado de Status200 del Admin Dashboard lo indica, con el ajuste que lo cambia.

Lista de comprobación para producción#

Docker Compose ejecuta una sola copia de cada servicio en un solo servidor, lo que encaja con equipos pequeños y homelabs. Antes de confiar en él, repasa esta lista.

Cambia la contraseña de la base de datos#

PostgreSQL conserva la contraseña con la que se creó, así que cambiar solo DATABASE_PASSWORD en config.env deja a Status200 fuera de su base de datos. Para darle una contraseña propia a una instalación que arrancó con el marcador, cámbiala en PostgreSQL y en config.env a la vez, y después vuelve a arrancar Status200:

NEW_PASSWORD=$(openssl rand -hex 32) &&
  (export $(grep -v '^#' config.env | xargs) && docker compose exec -T postgres psql -U "$DATABASE_USERNAME" -d "$DATABASE_NAME" -c "ALTER USER \"$DATABASE_USERNAME\" PASSWORD '$NEW_PASSWORD'") &&
  sed -i "s/^DATABASE_PASSWORD=.*/DATABASE_PASSWORD=$NEW_PASSWORD/" config.env
npm start

Si definiste DATABASE_BACKUP_PASSWORD y DATABASE_RESTORE_PASSWORD, dales también el nuevo valor.

Copia de seguridad y restauración#

PostgreSQL guarda todo lo que configuras: monitores, incidentes, páginas de estado, usuarios. npm run backup lo vuelca en un archivo de la carpeta Backups.

1. Dale al script de copia de seguridad la contraseña de la base de datos#

   En config.env, define DATABASE_BACKUP_PASSWORD con el valor de DATABASE_PASSWORD. El script lee config.env como texto plano, así que el ${DATABASE_PASSWORD} que trae nunca se rellena.

2. Ejecuta la copia de seguridad#

   Bash

   npm run backup

   Pide tu contraseña de sudo y escribe Backups/db-<day of the month>.backup, de modo que las copias diarias sustituyen a las de un mes antes. Ejecútalo al menos una vez al día.

3. Copia las copias de seguridad fuera del servidor#

   Una copia de seguridad en el mismo disco que la base de datos no sobrevive a la pérdida de ese disco.

Solo el propio servidor llega a PostgreSQL: responde en el puerto 5400 de 127.0.0.1. Para hacer copias de seguridad desde otra máquina, abre un túnel SSH desde esa máquina y después conéctate a su propio puerto 5400:

ssh -N -L 5400:127.0.0.1:5400 you@status200.example.com

services:
  postgres:
    ports:
      - "10.0.0.5:5401:5432"

ClickHouse guarda tu telemetría en el volumen de Docker status200_clickhouse, y ningún script lo respalda. Si necesitas conservar esa telemetría, respalda el volumen con una herramienta de ClickHouse como clickhouse-backup, o cópialo con Status200 detenido.

Para restaurar PostgreSQL, define los valores DATABASE_RESTORE_* en config.env: DATABASE_RESTORE_PASSWORD con el valor de DATABASE_PASSWORD, como para las copias de seguridad, y DATABASE_RESTORE_FILENAME con la copia que quieres restaurar, por ejemplo db-31.backup. Después ejecuta bash restore.sh. La base de datos en la que restaura tiene que existir ya; en una instalación en marcha, existe.

Actualizar Status200#

Haz primero una copia de seguridad y después ejecuta:

git checkout release
git pull
npm run update

npm run update pide tu contraseña de sudo, añade a tu config.env los ajustes nuevos de config.example.env (tus propios valores se mantienen), descarga las imágenes nuevas y reinicia Status200. Igual que npm start, termina con Status200 is up!

Pasar a una versión mayor nueva (de la 13 a la 14, por ejemplo) puede requerir más: lee Actualizar a una nueva versión de Status200 antes de empezar.

APP_TAG=release en config.env descarga siempre la última versión de la Community Edition. Para quedarte en una versión, define APP_TAG con su número, por ejemplo 14.0.22. Para la Enterprise Edition, las etiquetas son enterprise-release y enterprise-14.0.22.

Desinstalar Status200#

Detén Status200 y elimina sus contenedores y su red:

npm run down

Tus datos se quedan en los volúmenes status200_postgres y status200_clickhouse, y la carpeta oneuptime conserva config.env y tus copias de seguridad. Para borrar también los datos:

(export $(grep -v '^#' config.env | xargs) && docker compose down --volumes --remove-orphans)

Después borra la carpeta oneuptime.

Solución de problemas#

sudo usermod -aG docker $USER

npm run ps
npm run logs

(export $(grep -v '^#' config.env | xargs) && docker compose logs app) | grep -A 5 CoreSSL

Próximos pasos#