返回探索
指南VibeFix 内容整理更新于 2026年11月11日

别让你的域名在上线当天掉链子:vibe 项目的自定义域名与 SSL 实战

域名出事不是某个功能出 bug,是整站失联。这篇讲域名接上线的全程:解析三件套、根域名难题与四种解法、证书三种验证方式,以及 6 步 75 分钟走到全站 HTTPS。

数据中心机房里一排排黑色服务器机柜,指示灯闪烁

先划界,免得你读错篇:站内已经有《多租户隔离架构实战》,那篇讲的是一个平台怎么给很多租户分域名、怎么做路由取舍;也有部署上线的指南,讲的是代码怎么发布。这篇只讲中间被跳过的那一段——你自己的域名怎么接上线、证书怎么不出事。一个判断先摆出来:域名和证书是 vibe 项目里最“不写代码、却最能炸”的一环。AI 可以一夜帮你写完整个产品,但它不会帮你点开 DNS 面板,也不会在证书过期那天早上叫醒你。域名出事不像 bug 那样只影响一个功能,它是整站失联,用户看到的是浏览器红字警告,连你的报错页都看不到。

数据中心机房里一排排黑色服务器机柜,指示灯闪烁

买域名之前先想好的 4 件事

很多人买域名是凭感觉:看一眼顺眼就付款。域名这东西,买错了改名成本极高——所有外链、搜索引擎收录、用户口碑都要重来。付款之前先过 4 件事:

第一,念得出来、打得出来。好域名的标准不是酷,是“电话里报一遍对方能拼对”。去掉连字符和数字,越短越好,超过 15 个字符就要三思。念三遍,拼三遍,拼不对就换。你的域名会在播客、视频、线下场合被口头传播,拼写成本就是获客成本。

第二,看续费价,不看首年价。很多注册商首年 1 美元、续费 30 美元,等你发现时已经用了两年、换不起了。买之前先把续费价查清楚,乘以 5 年,算算总账。还有一个坑:所谓“溢价域名”,首年价可能就是几千美元,付款页面的小字要逐行读。

第三,隐私保护默认开。域名注册信息默认是公开的,不开隐私保护,你的姓名、邮箱、电话全挂在 WHOIS 上,垃圾邮件和推销电话当天就到。现在大多数注册商免费送隐私保护,买的时候确认它开着,别等到被骚扰了再去找开关。

第四,后缀别贪小众。.com 拿不到就退到 .dev、.app、.io,再退到国别后缀。别为了一个“酷”后缀选用户记不住、邮箱系统不认的冷门后缀。还有一个硬性提醒:.dev 和 .app 是强制 HTTPS 的后缀——证书没配好之前,网站连 HTTP 都打不开,别在调试阶段被这个坑绊住。

域名解析三件套:A、CNAME、TXT 各干什么

先讲一个虚构示例。下面提到的产品“潮汐日记”、开发者“小满”和域名 chaoxi.example 都是虚构的,数字也是为了讲清楚问题编的例子,不是真实项目的数据。小满的产品在平台给的二级域名上跑得好好的,上线前一天决定换成自己的域名,结果折腾了 6 个小时还没通——不是因为他笨,而是因为他把三件套的用途搞混了。先把三件套一次讲清:

记录类型干什么值长什么样改错了会怎样
A / AAAA把域名直接指向一台服务器的 IP 地址一个 IPv4 或 IPv6 地址,如 203.0.113.10网站打不开,或打开的是别人的服务器
CNAME把域名指向另一个域名,让对方决定最终 IP另一个域名,如 cname.vercel-dns.com解析死循环,或指向一个不存在的主机名
TXT贴一张“纸条”在域名上,供别人验证任意文本,如证书验证用的随机字符串证书签不下来,或邮件被判为垃圾邮件

三件套的分工一句话:A 记录是“地址”,CNAME 是“转发”,TXT 是“纸条”。小满当天的第一个错,就是把托管平台要求填的 CNAME 值填进了 A 记录——平台给的是一个域名,他填进了一个只认 IP 地址的格子,解析当然不通。第二个错是 TTL 设成了 86400 秒(24 小时):改错一次,要等一整天才能生效下一次修改。给新手的铁律是:动手之前先把 TTL 改成 300 秒(5 分钟),全部调通之后再改回 3600 秒。5 分钟的 TTL 意味着你每次改错,最多 5 分钟就能重来。

