Hetzner Cloud — API y modo Rescue de VPS

Hetzner Cloud — API y modo Rescue de VPS

Guía para arrancar un VPS de Hetzner Cloud en modo Rescue (sistema mínimo de mantenimiento) tanto desde la consola web como desde la API, con la lección aprendida en producción sobre cómo inyectar la llave SSH correctamente.

Cuándo se usa el modo Rescue

Método de acceso: contraseña o llave registrada

Al activar el Rescue hay que elegir cómo entrar después:

⚠️ La clave de host cambia en modo Rescue (es otro sistema). En la conexión de rescate hay que saltarse la verificación del host key (StrictHostKeyChecking=no + UserKnownHostsFile=/dev/null) solo para esa sesión, sin contaminar el known_hosts normal.

Por consola web (panel de Hetzner)

  1. Servidor → pestaña Rescue.
  2. Sistema linux64 → método de acceso (llave ED25519 recomendada).
  3. Power on si está apagado.
  4. ssh -p 22 root@<ip-del-vps> con la llave elegida.
  5. Al terminar: desactivar Rescue en el panel y Reiniciar.

Por API — lección importante sobre la llave

La API permite activar el Rescue completo (activar, encender, apagar, desactivar). Punto aprendido en producción: la llave se inyecta por el parámetro ssh_keys con el ID o fingerprint de una llave registrada en el proyecto — no vale pasar una public_key suelta: la API acepta la acción, pero luego el SSH del Rescue no autentica con esa llave (Permission denied), aunque sea la misma que sí entra vía ssh_keys.

Secuencia validada (token de la API de Hetzner Cloud; servidor y fingerprint de ejemplo):

TOKEN="<token>"; SVR="<server-id>"
FP="<fingerprint-del-id-de-la-llave-numerico>"

# Estado actual
curl -sS -H "Authorization: Bearer $TOKEN" "https://api.hetzner.cloud/v1/servers/$SVR"

# Activar Rescue CON la llave registrada (id o fingerprint). Esperar status success.
curl -sS -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d "{\"type\":\"linux64\",\"ssh_keys\":[\"$FP\"]}" \
  "https://api.hetzner.cloud/v1/servers/$SVR/actions/enable_rescue"

# Power on si está apagado, y esperar status running
curl -sS -X POST -H "Authorization: Bearer $TOKEN" \
  "https://api.hetzner.cloud/v1/servers/$SVR/actions/poweron"

# SSH al Rescue (host key distinto al normal)
ssh -p 22 -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no root@<ip-del-vps>
#    mount /dev/sda1 /mnt   → trabajar sobre la raíz (ej. retirar enlaces de systemd)
#    umount /mnt            → antes de apagar

# Desactivar Rescue y reinicio normal
curl -sS -X POST -H "Authorization: Bearer $TOKEN" \
  "https://api.hetzner.cloud/v1/servers/$SVR/actions/disable_rescue"
curl -sS -X POST -H "Authorization: Bearer $TOKEN" \
  "https://api.hetzner.cloud/v1/servers/$SVR/actions/poweroff"
# esperar status off, luego:
curl -sS -X POST -H "Authorization: Bearer $TOKEN" \
  "https://api.hetzner.cloud/v1/servers/$SVR/actions/poweron"

Verificación tras el arranque normal

Notas


Revision #1
Created 2026-11-22 07:04:09 UTC by Abkrim
Updated 2026-11-22 07:04:09 UTC by Abkrim