Raspberry Pi 4で軽量なMatrix Homeserverを実行する

はい、Raspberry Pi 4でもConduitは動作します。プロジェクトではARM64ビルドも公開されています。小規模な個人用または家庭用ホームサーバーの場合、最も重要な設定項目は、64ビットOS、永続的なMatrixサーバー名、永続ストレージ、そしてHTTPSルーティングが正常に動作することです。Conduitは現在ベータ版であるため、常に最新の状態に保ち、Pi 4に特定のユーザー容量がサポートされていると想定しないでください。プロジェクトではRaspberry Pi 4の容量ベンチマークは公開されていません。

ConduitはこのRaspberry Piに最適なツールでしょうか?

Conduitは軽量なMatrixホームサーバーで、推奨データベースバックエンドとしてRocksDBを採用しています。公式の導入ドキュメントにはaarch64バイナリとOCIイメージが記載されており、これは64ビット版Raspberry Pi OSのインストール環境に対応しています。2026年10月10日に確認したところ、プロジェクトの変更履歴には2026年9月30日付けのv0.10.15が記載されていました。それ以前のv0.10.14リリースではアカウントアクセスに関する脆弱性が修正され、迅速なアップグレードが推奨されていました。こうした経緯から、アップデートの監視はセットアップの一部として必須であり、後から行うオプション作業ではありません。

Conduit の Web サイトでは、このプロジェクトはまだベータ版と表示されており、一部の機能が欠けていることが指摘されています。選択する前に、現在の機能セットがニーズを満たしているかどうかを確認してください。特に、ブリッジ、高度な管理機能、または幅広いクライアント互換性に依存している場合は、この点が重要です。Raspberry Pi は小規模な展開には実用的なホストになり得ますが、トラフィック、メディアの使用、およびフェデレーションのアクティビティはパフォーマンスに影響します。約束されたユーザー数に頼るのではなく、まずは控えめなユーザーグループから始めて、メモリ、温度、およびストレージの使用状況を監視してください。

インストール前に決めておくべきことは何ですか?

  • Matrixサーバー名を選択してください。この例では、 ですmatrix.example.org。このドメインは、 などのユーザーのMatrix IDに表示されます@alex:matrix.example.org。管理していて、今後も維持する予定のドメインを選択してください。後で変更するのは、ホスト名の編集のように簡単にはできません。
  • 公開アクセスを計画してください。ドメインに、パブリックIPアドレスを指すDNSレコードを設定します。ルーターの転送設定と、有効なHTTPS証明書を使用したリバースプロキシを設定します。Conduitの導入ガイドではHTTPSの使用が必須とされており、フェデレーショントラフィックは、検出とプロキシの設定に応じて、ポート443および/または8448でアクセス可能である必要があるとされています。
  • 64 ビット版の Raspberry Pi OS を使用してください。アーキテクチャは で確認できuname -mます。 と表示されるはずですaarch64。Docker の現在の Raspberry Pi に関するガイダンスでは、今後の Docker Engine のメジャー リリースでは 32 ビット版の Raspberry Pi OS 用のパッケージは提供されなくなると記載されています。64 ビット ARM の場合、ユーザーは Debian のarm64インストール手順を参照するように指示されます。
  • データベースは永続的に保存してください。Conduitのデータは永続的なディレクトリまたはDockerボリュームに保存し、テスト済みのバックアッププランに含めてください。唯一のコピーをコンテナの書き込み可能なレイヤーや、再フォーマットする可能性のあるリムーバブルカードに保存しないでください。

DockerでConduitを起動するにはどうすればよいですか?

お使いのRaspberry Pi OSのバージョンに対応した最新の手順に従って、Docker EngineとComposeプラグインをインストールしてください。次に、Dockerが実行されていることを確認してください。Conduitのドキュメントには、安定版のDocker Hubイメージregistry.gitlab.com/famedly/conduit/matrix-conduit:latestとARM64 OCIイメージが記載されています。安定版イメージをプルし、DockerがARM64イメージを選択していることを確認してください。