还有一个容易忽略的点:DNS 记录是分“主机记录”的。@ 代表根域名本身(chaoxi.example),www 代表 www.chaoxi.example,app 代表 app.chaoxi.example。很多人只配了 www,忘了配 @,结果用户直接输入根域名就打不开;或者反过来。正确的做法是:根域名和 www 两个都要配,并且其中一个 301 跳转到另一个,全站只留一个规范地址。搜索引擎和用户书签都会感谢你。

根域名难题:为什么 apex 不能直接写 CNAME

这是 DNS 里最反直觉的一条规则,也是新手最容易卡住的地方:根域名(apex,也就是不带任何前缀的 chaoxi.example)不能直接配 CNAME。不是托管平台为难你,是 DNS 协议本身的规定——根域名上必须有 SOA 和 NS 记录,而 CNAME 规定“一个名字配了 CNAME 就不能再配别的记录”,两者直接冲突。所以你想把根域名指向托管平台,有四种解法,各有利弊:

  • 解法一:A 记录指向固定 IP。最直接,但要求托管平台给你一个固定 IP。很多现代托管平台(Vercel、Netlify、Cloudflare Pages)用的是随时会变的边缘 IP,不给你固定地址,这条路就走不通。
  • 解法二:ALIAS / ANAME 记录。少数 DNS 服务商提供的“类 CNAME”记录,表面上写在根域名上,背后自动帮你解析成 IP。这是根域名场景下的首选,但前提是你的 DNS 服务商支持——Cloudflare、DNSPod、Route 53 都支持,名字各不相同,找一下你家服务商的文档。
  • 解法三:CNAME flattening(扁平化)。Cloudflare 的叫法:你在根域名上写 CNAME,它在边缘节点上实时解析成 A 记录返回。效果跟解法二一样,只是名字不同。如果你已经在用 Cloudflare,这就是零成本的答案。
  • 解法四:根域名 301 跳转到 www。根域名本身只放一个跳转服务(很多 DNS 服务商免费提供“URL 转发”),所有访问根域名的请求都 301 跳到 www.chaoxi.example,真正的内容只挂在 www 上。这是最“土”但最稳的办法,适合不想换 DNS 服务商的人。

选哪个的判断标准就一条:你的 DNS 服务商支持什么,就用什么,别为了用某个解法而搬家。搬家本身又是一次解析中断,收益抵不过风险。只有一个例外:如果你现在的 DNS 服务商既不支持 ALIAS、又不提供 URL 转发,那它确实该换了——这属于基础设施欠账,早换早省心。

子域名怎么分工:一张表定下来

主域名接通之后,下一个问题是子域名怎么分。很多 vibe 项目是想到一个开一个,半年后 api2.chaoxi.example、newapp.chaoxi.example 满天飞,自己都记不住哪个在用。第一次接域名时就把分工定下来,写进文档,以后只按表开新子域名:

子域名用途备注
根域名 / www产品主站二选一做规范地址,另一个 301 跳转
app登录后的应用本体与营销页分开,方便以后独立部署
api对外 API跨域策略、CORS 只在这里配,别配在主站
docs文档站可以挂在别的托管平台上,解析独立
status状态页主站挂了时它还得能打开,最好放不同服务商

这张表还有一个好处:通配符证书的决策就有了依据。如果你现在只用主站和 app 两个名字,两张单域名证书够了;等你要开到第 4 个子域名时,再换通配符证书也不迟。子域名的数量决定证书的形态,而不是反过来。另外提醒一句:status 状态页单独放不同服务商不是洁癖——主站宕机那天,用户唯一能看到的“我们正在修”的页面就是它,跟主站放一起等于没有状态页。

证书三种验证方式:选错了就签不下来

域名通了,下一步是证书。浏览器地址栏那把小锁,背后是一张 TLS 证书,而证书颁发之前,颁发机构要先验证“这个域名真是你的”。验证方式有三种,选错了,证书能卡你一整天:

