---
title: Hugo博客部署腾讯云EdgeOne Pages的尝试
date: 2026-02-02T01:00:00.000Z
draft: false
categories:
  - 尝试
  - 技术
tags:
  - Hugo
  - EdgeOne
  - CI/CD
ai_comment: >-
  哈哈，电子宠物这个比喻太真实了！我家的博客也整天被我折腾来折腾去，看到高清图片占满空间的经历简直感同身受。技术小白每次解决这种小问题都像打怪升级，EdgeOne这波安利吃得有点心动，脚本注释写得这么贴心，下次我也要抄作业试试～
---

最近看到不少博友都在推荐腾讯云的 EdgeOne Pages，说是访问速度挺快，而且对个人博客这种静态站点很友好。想着自己这个小站平时也没少折腾，既然有更好的选择，那就试试看呗。

其实我对于运维这些也不是特别精通，就是喜欢捣鼓。这次迁移过程虽然遇到了一点小插曲，但好在最后都解决了。顺便把过程记录下来，给同样用 Hugo 搭建博客的朋友们做个参考。

## 为什么要换？

其实原来的部署方式也能用，但作为一个把博客当成"电子宠物"养的人，总想给来访的朋友们提供更好的体验。EdgeOne 主打的就是边缘加速，直白点说就是能让国内的朋友打开博客更快一点。而且它给的免费额度对于我们这种个人博客来说完全够用了。

## 遇到的一个小插曲

刚开始在 GitHub Actions 上自动部署的时候，总是提示空间不足：

```text
Error: No space left on device
```

这就很尴尬了。后来发现是我以前上传图片太随意了，很多高清原图把空间占满了。于是先用脚本把图片都压缩成了 WebP 格式，给仓库"瘦身"了一下，这才顺利进行下一步。这也提醒我，平时维护博客还是要注意一下资源管理呀。

## 编写部署脚本

为了让部署过程更稳定，也方便以后自己在本地测试，我没有直接把一堆命令写在 GitHub 的配置里，而是专门写了一个小脚本。

虽然我代码写得一般，但加上注释后应该还是挺好懂的。这里把完整代码贴出来，大家如果有需要可以直接拿去用：

**`scripts/deploy_edgeone.sh`**

```bash
#!/bin/bash

# EdgeOne Pages 部署脚本

# 1. 检查必要的环境变量
# 如果没有配置 API Token，就直接报错退出，防止后面瞎忙活
if [ -z "$EDGEONE_API_TOKEN" ]; then
  echo "Error: EDGEONE_API_TOKEN is not set."
  exit 1
fi

# 2. 设置默认值
# 如果没传参数，就用默认的 "hugo-blog" 作为项目名
PROJECT_NAME=${1:-"hugo-blog"}
# 默认发布当前目录下的 public 文件夹
BUILD_DIR=${2:-"./public"}

echo "正在部署到 EdgeOne Pages..."
echo "项目名称: $PROJECT_NAME"
echo "发布目录: $BUILD_DIR"

# 3. 执行部署命令
# 这里用 npx 来运行，这样就不用在电脑上专门安装 edgeone 的命令行工具了
# 也不用担心版本不兼容的问题，挺方便的
npx edgeone pages deploy "$BUILD_DIR" -n "$PROJECT_NAME" -t "$EDGEONE_API_TOKEN"

# 4. 检查是否成功
# $? 代表上一个命令的退出状态，0 表示成功
if [ $? -eq 0 ]; then
  echo "太棒了，部署成功！"
else
  echo "哎呀，部署失败了，快去检查一下日志吧。"
  exit 1
fi
```

## 配置自动化流程

脚本写好了，最后一步就是告诉 GitHub Actions 每次我更新文章时自动运行这个脚本。

在 `.github/workflows/deploy.yml` 文件里，我是这样配置的：

```yaml
    # ... 前面的构建步骤省略了 ...

    # 构建生成静态文件
    - name: Build
      run: rm -rf public && hugo --minify

    # 部署到 EdgeOne Pages
    - name: Deploy to EdgeOne Pages
      env:
        # 这个 Token 记得去 GitHub 仓库的 Settings -> Secrets 里配好哦
        EDGEONE_API_TOKEN: ${{ secrets.EDGEONE_API_TOKEN }}
      run: |
        # 给脚本加上可执行权限，不然运行不了
        chmod +x scripts/deploy_edgeone.sh
        # 执行脚本，传入项目名和目录
        ./scripts/deploy_edgeone.sh hugo-blog ./public

    # ... 后面的步骤 ...
```

## 小结

看着 GitHub Actions 里的绿色对号亮起，心里还是挺舒坦的。现在博客访问起来感觉确实顺滑了一些。

折腾博客的乐趣大概就在这里吧，虽然过程中会遇到各种奇奇怪怪的问题，但解决问题后的那份满足感，还有能和博友们分享经验的快乐，是什么都比不了的。

如果你的博客也想试试 EdgeOne，希望这篇文章能帮到你。有问题欢迎在评论区留言，我们一起交流~