Posted inホームラボ

HomeLabのスケールアップ：MinIOオブジェクトストレージを活用したNextcloud構築

HomeLab tutorial - IT technology blog
HomeLab tutorial - IT technology blog

HomeLabでオブジェクトストレージを採用すべき理由

多くのHomeLabは、1台の4TB SATAドライブと大きな夢から始まります。この構成は、データの移行やOSのアップグレード、あるいは最初のディスクを超えた拡張が必要になるまでは完璧に機能します。自宅でプロダクション級のインスタンスを6ヶ月以上運用した結果、アプリケーション層とストレージ層を分離することが、管理の負担を減らす最善の方法であると気づきました。

MinIOを介してデータを独立したサービスとして扱うことで、脆弱なローカルディレクトリ構造から脱却できます。このアプローチにより、Linuxのファイル権限に関するよくある悩みが解消されます。また、バックアップ作業も面倒なルーチンワークから、合理的で自動化されたプロセスへと変わります。

Docker Composeの設計図

Docker Composeを使えば、このスタック全体を5分以内にデプロイできます。この構成では、Nextcloud、MariaDBデータベース、そしてS3バックエンドとして機能するMinIOインスタンスをまとめて起動します。

version: '3.8'

services:
  db:
    image: mariadb:10.6
    command: --transaction-isolation=READ-COMMITTED --binlog-format=ROW
    restart: always
    volumes:
      - db_data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=your_root_password
      - MYSQL_PASSWORD=nextcloud_pass
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud

  minio:
    image: minio/minio
    restart: always
    environment:
      - MINIO_ROOT_USER=admin
      - MINIO_ROOT_PASSWORD=minio_secret_key
    volumes:
      - minio_data:/data
    command: server /data --console-address ":9001"

  app:
    image: nextcloud:latest
    restart: always
    ports:
      - 8080:80
    depends_on:
      - db
      - minio
    volumes:
      - nextcloud_data:/var/www/html

volumes:
  db_data:
  minio_data:
  nextcloud_data:

docker-compose up -dでコンテナを起動したら、http://localhost:9001にアクセスしてください。ログイン後、nextcloudという名前のバケットを作成します。このバケットが、アップロードするすべてのファイルのセントラルリポジトリとなります。

S3をプライマリストレージとして設定する

多くのガイドでは、NextcloudのUI内でS3を「外部ストレージ」として追加することを推奨していますが、メインの構成では避けるべきです。余計なオーバーヘッドが発生するためです。代わりに、MinIOをプライマリストレージバックエンドとして設定します。このモードでは、Nextcloudはローカルディスクを完全にバイパスし、すべてのバイトをMinIOに直接ストリーミングします。

これを有効にするには、config/config.phpファイルを編集します。以下の配列を追加して、NextcloudにS3オブジェクトストレージクラスを使用するよう指示します。

<?php
$CONFIG = array (
  'objectstore' => array(
    'class' => '\\OC\\Files\\ObjectStore\\S3',
    'arguments' => array(
      'bucket' => 'nextcloud',
      'autocreate' => true,
      'key'    => 'admin',
      'secret' => 'minio_secret_key',
      'hostname' => 'minio', 
      'port' => 9000,
      'use_ssl' => false,
      'region' => 'us-east-1',
      'use_path_style'=> true,
    ),
  ),
);

標準的なS3はbucket.domain.comのような仮想ホスト形式のアドレスを使用します。しかし、複雑なスプリットホライズンDNSを持たないローカルインスタンスの場合、use_path_style => trueにするのが正解です。これにより、アプリはよりシンプルなdomain.com/bucket形式でMinIOと通信するようになります。

なぜ標準的なNASではなくMinIOを選ぶのか？

NFSやSMBのような従来のプロトコルは、数千個の小さなファイルを扱う際に動作が非常に遅くなることがよくあります。500枚の写真のサムネイルが読み込まれるのを待ったことがあるなら、そのレイテンシを実感しているはずです。MinIOはメタデータをより効率的に処理するため、ウェブインターフェースの動作が格段に軽快になります。また、ビット腐敗（bit-rot）保護やイレージャーコーディングも組み込まれています。これにより、高解像度の家族写真が長年の間にサイレントデータ破損に見舞われる心配もありません。

パフォーマンスチューニングとセキュリティ

基本的なインストール状態では、大きなメディアライブラリをスクロールする際に動作が重く感じることがあります。これは通常、ストレージそのものではなく、ファイルロックがボトルネックになっています。

1. Redisによる高速化

Nextcloudは常にMariaDBデータベース内のファイルロックを確認しており、これが大きなオーバーヘッドを生んでいます。これをRedisにオフロードすることで、データベースのCPU使用率を最大30%削減できます。ComposeファイルにRedisコンテナを追加し、設定に以下の行を含めてください。

'memcache.local' => '\\OC\\Memcache\\APCu',
'memcache.distributed' => '\\OC\\Memcache\\Redis',
'memcache.locking' => '\\OC\\Memcache\\Redis',
'redis' => array(
     'host' => 'redis',
     'port' => 6379,
),

2. トラフィックの保護

MinIOやNextcloudを直接Webに公開するのは、重大なセキュリティリスクです。CaddyやNginx Proxy Managerなどのリバースプロキシを使用して、SSL終端を処理してください。悪名高い「Trusted Domain」エラーを避けるために、プロキシが以下の特定のヘッダーを渡すように設定してください。

  • X-Forwarded-For
  • X-Forwarded-Proto
  • Host

本番運用6ヶ月で得られた教訓

この構成を日常業務で利用してきた経験から、長期メンテナンスに関するいくつかの重要な教訓を得ました。

オフサイトバックアップ戦略

オブジェクトストレージはハードウェアの故障には対応できますが、誤ってフォルダを削除してしまった場合には救ってくれません。私は**Rclone**を使用して、週に一度MinIOバケットをBackblaze B2に同期しています。データはすでにS3形式であるため、同期は非常に効率的です。同期中は、1Gbpsの上り回線が飽和するほどの転送速度が出ることも珍しくありません。

# ローカルのMinIOをオフサイトのB2バケットに同期
rclone sync minio:nextcloud b2:my-backup-bucket

プレビュー生成のレイテンシ管理

Nextcloudは膨大な量のサムネイルを生成します。これらをMinIOに保存するのは管理上シンプルですが、ネットワークが混雑しているとラグの原因になります。遅延が気になる場合は、preview_storage設定を構成して、サムネイルはローカルのNVMe SSDに保持し、実際の2TBのデータはMinIOアレイに保持するといった運用が可能です。

モニタリングとヘルスチェック

MinIOにはネイティブのPrometheusメトリクスエンドポイントが含まれています。Grafanaを使用している場合は、MinIOをダッシュボードに組み込んでIOレイテンシを追跡しましょう。100msを超えるスパイクが見られる場合は、通常、ディスクの故障の兆候か、ネットワークケーブルの混雑を意味します。

このようにクラウドを構築することで、プロフェッショナルなエンタープライズ環境を模倣できます。Dockerボリュームを移動するだけでスタック全体を新しいサーバーに移行できる自由が得られます。もう、絶対パスの破損に悩まされることはありません。

Share:
Tags: