VitePress+GitHub 私有仓库+Cloudflare Page

实战案例：https://zslinux.com/

一、必备软件

待补充

二、GitHub 仓库克隆成功后本地操作指南

（一）前提说明

已通过 SSH 协议成功克隆目标仓库，克隆命令如下：

git clone [e-mail]:peiyafei/zslinux-website.git

（二）本地核心操作步骤

1. 进入本地仓库目录

克隆完成后，本地会自动生成名为 zslinux-website 的项目文件夹，需先通过终端切换到该目录：

cd zslinux-website

执行后，终端路径会切换至项目根目录，后续所有操作均在此目录下进行。

1. 安装项目依赖

项目运行依赖第三方包（如 VitePress 相关依赖），需使用 yarn 包管理器安装依赖（与前期使用习惯一致）：

yarn install

安装成功标志：项目根目录会新增 node_modules 文件夹，该文件夹存放所有已安装的依赖包。

1. 启动项目预览

依赖安装完成后，启动本地开发服务器，即可在浏览器中预览项目效果，命令如下：

yarn dev

启动成功提示：终端会输出类似以下内容，包含访问地址（通常为 http://localhost:5173 或 http://127.0.0.1:5173）

三、cloudflare 优化设置

1. 提高网站加载速度

在 Page Rule（https://zslinux.com/*）里只设置这三项即可：

设置项	值	说明（为什么这样最合理）
Cache Level	Cache Everything	缓存 HTML（核心）
Edge Cache TTL	1 hour	Cloudflare 每小时自动向 GitHub 检查一次有没有更新
Browser Cache TTL	1 hour	浏览器也缓存 1 小时，足够“秒开”