Commit.
Push.
Deploy.

开始前需要

1. 一个 GitHub 账号。
2. 一个 Cloudflare 账号。
3. 已经加入 Cloudflare 管理的域名。
4. Mac 上安装好的 Git。
5. 网站根目录内存在 index.html。

检查 Git 是否安装

git --version

能看到类似 git version 2.50.1 的结果，说明 Git 已安装。

进入网站目录

cd "/Users/sieh/Desktop/Server/个人网站"
pwd

预期输出 /Users/sieh/Desktop/Server/个人网站。

确认首页存在

ls index.html

仓库根目录必须存在 index.html，Cloudflare Pages 发布的就是这个根目录。

获取 GitHub 隐私邮箱

Git 的每次提交都需要记录作者姓名和邮箱。打开 github.com/settings/emails，启用 Keep my email addresses private，GitHub 会提供类似 数字+用户名@users.noreply.github.com 的隐私邮箱。

请将下面命令中的 YOUR_GITHUB_NOREPLY_EMAIL 替换为你在 GitHub 邮箱设置页面看到的隐私邮箱。使用隐私邮箱可以避免真实邮箱直接出现在公开的 Git 提交记录中。

设置用户名和邮箱

git config --global user.name "ziyue-97"
git config --global user.email "YOUR_GITHUB_NOREPLY_EMAIL"

git config --global user.name
git config --global user.email

验证时应分别输出你的 GitHub 用户名和隐私邮箱地址。

创建 .gitignore

macOS 经常自动生成 .DS_Store，它不属于网站内容，不应上传。

cd "/Users/sieh/Desktop/Server/个人网站"
printf ".DS_Store\n" > .gitignore

初始化仓库

git init -b main

• git init：让当前目录成为 Git 仓库。
• -b main：将默认主分支命名为 main。

加入文件并检查

git add .
git status

git add 只是在本地标记需要记录的文件，不会上传到网络。正确状态通常包含 On branch main、No commits yet、Changes to be committed:。

• index.html、CSS、JavaScript、图片和 .gitignore 在列表中。
• .DS_Store 不在列表中。
• 没有密码、私钥、访问令牌或个人配置文件。

创建第一次提交

git commit -m "Initial website"
git log --oneline
git status

本次首次提交为 fb1bde6 Initial website。干净的工作区应显示 nothing to commit, working tree clean。

创建 ED25519 密钥

GitHub 已不支持使用账户密码进行 Git 推送，可以使用 SSH 密钥进行安全认证。先检查是否已有密钥：

ls -la ~/.ssh

常见密钥文件是 id_ed25519 和 id_ed25519.pub。如果不存在，则创建新密钥：

ssh-keygen -t ed25519 -C "YOUR_GITHUB_NOREPLY_EMAIL"

出现 Enter file in which to save the key 时直接按回车，使用默认位置。接下来可以设置密钥密码，输入时终端不会显示字符，这是正常现象。

两个密钥文件的分工

• ~/.ssh/id_ed25519：私钥，绝对不能发送、公开或上传。
• ~/.ssh/id_ed25519.pub：公钥，可以添加到 GitHub。

如果不慎把密钥生成到了网站目录，应立即将它移出网站目录，并确认它从未被 Git 提交。

添加公钥到 GitHub

pbcopy < ~/.ssh/id_ed25519.pub

打开 github.com/settings/keys，点击 New SSH key：

测试 SSH 连接

ssh -T git@github.com

第一次连接可能提示 Are you sure you want to continue connecting (yes/no/[fingerprint])?，输入 yes。

成功结果为 Hi ziyue-97! You've successfully authenticated, but GitHub does not provide shell access.

最后一句“不提供 shell access”不是错误，它表示身份认证已经成功，但 GitHub 不提供普通服务器终端。

添加远程仓库

cd "/Users/rda/Desktop/Server/personal-web"
git remote add origin git@github.com:ziyue-97/personal-website.git

origin 是远程仓库的常用别名。

检查远程地址

git remote -v

预期输出两行，分别是 origin git@github.com:ziyue-97/personal-website.git (fetch) 和 (push)。

创建 Pages 项目

登录 Cloudflare Dashboard，进入 Workers & Pages，点击 Create application。

正确入口位于创建页面底部的 Looking to deploy Pages? Get started，点击其中的 Get started，进入 Cloudflare Pages 后选择 GitHub。

授权 Cloudflare 访问 GitHub

1. 在 Pages 的仓库选择页面选择 GitHub。
2. GitHub account 选择 ziyue-97。
3. 如果尚未授权，安装 Cloudflare Pages GitHub App。
4. Repository access 建议选择 Only select repositories。
5. 仅选择 personal-website。
6. 返回 Cloudflare，选择 personal-website。
7. 点击 Begin setup。

Cloudflare 看不到仓库时

