EdgeOne Pages 部署
约 908 字大约 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)
第四步:配置构建设置
这是关键步骤,需要正确配置构建命令:
- 框架预设:选择 "VuePress" 或 "静态网站"
- 构建命令:修改为
pnpm i && pnpm build - 输出目录:设置为
.vuepress/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 或更高版本
- 构建输出:确认输出目录设置正确(
.vuepress/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) - 等待自动部署完成
整个过程通常只需要几分钟,而且完全免费,非常适合个人博客使用。