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 a nivel de disco en Unraid dependen de los nombres de dispositivos de Linux, como /dev/sdX. Puede encontrar el identificador del dispositivo para cualquier unidad en la pestaña Main del WebGUI. Busque la etiqueta de tres letras sdX o nvmeX junto a cada disco. Use el identificador apropiado en todos los comandos, reemplazando sdX con su disco específico.

Acceder al terminal​

Unraid incluye un terminal web integrado al que puede acceder directamente desde el WebGUI. Simplemente utilice el menú desplegable en la esquina superior derecha y seleccione ">_". Esto abrirá una sesión de línea de comandos como el root user, dándole acceso administrativo completo a su sistema.

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

When ¿debería usar el terminal?

El acceso al terminal es útil para:

  • 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%%

Usando PuTTY (solo para Windows)​

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 - Haz clic para expandir/contraer
  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 haya iniciado sesión, estará en el entorno de shell de Unraid. Escriba exit cuando haya 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.

hdparm​

Utilice este comando para probar la velocidad de lectura y mostrar las características del disco.

Ver opciones de hdparm - Haz clic para expandir/contraer

Prueba de velocidad de lectura de disco:

hdparm -tT /dev/sdX

La opción -t prueba las lecturas de disco en búfer, mientras que -T prueba las lecturas de la 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 - Haz clic para expandir/contraer

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 autotests 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.

diskspeed.sh​

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

Ver uso de diskspeed.sh - Haz clic para expandir/contraer

Este solía ser un script que descargarías de los foros de Unraid. DiskSpeed está ahora 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.

top​

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

Ver uso de top - Haz clic para expandir/contraer
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.

    consejo

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

libre​

Este comando muestra estadísticas de uso de memoria.

Ver uso gratuito - Haz clic para expandir/contraer
free -h

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

Comprender la salida

Una lectura de memoria "disponible" baja no necesariamente indica un problema—Linux guarda en caché datos de forma agresiva para rendimiento.

ps​

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

Ver opciones de ps - Haz clic para expandir/contraer

Listar todos los procesos con detalles completos:

ps aux

Ordenar por uso de memoria:

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.

df​

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

Ver uso de df - Haz clic para expandir/contraer
df -h

Este comando muestra el espacio utilizado 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 registros del sistema.

fdisk​

Ver tablas y geometría de partición de discos.

Ver uso de fdisk - Haz clic para expandir/contraer
fdisk -l /dev/sdX

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

lsblk​

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

Ver uso de lsblk - Haz clic para expandir/contraer
lsblk

Este comando muestra todos los dispositivos de almacenamiento, junto con sus puntos de montaje, en una estructura de árbol sencilla. Es excelente para obtener una visión general de su diseño de almacenamiento.

blockdev -getsz​

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

Ver uso de blockdev - Haz clic para expandir/contraer

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.

blkid​

Identificar etiquetas de sistemas de archivos.

Ver uso de blkid - Haz clic para expandir/contraer

Sintaxis:

blkid /dev/sdX1

Muestra el tipo y la etiqueta del sistema de archivos. Use esto en lugar del comando obsoleto vol_id 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.

ss​

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

Ver opciones de ss - Haz clic para expandir/contraer

Mostrar todos los puertos en escucha:

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.

ip​

Configure y muestre información sobre la interfaz de red. Este es el reemplazo moderno para ifconfig.

Ver opciones de ip - Haz clic para expandir/contraer

Mostrar todas las interfaces de red:

ip addr show

Mostrar interfaces de red con colores:

ip -c addr show

Mostrar tabla de enrutamiento:

ip route show

ping​

Probar conectividad de red.

Ver uso de ping - Haz clic para expandir/contraer

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

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 uso de ethtool - Haz clic para expandir/contraer

Información básica de controlador y firmware:

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:

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

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.

Información del sistema​

Obtenga información detallada sobre el hardware, kernel y configuración general del sistema.

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/contraer
tail -f /var/log/syslog

Este comando muestra actualizaciones en vivo del registro del sistema. Para salir, use 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/contraer
powerdown

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