1. 打开 github.com/settings/installations。
2. 找到 Cloudflare Pages，点击 Configure。
3. 在 Repository access 中加入 personal-website。
4. 保存后回 Cloudflare 刷新。

绑定 www.ziyuedesign.com

进入 Workers & Pages → personal-website → Custom domains → Set up a domain，输入 www.ziyuedesign.com。

Cloudflare 会显示 DNS 变更。本次原记录是 CNAME www ziyuedesign.com，新记录是 CNAME www personal-website-8xc.pages.dev。确认无误后点击 Activate domain。

状态可能依次显示 Verifying、Initializing、Active。变为 Active 后，www 已经由 Cloudflare Pages 提供，不再访问原服务器。

绑定裸域名 ziyuedesign.com

只绑定 www 还不够，裸域名可能仍然指向原服务器。关闭原服务器后访问 https://ziyuedesign.com 出现 Cloudflare 522，通常表示裸域名的 DNS 仍指向已关机的原服务器。本次原有记录为 A @ 38.59.225.179。

再次进入 Custom domains → Set up a domain，输入 ziyuedesign.com。Cloudflare 会把旧记录替换为 CNAME @ personal-website-8xc.pages.dev，点击 Activate domain 并等待 Active。

如果原服务器只运行这个网站，可以继续保持关机；如果服务器还运行数据库、代理、录制程序或其他服务，则不能因为网站迁移完成而直接删除整台服务器。

查看文件变化

cd "/Users/sieh/Desktop/Server/个人网站"
git status
git diff
git diff --stat

• modified：现有文件被修改。
• untracked：出现尚未被 Git 管理的新文件。
• deleted：已删除文件。

加入变化并提交

git add -A
git status
git commit -m "新增一篇旅行文章"
git push

-A 会加入新增、修改和删除的文件。提交前再次 git status，确认没有把密码、SSH 私钥、令牌、临时文件或无关的大文件加入提交。

提交说明应简短表达本次修改，例如 新增首尔摄影页面、更新饮食文章、修复移动端导航、替换首页图片。第一次已设置 main 跟踪 origin/main，以后不需要重复输入仓库地址。

等待 Cloudflare 自动部署

进入 Workers & Pages → personal-website → Deployments，新提交会自动生成一次部署，一般一到数分钟内完成。

• Queued：等待执行。
• Building：正在构建。
• Success：已经上线。
• Failed：部署失败，需要查看日志。

如果部署成功但浏览器仍显示旧内容，用 Command + Shift + R 强制刷新。

只修改了一个文件时

git diff index.html
git add index.html
git commit -m "更新首页"
git push

git status
git add img/new-photo.jpeg
git commit -m "添加新图片"
git push

撤销尚未提交的修改

git restore index.html

这会丢弃该文件尚未提交的修改，执行前必须确认。

从待提交区移回工作区

git restore --staged index.html

文件内容不会消失，只是不再进入下一次提交。

仓库列表中没有 GitHub 仓库

打开 github.com/settings/installations，找到 Cloudflare Pages，点击 Configure，把 personal-website 加入可访问仓库。

进入了 Worker 页面

如果页面出现 Create a Worker、npx wrangler deploy、Deploy command，说明选择错了。返回创建方式页面，点击底部 Looking to deploy Pages? Get started。

www 正常，但裸域名显示 522

原因：裸域名仍指向已经关机的原服务器。解决：将 ziyuedesign.com 也添加到 Pages 的 Custom domains。

GitHub 页面没有文件

git status
git remote -v
git log --oneline
git push

确认 GitHub 页面选择的是 main 分支。

git push 要求认证

ssh -T git@github.com

正常结果应包含 You've successfully authenticated。

页面仍显示旧内容

先检查 Cloudflare Deployment 是否为 Success，然后用 Command + Shift + R 强制刷新浏览器。

.html 地址自动跳转

Cloudflare Pages 可能把 /about.html 重定向到 /about，这是正常行为。

禁止提交的内容

• id_ed25519 等 SSH 私钥。
• GitHub Personal Access Token。
• Cloudflare API Token。
• 数据库密码。
• 订阅链接或真实访问令牌。
• .env 文件。
• 服务器私钥和证书。

建议加入的忽略规则

.DS_Store
.env
.env.*
*.pem
*.key

确认网站已完全脱离原服务器

1. Cloudflare Pages 最新部署状态为 Success。
2. www.ziyuedesign.com 在 Custom domains 中为 Active。
3. ziyuedesign.com 在 Custom domains 中为 Active。
4. 两个域名都能通过 HTTPS 打开。
5. 关闭原服务器后两个域名仍然正常。
6. DNS 中不再使用旧服务器的 A 记录提供网站。

用 curl 检查状态

curl -I https://www.ziyuedesign.com
curl -I https://ziyuedesign.com

正常时应看到 HTTP/2 200。如果裸域名配置了 301 跳转，则看到 HTTP/2 301 也正常。