Matrixのソースを表示

[[Category:Voice over IP]]
[[en:Matrix]]
[https://matrix.org/ Matrix] はオープンなインスタントメッセージや VoIP のための野心的な新しいエコシステムです。サーバー・[https://matrix.org/clients/ クライアント]と、IRC など既存のメッセージソリューションと通信するための[https://matrix.org/bridges/ ブリッジソフトウェア]から構成されています。

Arch Linux の Matrix チャンネルがあります: [https://matrix.to/#/!SEgsRQLScqPxYtucHl:archlinux.org?via=archlinux.org&via=matrix.org&via=privacytools.io #archlinux:archlinux.org]

== インストール ==

サーバーのリファレンス実装である '''Synapse''' は {{Pkg|matrix-synapse}} パッケージで[[インストール]]できます。パッケージをインストールすると ''synapse'' ユーザーが作成されます。

== 設定 ==

インストールしたら、設定ファイルを作成する必要があります。ファイルは ''synapse'' ユーザーから読み込めるように設定してください:
{{bc|<nowiki>
$ cd /var/lib/synapse
$ sudo -u synapse python -m synapse.app.homeserver \
  --server-name my.domain.name \
  --config-path /etc/synapse/homeserver.yaml \
  --generate-config \
  --report-stats=yes
</nowiki>}}

上記のコマンドで、入力したサーバー名の SSL 鍵と自己署名証明書が生成されます。サーバー名を変更した場合は再生成してください。

なお、同一のドメイン名にて Matrix 以外のサービスを動作させないことと、リバースプロキシを設定することが推奨されます。[https://github.com/matrix-org/synapse/#id9 公式ドキュメント Security Note] も参照してください。

== サービス ==

パッケージには {{ic|synapse.service}} という名前の systemd サービスが付属しています。サービスを[[起動]]することで ''synapse'' ユーザーで synapse サーバーが起動し、{{ic|/etc/synapse/homeserver.yaml}} 設定ファイルが使われます。

== ユーザー管理 ==

synapse サーバーには最低でもひとりのユーザーが必要です。以下のようにコマンドでユーザーを作成できます:
{{bc|$ register_new_matrix_user -c /etc/synapse/homeserver.yaml https://localhost:8448}}
もしくは [https://matrix.org/docs/projects/try-matrix-now.html matrix クライアント] を使ってください。

== Spider Webcrawler ==

Webcrawler を有効にするには、サーバーが生成するリンクのプレビューのために、追加パッケージ {{Pkg|python-lxml}} と {{Pkg|python-netaddr}} をインストールする必要があります。その後、設定オプション {{ic|url_preview_enabled: True}} は {{ic|homeserver.yaml}} で設定することができます。synapse サーバが内部ホストに対して任意の GET リクエストを発行しないようにするには、 {{ic|url_preview_ip_range_blacklist:}} を設定する必要があります。

{{Warning|デフォルトはありません! デフォルトでは、synapse サーバはすべての内部ホストをクロールすることができます。}}

コメントアウトしなくてもよい例がいくつかあります。ローカルな IP 範囲をこのリストに追加して、synapse サーバがそれらをクロールしようとするのを防ぎます。{{ic|homeserver.yaml}} を変更した後、サービスを再起動する必要があります。

== 興味深いチャンネル ==

KDE コミュニティには、特定のアプリケーション、言語、イベントなどのための様々なマトリックスルームがあります。詳しくは https://community.kde.org/Matrix をご覧ください。