render-domains について
Render の Web サービスや静的サイトにカスタムドメインを設定するスキルです。DNS、検証、ワイルドカード、TLS 証明書、Blueprint の宣言方法を扱います。
主な機能
- 01カスタムドメインの設定
- 02DNS レコードの案内
- 03ワイルドカードドメインの設定
- 04検証と証明書のトラブル対応
- 05Blueprint のドメイン宣言
活用シーン
- 01Web サービスへのドメイン追加
- 02apex または www ドメインの設定
- 03TLS 証明書発行エラーの調査
- 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. ダッシュボードでドメインを追加する
- サービスの Settings > Custom Domains に移動します
- + Add Custom Domain をクリックします
- ドメインを入力します(例:
app.example.com) - Save をクリックします
www サブドメインを追加すると、ルートドメインも自動的に追加されます(その逆も同様です)。両者の間にはリダイレクトが設定されます。
2. DNS を設定する
プロバイダーで、Render のサービスを指す DNS レコードを追加します。
| ドメインの種類 | レコードの種類 | 名前 | 値 |
|---|---|---|---|
サブドメイン(app.example.com) | CNAME | app | <service>.onrender.com |
Cloudflare 上の apex(example.com) | CNAME(フラット化) | @ | <service>.onrender.com |
| その他のプロバイダー上の apex | A | @ | 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.com | Let's Encrypt の検証 |
_cf-custom-hostname | <service-id>.hostname.renderdns.com | Cloudflare の 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 サブドメインを無効にできます。
- Settings > Custom Domains > Render Subdomain > 切り替えを Disabled にします
onrender.comの URL へのすべてのリクエストに 404 が返されます- いつでも再度有効にできます
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フィールド