メインコンテンツへスキップ

ファイルシステム

ファイルシステムの種類を選択する​

Unraid array または cache pool に適したファイルシステムを選ぶことは非常に重要です。これにより、パフォーマンス、データ保護、高度な機能のバランスを取ることができます。Unraid はいくつかの最新の Linux ファイルシステムをサポートしており、それぞれに独自の強みと特定の用途があります。

ファイルシステムデータ保護容量効率高度な機能最適な使用例
XFS組み込みの冗長性なし100%破損に強いarray ドライブの既定値; 高信頼性
EXT4組み込みの冗長性なし100%成熟していて安定しており、ジャーナリング対応Array ドライブまたは単一ドライブのプール。XFS の代替
ZFSRAIDZ1/RAIDZ2/RAIDZ3、ミラーなどRAID レベルにより異なるChecksums、Snapshots、RAID複数デバイスのプール、VMs、Docker、上級ユーザー
BTRFSRAID 0/RAID 1/10/5/6、ミラーRAID レベルにより異なるChecksums、Snapshots、RAID複数デバイスのプール、混在 SSD/HDD、柔軟なプール
NTFS組み込みの冗長性なし100%Windows との互換性データ移行なしで既存の Windows ドライブを追加
exFAT組み込みの冗長性なし100%クロスプラットフォームの互換性データ移行なしで既存の exFAT ドライブを追加

XFS​

XFS は、Unraid における array ドライブの既定ファイルシステムです。堅牢で、予期しないシャットダウンやクラッシュ後の破損からの回復能力に優れていることで知られています。XFS でフォーマットされた各ドライブは独立したファイルシステムとして機能するため、どの Linux システムでもデータ復旧が容易です。

  • データ保護: 組み込みの冗長性はなく、保護は Unraid の parity に依存します。
  • 性能: 一貫して安定しています。
  • 最適な用途: Array ドライブ。特に安定性とデータ復旧のしやすさを重視する場合。

EXT4​

EXT4 は成熟した安定性の高いファイルシステムで、優れた互換性と信頼性を備えています。完全にサポートされており、XFS、BTRFS、ZFS と同等であるため、Array ドライブや単一ドライブのプールに適した選択肢です。

  • データ保護: 組み込みの冗長性はなく、保護は Unraid の parity に依存します。
  • 性能: ジャーナリングによりデータ整合性を確保しつつ、一貫して信頼性の高い性能を提供します。
  • 最適な用途: XFS の代替を探している場合の Array ドライブまたは単一ドライブのプール。

ZFS​

ZFS は、checksums による bit rot の検出、バックアップ用の snapshots、RAIDZ1/RAIDZ2/RAIDZ3 やミラーなどのネイティブ RAID サポートオプションといった高度な機能を備えた最新のファイルシステムです。ZFS は単一デバイスおよび複数デバイスの両方のプールで利用できます。

  • データ保護: 冗長性のためのさまざまな RAID レベルをサポートします。
  • 性能: 非常に優れており、特に複数デバイスのプールで効果を発揮します。
  • 最適な用途: 高性能環境、virtual machines、Docker、または snapshots のような高度な機能が必要な場合。

ZFS の機能、設定、ベストプラクティスの詳細については、専用の ZFS ストレージ ページを参照してください。

BTRFS​

BTRFS は柔軟な RAID サポート、データ整合性のための checksums、異なるサイズのドライブが混在するプールの効率的な管理を提供します。これは cache pools の既定ファイルシステムとして機能し、単一デバイス構成と複数デバイス構成の両方をサポートします。

  • データ保護: RAID 0/1/10/5/6 をサポートします（※ RAID 5/6 はまだ実験的です）。
  • 性能: 良好で、拡張や縮小に柔軟に対応できます。
  • 最適な用途: Cache pools。特に SSD と HDD を混在させたい場合や、簡単に拡張したい場合。

NTFS と exFAT（制限付きサポート）​

