カスタムドメイン

独自ドメインでyurucommuを運用するための設定方法です。

重要: ActivityPubではユーザーや投稿のURLにドメインが入ります。運用開始後の変更は、既存のフォローや投稿への参照に影響するため、公開前に決めてください。

最初に確認すること

ブラウザで開くURL、Workerに渡すAPP_URL、ActivityPubが公開するユーザーや投稿のURLは、同じHTTPS originにそろえます。

Takosumiで運用する場合

インストール時に公開URLを指定するか、ホストが割り当てたURLを使います。 PlanでURLを確認してからApplyしてください。Apply後はTakosumiのApps画面に表示されたリンクを開き、/.well-known/social-serverが同じ originを返すことを確認します。

Cloudflareでセルフホストする場合

WorkerのCustom Domainまたはrouteを設定し、同じURLを APP_URLに設定します。ルートのOpenTofuモジュールを使う場合は app_urlとrouteのPlanを確認します。既存のWorkerへ wrangler.jsoncで接続する場合は、routeとSecretを別途用意します。

外部DNSを使う場合

先にホストまたはCloudflareが割り当てた公開先を確認し、DNSプロバイダ側で CNAMEなど必要なレコードを作ります。使うレコードと証明書の設定は公開先によって異なるため、ホストの案内を優先してください。

タイプ: CNAME
名前: yurucommu（サブドメイン部分）
値: ホストが案内した公開先

SSL/TLS設定

公開URLにはHTTPSが必要です。Cloudflareや管理ホストで証明書が有効になってから Yurucommuを公開してください。HTTPのままでは認証、Web Push、 ActivityPubの署名付き通信が正しく動きません。

サブドメインの選択

ActivityPubでの表示名に影響するため、適切なサブドメインを選びましょう：

@[email protected] - ルートドメイン（上級者向け）
@[email protected] - socialサブドメイン
@[email protected] - アプリ名サブドメイン

ドメイン変更時の注意点

警告: ドメインを変更すると以下の問題が発生します：

既存のフォロワーからのフォローが切れる
他サーバーにキャッシュされた投稿のリンクが切れる
ActivityPub上でのアカウントの同一性（identity）が変わる

変更が必要な場合は、バックアップを取り、アカウント移行機能を使えるか確認し、事前に利用者へ告知してください。DNSだけを先に変えず、旧URLからの移行方法と新しいURLの/.well-known応答を確認してから切り替えます。

困ったとき

ブラウザでは開けるがログイン後に戻れない

APP_URLとOIDCのcallback URLが、ブラウザで開いているHTTPS originと一致するか確認します。

ほかのサーバーから見つからない

DNSと証明書に続いて、/.well-known/webfingerと /.well-known/social-serverが新しいoriginから返るか確認します。