验证方式怎么验证适合谁短板
HTTP-01在网站根目录放一个指定文件,颁发机构来取网站已经能通过 HTTP 访问,最常用网站还没上线、或有跳转时容易失败
DNS-01在 DNS 里加一条 TXT 记录,颁发机构来查要签通配符证书(*.chaoxi.example),或网站还没上线要等 DNS 传播,慢,还容易贴错记录
TLS-ALPN-01在 TLS 握手里回答一个特殊质询443 端口已被占用、HTTP 方式走不通时大多数托管平台不支持,自己搭才用得上

给一人团队的建议很直接:能用托管平台的自动证书就用自动证书,别自己签。Vercel、Netlify、Cloudflare Pages、Fly.io 这些平台,你把域名指过去,它们自动签发、自动续期,全程不用你碰。自己签证书(比如用 certbot 跑 Let's Encrypt)只有一种情况值得:你的服务不在这些平台上,比如一台自己维护的 VPS。Let's Encrypt 的证书有效期只有 90 天,意味着一年要续 4 次,续期脚本挂一次,网站就挂一次——这个账要先算清。

还有一个判断:通配符证书(*.chaoxi.example)只有一种验证方式,就是 DNS-01。如果你打算以后开 app.chaoxi.example、api.chaoxi.example、docs.chaoxi.example 一堆子域名,一张通配符证书全包,比每个子域名各签一张省事得多。但代价是每次续期都要改 TXT 记录——除非你的 DNS 服务商支持 API 自动改,否则别贪这个方便。

一张图看懂:从买域名到全站 HTTPS 的 6 步 75 分钟

把上面的内容串成一条时间线,虚构示例“潮汐日记”第一次接域名时,6 个步骤加起来是 75 分钟。这个数字不是行业标准,是按下面这张表的预算加出来的——你照着走,留出这个时间,就不会在上线当天手忙脚乱:

从买域名到全站 HTTPS:6 步 75 分钟

步骤做什么预算(分钟)
1买域名、选好 DNS 服务商5
2配 DNS 记录(A/CNAME + www 跳转)10
3等 DNS 传播(TTL 设 300 秒的前提下)30
4签发证书(托管平台自动签发)5
5配 www 与根域名的 301 跳转10
6验证全链路(见下一节的 4 条命令)15
合计6 步75

这张表里最值得注意的是第 3 步:等 DNS 传播的 30 分钟是全程最长的一步,而且你什么都干不了,只能等。所以正确的工作流是:先把 TTL 改成 300 秒,配好记录,然后去干别的事——写更新日志、回用户邮件——30 分钟后再回来验证。盯着终端反复 ping 除了焦虑什么也得不到。反过来,如果 30 分钟后还不通,别继续等,先查下面两节:大概率是记录配错了位置,或者证书验证方式选错了。

续期失败的 5 个常见原因:证书过期前先自查

证书不会突然过期,它会提前 30 天就开始发警告邮件,提前 7 天再发一次。真正让证书过期的人,都是把警告邮件当成垃圾邮件的人。但就算你按时看到了警告,续期也可能失败,5 个常见原因按出现频率排序:

  1. DNS 记录被改动过。有人动过 A 记录或 CNAME,HTTP-01 验证去取文件时走到了错误的服务器。续期前先确认解析没变过。
  2. HTTP 跳转写死了。全站强制 HTTPS 跳转没问题,但如果把 /.well-known/ 路径也跳走了,验证机构取不到文件。解决办法是:验证路径永远不跳转。
  3. DNS-01 的 TXT 记录被删了。上次手动贴的 TXT 记录,有人当成垃圾清理掉了。续期是重新验证,不是“沿用上次的结果”,记录必须一直在。
  4. API 密钥过期了。用 DNS 服务商 API 自动改 TXT 记录的,密钥过期就等于续期断了。密钥有效期写进你的日历,跟证书有效期放一起提醒。
  5. 服务器时间错了。服务器时间偏差超过 5 分钟,证书验证会直接失败。这是最容易被忽略的一条:先对时,再谈别的。

防住这 5 条只需要两个习惯:第一,证书到期前 30 天的日历提醒,雷打不动;第二,每年手动跑一次续期流程,别等到它自动失败那天才发现脚本早坏了。自动续期最大的敌人不是技术,是“我以为它在自动跑”。

证书链与混合内容:小锁变灰的两个原因

证书签下来了,浏览器小锁却还是灰的、或者带个感叹号,别急着怪证书,两个原因各占一半。第一是证书链不完整:证书分三级——根证书、中间证书、你的证书,浏览器只认“链条完整”的一套。有些服务器只配了自己的证书,没配中间证书,桌面端浏览器因为缓存过中间证书还能打开,手机端和新装的浏览器直接报红字。验证办法就是上一节那条 openssl s_client 命令,看它能不能从头到尾把链走完;修法是把中间证书拼进同一个文件,具体拼法看你家托管平台的文档,别自己猜顺序。

第二是混合内容:页面本身是 HTTPS,但里面嵌了一张 HTTP 的图片、一个 HTTP 的脚本。浏览器不会为此整站报错,但小锁会变灰,控制台会刷警告。AI 生成的页面最容易带这个毛病——它随手写个 http:// 开头的图片地址,你不检查就上线。修法也简单:全站资源一律用相对路径或 https://,上线前用浏览器控制台扫一遍混合内容警告,一个都不留。

迁移不掉流量:换域名与换托管的 301 六步

总有一天你要换域名,或者换托管平台。迁移最怕的不是技术,是流量:旧链接散落在搜索引擎、用户书签、别人的文章里,断了就回不来。301 永久重定向就是干这个的,六步走完,流量基本不掉:

  1. 先在新地方把网站跑通。用临时域名或 hosts 文件验证新站完全正常,再动 DNS。DNS 一动就没有回头路。
  2. 旧站全站配 301。每一条旧 URL 都要 301 到对应的新 URL,不是全跳到首页。全跳首页等于告诉搜索引擎“旧内容没了”,权重直接清零。
  3. DNS 的 TTL 提前一天改成 300 秒。迁移前 24 小时就改好,别等到当天。TTL 是“旧记录在各地缓存里还要活多久”,当天改已经晚了。
  4. 切 DNS,盯着日志看。切完之后看新站的访问日志:旧域名的请求是不是都带着 301 过来了,有没有 404。有 404,说明某条旧 URL 没配好映射。
  5. 旧域名至少续费保留一年。别迁移完就把旧域名扔了。旧链接的有效期按年算,域名一过期,所有外链瞬间全断。
  6. 搜索引擎里提交地址变更。Google Search Console 和 Bing Webmaster Tools 都有“地址变更”工具,提交一次,收录迁移能快几周。

这里有个反直觉的判断:迁移当天最危险的不是 DNS,而是你以为配好了、其实没配好的那几条冷门 URL。首页、登录页这种热门 URL 人人都会检查,真正掉链子的是三年前那篇博客的内链、某个用户收藏夹里的深链接。所以第 4 步要盯的不是首页通没通,而是 404 日志里有没有新增的旧 URL。

故障排查:4 条命令定位 90% 的问题

域名不通的时候,别凭感觉猜,4 条命令按顺序跑,90% 的问题 5 分钟内定位:

dig chaoxi.example +short        # 查解析:返回的 IP 对不对
dig www.chaoxi.example +short    # 查 www 的解析,别只查根域名
curl -I https://chaoxi.example   # 查 HTTPS:状态码、跳转链、有没有证书报错
openssl s_client -connect chaoxi.example:443 -servername chaoxi.example | openssl x509 -noout -dates  # 查证书:签给谁、哪天过期

读结果有个顺序:dig 没返回或返回了错的 IP,是 DNS 的问题,回去检查记录;dig 对了但 curl 报错,是证书或服务器的问题;curl 通了但浏览器报红字,是证书链不完整或域名不匹配——最常见的是证书只签了 www.chaoxi.example,没签根域名。还有一个新手常踩的坑:dig 查的是你本地 DNS 缓存的结果,不代表全世界都这么看。怀疑是缓存问题时,换个公共 DNS 查一遍,比如 dig @8.8.8.8 chaoxi.example,对比结果。

最后补一个 2026 年的现实:越来越多的用户在手机上打开你的网站,而手机浏览器对证书问题比桌面端更不宽容——桌面端还能点“高级、继续前往”,手机端很多情况下连这个入口都藏得很深。所以“证书有点小问题但大部分用户能打开”是不存在的:证书有问题,就是全站失联。上线前把上面 4 条命令跑一遍,写进你的上线检查清单,比事后道歉便宜得多。

10 项上线检查清单

照着抄,跑完再官宣上线:

  1. 根域名和 www 两个都配了,其中一个 301 跳转到另一个,全站只留一个规范地址。
  2. 动手前 TTL 已改成 300 秒,调通后再改回 3600 秒。
  3. A 记录填的是 IP 地址,CNAME 填的是域名,两者没填反。
  4. 根域名没直接配 CNAME,用的是 ALIAS、扁平化或 301 跳转四种解法之一。
  5. 证书已签发且覆盖根域名与 www 两个名字,浏览器小锁正常。
  6. 通配符证书走的是 DNS-01 验证,TXT 记录还在,没被人清理掉。
  7. 证书到期前 30 天的日历提醒已建,自动续期每年手动跑一次验证。
  8. /.well-known/ 验证路径不参与全站 HTTPS 强制跳转。
  9. dig、curl、openssl 三条命令跑过,全链路验证通过。
  10. 旧域名(如果有迁移)至少续费保留一年,搜索引擎里已提交地址变更。

最后再说一遍核心判断:域名和证书这件事,技术含量不高,但容错率极低。代码写错了可以热修复、可以回滚,域名配错了,全世界要等 DNS 传播;证书过期了,连道歉信都发不出去——因为你的网站已经打不开了。所以别把它当成“上线前顺手做的事”,把它当成上线本身:6 步 75 分钟,跑完清单再官宣,这 75 分钟是你花过最值的上线时间。

阅读 5评论 0

评论 (0)

ME
0/1000
评论加载中...
浏览项目广场发布你的项目

相关文章

Amp 新的线程编辑器截图:运行位置选择器里出现 Boxes,工作区 acme/workbench 下挂着 bug-tracker、tiny-crm、team-wiki 与 incident-database 四个应用
资讯
18 美元一个月,给智能体造的软件安个家:Amp 的 Boxes 是在补最后一块拼图

2026 年 11 月 10 日,Amp 推出 Boxes:每月 18 美元起的常开小电脑,专门部署你用智能体造出来的软件。每个 box 自带 runner,智能体能直接在上面改生产数据;同一周 Amp 还上线了 Spaces、告别了 Dial、登陆了 Windows——智能体的工作场,正在从笔记本搬到云端。

开发工作流产品发布部署上线
真实照片:一排浅灰色金属档案柜,其中一个抽屉拉开,露出里面一排排悬挂的文件夹
指南
浏览器里也能用数据库:IndexedDB 本地存取实战指南

localStorage 只能存字符串、没有索引。IndexedDB 是浏览器里真正的数据库:能存结构化数据、容量大得多、能建索引、能用事务。本文按 MDN 的《Using IndexedDB》《IDBDatabase》《IDBObjectStore》三篇官方文档讲清楚:五步套路、开库、升级、主键、索引、事务、add 与 put、get、游标、范围与多标签页升级。

工具技巧数据工作流前端工程
真实照片:一双手在 MacBook Pro 上打字,屏幕显示改写 HTML 内容的 JavaScript 代码,白色桌面上有白色鼠标、纸张和文件夹
指南
别让函数把你绕晕:JavaScript 函数、参数与箭头函数实战指南

函数你每天都在调,这篇把你一直在做的事讲清楚。本文按 MDN 的《Functions》《Arrow function expressions》《Rest parameters》三篇官方文档讲清楚:声明与表达式、参数与实参、默认值、剩余参数、展开语法、返回值、箭头函数省写规则、this 的坑、回调与高阶函数、作用域。

工具技巧前端工程AI 编程实践