NTFS および exFAT ファイルシステムは、一部の制限付きでサポートされています。これは主に、データを別の場所へ先に移動することなく、既存のデータ付きドライブを Unraid システムに追加できるようにするためです。

警告

NTFS または exFAT でフォーマットされたドライブは、パリティドライブを追加する 前に array に追加する必要があります。array にパリティドライブを追加すると、その後に追加する新しいデータドライブは、ファイルシステム形式に関係なくゼロ化されます。

既存の NTFS または exFAT ドライブを使用する場合は：

  • まずそれらを array に追加します（または Tools → New Config を実行して Array 構成をリセットします）。
  • NTFS/exFAT のデータドライブを追加した後で、パリティドライブを追加できます。
  • これらのドライブ上の既存データは保持され、パリティによって保護されます。
  • データ保護: これらのドライブには組み込みの冗長性がなく、パリティ追加後は Unraid の parity に保護を依存します。
  • 性能: 基本的なストレージ用途には十分です。
  • 最適な用途: データ移行なしで、既存の Windows 形式ドライブ（NTFS）またはクロスプラットフォーム形式ドライブ（exFAT）を追加する場合。また、単一ドライブのプールにも使用できます。
  • 制限: これらのファイルシステムは通常の使用には推奨されません。主に既存ドライブの移行用です。新しいドライブには、XFS、EXT4、BTRFS、または ZFS の使用を検討してください。

既存ドライブの追加の詳細については、リリースノート を参照してください。

Additional 注記
  • Unraid システムで異なる種類のファイルシステムを混在させることはまったく問題ありません。Unraid の parity システムは、使用するファイルシステムとは独立して動作します。
  • 互換性を確保するため、ドライブのフォーマットとパーティション作成は必ず Unraid 内で行ってください。
  • Linux システムではこれらのファイルシステムをネイティブに読み取れますが、Windows と macOS でアクセスするには追加のソフトウェアが必要です。
  • セキュリティ強化のためにドライブを 暗号化 できますが、破損が発生した場合、暗号化されたドライブは復旧が難しくなる可能性があることに注意してください。
  • 転送用ドライブや外部デバイスには、追加のファイルシステムをサポートする Unassigned Devices プラグインの使用を推奨します。
Still ヘルプが必要ですか？
  • Array ドライブ向け: ほとんどのユーザーには XFS が一般的に最適です。より伝統的な Linux ファイルシステムを好む場合は EXT4 も堅実な選択肢です。
  • 高性能や高度な機能向け: cache pools や複数デバイス構成には ZFS または BTRFS を選択してください。ZFS の詳細は ZFS ストレージ ページを参照してください。
  • 混在または拡張中のプール向け: 異なるサイズのドライブを使いたい場合や、デバイスを簡単に追加・削除したい場合は、BTRFS が最適です。BTRFS プールへのディスク追加の詳細は BTRFS プール を参照してください。
  • 既存ドライブ向け: NTFS または exFAT は、データ付きの既存ドライブを追加する場合にのみ使用してください。パリティより先に追加します。

迷う場合は、まずは既定値から始めるのがよいでしょう。array ドライブには XFS を、cache pools には BTRFS を使用します。

ファイルシステムの種類を設定する​

Unraid に新しいドライブを追加するときは、用途に最適なファイルシステムの種類を選択できます。ファイルシステムは、ディスク上でデータがどのように整理され、保護されるかを決定します。

グローバルにファイルシステムの種類を設定するには、Settings → Disk Settings に移動して、新しい array ドライブのみの既定ファイルシステムを設定します。Unraid の array ドライブの既定は XFS です。

注記

現在、cache pools に対するグローバルな既定設定はありません。"auto" のままにすると、常に BTRFS が既定になります。

important

既存の NTFS または exFAT データドライブを追加する場合は、パリティドライブを追加する 前 に array に追加する必要があります。パリティがある状態では、新しく追加されたデータドライブはファイルシステムの種類に関係なくすべてゼロ化されます。

