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

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.

ps​

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

Ver opciones de ps - 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.

df​

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

Ver uso de df - 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.

    consejo

    Considere usar htop para una interfaz más fácil de usar con controles mejorados.

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.

Comprender la salida

Una lectura baja de memoria "disponible" no necesariamente indica un problema: Linux almacena en caché datos de manera agresiva para mejorar el rendimiento.

lsblk​

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

Ver uso de lsblk - 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.

blkid​

Identificar etiquetas de sistemas de archivos.

Ver uso de blkid - 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, los tamaños, y la geometría del disco. Ayuda a solucionar problemas de tamaños de disco no coincidentes, especialmente al reemplazar discos.

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

ping​

Probar conectividad de red.

Ver uso de ping - 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.

Operaciones de transferencia de archivos​

Estos métodos te ayudan a transferir archivos desde comparticiones de red externas (comparticiones SMB/CIFS de Windows o Linux) a tu servidor Unraid usando herramientas de línea de comandos y utilidades incorporadas.

Usando Midnight Commander (integrado)​

Unraid incluye Midnight Commander (mc), un gestor de archivos con interfaz de texto y doble panel accesible a través de la terminal web.

  1. Abre la terminal web. Puedes encontrar esta opción en el menú superior derecho de la WebGUI de Unraid.

  2. Lanzar Midnight Commander:

    mc

    Esta interfaz ofrece navegación de arrastrar y soltar entre acciones locales y rutas de red montadas.

  3. Monta un compartición de red (si aún no está montado):

    # Create a temporary mount point
    mkdir /work
    # 1) Interactive prompt (recommended for one-off mounts)
    mount -t cifs //workstation/share /work -o username=youruser,iocharset=utf8
    # You will be prompted for the password interactively.
    # 2) Use a credentials file (recommended for scripts/automation)
    # Create /root/.cifscredentials with the following content:
    #   username=youruser
    #   password=yourpassword
    # Then protect the file and mount using:
    chmod 600 /root/.cifscredentials
    mount -t cifs //workstation/share /work -o credentials=/root/.cifscredentials,iocharset=utf8
    • Reemplaza workstation, share y youruser con los valores apropiados.
    • La opción iocharset=utf8 ayuda a mantener nombres de archivo internacionales.

    Nota de seguridad: No introduzcas contraseñas en la línea de comandos (por ejemplo, contraseña=...). Los argumentos del comando pueden ser grabados en el historial del shell y son visibles para otros usuarios locales a través de listados de procesos; prefiere avisos interactivos o un archivo de credenciales protegido con chmod 600.

  4. Usa los paneles de MC para transferir archivos entre /work (el compartición de red) y cualquier compartición /mnt/user/ o /mnt/diskX.

  5. Limpia luego:

    umount /work
    rmdir /work

Midnight Commander se ejecuta completamente dentro del sistema incorporado, sin requerir ninguna instalación adicional. Es adecuado para la mayoría de las necesidades de transferencia, incluidas aquellas que involucran nombres de archivo Unicode, y preserva atributos de archivo cuando tanto la fuente como el destino los admiten.

Usando Krusader​

Si prefieres una interfaz gráfica, puedes usar contenedores Docker como Krusader como una solución de terceros.

  1. Instalar Krusader:
    • Navega a la pestaña Aplicaciones (Aplicaciones Comunitarias).
    • Busca e instala el contenedor Docker de Krusader.
  2. Inicia el contenedor y accede a su IU web desde la pestaña Docker.
  3. Conéctate a comparticiones remotas dentro de Krusader, y utiliza arrastrar y soltar o copia y pega para transferir archivos entre el compartición de red y tu %%array|matriz%% de Unraid.
información

Otros contenedores populares de gestores de archivos incluyen Double Commander y CloudCommander, ambos disponibles a través de Aplicaciones Comunitarias.

Métodos de línea de comandos​

Para usuarios avanzados o aquellos que usan automatización, también pueden utilizar métodos de transferencia por línea de comandos.

Ver instrucciones de transferencia por línea de comandos - Haz clic para expandir/colapsar

  1. Abre la terminal (terminal web o SSH como root).

  2. Crea y monta una acción de red:

mkdir /work
# 1) Interactive prompt (recommended for one-off mounts)
mount -t cifs //workstation/share /work -o username=youruser,iocharset=utf8
# You will be prompted for the password interactively.
# 2) Use a credentials file (recommended for scripts/automation)
# Create /root/.cifscredentials with the following content:
#   username=youruser
#   password=yourpassword
# Then protect the file and mount using:
chmod 600 /root/.cifscredentials
mount -t cifs //workstation/share /work -o credentials=/root/.cifscredentials,iocharset=utf8

Nota de seguridad: No pase contraseñas en la línea de comandos. En su lugar, use un aviso interactivo o un archivo de credenciales con permisos estrictos.

  1. Copiar archivos:

    • Puedes usar cp:

      cp -r /work/* /mnt/disk1

    • O, usa rsync para un progreso detallado:

      rsync -av --progress /work/ /mnt/disk1/

  2. Desmonta y elimina el directorio temporal:

    umount /work
    rmdir /work
precaución

Al transferir archivos con caracteres especiales o internacionales, siempre monta el share con la opción iocharset=utf8. No hacerlo puede resultar en nombres de archivos incorrectos o archivos ilegibles en otras plataformas.

Además, si copias archivos como root vía terminal, pueden tener permisos restrictivos. Si esto ocurre, usa la herramienta Nuevos Permisos desde el menú Herramientas en la WebGUI o la Docker Safe New Perms si estás tratando con comparticiones involucradas con Docker para restablecer permisos, asegurándote de que todos los usuarios tengan acceso a la red.