Firebase Hosting是Google提供的一项静态网站托管服务，部署速度快、自带全球CDN，非常适合托管前端项目、文档站点或落地页。默认情况下，每个项目会得到一个project-id.web.app的免费二级域名，但如果你希望网站使用自己的品牌域名，就需要完成自定义域名的绑定。整个过程涉及域名所有权验证、DNS解析配置和SSL证书签发三个环节，任何一步出问题都会导致域名无法正常访问。本文将完整梳理这套流程，并针对常见报错给出排查思路。
一、绑定自定义域名的整体流程与原理
在动手配置之前，先理解Firebase的域名绑定机制会让后续排错容易很多。当你在Firebase控制台添加一个自定义域名时，Firebase会通过DNS记录来确认你确实拥有这个域名，验证通过后，系统会为你的域名签发一张免费的SSL证书（由Google管理的受信任证书），之后所有流量都会经过Google的全球CDN节点进行分发。
整个流程可以概括为三个阶段。第一阶段是添加域名并选择配置方式：如果你的域名之前没有在Google服务中使用过，Firebase会要求你先完成域名所有权的初步验证，这一步通常需要在DNS中添加一条TXT记录。第二阶段是解析指向配置，Firebase会给出两条A记录（IP地址）或一条CNAME记录，你需要将它们添加到域名服务商的DNS管理后台。第三阶段是SSL证书签发，Firebase会在后台自动申请并部署证书，控制台状态从“等待”变为“已连接”后，域名就可以通过HTTPS正常访问了。
需要注意的是，Firebase Hosting支持顶级域名（如ippipp.com）、子域名（如www.ippipp.com）以及多级子域名。顶级域名和子域名在DNS配置方式上略有差异：顶级域名通常使用A记录直接指向Firebase的IP，而子域名如果本身就是主域名的别名，可以用CNAME记录指向project-id.web.app。两种方式在后面的小节中会分别演示。
二、在Firebase控制台添加自定义域名并配置DNS记录
具体操作从Firebase控制台开始。进入项目后，在左侧菜单选择“Hosting”，点击“添加自定义域名”按钮，输入你想绑定的完整域名，例如www.ipipp.com。如果系统检测到该域名尚未与任何Google账号关联，会提示你验证域名所有权，此时按照页面指引，去域名注册商的DNS管理面板添加一条TXT记录，主机名填写你的域名本身，记录值复制控制台给出的那串字符。TXT记录生效通常需要几分钟到几小时不等，取决于注册商的DNS刷新速度。
验证通过后，Firebase会展示需要配置的DNS记录。对于子域名，一般是两条A记录，指向类似下面的IP地址（实际IP以控制台显示为准）：
A记录 www.ipipp.com 199.36.158.100 A记录 www.ipipp.com 199.36.158.101
如果你的域名服务商支持CNAME方式（且该子域名不是顶级域名），也可以使用CNAME记录：
CNAME记录 www project-id.web.app
添加记录时有几个细节容易出错。第一，主机名字段不需要填写完整域名，多数注册商只需要填子域名前缀（如www），系统会自动补全主域名，具体以注册商的说明为准。第二，TTL值如果可以设置，建议先用较短的时间（如300秒），方便配置出错时快速回滚，确认稳定后再调大。第三，如果该域名之前指向过其他服务器，记得删除或修改旧的A记录和CNAME记录，同一主机名上同时存在A记录和CNAME记录会导致解析冲突。
配置完成后回到Firebase控制台，状态一般会先显示为“等待DNS记录传播”或类似提示。DNS传播是全球性的过程，新记录通常几分钟内生效，极端情况下可能需要48小时。可以使用nslookup或dig命令检查解析是否已经指向Firebase的IP：
# 检查域名的A记录是否生效 nslookup www.ipipp.com # 使用dig查询更详细的信息 dig www.ipipp.com +short
当命令返回的IP地址与Firebase控制台显示的一致时，说明DNS配置已经生效，接下来就只剩SSL证书的签发等待了。
三、SSL证书签发与常见问题排查
DNS生效后，Firebase会自动为域名申请SSL证书。证书签发一般需要几小时，少数情况可能长达一天以上。控制台的“预配状态”会从“等待”变为“已连接管理式SSL证书”，届时访问https://www.ipipp.com就能看到你的站点了。在证书签发完成之前，浏览器访问域名可能提示证书错误，这是正常现象，不必惊慌。
如果SSL状态长时间停留在“等待”，最常见的原因是DNS记录尚未真正生效，或者域名存在与Firebase记录冲突的其他解析。此时建议逐项排查：先用dig命令确认所有必需记录都已返回正确结果；再检查是否残留旧的CNAME或A记录；最后确认没有开启会拦截验证请求的服务（例如某些注册商的域名停放页面、代理加速功能等）。部分国内注册商的DNS服务器在境外验证时可能存在延迟，可以考虑将DNS服务切换到Cloudflare或Google Domains的NS服务器来提升稳定性。
另一个高频问题是域名所有权验证失败。这种情况多出现在域名之前被其他Google账号绑定过的场景，Firebase会提示该域名已被占用。解决办法是使用当前账号在Google Search Console中完成域名验证，或者联系原账号持有人移除该域名的关联。此外，如果你的域名启用了DNSSEC，且记录配置有误，也可能导致验证请求失败，可以在配置期间临时关闭DNSSEC，完成绑定后再重新启用。
还有一点值得提醒：绑定成功后，很多人希望用户访问顶级域名ipipp.com时自动跳转到www.ipipp.com。Firebase Hosting本身支持这个能力，做法是将两个域名都添加到控制台，顶级域名配置A记录，子域名同样配置解析，然后在Hosting设置中将其中一个域名设为主要版本，Firebase会自动处理301重定向。反过来，如果你更喜欢裸域名作为主域名，把方向调换即可。
四、注意事项与最佳实践
最后补充几个实践层面的建议。首先，域名必须是可以修改DNS记录的域名，某些免费域名或锁定状态的域名无法完成配置。其次，Firebase的SSL证书由Google自动续期，无需手动管理，但前提是DNS解析始终指向Firebase，一旦你把解析切走，证书会在一段时间后被回收，再次切回时需要重新签发。第三，Firebase Hosting的免费套餐已包含自定义域名、SSL和CDN流量，中小型站点基本不需要额外付费，只有当月流量超过10GB时才会产生费用，对个人博客和项目官网来说非常宽裕。
如果你同时在网站前面接了Cloudflare之类的CDN或代理服务，要注意代理模式可能干扰SSL证书签发和Firebase的验证流程。建议在绑定阶段将Cloudflare的代理状态设为“仅DNS”，等Firebase证书签发完成后再评估是否开启代理，并确保SSL模式选择“完全（严格）”，避免出现重定向循环或证书不匹配的报错。
总体来说，Firebase Hosting绑定自定义域名的流程虽然环节较多，但每一步都有明确的验证反馈。只要DNS记录准确、无冲突，耐心等待传播和证书签发，绝大多数域名都能顺利上线。遇到问题时，先从DNS解析入手排查，再检查证书状态，按这个顺序定位，基本都能快速找到原因。
Firebase Hosting自定义域名SSL证书修改时间：2026-09-01 18:26:34