Cloudflare Pages 静态网页托管全流程指南

---
本指南涵盖了从 Linux 本地环境配置、GitHub 私有仓库关联到 Cloudflare Pages 自动部署的完整链路。

## 一、 准备阶段：本地环境配置

在 Linux 终端执行以下操作，确保 Git 已安装并配置。

### 1. 安装 Git

根据你的系统发行版选择安装命令：

* **Ubuntu/Debian**: `sudo apt install git`
* **CentOS/Fedora**: `sudo dnf install git`

### 2. 配置 Git 全局身份

```bash
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"

```

---

## 二、 身份验证：配置 SSH 密钥

GitHub 已停止支持 HTTPS 密码推送，建议使用 SSH 密钥进行免密且安全的通信。

### 1. 生成密钥对

执行以下命令，一路回车即可：

```bash
ssh-keygen -t ed25519 -C "你的邮箱"

```

### 2. 获取公钥并添加至 GitHub

1. 查看并复制公钥内容：`cat ~/.ssh/id_ed25519.pub`
2. 登录 GitHub，进入 **Settings** -> **SSH and GPG keys** -> **New SSH key**。
3. 将复制的内容粘贴到 Key 文本框内并保存。

### 3. 测试连接

```bash
ssh -T git@github.com

```

若输出包含 `You've successfully authenticated`，则表示配置成功。

---

## 三、 代码提交：建立本地与远程仓库

### 1. 初始化本地项目

进入你的项目目录并创建初始文件：

```bash
cd ~/git/blog
git init
# 创建示例网页
echo "<h1>Hello World</h1>" > index.html

```

### 2. 提交文件

```bash
git add .
git commit -m "initial commit"

```

### 3. 关联 GitHub 私有仓库

在 GitHub 网页端创建一个名为 `blog` 的 **Private** 仓库，然后在终端关联它：

```bash
# 请将 zhoujun0601 替换为你的实际 GitHub 用户名
git remote add origin git@github.com:zhoujun0601/blog.git

```

### 4. 推送代码

```bash
git branch -M main
git push -u origin main

```

---

## 四、 云端部署：配置 Cloudflare Pages

### 1. 关联 GitHub 账号

1. 登录 [Cloudflare 控制台](https://dash.cloudflare.com/)。
2. 导航至 **Workers & Pages** -> **Create application** -> **Pages** -> **Connect to Git**。
3. 按照提示授权 GitHub 访问权限（可仅选择 `blog` 私有仓库）。

### 2. 构建与部署设置

选择仓库后，按照以下参数配置：

| 配置项 | 推荐值 | 说明 |
| --- | --- | --- |
| **Framework preset** | None | 纯静态网页无需框架预设 |
| **Build command** | (留空) | 纯 HTML 文件不需要编译命令 |
| **Build output directory** | / | 网页文件所在的根目录 |
| **Root directory** | / | 项目源码所在的根目录 |

### 3. 验证部署

点击 **Save and Deploy**。部署完成后，Cloudflare 会提供一个以 `.pages.dev` 结尾的二级域名供访问。

---

## 五、 后续维护与自动化

### 1. 自动更新

由于已关联 GitHub，今后你只需在 Linux 终端执行：

```bash
git add .
git commit -m "update content"
git push

```

Cloudflare Pages 会实时监测到 GitHub 的变更并自动触发新的构建过程。

### 2. 自定义域名（可选）

在 Pages 项目详情页进入 **Custom domains**，可以绑定你拥有的顶级域名，Cloudflare 会自动处理 SSL 证书。

---