docker image pull registry.gitlab.com/famedly/conduit/matrix-conduit:latest
docker image inspect registry.gitlab.com/famedly/conduit/matrix-conduit:latest \
  --format '{{.Architecture}}'

報告されたアーキテクチャがご使用の64ビットOSと一致する場合のみ続行してください。作業ディレクトリとComposeファイルを作成します。

mkdir -p ~/matrix-conduit/data
cd ~/matrix-conduit
nano compose.yaml

この設定を起点として使用してください。リバースプロキシがPiホスト上で実行され、Matrixリクエストをポート6167に転送することを前提としています。サンプルサーバー名を置き換えてください。空欄にすると、CONDUIT_CONFIGコンテナは環境変数を使用するようになります。これは、現在のConduit Dockerの手順でこの設定に必要とされるものです。

services:
  conduit:
    image: registry.gitlab.com/famedly/conduit/matrix-conduit:latest
    container_name: conduit
    restart: unless-stopped
    ports:
      - "127.0.0.1:6167:6167"
    volumes:
      - ./data:/var/lib/matrix-conduit
    environment:
      CONDUIT_CONFIG: ""
      CONDUIT_SERVER_NAME: "matrix.example.org"
      CONDUIT_ADDRESS: "0.0.0.0"
      CONDUIT_PORT: "6167"
      CONDUIT_DATABASE_BACKEND: "rocksdb"
      CONDUIT_ALLOW_REGISTRATION: "true"
      CONDUIT_REGISTRATION_TOKEN: "${CONDUIT_REGISTRATION_TOKEN}"
      CONDUIT_ALLOW_FEDERATION: "true"
      CONDUIT_TRUSTED_SERVERS: '["matrix.org"]'

プライベート登録トークンファイルを作成し、サービスを起動します。

umask 077
printf 'CONDUIT_REGISTRATION_TOKEN=%s\n' "$(openssl rand -hex 32)" > .env
docker compose up -d
docker compose logs --tail=100 conduit

トークンは最初のアカウントを登録するために必要です。Conduit では、最初に作成されたユーザーがサーバー管理者になります。この.envファイルは非公開にし、公開リポジトリにはコミットしないでください。この例では Conduit を Pi のループバックインターフェイスにバインドしているため、同じホストで実行されているリバースプロキシ経由でのみアクセス可能です。プロキシが別のコンテナまたは別のマシンで実行されている場合は、ポート 6167 を公開する代わりに、プライベート Docker ネットワークまたは保護されたプライベートインターフェイスを使用してください。

サーバーへのアクセス性とセキュリティをどのように確保しますか?

リバースプロキシを設定して、ドメインをHTTPS経由で提供し、Matrixクライアントおよびフェデレーション要求(を含む)を/_matrix/Conduitに転送します/.well-known/matrix/。最もシンプルな公開構成は、プロキシの種類と、フェデレーションがポート8448を使用するか、ポート443で委任された検出を使用するかによって異なります。ConduitのDockerデプロイメントドキュメントにある対応する例に従ってください。ホスト名、証明書の処理、およびネットワークパスを調整せずにプロキシのスニペットをコピーしないでください。

server_nameとホームサーバーの URLに同じドメインを使用する場合は、クライアントが公開されている HTTPS エンドポイントにアクセスできることを確認してください。Conduit が Matrix ID ドメインとは別のサブドメインでホストされている場合は、委任ガイドに記載されているように/.well-known/matrix/client、と両方を設定してください/.well-known/matrix/server。ポートを開放するだけでは、検出や TLS は設定されません。

登録トークンをサポートする Matrix クライアントを使用して、管理者アカウントを速やかに登録してください。その後、他のユーザーがアカウントを作成できるように意図的に設定しない限り、オープン登録を無効にしてください。Compose で、CONDUIT_ALLOW_REGISTRATIONを に変更し"false"、サービス環境から登録トークンを削除して、 を使用してコンテナを再作成してくださいdocker compose up -d。バインドマウントされたデータディレクトリはそのまま残ります。サーバーの機密情報が漏洩または変更される可能性があるため、Pi の Docker ソケットと構成ファイルにアクセスできるユーザーを確認してください。