個別のドライブにファイルシステムを設定するには：

  1. 変更を行う前に array を停止します。
  2. Main タブで、設定したいドライブをクリックします。
  3. ドロップダウンメニューから目的のファイルシステムの種類を選択します。
  4. （オプション）auto を選択すると、Unraid はグローバル既定を使用します。
  5. 複数デバイスの cache pools では、BTRFS または ZFS のみがサポートされます。
  6. 既存の NTFS または exFAT データドライブを array に追加する場合は、パリティドライブを追加する前に追加してください。

ファイルシステムの作成（フォーマット）​

Unraid で新しいディスクを使用する前に、選択したファイルシステムでフォーマットする必要があります。

警告

フォーマットすると、ドライブ上の既存の内容はすべて消去されます。続行する前に、重要なデータを必ずバックアップしてください。

ドライブをフォーマットするには：

  1. array を起動します。
  2. マウントできないドライブを特定します（unmountable と表示されます）。
  3. マウントできないドライブが、実際にフォーマットしたいドライブであることを確認します。
  4. 確認ボックスにチェックを入れ、警告ダイアログを読み、Format をクリックします。
  5. 処理を監視します。新しいディスクの場合、Unraid は最初にパーティションテーブルを書き換えます。
  6. 完了するまで待ちます。進行が止まる場合は、Main タブを更新してください。

フォーマットが完了すると、ドライブはファイルの保存に使用できるようになります。

ファイルシステムの種類を変更する​

新機能を利用したり、他のドライブとの互換性を確保したりするために、特定のドライブのファイルシステムの種類を変更したい場合があります。

警告

ファイルシステムの種類を変更すると、ドライブ上の 既存のデータはすべて消去されます。続行する前に、重要なファイルは必ずバックアップしてください。

特定のドライブのファイルシステムの種類を変更するには：

  1. array を停止します。
  2. Main タブで、変更したいドライブをクリックします。
  3. ドロップダウンから新しいファイルシステムを選択します（必要に応じて複数ドライブ分繰り返します）。
  4. array を起動します。
  5. Main タブで、マウントできないドライブの一覧を確認し、対象のドライブだけが含まれていることを確認します。
  6. 確認ボックスにチェックを入れ、Format をクリックします。
  7. 完了するまで待ちます。状態が更新されない場合は、Main タブを更新してください。

問題が発生した場合は、Unraid フォーラム をご利用ください。サポート用にシステム診断の zip ファイル（Tools → Diagnostics にあります）を添付してください。

新しいファイルシステムの種類への変換​

important

Main ページでは、Array またはプールのドライブがレガシー ファイルシステムでフォーマットされている場合に警告が表示されます：

  • ReiserFS でフォーマットされたドライブは、将来の Unraid リリースでは使用できなくなるため、できるだけ早く別のファイルシステムに移行する必要があります。
  • 古い XFS バージョンでフォーマットされたドライブは、2030 年までに移行する必要があります。

ドライブのファイルシステムの種類を変更しつつデータを保持するには、再フォーマットする前に内容を別の場所へ移行する必要があります。この手順は、非推奨の ReiserFS（古い Unraid バージョンで使用）から XFS や BTRFS へ移行するユーザーに特によく見られますが、あらゆるファイルシステム変換に適用できます。

important

この手順では、データを一時的に別の場所へ移動する必要があります。開始する前に、array の別の場所または外部デバイスに十分な空き容量があることを確認してください。

