Configurar una dirección IPv4 estática con nmcli sin quedar bloqueado fuera del sistema

Objetivo

Asignar a una interfaz de red una dirección IPv4 estática, una puerta de enlace y servidores DNS mediante NetworkManager, con un método que no corte una sesión SSH en la interfaz que se está cambiando.

Requisitos previos

• NetworkManager activo (nmcli general status); un perfil de conexión ya vinculado al dispositivo de destino.
• Root o una regla de polkit que permita cambios de conexión.
• Una segunda vía de acceso (consola, gestión fuera de banda o una segunda NIC) es la única alternativa totalmente segura. Sin ella, un perfil clonado más una reversión automática programada (paso 4) es la siguiente mejor opción; clonar por sí solo no ayuda una vez perdida la sesión.

Pasos

1. Inspeccionar el estado actual: nmcli -t -f NAME,DEVICE,TYPE connection show y nmcli device show eth0.
2. Clonar el perfil activo en lugar de editarlo directamente: nmcli connection clone "eth0-dhcp" "eth0-static". Esto deja intacto el perfil que funciona.
3. Configurar el clon (todavía no afecta a la conexión activa):

   nmcli connection modify eth0-static ipv4.addresses 203.0.113.10/24
   nmcli connection modify eth0-static ipv4.gateway 203.0.113.1
   nmcli connection modify eth0-static ipv4.dns "203.0.113.53 203.0.113.54"
   nmcli connection modify eth0-static ipv4.method manual
   nmcli connection modify eth0-static connection.autoconnect yes
   

4. Programar primero una reversión y luego activar: systemd-run --on-active=5min nmcli connection up eth0-dhcp (root), seguido de nmcli -w 30 connection up eth0-static. Si la nueva dirección es incorrecta y la sesión se cae, el temporizador restaura el perfil anterior al cabo de cinco minutos; la activación se ejecuta dentro de NetworkManager, por lo que una sesión SSH interrumpida no la aborta. No confiar en un reinicio para restaurar el perfil anterior: con dos perfiles de autoconexión para el mismo dispositivo, NetworkManager prefiere el de mayor connection.autoconnect-priority y, después, el usado más recientemente, es decir, el nuevo perfil.
5. Una vez confirmada la accesibilidad desde una nueva sesión hacia la nueva dirección, cancelar la reversión (systemctl list-timers 'run-*', y luego systemctl stop <unit>.timer) y desactivar o eliminar el perfil antiguo: nmcli connection modify eth0-dhcp connection.autoconnect no (conservarlo para una reversión) o nmcli connection delete eth0-dhcp.

Resultado esperado

nmcli -t -f IP4.ADDRESS,IP4.GATEWAY,IP4.DNS device show eth0 muestra los nuevos valores. Los perfiles nuevos se almacenan como archivos keyfile en /etc/NetworkManager/system-connections/ en Debian, Fedora 33+ y RHEL 9+; RHEL 8 escribe archivos ifcfg en /etc/sysconfig/network-scripts/, y Ubuntu 23.10+ almacena los perfiles de NetworkManager como YAML de netplan (/etc/netplan/90-NM-*.yaml).

Límites y base de verificación

Comandos verificados contra la página de manual nmcli(1) (paquete network-manager). nmcli connection up bloquea hasta que la conexión alcanza el estado activado o se agota el tiempo de espera (-w seconds controla el tiempo de espera, 90 segundos por defecto); un script no interactivo debería pasar siempre -w explícitamente en lugar de confiar en el valor por defecto.