コマンドラインインターフェース
Unraid のほとんどの作業は WebGUI から実行できますが、特に診断、ドライブ管理、スクリプト作成に関する一部の操作は、システムコンソールまたは SSH ターミナルの使用が必要です。このページでは、Linux の詳しい知識がなくても使える、Unraid 向けのコマンドラインツールと使用例を紹介します。
多くのディスクレベルの Unraid 操作は、/dev/sdX のような Linux のデバイス名に依存します。任意のドライブのデバイス識別子は、WebGUI の Main タブで確認できます。各ディスクの横にある 3 文字のラベル sdX または nvmeX を探してください。すべてのコマンドでは、sdX を実際のディスクに置き換えて適切な識別子を使用してください。
ターミナルへのアクセス
Unraid には、WebGUI から直接アクセスできる組み込みの Web ターミナルがあります。右上のドロップダウンメニューを開き、">_" を選択してください。これにより、root user としてコマンドラインセッションが開き、システムに対する完全な管理アクセスが可能になります。
SSH（セキュアシェル）を使って、PuTTY のようなクライアントから外部経由で Unraid サーバーに接続することもできます。
ターミナルアクセスが役立つのは次のような場合です:
smartctl、xfs_repair、tail、topなどの診断およびコマンドラインツールの実行- ユーザーインターフェースを必要としないプラグインスクリプトやツールの実行
- 接続性、システムサービス、または user shares に関連する問題のトラブルシューティング
PuTTY の使用（Windows 専用）
Windows を使用している場合は、組み込みターミナルの代わりに SSH アクセス用として PuTTY を使うとよいでしょう。軽量で無料で、後から簡単にアクセスできるようセッションを保存できます。
PuTTY のインストールと使用方法 - クリックして展開/折りたたみ
ドライブ情報を表示:
hdparm -I /dev/sdX
これにより、モデル、ファームウェア、キャッシュサイズ、対応機能が表示され、ディスクの種類やコントローラーの動作確認に役立ちます。
smartctl
このコマンドは SMART 診断を実行し、ドライブの健全性を監視します。
smartctl のオプションを表示 - クリックして展開/折りたたみ
基本 SMART レポート:
smartctl -a /dev/sdX
このコマンドでエラーが返る場合は、デバイスタイプを指定してみてください: smartctl -a -d ata /dev/sdX（NVMe ドライブの場合は -d nvme を使用）。
SMART 自己テストを開始:
ショートテスト（数分かかります）
smartctl -t short /dev/sdX
拡張テスト（数時間かかる場合があります）
smartctl -t long /dev/sdX
SMART レポート をファイルに保存:
smartctl -a /dev/sdX > /boot/smart_report.txt
これにより、レポートが Unraid のフラッシュドライブに保存され、後で確認したり forums で共有したりできます。
diskspeed.sh
このスクリプトは、視覚的なレポート付きで包括的な表面レベルのパフォーマンステストを行えます。
diskspeed.sh の使い方を表示 - クリックして展開/折りたたみ
以前は Unraid フォーラムからダウンロードするスクリプトでした。現在は、より洗練されたパッケージとして DiskSpeed が利用できます:
Community Applications（Apps tab）で「DiskSpeed」を検索して DiskSpeed をインストールするか、手動インストール手順については GitHub リポジトリ を参照してください。
システム監視
WebGUI が利用できない場合や、より詳細な診断を行う場合に、メモリ、プロセス、システムパフォーマンスを監視するためにこれらのコマンドを使用します。
top
このコマンドは、リアルタイムのプロセスおよびリソースモニターを提供します。
top の使い方を表示 - クリックして展開/折りたたみ
top
-
各プロセスの CPU 使用率とメモリ使用率をリアルタイムで表示します。
-
終了するには
qを押します。 -
矢印キーでスクロールし、
kでプロセスを終了します。ヒントより使いやすいインターフェースと拡張されたコントロールを求めるなら、
htopの使用を検討してください。
無料
このコマンドはメモリ使用状況の統計を表示します。
free の使い方を表示 - クリックして展開/折りたたみ
free -h
RAM の使用状況を人間が読みやすい形式で表示します。-h フラグは、サイズをバイトではなく KB、MB、または GB で表示することを意味します。
「利用可能」メモリの値が低くても、必ずしも問題を示すわけではありません。Linux はパフォーマンス向上のためにデータを積極的にキャッシュします。
ps
このコマンドは、詳細情報付きで実行中のプロセスを表示するために使用します。
ps のオプションを表示 - クリックして展開/折りたたみ
全プロセスを詳細付きで一覧表示:
ps aux
メモリ使用率で並べ替え:
ps aux --sort=-%mem | head -20
CPU 使用率で並べ替え:
ps aux --sort=-%cpu | head -20
ストレージユーティリティ
これらのコマンドは、ディスク使用量、パーティション情報の確認、ストレージデバイスの特定に役立ちます。
df
このコマンドはファイルシステムのディスク容量使用状況を表示します。
df の使い方を表示 - クリックして展開/折りたたみ
df -h
このコマンドは、マウントされているすべてのファイルシステムの使用済み領域と利用可能領域を表示します。Unraid で /var/log（RAM ベースのロギングを使用）を確認するのに便利です。system logging の詳細については、こちらを参照してください。
fdisk
ディスクのパーティションテーブルとジオメトリを表示します。
fdisk の使い方を表示 - クリックして展開/折りたたみ
fdisk -l /dev/sdX
このコマンドは、パーティションのレイアウト、サイズ、およびディスクジオメトリを表示します。これは、特にディスクの交換時に、ディスクサイズの不一致をトラブルシュートするのに役立ちます。
lsblk
すべてのブロックデバイスをツリー形式で一覧表示します。
lsblk の使い方を表示 - クリックして展開/折りたたみ
lsblk
このコマンドは、すべてのストレージデバイスとそのマウントポイントを、わかりやすいツリー構造で表示します。ストレージ構成全体を把握するのに最適です。
blockdev -getsz
リビルド前に置換ドライブの容量が十分かどうかを判断するのに役立ちます。
blockdev の使い方を表示 - クリックして展開/折りたたみ
構文:
blockdev --getsz /dev/sdX
デバイス上の 512 バイトセクタの生の数を返します。リビルド前に置換ドライブが十分な大きさかを確認するのに便利です。
blkid
ファイルシステムのラベルを識別します。
blkid の使い方を表示 - クリックして展開/折りたたみ
構文:
blkid /dev/sdX1
ファイルシステムの種類とラベルを出力します。Unraid のフラッシュが UNRAID とラベル付けされていることを確認するときは、非推奨の vol_id コマンドの代わりにこれを使用してください。
ネットワーク診断
ネットワーク接続やインターフェース設定のトラブルシューティング用ツールです。
ss
ソケット統計とネットワーク接続を表示します。これは netstat の現代的な代替です。
ss のオプションを表示 - クリックして展開/折りたたみ
すべてのリスニングポートを表示:
ss -tuln
-
-t: TCP ソケット -
-u: UDP ソケット -
-l: リスニング中のソケットのみ表示 -
-n: サービス名ではなくポート番号を表示確立済み接続を表示:
ss -tupこのコマンドは、アクティブな接続とプロセス情報を表示します。
ip
ネットワークインターフェース情報を設定および表示します。これは ifconfig の現代的な代替です。
ip のオプションを表示 - クリックして展開/折りたたみ
すべてのネットワークインターフェースを表示:
ip addr show
色付きでネットワークインターフェースを表示:
ip -c addr show
ルーティングテーブルを表示:
ip route show
ping
ネットワーク接続をテストします。
ping の使い方を表示 - クリックして展開/折りたたみ
少数のパケットを送信して接続をテスト:
ping -c 4 google.com
このコマンドは宛先に 4 パケットを送信して停止するため、連続出力なしで基本的な接続テストを行うのに適しています。
ethtool
リンク速度、オフロード機能、統計情報など、ネットワークインターフェースカード（NIC）のパラメータを照会および調整するのに便利なツールです。
ethtool の使い方を表示 - クリックして展開/折りたたみ
基本的なドライバーとファームウェア情報:
ネットワークインターフェースのドライバーとファームウェアに関する情報を取得するには、次のコマンドを使用します:
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
ログファイルをリアルタイムで監視します。
tail の使い方を表示 - クリックして展開/折りたたみ
tail -f /var/log/syslog
このコマンドはシステムログのライブ更新を表示します。終了するには Ctrl+C を使用します。
特定の行数を表示:
tail -n 50 /var/log/syslog
powerdown
システムを安全にシャットダウンします。
powerdown の使い方を表示 - クリックして展開/折りたたみ
powerdown
このコマンドは Unraid の組み込みシャットダウン処理を利用して array を停止し、安全にシステムを電源オフします。手動でのシャットダウン方法より推奨されます。
ファイル転送操作
これらの方法を使うと、コマンドラインツールと組み込みユーティリティを使用して、外部ネットワーク共有（Windows または Linux の SMB/CIFS 共有）から Unraid サーバーへファイルを転送できます。
Midnight Commander の使用（組み込み）
Unraid には、Web ターミナルからアクセスできる、テキストベースの2ペインファイルマネージャーである Midnight Commander（mc）が含まれています。
-
Web ターミナルを開きます。このオプションは、Unraid の WebGUI の右上メニューにあります。
-
Midnight Commander を起動します:
mcこのインターフェースでは、ローカル共有とマウントされたネットワークパスの間をドラッグ＆ドロップで移動できます。
-
ネットワーク共有をマウントします（まだマウントされていない場合）:
# 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=utf8workstation、share、youruserを適切な値に置き換えてください。iocharset=utf8オプションは、国際化されたファイル名の維持に役立ちます。
セキュリティ上の注意: コマンドラインでパスワードを渡さないでください（例:
password=...）。 コマンド引数はシェル履歴に記録される可能性があり、プロセス一覧を通じて他のローカル ユーザーから見えてしまいます。対話型プロンプトまたはchmod 600で保護された 資格情報ファイルを使用してください。 -
MC のペインを使って、
/work（ネットワーク共有）と任意の/mnt/user/または/mnt/diskX共有の間でファイルを転送します。 -
最後にクリーンアップします:
umount /work
rmdir /work
Midnight Commander は組み込みシステム内で完全に動作し、追加のインストールは不要です。Unicode ファイル名を含むほとんどの転送ニーズに適しており、送信元と送信先の両方が対応している場合はファイル属性も保持します。
Krusader の使用
グラフィカルユーザーインターフェースを好む場合は、Krusader のような Docker コンテナをサードパーティ製ソリューションとして使用できます。
- Krusader をインストールします:
- Apps タブ（Community Applications）に移動します。
- Krusader の Docker コンテナを検索してインストールします。
- コンテナを起動し、Docker タブからその WebUI にアクセスします。
- Krusader 内でリモート共有に接続し、ドラッグ＆ドロップまたはコピー＆ペーストを使って、ネットワーク共有と Unraid array の間でファイルを転送します。
ほかの人気のファイルマネージャーコンテナには、Double Commander と CloudCommander があり、どちらも Community Applications から利用できます。
コマンドラインの方法
高度なユーザーや自動化を利用する場合は、コマンドラインによる転送方法も使用できます。
コマンドライン転送手順を表示 - クリックして展開/折りたたみ
-
ターミナルを開きます（Web Terminal または
rootとしての SSH）。 -
ネットワーク共有を作成してマウントします:
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
セキュリティ上の注意: コマンドラインでパスワードを渡さないでください。代わりに、 対話型プロンプトまたは厳格な権限を持つ資格情報ファイルを使用してください。
-
ファイルをコピーします:
-
cpを使用できます:cp -r /work/* /mnt/disk1 -
または、詳細な進行状況を表示するには
rsyncを使用します:rsync -av --progress /work/ /mnt/disk1/
-
-
一時ディレクトリをアンマウントして削除します:
umount /work
rmdir /work
特殊文字や国際文字を含むファイルを転送する場合は、常に iocharset=utf8 オプションを付けて共有をマウントしてください。これを行わないと、他のプラットフォームでファイル名が不正になったり、ファイルが読み取れなくなったりする可能性があります。
また、ターミナル経由で root としてファイルをコピーした場合、権限が制限されることがあります。その場合は、WebGUI の Tools メニューにある New Permissions ツール、または Docker 関連の共有を扱っている場合は Docker Safe New Perms を使用して権限をリセットし、すべてのユーザーがネットワークアクセスできるようにしてください。