mcpField
R
render-domains

render-domains

github.com/render-ossクラウド・DevOps90364 回インストール今日更新
リポジトリ

render-domains について

Render の Web サービスや静的サイトにカスタムドメインを設定するスキルです。DNS、検証、ワイルドカード、TLS 証明書、Blueprint の宣言方法を扱います。

主な機能

  1. 01カスタムドメインの設定
  2. 02DNS レコードの案内
  3. 03ワイルドカードドメインの設定
  4. 04検証と証明書のトラブル対応
  5. 05Blueprint のドメイン宣言

活用シーン

  1. 01Web サービスへのドメイン追加
  2. 02apex または www ドメインの設定
  3. 03TLS 証明書発行エラーの調査
  4. 04静的サイトのワイルドカード設定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/render-oss/skills --skill render-domains

インストール後、Claude Code で/render-domainsを入力して読み込まれたか確認します。

同梱ファイルreferences/dns-configuration.md

詳細

Render カスタムドメイン

Render は、すべてのカスタムドメインに対して TLS 証明書(Let's Encrypt および Google Trust Services 経由)を自動的にプロビジョニングし、更新します。すべての HTTP トラフィックは HTTPS にリダイレクトされます。カスタムドメインはウェブサービスと静的サイトでのみ使用できます。

使用する場面

  • ウェブサービスまたは静的サイトにカスタムドメインを追加する場合
  • プロバイダーでDNS レコード(CNAME、A、または ALIAS)を設定する場合
  • ワイルドカードドメイン(*.example.com)を設定する場合
  • 証明書の発行またはドメインの検証に失敗した場合のトラブルシューティング
  • apex(example.com)と www(www.example.com)のどちらを選ぶか検討する場合
  • カスタムドメインの追加後に onrender.com サブドメインを無効にする場合

ドメインの上限と料金

ワークスペースのプランには、カスタムドメインの利用上限が含まれています。含まれる上限を超えてドメインを追加すると、追加料金が発生します。現在の上限と料金は、Render の料金またはダッシュボードでご確認ください。

設定手順

1. ダッシュボードでドメインを追加する
  1. サービスの Settings > Custom Domains に移動します
  2. + Add Custom Domain をクリックします
  3. ドメインを入力します(例:app.example.com)
  4. Save をクリックします

www サブドメインを追加すると、ルートドメインも自動的に追加されます(その逆も同様です)。両者の間にはリダイレクトが設定されます。

2. DNS を設定する

プロバイダーで、Render のサービスを指す DNS レコードを追加します。

ドメインの種類レコードの種類名前値
サブドメイン(app.example.com)CNAMEapp<service>.onrender.com
Cloudflare 上の apex(example.com)CNAME(フラット化)@<service>.onrender.com
その他のプロバイダー上の apexA@Render が提供する IP(ダッシュボードを参照)

重要: ドメインの AAAA(IPv6)レコードをすべて削除してください。Render は IPv4 を使用するため、古い AAAA レコードがあると予期しない動作が発生します。

プロバイダー別のガイド:

3. ドメインを検証する

ダッシュボードで Verify をクリックします。検証に失敗した場合は、DNS の変更がまだ反映されていない可能性があります。数分待ってから再試行してください。

DNS キャッシュを消去すると、検証を早められます。

検証が完了すると、Render が TLS 証明書を自動的に発行します。

ワイルドカードドメイン

ワイルドカードドメイン(*.example.com)を使うと、一致するすべてのサブドメインを1つのサービスにルーティングできます。

3つの CNAME レコードが必要です。

名前値用途
*<service>.onrender.comトラフィックをルーティングします
_acme-challenge<service-id>.verify.renderdns.comLet's Encrypt の検証
_cf-custom-hostname<service-id>.hostname.renderdns.comCloudflare の DDoS 検証

Cloudflare ユーザーの場合: Render にルートドメインを追加せずに *.example.com を追加する場合は、ルーティングの競合を避けるため、ルートドメインのプロキシを無効(グレーの雲)にしてください。

CAA レコード

ドメインに CAA レコードがある場合は、Render の証明書認証局用のエントリーを追加してください。

example.com IN CAA 0 issue "letsencrypt.org"
example.com IN CAA 0 issuewild "letsencrypt.org"
example.com IN CAA 0 issue "pki.goog; cansignhttpexchanges=yes"
example.com IN CAA 0 issuewild "pki.goog; cansignhttpexchanges=yes"

これらが設定されていないと、TLS 証明書の発行はエラーが表示されないまま失敗します。

onrender.com サブドメインを無効にする

カスタムドメインを1つ以上追加すると、デフォルトの onrender.com サブドメインを無効にできます。

  1. Settings > Custom Domains > Render Subdomain > 切り替えを Disabled にします
  2. onrender.com の URL へのすべてのリクエストに 404 が返されます
  3. いつでも再度有効にできます

Blueprint の設定

カスタムドメインは domains フィールドで指定します。

services:
  - type: web
    name: api
    runtime: node
    plan: starter
    domains:
      - app.example.com
      - www.example.com

Blueprint の domains は、ドメインとの関連付けを宣言するだけです。プロバイダーでの DNS 設定は、引き続き手動で行う必要があります。

よくある間違い

間違い修正方法
AAAA レコードが存在するドメインの IPv6 AAAA レコードをすべて削除します
CAA レコードが発行を妨げているletsencrypt.org と pki.goog のエントリを追加します
確認を急ぎすぎているDNS の伝播を待つため 2-5 分待ってから、キャッシュをフラッシュします
Cloudflare プロキシを有効にした状態で、ルートドメインなしのワイルドカードを使用しているルートドメインのプロキシを無効にします(グレーの雲)
プライベートサービスにドメインを追加しようとしているカスタムドメインは Web サービスと静的サイトでのみ使用できます
確認後に 502 が発生するルーティングルールを更新中です。数分お待ちください

参考資料

ドキュメント内容
references/dns-configuration.mdプロバイダー別の DNS 設定、apex ドメインの選択肢、TTL の推奨事項

関連スキル

  • render-web-services — Web サービスの設定、TLS、ポートのバインド
  • render-static-sites — 静的サイトのドメイン、CDN、ヘッダー
  • render-blueprints — render.yaml の domains フィールド

コメント