新しいファイルシステムの種類へ安全に変換するには:

  1. ドライブ上のすべてのデータを別の場所（別の array ドライブ、cache pool、または外部バックアップ）に移動します。次のいずれかの方法を使用してください：

    WebGUI 経由（Unraid 7.2+）：

    • Main → Array Operation に移動し、array を停止する
    • Settings → Global Share Settings に移動します。Emptying disk(s) の欄で空にするディスクを選択し、Apply をクリックします。注: この状態は array を停止すると自動的に解除されます。
      • Unraid 7.2.0 では、このステータスが解除されるまで、このディスク上のデータはユーザー共有から非表示になります。
      • Unraid 7.2.1 以降では、データはユーザー共有で引き続き利用できますが、このステータスが解除されるまで新しいファイルはディスクに書き込まれません。
    • Main → Array Operation に移動し、array を開始する
    • Main → Array Operation で Move をクリックする（または mover が通常のスケジュールで実行されるのを待つ）
    • Mover はディスクを空にし、共有設定に従ってファイルを他の Array ドライブへ移動します。ドライブのルートにあるファイルはどの共有にも属さないため、移動されない点に注意してください。
    • Tools → System Log で、使用中または空き容量不足のために移動できなかったファイルに関するメッセージを確認する

    またはコマンドライン経由（Unraid 7.0 および 7.1 のみ）：

    または手動で：

    • ファイルを手動で別の場所へ移動する

    完了したら、Main → Array Devices に移動してディスクを参照し、空であることを確認します。ディスクが空であると確信できる場合のみ続行してください。

  2. ファイルシステムの種類を変更する 手順に従ってください。これによりドライブがフォーマットされ、すべての内容が消去され、新しい形式の空のドライブが作成されます。

  3. （オプション）ファイルを移動した先に応じて、データを新しくフォーマットしたドライブへ戻します。

  4. 変換するドライブが複数ある場合は、各ドライブについてこの手順を繰り返します。

:::note[Timing]

この処理には、データ量とドライブ速度に応じて数時間かかることがあります。時間の大半はファイルのコピーに費やされ、作業は放置しておけます。

:::

ドライブの再フォーマット​

Unraid でドライブを再フォーマットすると、すべてのデータが消去され、新しい空のファイルシステムが作成されます。この手順は、継続的なファイルシステムエラーの解消や、新しい形式でやり直す場合に役立ちます。

警告

再フォーマットすると、ドライブ上のすべてのデータが恒久的に消去されます。開始する前に、重要なファイルは必ずバックアップしてください。

ドライブを 安全に 再フォーマットするには:

  1. array を停止する。
  2. ファイルシステムの種類を変更する:
    • Main タブに移動し、再フォーマットしたいドライブをクリックします。
    • 別のファイルシステムの種類を選択します（たとえば、XFS から BTRFS に変更する）。
    • array を開始すると、ドライブは unmountable と表示されます。
    • 求められたら、ドライブをフォーマットします。
  3. （任意）元のファイルシステムの種類に戻す:
    • 再度 array を停止します。
    • ファイルシステムを希望の種類に戻します。
    • array を開始し、もう一度ドライブをフォーマットします。

この簡単な手順で、ドライブは完全に消去され、希望どおりにフォーマットされます。フォーマット処理は通常、数分で完了します。

キャッシュドライブの再フォーマット​

場合によっては、次の理由で cache ドライブを再フォーマットする必要があります:

  • ファイルシステムの種類を変更するため（たとえば、BTRFS から XFS へ、またはその逆）
  • 継続的なファイルシステムエラーを修正するため
  • 新しい用途のためにやり直すため

準備​

再フォーマットする前に、システムを準備します：

  1. array を停止します。
  2. Settings に移動し、Docker と VM サービスを無効にします（処理中にそれらのタブが表示されないようにするためです）。
  3. array を再度開始します。

キャッシュからデータを移動する​

キャッシュからデータを移動するには:

  1. 共有のストレージと Mover の動作を設定する（cache → array）：
    • Shares タブに移動します。
    • cache にファイルがある各共有について、Primary storage を元の cache プールに、Secondary storage を array に設定します。
    • Mover action を cache → array に設定します。
    • 変更した共有と、元の設定をメモします。
  2. Main タブで Move Now をクリックし、完了するまで待ちます。cache が空になっていることを確認してください。
    • ファイルが残っている場合は、停止してフォーラムで助けを求めてください。

キャッシュドライブを再フォーマットする​

