很多人会根据自己的简历做一个个人网页，我刚好最近也在投简历，就借助 Codex 帮自己完成了一个个人介绍页。
网页做好以后，总不能给 HR 发一个本地路径或者 localhost，还需要部署上线，别人才可以打开链接访问到页面。
因为是首次操作，这个过程我也踩了一些坑。
一开始我用的是 Vercel。Vercel 用 GitHub 登录，导入仓库，填好环境变量，整体过程非常流畅，几乎一气呵成。
但问题是，Vercel 创建出来的 vercel.app 链接在国内环境里不稳定，我甚至自己本人都打不开网页，本来就是为了让别人快速认识我，HR 点开以后一直加载不出来也很尴尬。
后来我启用备用方案，决定试试 Cloudflare Pages。这里我原本的理解是「Cloudflare 有覆盖全球的免费域名」，但更准确地说，Cloudflare Pages 会给项目提供一个免费的 pages.dev 访问地址，并且静态资源会通过 Cloudflare 的网络分发。它不是一个真正属于我的独立域名，但对我这个阶段来说已经够用了。
目前这个网站更像是一个让别人认识我的入口，还没有到必须每年花钱买域名、维护域名、配置备案的程度。所以我还是本着 0 元先跑通流程的原则，决定先用 Cloudflare。
事实证明，有时候免费的代价就是时间。
这里我主要记录两个真正卡住我的点。其它类似 GitHub 连接、Cloudflare Pages 支持文件的更新、项目创建、重新部署这些步骤，AI可以提供帮助或者网上资料很多，跟着提示基本都能解决。市面很多教程默认你已经知道 Pages、Workers、Functions、环境变量这些概念，所以新手操作的时候，反而会在一些小问题上卡住。
第一个点，是 Cloudflare Pages 的入口。
Codex 让我去 Cloudflare Pages 新建项目。我登录 dash.cloudflare.com 以后，在左侧边栏找到了「Workers & Pages」。但 Cloudflare 现在的产品入口有点混在一起了，Pages、Workers都在同一个大分类下面，不熟悉的人很容易点到 Workers 的部署流程里。（Pages的入口算隐蔽了）
Worker / Wrangler 的部署方式不适合我这个从 GitHub 仓库子目录部署静态网页的场景。因为我的项目是在仓库里的 personal-ai-portfolio 子目录，所以需要配置 Root directory。如果走错到 Workers 创建页面，就不会看到我需要的 Root directory 配置项。
进入 Workers & Pages 后，选择 Pages，然后 Connect to Git，连接 GitHub 仓库。连接 GitHub 仓库以后，需要创建 Project name。这个名字通常会影响 Cloudflare 给你的 pages.dev 子域名，比如项目名是什么，最后生成的访问地址大概率也会跟它有关。然后配置 Root directory、Build command、Build output directory，以及 Environment variables。我的网页里有 AI 问答模块，所以还需要配置 DeepSeek API 相关环境变量。
配置完以后，点击 Save and deploy，Cloudflare 就会开始部署。部署完成后，就能拿到一个 pages.dev 链接。
到这里，网页已经能打开了。
但第二个卡点来了，网页打开了，AI 问答死活调不动。
我排查了很久。一边看 Cloudflare 的规则设置，一边翻别人的经验帖，一边问 AI 老师们，最后 Codex 看了截图后，说你这个 Variables and secrets 环境变量填错了！
我当时把模型名当成了变量名填错了：
代码里真正读取的是 DEEPSEEK_API_KEY。也就是说，变量名必须和代码里读取的名字完全一致。那条错误的 deepseek-v4-flash = sk-xxxx 需要删掉，改成以下三条：
Name: DEEPSEEK_API_KEYValue: 你的 DeepSeek Key（sk-开头）
Name: DEEPSEEK_MODELValue: deepseek-v4-flash
Name: DEEPSEEK_BASE_URLValue: https://api.deepseek.com
还有一个细节是，环境变量要配在 Production 环境里。配完以后需要点击 Retry deployment 重新部署一次。否则网页虽然能打开，但 /api/chat 调用还是会返回 500，前端就会 fallback 到我的本地预设回答。
重新部署以后，终于成功了。
当这个网页接了 API、接环境变量、接 GitHub 自动部署以后，它就不再只是一个静态页面，而是一个小小的系统。第一次实现的那一刻真的很快乐。
完成了网页，本地能打开，只能说明它在我电脑上成立。
GitHub 能保存，说明它可以被版本管理。
Cloudflare 部署完，说明它可以被别人访问。
API 能正常调用，说明它开始具备一点互动能力。
这几步连起来以后，我才真正感觉这个个人网页从一个文件变成了一个可以对外交互的信息系统。同时，也是我觉得 AI 和 Codex 对我很重要的地方。它除了帮我写代码，还会在我不知道下一步哪里配置错了、为什么页面能打开但 API 不能用、出问题了该查哪里的时候，帮我把问题一点点解决掉。
