このページは英語のページを機械翻訳したものです。内容は英語のページが正です。 英語のページを読む
本番環境のチェックリスト
サーバーをユーザーとほかのサーバーに公開する前と、デプロイを変えたあとに、この一覧を確認してください。 いったん連合したサーバーでは変えられない設定があり、鍵暗号化鍵をなくすといった誤りは まったく元に戻せません。
各項目には、なぜ重要か、どう確認するか、詳しい説明がどこにあるかを書いています。 まず自動の部分から始めます。
my config check # the configuration, and the settings that do not suit productionmy config check -instance # also the instance settings in the databasemy config check が確認すること
Section titled “my config check が確認すること”production プロファイル(profile の既定値)では、my config check は
まずすべての設定を検証し、次に有効な設定が本番のインスタンスに適しているかを確認します。
問題は 2 つのグループに分けて一覧され、プロセスのロケールの言語による要約の下に、それぞれ英語の技術的な詳細が付きます。
- エラーがあると、
my config checkは 1 で終了します。本番のインスタンスを壊すか、そのセキュリティを弱める設定です。- ほかのサーバーから届かない
hostまたはaccount_domain。ポート付きのもの、localhost、ドットのない名前、 ローカル用やテスト用に予約されたトップレベルドメインの下の名前(.localhost、.local、.test、.example、.invalid、.internal、.home.arpa)です。 httpのweb_origin。- データベースをメモリに置く SQLite の
database_url。 - すべてゼロや同じバイトの繰り返しのような、ランダムでない
kek。 - CAPTCHA のサービスが公開しているテスト用の鍵である、
captchaのサイトキーまたはシークレットキー。 - どのジョブの種類も指していない
worker_job_types、worker_job_types_except、またはキューのルート(すべてのプロファイルで。一覧はmy job typesで確認できます)。 -instanceを付けたとき、データベースのプールでは賄えないworker_job_concurrency。
- ほかのサーバーから届かない
- 警告では、終了コードは 0 のままです。開発ではよくあり、本番でも意図的なことがある設定です。
mail = none。- 一時ディレクトリ(
/tmp、/var/tmp、/dev/shm、$TMPDIR)にある SQLite のデータベースまたはfsの blob ストア。 queue = inline。vapid_private_keyがないこと。stream = hubまたはkv = memoryで、roleがall以外であること。これらは 1 つのプロセスの中でしか働きません。- STUN も TURN もない
voice = p2pのような、おそらく意図していない通話の設定。 http://のアドレスにあるプラグイン、またはトークンもクライアント証明書もないhttps://のアドレスにあるプラグイン。- 決済の事業者のテストモードの鍵。
origin_secretを設定したのにtrusted_proxiesが空であることと、交換のあともorigin_secret_previousが設定されたままであること。-instanceを付けたとき: 設定されていないインスタンスのテキストname、short_description、terms、privacy_policyとインスタンスの設定contact_account、contact_email、security_contact、そしてルールのないサーバー。 データベースに接続できないときは、それが警告として 1 つ加わり、残りの確認はそのまま行われます。
my serve は起動時に同じ結果を警告としてログに出しますが、起動はします。
development プロファイルはこれらの確認を省きます。ローカルでの開発とテストに使い、ほかの人が使うインスタンスには決して使わないでください。
my config check は、サーバーと同じ環境(同じ環境変数、シークレットのファイル、設定ファイル)で実行してください。
たとえば、新しいバージョンがトラフィックを受ける前のデプロイの手順の 1 つとして実行します。
あとから変えられない設定
Section titled “あとから変えられない設定”サーバーのドメインとハンドルのドメイン
Section titled “サーバーのドメインとハンドルのドメイン”- 理由:
hostはサーバーのすべての ActivityPub の id の一部で、ほかのサーバーはその id を保存します。account_domainはハンドル(@alice@example.org)のドメインです。データベースを使う最初のmy serveまたはmyのコマンドが 両方をデータベースに記録し、以降、設定が異なるとmy serveとそれらのコマンドは実行を拒否します。 連合したあとに変えると、すべてのフォローと、サーバーの投稿やアカウントへのすべての参照が壊れます。 両方とも最初の起動の前に設定してください。連合する前に見つけた誤りは、 すべての行を消すデータベースの作り直しで直します。 - 決めること: ハンドルにサーバーのドメインを使うか、別のドメインを使うか(たとえば、ハンドルは
example.org、 サーバーはsocial.example.org)。別のハンドルのドメインは、WebFinger、host-meta、NodeInfo をサーバーへ リダイレクトしなければなりません。 - 確認:
my config checkはhostとaccount_domainを表示し、ほかのサーバーから届かないドメインを報告します。my config check -instanceは、それらがデータベースの値と異なるときにも失敗し、何も記録しません。 別のハンドルのドメインでは、curl -sI "https://<account_domain>/.well-known/webfinger?resource=acct:<user>@<account_domain>"がhttps://<host>/.well-known/webfinger?...への301を返します。 - 詳細: サーバーの運用(連合のエンドポイントと、別のドメインからのハンドルの配信)、
hostとaccount_domain。
https で届くこと
Section titled “https で届くこと”- 理由: ほかのサーバーは id を
https://<host>/のポート 443 で取得し、ブラウザーはログインの Cookie をhttpsでだけ送ります。 - 確認: ネットワークの外から
curl -sI https://<host>/health/liveを実行すると、hostに有効な証明書で200が返り、my config checkがweb_origin、tls、tls_acme_agree_terms、tls_cert_fileについてのエラーを報告しないこと。curl -sI http://<host>/はhttps://<host>/への301を返します。サーバーの前にあるリバースプロキシ、ロードバランサー、CDN が TLS を終端してリダイレクトするか (Docker Compose では、レイヤーcompose.caddy.yamlがそうしたプロキシです)、サーバー自身が行います。tls = acmeなら、my tls statusがhost(web_originのホストが異なる場合はそのホストも)の証明書を表示し、その発行者がステージング用でないこと。 つまりtls_acme_directoryが未設定か、本番のディレクトリを指していることです。有効期限と、失敗した発行(order)にはアラートを設定してください (アラート)。tls = filesなら、証明書の残りが 14 日を切るとmy config checkが警告します。 証明書を更新する仕組みは、tls_cert_fileとtls_key_fileを最新に保つ必要があります。 - 詳細: サーバーの運用、サーバーからの HTTPS 配信、
web_origin、tls。
CDN を迂回して届かないこと
Section titled “CDN を迂回して届かないこと”- 理由: 前に CDN があり、サーバー自身のアドレスも公開されたまま(Cloud Run の
*.run.app)だと、誰でも WAF とキャッシュを迂回してサーバーを呼べ、 CDN と同じプラットフォームにいる呼び出し元は、レート制限が見るクライアントの IP を選べてしまいます。必要なのはこの場合だけです。ファイアウォールやプラットフォームがすでに接続できる相手を制限しているときは不要で、 CDN がなければ迂回するものもありません。 - 確認:
origin_secretとorigin_secret_headerが設定され、CDN がすべてのホスト名でそのヘッダーを付けていること。curl -s -o /dev/null -w '%{http_code}\n' https://<origin address>/が403を返し、その/health/liveが200を返し、https://<host>/が200を返すこと。 - 詳細: CDN を通らなかったリクエストを拒否する。全員が締め出されたときの戻し方も説明しています。
シークレット
Section titled “シークレット”鍵暗号化鍵(KEK)
Section titled “鍵暗号化鍵(KEK)”- 理由: KEK は、すべてのアクターの秘密鍵を暗号化します。KEK がなければサーバーは何にも署名できず、鍵をデータベースから 取り戻すこともできません。すべてのアカウントを作り直すことになり、ほかのサーバーはそれを信頼しなくなります。
- 確認:
- ランダムに生成されていること(
openssl rand -base64 32)。my config checkはランダムでない鍵を報告します。 - データベースとそのバックアップ以外の場所、たとえばパスワードマネージャーやクラウドのシークレットストアに保管され、 サーバーを運用するほかの少なくとも 1 人がそれにアクセスできること。
MY_KEKまたはMY_KEK_FILEだけでサーバーに渡されていること(設定ファイルはシークレットを拒否します)。Docker Compose では、 ファイルsecrets/kekで、.envには入っていないこと(Docker Compose のファイル)。
- ランダムに生成されていること(
- 詳細: 鍵の管理。
Web Push の VAPID 鍵
Section titled “Web Push の VAPID 鍵”- 理由: これがないと、サーバーは Web Push の通知を送りません。あとで変えるとすべての購読が終わるので、1 回だけ生成し、 KEK と同じように保管してください。
- 確認:
vapid_private_keyが設定されていないと、my config checkが警告します。my config vapid-keyで生成します。 - 詳細: 鍵の管理(Web Push の VAPID 鍵)。
そのほかのシークレットをリポジトリとイメージに入れない
Section titled “そのほかのシークレットをリポジトリとイメージに入れない”- 理由: リポジトリ、コンテナイメージ、設定ファイルに入ったシークレットは、それらが行くすべての場所に複製されます。
- 確認:
database_url、mail_smtp_password、captcha_secret_key、決済の事業者の鍵、valkey_url、そのほか 設定リファレンスでシークレットとされているすべての設定が、プラットフォームのシークレットストア(Docker や Kubernetes の シークレット、Secret Manager、Parameter Store)が埋める環境変数か<NAME>_FILEのファイルから来ていること。設定ファイルにはこれらを書けず、my config checkはそこにあるシークレットを拒否します。Docker Compose では、自分だけが読める.env(chmod 600)から来ます。リポジトリとイメージを値で検索し、複製が残っていないことを確かめてください。my config checkは、設定されているすべてのシークレットを(redacted)と表示します。 - 詳細: 設定リファレンス(Secret の列)、CAPTCHA、 Stripe、PAY.JP。
インスタンスの設定
Section titled “インスタンスの設定”インスタンスの設定はデータベースにあり、サーバーの動作中に、サーバーの管理画面か
my instance set で変えられます。my config check -instance は、設定されていないテキスト、連絡先、ルールについて警告します。
- 名前、短い説明、説明: ランディングページ、情報ページ(
/about)、リンクのプレビュー、 NodeInfo に表示されます。/aboutで確認してください。 - 連絡先:
contact_account(ユーザーがサーバーについて連絡するアカウント)とcontact_email(ユーザーと ほかのサーバーが連絡するアドレス。サーバーからのメールも、返信をこのアドレスに送ります)。/aboutで確認してください。 - 脆弱性の連絡先:
security_contact。https:またはmailto:の URI です。設定すると、サーバーは/.well-known/security.txtに応答します。curl -s https://<host>/.well-known/security.txtで確認してください。 - 利用規約とプライバシーポリシー:
termsとprivacy_policy。プライバシーポリシーには、CAPTCHA のサービスやメールの事業者など、 個人データを受け取るサービスを書かなければなりません。/aboutと登録の画面のリンクを確認してください。 - サーバーのルール: ユーザーが登録するときに同意し、モデレーターが守らせるものです。
my instance rule createか管理画面で追加し、/aboutで確認してください。 - 登録モード:
registration_modeは、変えるまでapprovalです。人がどう参加するかに合わせて、open、approval、invite、closedから 選びます。mail = noneのときは、openでの登録もモデレーターの承認を待ちます。 - 検索エンジンと AI:
search_indexing、ai_usage、indexable_defaultは、許可するまでどちらも拒否します。/robots.txtと/.well-known/tdmrep.jsonを確認してください。 - ステータスページ:
status_page_url(インスタンスの設定ではなく設定なので、 メンテナンス中もリンクが表示されます)に、サーバーとは別のサービス上のステータスページを設定します。
詳細: インスタンスの設定、登録、 検索エンジンと AI のクローラー、CAPTCHA(プライバシーポリシーに書くこと)、 プライバシーポリシーのひな形、処理活動の記録のひな形、 監視(ステータスページ)。
- 理由: メールでアドレスを確認し、パスワードのリセットと通知を送ります。
mail = noneでは、ユーザーにメールが届きません。 - 確認:
mailがsmtp、ses、pluginのいずれかで、mail_fromが自分の管理するドメインのアドレスであること。my config checkはmail = noneについて警告します。mail_fromのドメインに SPF、DKIM、DMARC のレコードがあり、事業者が DKIM で署名していること。これらがないと、メールは迷惑メールになります。- テスト用のアカウントで登録して確認のメールを受け取り、パスワードのリセットを求めてそのメールも受け取ること。
受け取ったメッセージのヘッダーで、
spf=pass、dkim=pass、dmarc=passを確認してください。 - SES では、アカウントがサンドボックスを出ていて、バウンスと苦情の通知がサーバーに届くこと。
- 詳細: メール、登録(メールアドレスの確認)。
- 理由: 管理者のアカウントは、すべての設定を変え、非公開のデータを読み、誰でも凍結できます。
- 確認:
- すべての管理者が二要素認証をオンにし(Web クライアントの「設定」の「二要素認証」)、 リカバリーコードを保管していること。
- 必要な人だけが
adminロールを持ち、モデレーターはmoderatorか、使う権限だけを持つロールを持っていること。my admin roleで一覧し、管理画面で見直してください。
- 詳細: 管理者とロール、モデレーション(権限とログインの回復)。
- バックアップと復旧: データベース、blob ストア(
blob_fs_dirまたはバケット)、KEK が、定期的に、 サーバーとは別の場所にバックアップされ、新しいサーバーへの復元を予行演習していること。復元したサーバーが起動し、アカウントが ログインして投稿できることを確かめます。一度も復元したことのないバックアップは、使えるかどうか分かりません。データベースとメディアは 一時ディレクトリに置いてはいけません。置いているとmy config checkが警告します。 鍵の管理(KEK のバックアップ)とデータベースを参照してください。 - 監視とアラート: 外部の監視が
/health/liveを確認し、対応できる人にアラートを送ること、そしてジョブキューの dead のジョブを 見張っていること。監視とサーバーの運用(ヘルスチェック、メトリクス、ジョブキュー)を参照してください。 - イメージ: インスタンスが、再起動で変わるイメージではなく、ダイジェストで固定したリリース済みのイメージ(
ghcr.io/mycroblog/my:0.1.0@sha256:...、リリースノートにあります)を実行し、 その来歴を確認していること。latestタグはありません。 アップグレードでは、そのバージョンを意図して変え、アップグレードに従って、マイナーバージョンを 1 つずつ上げます。 - ソースコード(AGPL-3.0): サーバーは、使うすべての人にソースコードを提供しなければなりません。変更していないリリースでは
source_urlを既定値のままにし、フォークや変更したバージョンを運用するときは 自分のソースを指すようにします。/aboutのリンクを確認してください。 サーバーの運用(ソースコードの公開)を参照してください。 - メンテナンス: 必要になる前に、サーバーをメンテナンスモードにする方法を知っておいてください。メンテナンスを参照してください。
- 理由: ほかのサーバーは WebFinger と NodeInfo でアカウントを見つけ、それからアクターを取得します。外からこれらのどれかが失敗すると、 そのサーバーは Fediverse から見えません。
- 確認は、ネットワークの外のマシンから行います。
curl -s "https://<account_domain>/.well-known/webfinger?resource=acct:<user>@<account_domain>"がアカウントを返すこと。 ドメインが異なるときは、hostへのリダイレクトをたどります(curl -L)。curl -s https://<host>/.well-known/nodeinfoが/nodeinfo/2.1にリンクし、そこにソフトウェアとそのソースが書かれていること。curl -s -H 'Accept: application/activity+json' https://<host>/@<user>がアクターの id にリダイレクトし、 その id のアクターがpublicKeyを持つ JSON であること。- Mastodon やほかのサーバーのアカウントから
@<user>@<account_domain>を検索してフォローし、新しい投稿が届くのを確かめること。 - サーバーの前にある CDN が、
Vary: Acceptに従わないかぎり/ap/*と/@*をキャッシュしないこと。
- 詳細: サーバーの運用(連合のエンドポイント)、CDN、リレー。
LLM とコーディングエージェント向け:llms.txt,llms-full.txt, llms-small.txt