モバイル読み込み速度を向上させるために、ネイティブマトリックススライディング同期を有効にする
廃止されたプロキシはスキップし、Synapseに組み込まれているスライディング同期を設定してください。クライアント検出機能をチェックした後、互換性のあるスマートフォンでルームリストの読み込みと再接続の動作を測定します。
Nginx でカスタム Element Web クライアントをホストするには、公式のビルド済み Element Web リリースをダウンロードし、静的ファイルを Web サーバーに配置し、config.jsonMatrix ホームサーバーで設定して、HTTPS 経由でサイトを提供します。Nginx は Element 自体を実行するのではなく、ブラウザ アプリケーション ファイルを提供し、アプリケーションは Matrix ホームサーバーに別々に接続します。クライアントとホームサーバーには、chat.example.comとのように異なるホスト名を使用してくださいmatrix.example.com。
このガイドは、DebianまたはUbuntu、パブリックDNS名を持つNginxサーバー、およびHTTPS経由でアクセス可能な既存のMatrixホームサーバーを前提としています。開発ビルドではなく、公式リリースアーカイブを使用します。Elementの現在のプロジェクトドキュメントでは、デプロイされたWebアプリは静的コンテンツとして説明されており、キャッシュを回避するためにキー構成とエントリポイントURLが必要です。リリースを選択したりオプションを変更したりする際は、リリースノートと最新の構成ドキュメントを確認してください。
NginxサーバーのパブリックIPv4アドレスを指すAレコードを作成しますchat.example.com。サーバーがIPv6経由でアクセス可能な場合にのみ、AAAAレコードを追加します。ホストファイアウォールとクラウドファイアウォールで、受信TCPポート80と443を許可します。これらのポートが他のWebサーバーによって使用されていないことを確認してください。
Nginxをインストールし、Webアプリ用のディレクトリを作成します。
sudo apt update
sudo apt install nginx
sudo mkdir -p /var/www/element
別のマシンで、Element Webの公式リリースページを開き、公開されている安定版リリースを選択します。そのリリースのビルド済みWebアーカイブをダウンロードし、サーバーに転送します。developプレビューソフトウェアを実行する場合を除き、公開サービスにはブランチやナイトリービルドを使用しないでください。
まず、リリースアーカイブを一時ディレクトリに展開します。アーカイブの最上位ディレクトリ構造を確認し、その中のウェブファイルを にコピーします/var/www/element。リリースのディレクトリ構造はそのまま維持してください。パッケージのレイアウトは変更される可能性があるため、index.html、バンドル、i18n、および設定ファイルが、Nginxのドキュメントルートが指す場所に配置されるようにしてください。
sudo mkdir -p /tmp/element-release
tar -xzf /tmp/element-web-REPLACE_WITH_RELEASE.tar.gz -C /tmp/element-release
find /tmp/element-release -maxdepth 2 -name index.html
リリースコンテンツを にコピーする際は、を含むディレクトリをindex.htmlソースとして使用してください/var/www/element。アーカイブにバージョン管理されたトップレベルディレクトリが 1 つだけある場合は、ネストされたレベルを新たに作成するのではなく、そのディレクトリの内容をコピーしてください。新しいファイルが完成するまで、稼働中のデプロイメントを置き換えないでください。コピーが不完全な場合、ユーザーに JavaScript バンドルが不足する可能性があります。
config.sample.jsonアーカイブにリリースのファイルが含まれている場合は、それをコピーしてconfig.json、新しいファイルを編集します。Element を起動するには、デフォルトのホームサーバー接続設定が必要です。サポートされている推奨形式はdefault_server_config、クライアント API のベース URL を使用した です。以下の例は説明のためのものです。URL を、Matrix ホームサーバーが提供する実際の URL に置き換えてください。
{
"default_server_config": {
"m.homeserver": {
"base_url": "https://matrix.example.com"
}
},
"brand": "Example Chat"
}
Element の設定ドキュメントdefault_server_nameでは、Matrix ディスカバリに依存する もサポートしています.well-known。default_server_configホームサーバーの URL を直接指定する場合は、 を使用してください。この公開 JSON ファイルに、パスワード、アクセス トークン、署名キー、その他の秘密情報を記述しないでください。このbrandオプションは一部のアプリ ラベルを変更しますが、完全なホワイト ラベルのリブランディングではありません。
`<Nginx server block>` のような Nginx サーバーブロックを作成します/etc/nginx/sites-available/element。必要に応じてドメインを置き換えてください。このシンプルな構成により、Element は静的ファイルとして提供され、不足しているパスは `<Nginx server block>` に送信されindex.html、すべてのレスポンスが再検証対象としてマークされます。この保守的なキャッシュポリシーにより、リリース後にユーザーが古いアプリシェルや古い設定を受け取ることを防ぎます。デプロイプロセスで Element の必須のキャッシュ不要パスが保持されている場合は、後でアセットのキャッシュを調整できます。
server {
listen 80;
listen [::]:80;
server_name chat.example.com;
root /var/www/element;
index index.html;
location / {
try_files $uri $uri/ =404;
add_header Cache-Control "no-cache" always;
add_header X-Frame-Options SAMEORIGIN always;
add_header X-Content-Type-Options nosniff always;
add_header Content-Security-Policy "frame-ancestors 'self'" always;
}
}
/config.*.jsonElement のウェブホスティングに関する注意事項では、<head> 、/i18n<body>、/version<body> 、<body>をキャッシュしないようにし/index.html、ページ読み込み時にブラウザの再検証を推奨しています。この例は、no-cache単純な出発点としてすべてに適用できます。また、フレームポリシーや MIME スニッフィング保護など、Element が推奨するセキュリティ ヘッダーも含まれています。既にコンテンツ セキュリティ ポリシーを別の場所で定義している場合は、frame-ancestors 'self'競合するポリシーを送信するのではなく、そのポリシーに統合してください。
サイトを有効化し、Nginxを検証してから再読み込みしてください。
sudo ln -s /etc/nginx/sites-available/element /etc/nginx/sites-enabled/element
sudo nginx -t
sudo systemctl reload nginx
要素はHTTPS経由で提供される必要があります。DNSがこのサーバーに解決され、ポート80にアクセス可能になったら、お使いのディストリビューションの最新の手順に従ってCertbotをインストールし、Nginxとの統合機能を備えた証明書を要求してインストールしてください。Certbotプロジェクトには、フローと更新チェックに関するドキュメントがあります。パッケージのインストール方法はオペレーティングシステムによって異なるため、お使いのリリースの最新のNginx手順certbot --nginxを使用してください。Certbotがサーバーブロックを編集した場合は、再度実行して更新がスケジュールされていることを確認してください。sudo nginx -t
https://chat.example.comプライベート ブラウザー ウィンドウで開きます。Element のログイン画面がスクリプトやスタイルが欠落することなく読み込まれ、想定どおりのホームサーバーが表示され、ブラウザーのアドレス バーに有効なロック アイコンが表示されているはずです。テスト アカウントでサインインし、ブラウザーがホームサーバーにアクセスできることを確認します。ログインに失敗した場合は、ブラウザーの開発者コンソールとネットワーク パネルで、ブロックされたリクエスト、証明書のエラー、または間違った がないか確認してくださいbase_url。
rootを含むディレクトリを指していることindex.html、およびバンドルとi18nディレクトリがそのディレクトリと一緒にコピーされていることを確認してください。config.json、ファイルがWebルートにあることを確認してください。ドメイン固有のファイルを設定するとconfig.chat.example.com.json、Elementはファイルを先に試行しますconfig.json。ファイルはマージされません。index.html、、、および設定JSONがキャッシュされていないことを確認してください。Nginxポリシーを変更した後は、ブラウザのキャッシュをクリアまたは再検証してくださいversion。i18n正常にデプロイするには、クライアントがHTTPS経由でカスタムドメインにアクセスし、設定が目的のホームサーバーを指し、テストアカウントがネットワークリクエストの失敗なくサインインできる必要があります。ここで説明する静的デプロイとサーバーブロックの動作については、 ElementのWebホスティングに関する注意事項とNginxのインデックスドキュメントを参照してください。
廃止されたプロキシはスキップし、Synapseに組み込まれているスライディング同期を設定してください。クライアント検出機能をチェックした後、互換性のあるスマートフォンでルームリストの読み込みと再接続の動作を測定します。
Element Webを静的サイトとしてデプロイし、Matrixホームサーバーに接続し、HTTPSを追加し、Nginxを設定して古いファイルなしで更新を配信します。
64ビット版Raspberry Pi 4に、永続データ、HTTPSフェデレーション、保護された登録、および動作中のホームサーバーのチェック機能を備えたConduitをセットアップします。
ElementまたはMatrix APIを使用して、権限、Synapse命名規則、およびフェデレーションのチェックを行いながら、ドメイン上の共有しやすいMatrixルームのアドレスを設定できます。
coturnとSynapseを一致するTURN認証情報で設定し、必要なリレーポートを開き、Matrixクライアントがリレー候補を取得できることを確認します。
Docker Compose、PostgreSQL、プライベート設定、およびHTTPS経由で公開する前にチェックを行う機能を備えた、永続的なSynapseホームサーバーをセットアップします。
Element Web デプロイメント用にブランド名、カスタムカラー、ログインアセットを設定すると同時に、どの部分が Element ブランドのままになるかを理解してください。
Synapseがプロセスごとのオープンファイル数の上限に達したかどうかを診断し、適切なサービスまたはワーカーに対してsystemdのドロップインを設定し、実際の制限を確認します。
エラーが特定のブラウザまたは特定のイベントに限定されているかどうかを確認し、残りの暗号化された履歴を危険にさらすことなく、Elementのリカバリキーまたは信頼できるデバイスを使用してください。
Synapseの履歴およびメディア消去APIまたは保持設定を使用して、古いデータを安全に削除し、完了とディスク容量の回復を確認してください。