命令行界面
While most tasks in Unraid can be performed through the WebGUI, certain operations - especially those related to diagnostics, drive management, or scripting - require using the system console or SSH terminal. This page offers Unraid-specific command-line tools and examples that can be used without needing extensive Linux knowledge.
Many disk-level Unraid operations depend on Linux device names, like /dev/sdX. You can find the device identifier for any drive in the Main tab of the WebGUI. Look for the three-letter label sdX or nvmeX next to each disk. Use the appropriate identifier in all commands, replacing sdX with your specific disk.
访问终端
Unraid includes a built-in web terminal that you can access directly from the WebGUI. Simply use the top-right dropdown menu and select ">_". This opens a command-line session as the root user, giving you full administrative access to your system.
您也可以使用 %SSH|ssh%（安全壳）与 PuTTY 等客户端外部连接到 Unraid 服务器。
如果您使用的是Windows，可能更喜欢使用PuTTY进行SSH访问，而不是内置终端。这个软件轻量级、免费，并允许您保存会话以便日后轻松访问。
- 运行例如
smartctl、xfs_repair、tail或top等诊断和命令行工具 - 执行不需要用户界面的插件脚本或工具
- Troubleshooting issues related to connectivity, system services, or user shares
驱动器测试和监控
如果您使用的是Windows，可能更喜欢使用PuTTY进行SSH访问，而不是内置终端。这个软件轻量级、免费，并允许您保存会话以便日后轻松访问。
如何安装和使用 PuTTY - 单击以展开/折叠
Unraid automatically configures the SSH server on the first boot. Ensure your networking is working properly and that your root password is set before attempting a remote connection.
驱动器测试和监控
这些工具有助于评估性能、检查驱动器健康情况以及解决array速度慢的问题。所有命令都应从终端或通过SSH执行。
diskspeed.sh
此脚本允许进行全面的表面性能测试，并生成可视化报告。
查看 diskspeed.sh 用法 - 单击以展开/折叠
以前这脚本需要从 Unraid 论坛下载。DiskSpeed 现在提供了一个更完善的软件包：
hdparm -tT /dev/sdX
-t 标志测试缓冲磁盘读取，而 -T 测试缓存读取。这主要衡量顺序读取性能，有助于识别异常缓慢的驱动器。
运行多个测试以提高准确性：
for ((i=0;i<5;i++)); do hdparm -tT /dev/sdX; done
查看驱动器信息：
hdparm -I /dev/sdX
这将显示型号、固件、缓存大小和支持的功能，帮助验证磁盘类型和控制器行为。
smartctl
此命令运行 SMART 诊断并监控驱动器健康。
查看 smartctl 选项 - 单击以展开/折叠
top
此命令提供实时的进程和资源监控。
查看 top 用法 - 单击以展开/折叠
系统监控
在 WebGUI 不可用或需要更详细诊断时，使用这些命令监控内存、进程和系统性能。
ps
使用此命令显示正在运行的进程及其详细信息。
查看 ps 选项 - 单击以展开/折叠
top
- 实时显示每个进程的 CPU 和内存使用情况。
- 按
q退出。 - 使用方向键滚动，按
k终止进程。
按内存使用排序：
free
此命令显示内存使用统计信息。
查看 free 用法 - 单击以展开/折叠
free -h
这将以人类可读的格式显示 RAM 使用情况。-h 标志表示大小将以 KB、MB 或 GB 而非字节显示。
"可用"内存读数低并不一定表示问题——Linux 积极缓存数据以提高性能。
df
此命令显示文件系统磁盘空间使用情况。
查看 df 用法 - 单击以展开/折叠
列出所有进程的详细信息：
ps aux
考虑使用 htop 获取更友好的界面和增强的控制。
ps aux --sort=-%mem | head -20
按 CPU 使用排序：
ps aux --sort=-%cpu | head -20
存储工具
这些命令有助于检查磁盘使用情况、分区信息和识别存储设备。
lsblk
以树形格式列出所有块设备。
查看 lsblk 用法 - 单击以展开/折叠
df -h
此命令显示所有已挂载文件系统的已用和可用空间。它便于检查 Unraid 中的 /var/log（使用基于 RAM 的日志记录）。更多关于系统日志记录的信息。
blockdev -getsz
帮助确定替换驱动器在重建前是否有足够的空间。
查看 blockdev 用法 - 单击以展开/折叠
fdisk -l /dev/sdX
此命令显示分区布局、大小和磁盘几何结构。它有助于解决磁盘大小不匹配的问题，特别是在替换磁盘时。
blkid
识别文件系统标签。
查看 blkid 用法 - 单击以展开/折叠
lsblk
此命令显示所有已挂载文件系统的已用和可用空间。它便于检查 Unraid 中的 /var/log（使用基于 RAM 的日志记录）。更多关于系统日志记录的信息。
blockdev -getsz
帮助确定替换驱动器在重建前是否有足够的空间。
查看 fdisk 用法 - 单击以展开/折叠
语法：
blockdev --getsz /dev/sdX
返回设备上 512 byte 扇区的原始数量 - 方便在重建前确认替换驱动器的大小。
ss
显示套接字统计和网络连接。这是netstat的现代替代品。
查看 ss 选项 - 单击以展开/折叠
语法：
blkid /dev/sdX1
输出文件系统类型和标签。用于验证 Unraid 闪存是否标记为 UNRAID，可替代已弃用的 vol_id 命令。
网络诊断
用于排除网络连接和接口配置问题的工具。
ping
测试网络连接。
查看 ping 用法 - 单 击以展开/折叠
通过发送有限数量的包来测试连接：
ss -tuln
-t：TCP 套接字-u：UDP 套接字-l：仅显示监听套接字-n：显示端口号而不是服务名称
显示已建立的连接：
ss -tup
此命令显示活动连接及其过程信息。
ethtool
用于查询和调整网络接口卡 (NIC) 参数的实用工具，例如链接速度、卸载功能和统计数据。
查看 ethtool 用法 - 单击以 展开/折叠
基本驱动程序和固件信息：
ip addr show
以颜色显示网络接口：
ip -c addr show
要检查接口的当前链接速度和设置，请运行：
ip route show
ping
测试网络连接。
查看 ss 选项 - 单击以展开/折叠
显示所有监听端口：
ping -c 4 google.com
此命令向目标发送四个数据包后停止，适合进行基础的连接测试而不会产生连续输出。
ethtool
用于查询和调整网络接口卡 (NIC) 参数的实用工具，例如链接速度、卸载功能和统计数据。
查看 ip 选项 - 单击以展开/折叠
显示所有网络接口：
使用此命令获取网络接口驱动程序和固件信息：
ethtool -i eth0
显示当前链接速度和设置：
显示路由表：
ethtool eth0
显示扩展接口统计：
对于界面的扩展统计，请使用以下命令：
ethtool -S eth0
这些命令可以帮助您确认千兆、2.5 GbE 或 10 GbE 连接的协商速度，诊断与电缆相关的问题，或识别可能由于卸载不匹配而产生的丢包。
尾
实时监控日志文件。
- CPU 信息
- 内存信息
- 存储信息
CPU 架构概况：
lscpu
此命令显示有关核心、线程、虚拟化支持和缓存详细信息。
功能检测：
grep -E 'lm|vmx|svm' /proc/cpuinfo
lm：表示支持 64 位vmx：Intel VT-x 虚拟化svm：AMD-V 虚拟化
内存使用概述：
free -h
详细内存分解：
cat /proc/meminfo | head -20
按序列号/型号列出驱动器：
ls -l /dev/disk/by-id/ | grep -v part
检查文件系统标签：
ls -l /dev/disk/by-label/
系统维护
系统关闭、日志监控和服务管理的命令。
尾
实时监控日志文件。
查看尾命令用法 - 点击展开/折叠
tail -f /var/log/syslog
该命令显示系统日志的实时更新。要退出，请使用 Ctrl+C。
显示特定行数：
tail -n 50 /var/log/syslog
关机
安全关闭系统。
查看关机用法 - 点击展开/折叠
powerdown
此命令利用 Unraid 内置的关机过程来停止 array 并安全地关闭系统。它优于手动关闭方法。