Saltar al contenido principal

Interfaz de línea de comando

Aunque la mayoría de las tareas en Unraid se pueden realizar a través del WebGUI, ciertas operaciones, especialmente aquellas relacionadas con diagnósticos, administración de discos o creación de scripts, requieren el uso de la consola del sistema o el terminal SSH. Esta página ofrece herramientas de línea de comandos específicas de Unraid y ejemplos que se pueden usar sin necesidad de un conocimiento extenso de Linux.

Device rutas

Muchas operaciones de nivel de disco en Unraid dependen de los nombres de dispositivos de Linux, como /dev/sdX. Puedes encontrar el identificador del dispositivo para cualquier unidad en la pestaña Principal del WebGUI. Busca la etiqueta de tres letras sdX o nvmeX junto a cada disco. Usa el identificador apropiado en todos los comandos, reemplazando sdX con tu disco específico.

Acceder al terminal​

Unraid incluye un terminal web integrado al que puedes acceder directamente desde el WebGUI. Simplemente usa el menú desplegable en la parte superior derecha y selecciona ">_". Esto abre una sesión de línea de comandos como el usuario root, otorgándote acceso administrativo completo a tu sistema.

También puede conectar su servidor Unraid externamente utilizando SSH (shell seguro) con un cliente como PuTTY.

When ¿debería usar el terminal?

Si está utilizando Windows, puede preferir PuTTY para el acceso SSH en lugar del terminal integrado. Es ligero, gratuito, y le permite guardar sesiones para un acceso fácil más adelante.

  • Ejecutar diagnósticos y herramientas de línea de comando como smartctl, xfs_repair, tail o top
  • Ejecutar scripts de complementos o herramientas que no requieren interfaz de usuario
  • Solucionando problemas relacionados con la conectividad, servicios del sistema, o %%user shares|comparticiones de usuario%%

Pruebas de discos y monitoreo​

Si está utilizando Windows, puede preferir PuTTY para el acceso SSH en lugar del terminal integrado. Es ligero, gratuito, y le permite guardar sesiones para un acceso fácil más adelante.

Cómo instalar y usar PuTTY - Haga clic para expandir/colapsar
  1. Descargar PuTTY del sitio oficial.
  2. Inicie la aplicación PuTTY.
  3. Ingrese la dirección IP o el nombre de host de su servidor Unraid (por ejemplo, tower.local).
  4. Establezca el tipo de conexión en %%SSH|ssh%%.
  5. (Opcional) Guarde el nombre de la sesión para usar en el futuro.
  6. Haga clic en Abrir para iniciar la sesión.
  7. Cuando se le indique, inicie sesión como root y luego ingrese su contraseña.

Una vez que te hayas registrado, estarás en el entorno de shell de Unraid. Escribe exit cuando hayas terminado para cerrar la sesión.

nota

Unraid configura automáticamente el servidor SSH en el primer arranque. Asegúrese de que su red funcione correctamente y que su contraseña de root esté establecida antes de intentar una conexión remota.

Pruebas de discos y monitoreo​

Estas herramientas ayudan a evaluar el rendimiento, verificar la salud de los discos y solucionar problemas de lentitud en el array. Todos los comandos deben ejecutarse desde la terminal o a través de SSH.

diskspeed.sh​

Este script permite pruebas de rendimiento a nivel superficial, completas con informes visuales.

Ver uso de diskspeed.sh - Haga clic para expandir/colapsar

Esto solía ser un script que descargarías desde los foros de Unraid. DiskSpeed ahora está disponible en un paquete más refinado:

hdparm -tT /dev/sdX

La bandera -t prueba las lecturas de discos con búfer, mientras que -T prueba las lecturas de caché. Esto mide principalmente el rendimiento de lectura secuencial y ayuda a identificar discos inusualmente lentos.

Ejecute múltiples pruebas para mayor precisión:

for ((i=0;i<5;i++)); do hdparm -tT /dev/sdX; done

Ver información del disco:

hdparm -I /dev/sdX

Esto muestra el modelo, firmware, tamaño de caché y características compatibles, lo que ayuda a verificar el tipo de disco y el comportamiento del controlador.