キャッシュドライブを再フォーマットするには:

  1. array を停止します。
  2. キャッシュドライブの形式を設定します：
    • Main タブで、キャッシュドライブをクリックします。
    • XFS、EXT4、または BTRFS から選択します。
    • 単一ドライブの cache には、XFS または EXT4 が推奨されます。
    • XFS と EXT4 は、1 つの cache スロットでのみ使用できる点に注意してください。
  3. array を起動します。
  4. キャッシュドライブをフォーマットします：
    • cache ドライブのみがマウント不可として表示されていることを確認します。
    • 確認ボックスにチェックを入れ、Format をクリックします。

データと設定を復元する​

データと設定を復元するには:

  1. 変更した各共有について、Primary storage と Secondary storage を元の値に戻します。
  2. データを戻す（array → cache）：
    • 変更した各共有について、Primary storage を移行先の cache プールに、Secondary storage を array に設定します。
    • Mover action を array → cache に設定します。
    • Main タブで Move Now をクリックし、データを cache に戻します。
  3. array を停止します。
  4. Settings に移動し、Docker と VM サービスを再度有効にします。
  5. array を起動して処理を完了します。

:::note[Timing]

Mover でデータを移動しドライブをフォーマットするのにかかる時間は、データ量とドライブ速度によって数分から数時間まで変わります。

:::

BTRFS の操作​

Unraid で BTRFS プールを適切に保守することは、正常に動作させ、データを安全に保つために不可欠です。定期的に使うべき重要なツールは Balance と Scrub の 2 つです。これらの操作は、領域割り当ての問題を解決し、ストレージの使用を最適化し、隠れた破損からデータを保護するのに役立ちます。

各操作が何を行い、いつ使うべきかを見ていきましょう：

バランス​

Balance 操作は、BTRFS プール全体にデータとメタデータのチャンクを再配置します。これにより空き容量を確保し、割り当ての問題を解決し、空きがあるように見える場合でも「デバイスに空き容量がありません」エラーを修正できることがあります。

Balance を実行するタイミング​

  • 空き容量があるのに「デバイスに空き容量がありません」エラーが発生したとき。
  • プールにドライブを追加または削除した後。
  • 容量の使用を最適化し、性能を向上させるため。

Balance の実行方法​

  1. WebGUI で、Main タブのプールをクリックし、Balance を選択します。
  2. （オプション）高度な用途向けのパラメーターを追加します（詳細は Unraid Help を参照）。
  3. Start をクリックして開始します。

:::note[Timing]

Balance 操作には、プールのサイズとデータ量に応じて、数分から数時間かかる場合があります。

:::

データスクラブ​

Scrub 操作は、すべてのデータとメタデータを読み取り、チェックサムの整合性を確認し、利用可能な冗長コピーを使って破損ブロックを修復します。Scrub は、重大な問題になる前に「bit rot」と呼ばれる静かなデータ破損を特定し修正するのに役立ちます。

Scrub を実行するタイミング​

  • 定期メンテナンスの一環として（下の推奨スケジュールを参照）。
  • 不適切なシャットダウンの後、または破損が疑われる場合。
  • 使用頻度の高いプールでは、より頻繁に。

推奨スケジュール​

  • 使用頻度の高いプール: 週 1 回
  • その他のすべてのプール: 月 1 回

Scrub の実行方法​

  1. WebGUI で、Main タブのプールをクリックし、Scrub を選択します。
  2. Start をクリックして開始します。

:::note[Timing]

Scrub 操作は、割り当て済みデータのみをチェックするため、通常はフルディスクスキャンよりも速く完了します。プールのサイズと使用状況によっては、数分から数時間かかることがあります。

:::

ヒント

Balance と Scrub はどちらもシステム稼働中に実行できますが、その間はパフォーマンスに影響が出る場合があることに注意してください。進行状況は WebGUI で確認できます。

高度な BTRFS 機能の詳細については、公式 BTRFS ドキュメント を参照してください。

未割り当てドライブ​

