ipmideck, que inicia el servidor, restablece la
contraseña de administrador o genera un certificado autofirmado.
La CLI solo se aplica cuando ejecutas ipmideck directamente (instalación pip o un checkout de fuente). La
imagen de Docker lanza
uvicorn backend.main:app directamente y nunca invoca la CLI, así que ninguno
de estos flags, la precedencia de enlace ni la guarda de instancia única se aplican al contenedor. El enlace del contenedor lo define su propio comando de arranque. Consulta Instalación.Iniciar el servidor
start es el comando principal de servicio. Una invocación sola sin subcomando sirve de forma idéntica,
así que estas son equivalentes:
0.0.0.0:3000 de forma predeterminada, alcanzable en cada interfaz,
en el puerto 3000. Abre http://<your-ip>:3000 una vez que esté activo.
Sobrescribe el enlace con --host y --port:
Subcomandos
serve es un alias obsoleto de start, prefiere start (o un ipmideck solo) en
los scripts nuevos.Flags
Estos flags de nivel superior se aplican a la ruta de servicio.--demo y --config se leen antes de cualquier
ramificación de subcomando, así que también afectan a reset-password y --gen-cert.
Precedencia de enlace
El host y el puerto a los que ipmideck se enlaza realmente se resuelven en este orden, mayor prioridad primero:- Un flag
--host/--portexplícito en la línea de comandos. - La configuración, que a su vez resuelve la variable de entorno (
IPMIDECK_SERVER_HOST/IPMIDECK_SERVER_PORT) sobreconfig.yamlsobre el predeterminado integrado. - El valor de reserva codificado
0.0.0.0:3000, usado si la carga temprana de la configuración falla.
config.yaml queda sobrescrito por una variable de entorno
IPMIDECK_ o un flag --host / --port en el siguiente arranque, el entorno y la CLI siempre ganan.
Si config.yaml está mal formado, ipmideck imprime una advertencia en stderr y recurre a
0.0.0.0:3000.
Las variables de entorno
IPMIDECK_SERVER_HOST y IPMIDECK_SERVER_PORT usan el
prefijo IPMIDECK_. Consulta Configuración para la lista completa de sobrescrituras.HTTPS con —gen-cert
--gen-cert genera un certificado y clave autofirmados, luego sale. No inicia
el servidor y no activa HTTPS por sí mismo:
data/certs/, registra sus rutas en el bloque server de
config.yaml e imprime tres líneas:
server.https: true en config.yaml y reinicia ipmideck. HTTPS nunca se habilita automáticamente.
Modo demo
--demo ejecuta ipmideck contra hardware simulado en lugar de BMC reales, útil para evaluar
el panel sin servidores conectados:
Restablecer la contraseña de administrador
reset-password crea o actualiza interactivamente el inicio de sesión de administrador, luego sale sin
iniciar nunca el servidor:
Username: y luego New password: (entrada oculta). Si ya existe una cuenta,
actualiza la contraseña de ese usuario e imprime Password updated for <username>; de lo contrario
crea el usuario e imprime User <username> created.
Recarga automática de desarrollo
--reload es una vía rápida solo de desarrollo: delega en el propio supervisor de recarga
automática de uvicorn y retorna. Omite intencionadamente la guarda de puerto de instancia única descrita
abajo, porque el recargador ejecuta su propio proceso supervisor.
Códigos de salida
En la ruta de servicio (no
--reload), ipmideck ejecuta una guarda de instancia única antes de enlazar. Si el
puerto ya está en uso imprime un error en stderr y sale con 1. Si el enlace falla porque la
dirección no está disponible o no está permitida, imprime un error distinto y también sale con 1.
Próximos pasos
- Configuración: claves de
config.yamly las sobrescrituras de entornoIPMIDECK_. - Instalación: instala ipmideck con Docker o pip.
- Solución de problemas: errores de conexión, puerto e IPMI.