smartctl​

Este comando ejecuta diagnósticos SMART y monitoriza la salud del disco.

Ver opciones de smartctl - Haga clic para expandir/colapsar

Informe SMART básico:

smartctl -a /dev/sdX

Si este comando devuelve un error, intente especificar el tipo de dispositivo: smartctl -a -d ata /dev/sdX (use -d nvme para discos NVMe).

Iniciar autopruebas SMART:

Prueba corta (toma unos pocos minutos)

smartctl -t short /dev/sdX

Prueba extendida (puede llevar horas)

smartctl -t long /dev/sdX

Guardar %%SMART report|informe-smart%% en un archivo:

smartctl -a /dev/sdX > /boot/smart_report.txt

Esto guarda el informe en su unidad USB de Unraid para su revisión o compartirlo después en los foros.

top​

Este comando proporciona un monitor en tiempo real de procesos y recursos.

Ver uso de top - Haga clic para expandir/colapsar

Esto solía ser un script que descargarías desde los foros de Unraid. DiskSpeed ahora está disponible en un paquete más refinado:

Instale DiskSpeed desde Community Applications (Pestaña de Apps) buscando "DiskSpeed", o visite el repositorio de GitHub para instrucciones de instalación manual.

Monitoreo del sistema​

Utilice estos comandos para vigilar la memoria, procesos y rendimiento del sistema cuando el WebGUI no esté disponible o para diagnósticos más detallados.

ps​

Utilice este comando para mostrar procesos en ejecución con información detallada.

Ver opciones de ps - Haga clic para expandir/colapsar
top
  • Muestra el uso de CPU y memoria para cada proceso en tiempo real.
  • Presione q para salir.
  • Use las arrow keys para desplazarse y k para finalizar procesos.

Ordenar por uso de memoria:

libre​

Este comando muestra estadísticas de uso de memoria.

Ver uso de free - Haga clic para expandir/colapsar
free -h

Esto muestra el uso de RAM en un formato legible por humanos. La bandera -h significa que los tamaños se mostrarán en KB, MB o GB en lugar de bytes.

Entender la salida

Una lectura baja de memoria "disponible" no indica necesariamente un problema; Linux almacena en caché los datos de manera agresiva para lograr un mejor rendimiento.

df​

Este comando muestra el uso de espacio en el disco del sistema de archivos.

Ver uso de df - Haga clic para expandir/colapsar

Listar todos los procesos con detalles completos:

ps aux
consejo

Considera usar htop para una interfaz más amigable al usuario con controles mejorados.

ps aux --sort=-%mem | head -20

Ordenar por uso de CPU:

ps aux --sort=-%cpu | head -20

Utilidades de almacenamiento​

Estos comandos ayudan a verificar uso de disco, información de partición e identificar dispositivos de almacenamiento.

lsblk​

Lista todos los dispositivos de bloque en formato de árbol.

Ver uso de lsblk - Haga clic para expandir/colapsar
df -h

Este comando muestra el espacio usado y disponible en todos los sistemas de archivos montados. Es conveniente para verificar /var/log (que utiliza un registro basado en RAM) en Unraid. Para más información sobre registro del sistema.

blockdev -getsz​

Ayuda a determinar si un disco de reemplazo tiene suficiente espacio antes de la reconstrucción.

Ver uso de blockdev - Haga clic para expandir/colapsar
fdisk -l /dev/sdX

Este comando muestra el diseño de particiones, tamaños y la geometría del disco. Ayuda a solucionar problemas de tamaños de discos desajustados, especialmente al reemplazar discos.

blkid​

Identificar etiquetas de sistemas de archivos.

Ver uso de blkid - Haga clic para expandir/colapsar
lsblk

Este comando muestra el espacio usado y disponible en todos los sistemas de archivos montados. Es conveniente para verificar /var/log (que utiliza un registro basado en RAM) en Unraid. Para más información sobre registro del sistema.

blockdev -getsz​

Ayuda a determinar si un disco de reemplazo tiene suficiente espacio antes de la reconstrucción.

