EdgeOne Pages 部署
约 916 字大约 3 分钟
2025-11-21
EdgeOne Pages 是腾讯云提供的静态网站托管服务，支持自动部署，与 GitHub 集成良好，非常适合部署 Mizuki 博客。
准备工作
- 拥有一个 GitHub 账号
- 准备好你的 Mizuki 博客项目代码
- 注册腾讯云账号（如果还没有）
部署步骤
第一步：创建 GitHub 仓库
- 登录你的 GitHub 账号
- 点击右上角的 "+" 号，选择 "New repository"
- 填写仓库名称（如：mizuki-blog）
- 选择公开（Public）或私有（Private）仓库
- 勾选 "Add a README file"（可选）
- 点击 "Create repository" 创建仓库
- 将你的 Mizuki 博客代码推送到这个仓库
第二步：配置 EdgeOne Pages
- 登录 腾讯云控制台
- 在搜索框中输入 "EdgeOne"，点击进入 EdgeOne 产品页面
- 在左侧导航栏找到 "EdgeOne Pages" 并点击
- 点击 "添加站点" 或 "新建应用" 按钮
第三步：连接 GitHub 仓库
- 在部署设置页面，选择 "GitHub" 作为代码源
- 系统会跳转到 GitHub 授权页面，点击 "Authorize" 授权 EdgeOne 访问你的 GitHub 账号
- 返回 EdgeOne 页面后，从下拉列表中选择你刚刚创建的仓库
- 选择要部署的分支（通常是 main 或 master）
第四步：配置构建设置
这是关键步骤，需要正确配置构建命令：
- 框架预设：选择 "Astro" 或 "静态网站"
- 构建命令：修改为
pnpm i && pnpm build - 输出目录：设置为
dist - Node.js 版本：建议选择 18.x 或更高版本
完成配置后，EdgeOne Pages 会自动开始构建你的网站。
第五步：访问网站
构建完成后，EdgeOne Pages 会提供一个默认的域名（通常是一个随机字符串加上 .edgeone.pages.dev）。你可以：
- 使用这个默认域名访问你的网站
- 在域名设置中绑定自定义域名（可选）
重要提示
1. 构建命令配置
必须使用以下构建命令：
pnpm i && pnpm build注意：不要使用默认的 npm install 或 yarn install，因为 Mizuki 项目使用 pnpm 作为包管理器。
2. 构建失败排查
如果构建失败，检查以下几点：
- 包管理器：确认使用了
pnpm而不是npm或yarn - Node.js 版本：使用 18.x 或更高版本
- 构建输出：确认输出目录设置正确（
/dist） - 依赖安装：检查 package.json 中的依赖是否完整
3. 自动部署
EdgeOne Pages 会自动监听你的 GitHub 仓库变化：
- 当你向仓库推送新代码时，EdgeOne 会自动触发构建
- 构建成功后，网站会自动更新
- 可以在 EdgeOne 控制台查看构建历史和日志
自定义域名（可选）
如果你想使用自己的域名：
- 在 EdgeOne Pages 控制台点击 "域名设置"
- 添加你的自定义域名（如：blog.yourdomain.com）
- 按照提示配置 DNS 记录
- 等待 SSL 证书自动颁发
优化建议
- 启用缓存：在 EdgeOne 中开启适当的缓存策略，提高网站访问速度
- CDN 加速：EdgeOne 自带全球 CDN，无需额外配置
- 压缩资源：EdgeOne 会自动压缩静态资源，无需手动配置
总结
通过 EdgeOne Pages 部署 Mizuki 博客非常简单，只需要：
- 创建 GitHub 仓库
- 在 EdgeOne 中连接仓库
- 配置正确的构建命令（
pnpm i && pnpm build） - 等待自动部署完成
整个过程通常只需要几分钟，而且完全免费，非常适合个人博客使用。