808 字
2 分钟
免费部署Mizuk个人博客教程
准备工作
前期需要准备 Cloudflare账号 Github账号 域名一个
开始/安装
下面是Github项目地址
Waiting for api.github.com...
环境依赖
在开始使用 Mizuki 之前，您需要确保系统满足以下要求：
- Node.js >= 22
- pnpm >= 9
- Git
安装 Node.js
访问 Node.js 官方网站 进行下载安装。
node -vnpm -v如果显示版本号，则表示安装成功。
安装pnpm
可以通过 npm 在cmd中安装：
npm install -g pnpm安装完成后，打开终端或命令提示符，运行以下命令验证 pnpm 是否安装成功：
pnpm -v如果显示版本号，则表示安装成功。
安装Git
访问 Git 官网 安装适合自己的版本。
安装完成后，打开终端或命令提示符，运行以下命令验证 Git 是否安装成功：
git --version如果显示版本号，则表示安装成功。
项目运行
克隆项目
git clone https://github.com/LyraVoid/Mizuki.gitcd Mizuki安装依赖
pnpm install配置博客
编辑 src/config.ts 文件来自定义博客设置。
启动
运行以下命令启动开发服务器：
pnpm dev启动成功后，您可以在浏览器中访问 http://localhost:4321 查看您的博客。
上传Github
在编辑完 src/config.ts 文件为自己想要的样子后方可进行。
创建Github仓库
打开 Github 主页
- 创建仓库 点击绿色
New - 在Repository name* 输入要自定义的仓库名
- Choose visibility *中
Public和Private分别是：公开仓库和私人仓库（两个都可以，如下图）。
- 然后点击Create repository 然后获取仓库克隆链接。
在本地电脑推送代码
请在您的电脑上打开终端（Windows 可以使用 CMD 或 PowerShell），并使用 cd 命令进入到您的 Mizuki 项目所在的文件夹。
1. 将所有文件添加到 Git 暂存区
git add .2. 提交代码
git commit -m "初始化 Mizuki 博客项目"3. 将主分支重命名为 main
git branch -M main4. 关联您刚才在 GitHub 创建的远程仓库（格式一般如下）
git remote add origin https://github.com/您的用户名/仓库名.git不成功尝试下面这个
git remote set-url origin https://github.com/您的用户名/仓库名.git4. 最后一步，把代码推送到GitHub
git push -u origin main执行完 push 命令后，如果弹出窗口让你登录 GitHub 进行授权，请按照提示登录。等进度条跑完，你的代码就成功传到 GitHub 了
配置 Cloudflare
Cloudflare Pages 是一个优秀的静态网站托管平台，具有全球 CDN、自动部署和免费 SSL 证书等特性。
本指南将详细介绍如何将 Mizuki 部署到 Cloudflare Pages
1. 将域名托管在Cloudflare
2. Cloudflare主页侧边栏中 计算/Workers和Pages
3. 点击创建应用，在创建页面点击下边 “ 想要部署 Pages？开始使用 ”
4. 选择导入现有 Git 存储库
选择Github 然后登录 GitHub 帐户 选择刚才创建并且上传的仓库点击开始设置。
5.设置构建和部署
- 设置一个项目名字
- 生产分支选择
main - 框架预设选择
Astro - 构建命令：
pnpm i && pnpm build- 环境变量：
NODE_VERSION = 22.12.0PNPM_VERSION = 8
- 点击保存并部署等待一会.
- 部署成功后点击自定义域绑定你的域名。
绑定成功后可以通过域名访问
更详细的操作可以查看 官方文档 获取指导
分享
如果这篇文章对你有帮助，欢迎分享给更多人！
部分信息可能已经过时