未割り当てドライブとは、Unraid サーバーに接続されているストレージデバイスのうち、メインの array やいずれかの cache pool に含まれていないものです。これらのドライブは、ファイルの転送、バックアップの作成、または virtual machines 用の高速ストレージとして利用できます。

注記

array が起動したときにサーバーに接続されているすべてのドライブは、array やプールに割り当てられていなくても、Unraid の Attached Devices ライセンス上限にカウントされます。

割り当てられていないドライブの一般的な用途​

  • 取り外し可能なドライブを接続して、簡単なファイル転送やバックアップに使います。
  • virtual machines の実行や一時データ保存など、高負荷の処理には専用ドライブを使用します。

Unassigned Devices プラグインの使用​

未割り当てドライブを最大限に活用するには、Apps タブから次のプラグインの導入を検討してください:

  • Unassigned Devices: このプラグインを使用すると、XFS、BTRFS、または NTFS など、Unraid がサポートするファイルシステムのドライブをマウント、共有、管理できます。

  • Unassigned Devices Plus: この拡張機能は、ExFAT や HFS+ を含む追加のファイルシステムをサポートすることで、利用範囲を広げます。

これらのプラグインにより次が可能になります:

  • Unraid の Web インターフェースからドライブを簡単にマウントおよびアンマウントする。
  • 未割り当てドライブをネットワーク経由で共有する。
  • サーバー起動時のマウント処理を自動化する。
  • 将来の使用に向けてドライブをフォーマットまたは消去する。
  • USB または外付けドライブを手間なく安全に取り外す。

プラグインのインストールと管理の詳細については、Plugins を参照してください。

トラブルシューティング​

ドライブが unmountable と表示される​

Unraid でドライブが unmountable と表示される場合、主な原因は 2 つ考えられます:

  1. 新しいドライブをセットアップに追加したばかりの場合、フォーマットするまでマウント不可として表示されます。フォーマットすると、ドライブにファイルを保存できるようになるファイルシステムが作成されます。ドライブをフォーマットする手順は こちら を参照してください。

  2. 以前は正常に動作していたドライブが突然マウント不可と表示される場合、ファイルシステムの問題である可能性が高いです。これは、予期しないシャットダウン、データ書き込み中の問題、またはドライブが無効化された場合（WebGUI では赤い「x」で表示されます）に起こり得ます。

important

unmountable なドライブは、その中のすべてのデータを失ってもよい場合以外はフォーマットしないでください。フォーマットするとすべてが消去され、parity 情報が更新されるため、復旧は不可能になります。まずは必ずファイルシステムの修復を試してください。

ドライブが unmountable の場合:

  1. 新しいドライブか、以前正常に動作していたドライブかを判断します。
  2. 新しいドライブの場合：ドライブをフォーマットして新しいファイルシステムを作成します（フォーマット手順 を参照）。
  3. 以前正常に動作していたドライブの場合：ファイルシステムのチェックまたは修復を実行します（ファイルシステムの確認 を参照）。データを保持したい場合は、フォーマットしないでください。
注記

ドライブが unmountable で、かつ無効（赤い 'x'）になっている場合は、まず エミュレートされた ドライブでファイルシステムのチェック/修復を実行します。エミュレートされたドライブも unmountable のままの状態でそれを再構築しようとすると、新しいドライブも unmountable になります。

通常、ファイルシステムの修復はドライブの再構築よりも短時間で済み、何も失わずにデータへアクセスできるようになります。なお、ドライブの再構築はファイルシステムの問題を 修正しません。物理ドライブをエミュレートされたものに一致させるだけで、既存の問題もそのまま引き継がれます。

Why parity で十分ではないのか？

parity は故障したドライブの復旧には役立ちますが、ファイルシステムの問題は修復できません。ファイルシステムが破損している場合、parity はその破損を新しいドライブへそのまま複製するだけです。

よくわからない場合は:

  • Tools → Diagnostics に移動してシステムログをダウンロードします。
  • 専門的な支援が必要な場合は、診断情報とともに問題を Unraid フォーラム に投稿してください。