設定が正しく機能していることをどのように確認できますか?

公開されているHTTPSホスト名を使用して、ローカルのMatrixクライアントAPIを確認してください。

curl -fsS https://matrix.example.org/_matrix/client/versions

JSONレスポンスは、クライアントAPIにアクセス可能であることを示すものであり、フェデレーションが正常に機能していることを証明するものではありません。サーバー名で公式のMatrix Federation Testerを実行し、.well-known報告されたDNS、TLS、ポートフォワーディング、またはエラーを修正してください。最後に、新しいアカウントでログインし、管理者権限が付与されていることを確認し、フェデレーションが目的の一部である場合は、別のホームサーバーのユーザーとルームでメッセージをテストしてください。

上記の技術的な詳細は、2026年10月10日にConduitの公式Docker、構成、委任、および変更履歴ページと照合して確認しました。リリースによって異なる詳細については、 Conduit Dockerデプロイメントガイド、ARM64バイナリおよび汎用デプロイメントガイド、構成リファレンス、委任ガイド、Conduit変更履歴、およびDockerのRaspberry Pi OSインストールノートを参照してください。

コメントを残す

モバイル読み込み速度を向上させるために、ネイティブマトリックススライディング同期を有効にする

モバイル読み込み速度を向上させるために、ネイティブマトリックススライディング同期を有効にする

廃止されたプロキシはスキップし、Synapseに組み込まれているスライディング同期を設定してください。クライアント検出機能をチェックした後、互換性のあるスマートフォンでルームリストの読み込みと再接続の動作を測定します。

カスタムホームサーバーを使用してNginx上でWebサイトをホストする

Element Webを静的サイトとしてデプロイし、Matrixホームサーバーに接続し、HTTPSを追加し、Nginxを設定して古いファイルなしで更新を配信します。

Raspberry Pi 4で軽量なMatrix Homeserverを実行する

64ビット版Raspberry Pi 4に、永続データ、HTTPSフェデレーション、保護された登録、および動作中のホームサーバーのチェック機能を備えたConduitをセットアップします。

独自のドメインにカスタムMatrixルームエイリアスを設定する

ElementまたはMatrix APIを使用して、権限、Synapse命名規則、およびフェデレーションのチェックを行いながら、ドメイン上の共有しやすいMatrixルームのアドレスを設定できます。

信頼性の高いマトリックス音声通話およびビデオ通話のためのcoturnを設定する

coturnとSynapseを一致するTURN認証情報で設定し、必要なリレーポートを開き、Matrixクライアントがリレー候補を取得できることを確認します。

Docker ComposeとPostgreSQLを使用してMatrix Synapseをデプロイする

Docker ComposeとPostgreSQLを使用してMatrix Synapseをデプロイする

Docker Compose、PostgreSQL、プライベート設定、およびHTTPS経由で公開する前にチェックを行う機能を備えた、永続的なSynapseホームサーバーをセットアップします。

Element Webのテーマとブランディングをカスタマイズする

Element Web デプロイメント用にブランド名、カスタムカラー、ログインアセットを設定すると同時に、どの部分が Element ブランドのままになるかを理解してください。

SynapseのSystemdファイル制限を推測なしで引き上げる

SynapseのSystemdファイル制限を推測なしで引き上げる

Synapseがプロセスごとのオープンファイル数の上限に達したかどうかを診断し、適切なサービスまたはワーカーに対してsystemdのドロップインを設定し、実際の制限を確認します。

要素に「復号化に失敗しました」と表示されますか?紛失したルームキーを復元してください。

要素に「復号化に失敗しました」と表示されますか?紛失したルームキーを復元してください。

エラーが特定のブラウザまたは特定のイベントに限定されているかどうかを確認し、残りの暗号化された履歴を危険にさらすことなく、Elementのリカバリキーまたは信頼できるデバイスを使用してください。

データを失うことなく、古いSynapseメッセージとメディアをクリーンアップする

Synapseの履歴およびメディア消去APIまたは保持設定を使用して、古いデータを安全に削除し、完了とディスク容量の回復を確認してください。