La consola solo aparece en una terminal interactiva real, tanto stdin como stdout deben ser
TTY. Bajo Docker, systemd, o cuando stdout se redirige, ipmideck omite la consola
por completo y solo escribe registros simples que se desplazan. Consulta Dónde aparece la consola.
Qué aspecto tiene
La consola es una única vista a pantalla completa: una cabecera fija que siempre ves, sobre un registro en vivo que se desplaza por debajo.
La cabecera
La parte superior de la pantalla es una cabecera fija que nunca se desplaza. Se apila, de arriba abajo:- El banner de ipmideck.
- La barra de ayuda: cada tecla de acción y lo que hace.
- La línea de estado: el estado en vivo de la sesión.
- Una línea de créditos compacta (autor, versión, licencia).
Línea de estado
La línea de estado muestra tres campos en vivo, separados por|:
- Verbosity: el nivel de registro actual (
INFO,DEBUGoWARNING). - Clients: el número de clientes del panel conectados ahora mismo.
- last: la última tecla de acción que pulsaste, como retroalimentación visual inmediata.
Teclas de acción
Cada acción es una pulsación de tecla. La barra de ayuda las lista todas:| Tecla | Acción |
|---|---|
v | Alternar la verbosidad del registro |
c | Abrir la subvista de sesiones conectadas |
s | Abrir la subvista de servidores configurados |
u | Mostrar la url del panel en el registro |
g | Comprobación de actualización (imprime la versión local) |
b | Abrir el editor de cambio de enlace |
r | Reiniciar el servidor |
q | Salir, o volver a la vista de registro desde una subvista |
ESC | Atrás, volver a la vista de registro desde una subvista |
v: verbosidad
v alterna el nivel de registro en tiempo de ejecución por un bucle fijo de tres pasos:
INFO es el predeterminado. DEBUG muestra más; WARNING muestra menos. El cambio surte efecto
de inmediato durante el resto de la sesión y la línea de estado se actualiza en consecuencia.
El interruptor de verbosidad cambia solo el nivel en ejecución. En el siguiente arranque, el nivel de
tu configuración (o la variable de entorno
IPMIDECK_LOGGING_LEVEL) vuelve a ganar. Consulta Configuración.c: sesiones
c abre la subvista Connected sessions, una tabla de solo lectura de los clientes del panel
conectados actualmente, con columnas:
- IP
- Connected since
- User-Agent
q o ESC para volver a la vista de registro.
s: servidores
s abre la subvista Configured servers, una tabla de solo lectura de los BMC con los que ipmideck
está configurado para hablar, con columnas:
- Name
- Host
- Status
q o ESC para volver a la vista de registro.
u: url
u muestra la URL del panel (scheme://host:port) en el cuerpo del registro. Si el servidor está
enlazado a una dirección comodín (0.0.0.0, :: o vacía), la URL se reescribe a
127.0.0.1 para que sea realmente abrible en un navegador, http://0.0.0.0:3000 es una dirección de
escucha, no una navegable.
g: actualización
g imprime la versión local y una nota de que la comprobación de actualización en línea se incluye con la
versión de pip. No hace ninguna llamada de red, ipmideck permanece sin conexión.
r: reinicio
r realiza un reinicio limpio dentro del proceso: ipmideck desmonta la consola, vuelve a leer
config.yaml e inicia de nuevo. Úsalo tras una edición de cambio de enlace para aplicar
la nueva dirección.
q / ESC: salir y atrás
- Desde una subvista (
sessionsoservers),qyESCte devuelven ambos a la vista de registro. - Desde la vista de registro,
qactiva una salida limpia, el servidor se apaga de forma controlada.
b: cambio de enlace
b abre el editor de cambio de enlace, una solicitud host:port en línea que reemplaza la barra de ayuda
mientras escribes. La cabecera muestra el enlace actual como una etiqueta de solo lectura current: host:port
y un campo new: vacío, así que el valor que escribes aparece de inmediato y nunca se confunde
con el existente.
- Enter: aplicar el
host:portescrito. - ESC: cancelar sin cambiar nada.
- Backspace: borrar el último carácter.
- Cualquier carácter imprimible, añadir al búfer.
host:port con un host no vacío y un puerto que sea un entero en el
rango 1–65535. Con una entrada válida, ipmideck confirma el nuevo enlace y te recuerda que se requiere un reinicio
(pulsa r). Con una entrada inválida, informa Invalid host/port y
nada cambia.
Dónde aparece la consola
La consola interactiva está condicionada a un TTY real: ipmideck la dibuja solo cuando tanto stdin como stdout son terminales interactivas. Cuando no lo son, degrada a un banner más registros simples que se desplazan y no instala ningún escuchador de teclas, así que nada gira ocupado en un no-TTY. Esto significa que la consola aparece cuando ejecutas ipmideck directamente en una terminal:- Se ejecuta bajo Docker: el contenedor lanza uvicorn directamente y nunca alcanza la
ruta de la consola; obtienes registros simples del contenedor (
docker logs). - Se ejecuta bajo systemd o cualquier gestor de servicios donde stdout no sea una terminal.
- Redirigir stdout (p. ej.
ipmideck > server.log): stdout ya no es un TTY.
0.0.0.0:3000; solo obtienes registros simples en lugar de la consola en vivo.
ipmilink es un alias retrocompatible de ipmideck, ambos lanzan la misma consola.Próximos pasos
- Ejecutar ipmideck: iniciar, servir y las reglas de precedencia de enlace.
- La CLI: cada subcomando y flag en detalle.
- Configuración: define la dirección de enlace, la verbosidad y los intervalos de sondeo.
- Instalación: instalar con Docker o pip.