20 · 配置域名、部署并验收正式版本

本页为文字教程；视频与配套媒体仍以实际发布状态为准。

返回课程总览 · 返回模块

本课交付：正式访问地址与发布验收记录

本课将示范工具从开发环境带到正式地址。目标不是得到一个绿色部署标签，而是让不依赖你本机的人完成输入、生成、核对和复制，并在失败时知道如何恢复。发布流程应可追溯，出现问题时能确定运行版本、数据结构和配置来源。

所有操作都应针对你拥有并确认的项目。课堂说明不是对任何未知生产服务的授权；示例域名采用保留示例地址，你需要替换为自己的真实配置，不向课程提交凭据或用户资料。

跟做一：固定发布候选

检查代码差异，明确本次包含什么、暂不包含什么。记录版本、依赖锁文件、构建根目录和启动命令。若项目有多个子应用，确认部署平台读取的是正确目录，不能因为本地命令成功就假定线上构建结构相同。

先完成必要构建与测试，再打包发布。包中不包含本地数据库、调试日志和秘密文件。保留上一个可运行版本与相关配置的识别信息，不要在故障发生后才开始寻找旧代码。构建生成的资源也应与候选版本对应，避免混入旧图片或脚本。

跟做二：核对环境与持久化

列出模型、数据库、存储、会话与公开地址所需变量，只检查名称、用途与是否存在，不显示敏感值。Cloudflare 的秘密配置文档区分敏感值与普通变量。Secrets | Cloudflare Workers 你使用其他平台时也要确认哪些配置会进入浏览器包、哪些仅在服务端读取。

如果本次有数据库迁移，先备份并核对实际状态，只应用本次必要变化。确认用户数据不依赖容器临时文件，应用重启后仍能读取。恢复计划必须区分代码与数据：旧代码能否读取新结构，备份如何恢复，恢复期间怎样处理新任务，这些都不能只写一句“可以回滚”。

跟做三：将域名指向正确服务

在部署平台取得它明确要求的域名目标，再到自己实际管理 DNS 的位置添加或修改记录。Cloudflare 的 DNS 记录文档说明类型、代理状态与 TTL 等设置。Manage DNS records | Cloudflare Docs 本课不提供适合所有平台的万能值；应按实际托管服务要求核对，避免把网上示例地址当作自己的来源。

修改前记录相关旧值，不删除与任务无关的邮件或验证记录。保存后用独立查询确认当前解析方向，再检查 HTTPS 证书与正式地址。域名能解析、证书有效和应用正确响应是不同层级，需要分别证据。存在代理或 CDN 时，还要确认它与源站的配置适配。

跟做四：用全新会话走一遍

先打开正式首页，检查标题、脚本、样式、图片与 API 是否来自预期环境，再提交自创事实完成一次生成。不要用长期登录、缓存丰富的开发浏览器作为唯一证据；另一台设备或独立会话更容易暴露错误地址和旧资源。

检查输入不足、上游失败、复制失败和需要登录的路径。若已经加入账户，验证退出后私有历史不可读；若未加入账户，就确认页面没有承诺不存在的跨设备保存。正式环境的测试要遵守事先范围，不发送真实推广通知，不随意修改用户信息。

跟做五：准备并理解恢复卡

Cloudflare 的回滚文档说明，回滚应用版本不会自动改变连接的资源。Rollbacks | Cloudflare Workers 因此，恢复卡应写明候选版本、旧版本、数据兼容、关键变量和验收路径。如果数据库已经删除字段，代码回退不能凭空恢复数据；如果图片覆盖了同名地址，也可能还要处理缓存与版本。

选择一个可控测试故障演练恢复，不在未知生产路径上试错。恢复后重新完成核心任务并核对状态，不只看控制台显示完成。记录需要人工决定的步骤与谁负责，避免在事故中把重要选择交给临时猜测。

加练：检查一次部署包根目录

将候选包放到独立目录，列出运行所需文件，核对构建命令所看到的相对路径。若 Dockerfile 期待仓库根，却只上传了子应用目录，就应修正发布候选与构建配置的一致性，而不是不断重试上传。不要把本地 node_modules 或秘密文件一起打包作为捷径。

再列出正式版本需要的外部服务及其环境归属：模型、数据库、对象存储和会话配置。测试地址可用但正式生成失败时，先检查这些差别，而不立即重写工具核心。

把这一轮发现写进发布卡，使下一次发布能够重复同样步骤。验收结果要标明候选版本与实际激活版本，避免拿本地新页面截图证明线上仍在运行的旧版本已经修复。

独立作业与阶段验收

提交正式地址、部署识别、环境核对表、备份说明、DNS 与 HTTPS 结果、核心流程与失败路径证据，以及未验证事项。不能把“页面可访问”写成“支付、语言质量和全部设备已经通过”；没有做过的检查明确列出。

最后请未参与开发的人按工具说明完成任务。你观察并记录障碍，必要时回到相关任务卡修复。这个模块的交付是一个能够公开使用并可维护的服务起点，搜索表现、获客与商业验证将在后续模块继续，不能因为上线就提前宣布项目成功。