Ver uso de fdisk - Haga clic para expandir/colapsar

Sintaxis:

blockdev --getsz /dev/sdX

Devuelve el número crudo de sectores de 512 bytes en un dispositivo - útil para confirmar que un disco de reemplazo es lo suficientemente grande antes de reconstruir.

ss​

Muestra estadísticas de sockets y conexiones de red. Este es el reemplazo moderno para netstat.

Ver opciones de ss - Haga clic para expandir/colapsar

Sintaxis:

blkid /dev/sdX1

Muestra el tipo de sistema de archivos y la etiqueta. Usa esto en lugar del comando vol_id obsoleto al verificar que el flash de Unraid está etiquetado como UNRAID.

Diagnósticos de red​

Herramientas para solucionar problemas de conectividad de red y configuración de interfaces.

ping​

Probar conectividad de red.

Ver uso de ping - Haga clic para expandir/colapsar

Prueba de conectividad enviando un número limitado de paquetes:

ss -tuln
  • -t: Sockets TCP
  • -u: Sockets UDP
  • -l: Sólo muestra sockets en escucha
  • -n: Muestra números de puerto en lugar de nombres de servicio

Mostrar conexiones establecidas:

ss -tup

Este comando muestra conexiones activas junto con información del proceso.

ethtool​

Herramienta útil para consultar y ajustar parámetros de la tarjeta de interfaz de red (NIC), como velocidad de enlace, características de carga y estadísticas.

Ver uso de ethtool - Haga clic para expandir/colapsar

Información básica de controlador y firmware:

ip addr show

Mostrar interfaces de red con colores:

ip -c addr show

Para verificar la velocidad de enlace y configuraciones actuales de su interfaz, ejecute:

ip route show

ping​

Probar conectividad de red.

Ver opciones de ss - Haga clic para expandir/colapsar

Mostrar todos los puertos en escucha:

ping -c 4 google.com

Este comando envía cuatro paquetes al destino y se detiene, lo que lo hace adecuado para pruebas básicas de conectividad sin salida continua.

ethtool​

Herramienta útil para consultar y ajustar parámetros de la tarjeta de interfaz de red (NIC), como velocidad de enlace, características de carga y estadísticas.

Ver opciones de ip - Haga clic para expandir/colapsar

Mostrar todas las interfaces de red:

Use este comando para obtener información sobre el controlador y firmware de su interfaz de red:

ethtool -i eth0

Mostrar velocidad de enlace y configuraciones actuales:

Mostrar tabla de enrutamiento:

ethtool eth0

Mostrar estadísticas extendidas de la interfaz:

Para estadísticas extendidas relacionadas con la interfaz, use el siguiente comando:

ethtool -S eth0

Estos comandos pueden ayudarle a confirmar las velocidades de negociación para conexiones gigabit, 2.5 GbE o 10 GbE, diagnosticar problemas con cables, o identificar paquetes perdidos que podrían surgir de desajustes de carga.

tail​

Monitorea archivos de registro en tiempo real.

Resumen de arquitectura de CPU:

lscpu

Este comando muestra información sobre núcleos, hilos, soporte de virtualización y detalles de caché.

Detección de características:

grep -E 'lm|vmx|svm' /proc/cpuinfo
  • lm: Indica soporte de 64 bits
  • vmx: Virtualización Intel VT-x
  • svm: Virtualización AMD-V

Mantenimiento del sistema​

Comandos para el apagado del sistema, monitoreo de registros y gestión de servicios.

tail​

Monitorea archivos de registro en tiempo real.

Ver uso de tail - Haz clic para expandir/colapsar
tail -f /var/log/syslog

Este comando muestra actualizaciones en vivo del registro del sistema. Para salir, usa Ctrl+C.

Mostrar un número específico de líneas:

tail -n 50 /var/log/syslog

powerdown​

Apaga el sistema de forma segura.

Ver uso de powerdown - Haz clic para expandir/colapsar
powerdown

Este comando utiliza el proceso de apagado incorporado de Unraid para detener la array y apagar el sistema de forma segura. Es preferible a los métodos de apagado manual.