Just 繰り返しになりますが
  • unmountable なドライブをフォーマットしてよいのは、新品の場合か、すべてのデータを消去したい場合だけです。
  • 破損したファイルを修復するにはファイルシステムのチェック/修復を使用してください。これらの問題を解決するために parity に頼らないでください。
  • 複数ドライブの cache pools では、BTRFS または ZFS のいずれかの使用を検討してください。
  • フォーマットやドライブの修復を行う前に、誤ってデータを失わないよう必ず再確認してください。

ファイルシステムのチェック​

以前は問題なくマウントできていたディスクが unmountable と表示される場合、通常はファイルシステムの破損を示しています。これは、不適切なシャットダウン、書き込み操作の失敗、または WebGUI でディスクが無効としてマークされたことが原因で起こることがあります。一般に、ファイルシステムのチェックと修復は再構築よりも迅速で安全なので、ディスクをフォーマットまたは再構築する前にこれを試すことをお勧めします。

important

WebGUI がマウント不可のドライブのフォーマットを提案していても、すべてのデータを消去するつもりがない限り フォーマットしないでください。フォーマットするとドライブの内容が破壊され、parity も更新されるため、復旧は不可能になります。

チェックまたは修復の準備​

  1. ファイルシステムの種類を特定します：

    • Main タブで、ディスクを選択します（例: Disk 3, Cache）。
    • File system type を確認します（XFS、EXT4、BTRFS、または ZFS のはずです）。

  2. 正しいモードで array を起動します：

  3. ディスクが無効化されエミュレーションされている場合は、再構築を試みる前に emulated disk でチェック／修復を実行してください。emulated disk がマウント不可であれば、再構築されたディスクもマウント不可になります。

よくあるエラーメッセージ​

メッセージ意味 / 対処
Superblock に不正なマジックナンバーがあります重大な破損です。ファイルシステムの修復を試してください。
Filesystem is dirty不適切なシャットダウンです。ファイルシステムのチェックを実行してください。
メタデータの破損が検出されましたファイルシステム構造が損傷しています。修復を開始してください。
有効な BTRFS が見つかりませんディスクが有効なプールに属していない可能性があります。プールの割り当てを確認してください。
マウントできません: fs の種類が違う、オプションが不正、などファイルシステムの選択が誤っているか、ディスクが未フォーマットです。
/dev/mdX をマウントできません: 構造体のクリーンアップが必要ですファイルシステムが破損しています。修復を実行してください。

WebGUI での確認​

  1. array を正しいモードで起動します（上の手順を参照）。
  2. Main タブで、確認したいディスクを選択します。
  3. Check Filesystem Status までスクロールします。
  4. XFS の場合: 入力オプションのない CHECK ボタンが表示されます。システムはチェック結果に基づいて必要な処理を自動的に判断します。
  5. その他のファイルシステムの場合: 必要なオプションを入力します（詳細は右上の Help を参照）。
  6. Check をクリックして処理を開始します。
  7. 出力ボックスで進行状況を確認します。必要に応じて Refresh を使用してください。
  8. 結果を確認します。不明な場合は、出力をコピーして フォーラム に投稿し、助言を求めてください。

XFS の自動修復ワークフロー​

XFS ファイルシステムの修復は、WebGUI を通じて完全に自動化されています：

  1. CHECK ボタンをクリックします（入力するオプションはありません）
  2. 結果の確認:
    • 破損は検出されませんでした: "filesystem corruption detected" と表示されず、CHECK ボタンが残ります
    • 破損が検出されました: "filesystem corruption detected" と表示され、FIX ボタンが表示されます
  3. FIX をクリックしてファイルシステムを自動修復します
  4. 必要に応じて ZERO LOG ボタンが表示されることがあります
  5. 処理完了時に「filesystem repaired」と表示されます

この自動化されたシステムにより、ユーザーが修復オプションを手動で入力する必要がなくなり、正しい修復手順が確実に実行されます。

コマンドラインでの確認​

