AGENT SKILL

render-domains

在 Render 上配置自定义域名与 TLS 证书——DNS 设置、CNAME 记录、apex 域名、泛域名及证书排障。当用户需要添加自定义域名、配置 DNS、设置 HTTPS/TLS、排查证书签发、停用 onrender.com 子域名,或添加泛域名时使用。触发词:custom domain、DNS、CNAME、TLS、SSL、HTTPS、certificate、apex domain、wildcard domain、onrender.com、domain verification。

License 许可
MIT
最近更新
2026-11-08
Stars
★ 37
Forks
1

01 前言 Front Matter

name
render-domains
license
MIT
metadata
{ "author": "Render", "version": "1.0.0", "category": "networking" }
description
在 Render 上配置自定义域名与 TLS 证书——DNS 设置、CNAME 记录、apex 域名、泛域名及证书排障。当用户需要添加自定义域名、配置 DNS、设置 HTTPS/TLS、排查证书签发、停用 onrender.com 子域名,或添加泛域名时使用。触发词:custom domain、DNS、CNAME、TLS、SSL、HTTPS、certificate、apex domain、wildcard domain、onrender.com、domain verification。
compatibility
Render web services and static sites

02 资源文件 2

03 SKILL.md 正文

Render Custom Domains

Render automatically provisions and renews TLS certificates (via Let's Encrypt and Google Trust Services) for all custom domains. All HTTP traffic is redirected to HTTPS. Custom domains work on web services and static sites only.

When to Use

  • Adding a custom domain to a web service or static site
  • Configuring DNS records (CNAME, A, or ALIAS) with a provider
  • Setting up a wildcard domain (*.example.com)
  • Troubleshooting certificate issuance or domain verification failures
  • Choosing between apex (example.com) and www (www.example.com)
  • Disabling the onrender.com subdomain after adding a custom domain

Domain Limits

Workspace tier Custom domain limit
Hobby 2 custom domains (across all services)
Professional+ Unlimited

Setup Steps

1. Add domain in Dashboard

  1. Go to your service's Settings > Custom Domains
  2. Click + Add Custom Domain
  3. Enter your domain (e.g. app.example.com)
  4. Click Save

Adding a www subdomain automatically adds the root domain (and vice versa) with a redirect between them.

2. Configure DNS

Add a DNS record with your provider pointing to your Render service:

Domain type Record type Name Value
Subdomain (app.example.com) CNAME app <service>.onrender.com
Apex (example.com) on Cloudflare CNAME (flattened) @ <service>.onrender.com
Apex on other providers A @ Use Render-provided IP (see Dashboard)

Important: Remove any AAAA (IPv6) records for your domain. Render uses IPv4, and stale AAAA records cause unexpected behavior.

Provider-specific guides:

3. Verify domain

Click Verify in the Dashboard. If verification fails, DNS may not have propagated yet—wait a few minutes and retry.

Speed up verification by flushing DNS caches:

After verification, Render issues a TLS certificate automatically.

Wildcard Domains

Wildcard domains (*.example.com) route all matching subdomains to one service.

Requires three CNAME records:

Name Value Purpose
* <service>.onrender.com Routes traffic
_acme-challenge <service-id>.verify.renderdns.com Let's Encrypt validation
_cf-custom-hostname <service-id>.hostname.renderdns.com Cloudflare DDoS validation

Cloudflare users: If you add *.example.com without adding the root domain to Render, disable proxying (gray cloud) for the root domain to avoid routing conflicts.

CAA Records

If your domain has CAA records, add entries for Render's certificate authorities:

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"

Without these, TLS certificate issuance fails silently.

Disabling the onrender.com Subdomain

After adding at least one custom domain, you can disable the default onrender.com subdomain:

  1. Settings > Custom Domains > Render Subdomain > toggle to Disabled
  2. All requests to the onrender.com URL receive a 404
  3. Can be re-enabled at any time

Blueprint Configuration

Custom domains are specified in the domains field:

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

Blueprint domains only declare the domain association. You still need to configure DNS with your provider manually.

Common Mistakes

Mistake Fix
AAAA records present Remove all IPv6 AAAA records for the domain
CAA records blocking issuance Add letsencrypt.org and pki.goog entries
Verifying too quickly Wait 2-5 minutes for DNS propagation, then flush caches
Cloudflare proxy + wildcard without root domain Disable proxying (gray cloud) for the root domain
Trying to add domain to a private service Custom domains only work on web services and static sites
502 after verification Routing rules are updating — wait a few minutes

References

Document Contents
references/dns-configuration.md Provider-specific DNS setup, apex domain options, TTL recommendations

Related Skills

  • render-web-services — Web service configuration, TLS, port binding
  • render-static-sites — Static site domains, CDN, headers
  • render-blueprints — domains field in render.yaml

04 同仓库更多 Skills

kael-odin
kael-odin/codex-plugins-zh

android-emulator-qa

Use when validating Android feature flows in an emulator with adb-driven launch, input, UI-tree inspection, screenshots, and logcat capture.

★ 37
kael-odin
kael-odin/codex-plugins-zh

supabase-postgres-best-practices

Postgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations.

★ 37
kael-odin
kael-odin/codex-plugins-zh

sentry

Use when the user asks to inspect Sentry issues or events, summarize recent production errors, or pull basic Sentry health data via the Sentry API; perform read-only queries with the bundled script and require `SENTRY_AUTH_TOKEN`.

★ 37
kael-odin
kael-odin/codex-plugins-zh

render-workflows

搭建、开发、测试和部署 Render Workflows。涵盖首次脚手架搭建(通过 CLI 或手动方式)、SDK 安装(Python 或 TypeScript)、任务模式(重试、子任务、扇出)、本地开发、控制台部署和故障排查。适用于用户首次搭建 Render Workflows、构建工作流服务、添加或修改工作流任务、本地测试工作流或部署到 Render 的场景。

★ 37
kael-odin
kael-odin/codex-plugins-zh

render-web-services

配置 Render web service——端口绑定、TLS、健康检查、自定义域名、自动部署、PR 预览、持久化磁盘及部署生命周期。当用户需要搭建 web service、修复健康检查失败、添加自定义域名、配置零停机部署,或排查端口绑定问题时使用。

★ 37
kael-odin
kael-odin/codex-plugins-zh

render-static-sites

在 Render 全球 CDN 上部署并配置静态站点——构建命令、发布路径、SPA 路由、重定向、自定义 header 及 PR 预览。当用户需要部署静态站点、搭建 React/Vue/Hugo/Gatsby 前端、配置 SPA 回退路由、添加重定向规则、自定义响应 header,或在静态站点与 web service 之间为前端做选择时使用。触发词:static site、CDN、SPA、single-page app、React deploy、Vue deploy、Hugo、Gatsby、Docusaurus、Jekyll、staticPublishPath。

★ 37