Files
blog/content/post/2026/2026-02-02-hugo-deploy-edgeone/index.md
T

4.5 KiB

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

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

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

为什么要换?

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

遇到的一个小插曲

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

Error: No space left on device

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

编写部署脚本

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

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

scripts/deploy_edgeone.sh

#!/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 文件里,我是这样配置的:

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

    # 构建生成静态文件
    - 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,希望这篇文章能帮到你。有问题欢迎在评论区留言,我们一起交流~