コマンドラインで XFS ファイルシステムを確認するには:

  • Maintenance Mode で array を開始します。
  • 次のコマンドを実行します: xfs_repair -v /dev/mdXp1
  • X をディスク番号に置き換えます（例: /dev/md1p1）。
  • 暗号化された XFS では、/dev/mapper/mdXp1 を使用します。
  • array に含まれていないドライブの場合: xfs_repair -v /dev/sdX1
  • 正しいデバイス識別子を使用していることを確認してください。
警告

このコマンドを Maintenance Mode の外で array ディスクに対して実行すると、parity が無効になります。

ヒント
  • ファイルシステムの修復は通常、完全な再構築よりも速く、データを失わずにアクセスを回復できます。
  • ディスクの再構築ではファイルシステムの破損は解消されません。まず必ずチェックまたは修復を実行してください。
  • 不明な点がある場合は、診断情報とエラーメッセージを Unraid の フォーラム に投稿して、専門的な सहायताを受けてください。

ファイルシステムの修復​

ファイルシステムのチェックでエラーが見つかった場合は、データに再びアクセスするために修復を実行する必要があるかもしれません。修復は通常、完全な再構築より短時間で済みますが、出力内容を注意深く読み、何か不明な点があれば forums で助けを求めることが重要です。

:::note[Timing]

修復には数分から数時間かかることがあり、特に大きなファイルシステムや深刻に破損したファイルシステムではその傾向があります。進行は遅く見えるかもしれませんが、Main ページの読み取り/書き込み統計を見れば作業状況を確認できます。

:::

修復の準備​

  1. Main タブでディスクをクリックし、ファイルシステムの種類（XFS、EXT4、BTRFS、または ZFS）を確認します。

  2. 正しいモードで array を起動します：

  3. ディスクが無効化されエミュレーションされている場合は、再構築を試す前に emulated disk で修復を実行してください。

WebGUI での修復​

  1. array を正しいモードで起動します（上のセクションを参照）。
  2. Main タブで、修復したいディスクをクリックします。
  3. Check Filesystem Status までスクロールします。
  4. XFS の場合: 修復プロセスは完全自動です。CHECK をクリックし、破損が検出されたら FIX をクリックし、求められたら ZERO LOG をクリックします。
  5. その他のファイルシステムの場合: チェックのみモードで実行されるオプションを削除します（BTRFS の --readonly など）。
  6. 求められた場合は、チェック出力に示された推奨オプションを追加します。
  7. Check をクリックして修復を開始します。
  8. 出力ボックスで進行状況を監視します。必要に応じて Refresh を使用してください。
  9. 修復後に lost+found フォルダーが見つかった場合、完全には復元できなかったファイルやフォルダーが含まれている可能性があります。必要に応じて、バックアップや Linux の file コマンドを使用して中身を特定してください。
情報

出力内容に自信がない場合は、コピーして Unraid forums に共有し、専門家の助けを求めてください。読みやすく保つため、コード書式オプションを使用してください。

コマンドラインでの修復​

  • Maintenance Mode で array を開始します。
  • 次のコマンドを実行します: xfs_repair /dev/mdXp1。X はディスク番号に置き換えてください（例: /dev/md1p1）。
  • 暗号化された XFS には、次を使用します: /dev/mapper/mdXp1。
  • -L の使用を求められた場合は、次のようにコマンドを再実行します: xfs_repair -L /dev/mdXp1。これは通常安全で、修復を完了するために必要です。
  • array の一部ではないドライブには、xfs_repair /dev/sdX1 を使用します。
注意

Maintenance Mode の外で array ディスクにこのコマンドを実行すると、パリティが無効になります。

After 修復
  • array を Normal mode で停止して再起動します。
  • これでドライブはマウントされ、アクセスできるようになるはずです。
  • lost+found フォルダーが見つかった場合は、中身を確認して重要なファイルがないか調べてください。

修復の出力が理解できない場合、または処理が失敗した場合は、診断情報と修復ログを Unraid forums に共有して、さらに सहायताを受けてください。