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
- Para editar el sistema o la configuración de arranque de un VPS que no puede arrancar por su cuenta (por ejemplo, retirar servicios del boot, reparar
fstab, recuperar contraseñas). - Para encender un VPS sin que levante los servicios de producción (mantenimiento, failover, failback).
- El sistema Rescue es una imagen mínima independiente que no monta el disco del sistema por defecto: tú lo montas a mano (
mount /dev/sda1 /mnt) para trabajar sobre la raíz real.
Método de acceso: contraseña o llave registrada
Al activar el Rescue hay que elegir cómo entrar después:
- Contraseña: Hetzner genera una password que se muestra una sola vez.
- Llave SSH registrada en el proyecto: aquí conviene elegir la más moderna (ED25519) de las registradas. El arranque Rescue escucha SSH en el puerto 22 (el puerto de gestión habitual del VPS puede ser otro).
⚠️ 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 elknown_hostsnormal.
Por consola web (panel de Hetzner)
- Servidor → pestaña Rescue.
- Sistema linux64 → método de acceso (llave ED25519 recomendada).
- Power on si está apagado.
ssh -p 22 root@<ip-del-vps>con la llave elegida.- 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
- El disco raíz se monta en
/dev/sda1(comprobarlo conlsblken el Rescue). - Al volver al arranque normal, confirmar que el sistema no levantó los servicios de producción que se retiraron del boot.
- Si se retiraron enlaces de arranque de systemd, comprobar que no quedan:
ls /etc/systemd/system/multi-user.target.wants/y/etc/systemd/system/timers.target.wants/.
Notas
- El fingerprint se obtiene desde el panel o desde la propia API (
/api/ssh_keys), y corresponde al ID numérico para el campossh_keys. - Un
schedule:runaislado con el runtime parado no es un servicio levantado: no asumir que el VPS volvió a producción solo por ver un proceso PHP suelto.