hugo部署到coding&备份源码

3.7k 字

本地操作

安装GIt

本地需要安装 Git ，安装过程略。安装完git后还要配置环境变量： 右键我的电脑 –> 属性，然后点击高级系统设置 –> 环境变量 –> 选择用户变量或系统变量中的Path,点击编辑；找到Git安装目录,添加以下地址:

1
2
3

D:\Program Files\Git\bin
D:\Program Files\Git\mingw64\libexec\git-core
D:\Program Files\Git\mingw64\bin

配置SSH 公钥

Windows 上安装 Git for Windows 之后在开始菜单里打开 Git Bash 输入：

1
2

git config --global user.name "你的用户名"
git config --global user.email "你的电子邮箱"

1
2
3
4

cd ~
mkdir .ssh
cd .ssh
ssh-keygen -t rsa

在系统当前用户文件夹下生成了私钥 id_rsa 和公钥 id_rsa.pub。

初始化 Hugo

安装hugo

windows10下安装hugo，可以参照Hugo官方手册的方法，这里讲一个相对简单稳定的方法。

1.下载hugo程序压缩包：前往https://github.com/gohugoio/hugo/releases下载和自己系统版本相符合的hugo程序压缩包。(建议下载hugo_extended版本)

2.解压到某个文件夹中（路径不要有中文，而且自己要记得文件夹的路径），最好是不常改动的文件夹下边，以防文件被误删或者丢失。

3.添加hugo到系统环境变量PATH中

  • 找到“系统环境变量”的设置位置，在开始菜单的搜索栏搜索环境变量
  • 添加用户环境变量，依此：点击环境变量，找到用户变量中的path，点击编辑，然后点击新建，在使用浏览按钮选中文件夹，即可使用hugo。（选中到hugo.exe所在的文件夹即可，不需要选中hugo.exe，貌似添加完系统变量，要重启电脑才能在Git Bash里运行hugo）
  • 接下来，为了万无一失，还是要检查一下hugo是否安装完成。以管理员方式打开cmd命令窗口，然后输入以下指令：
1

hugo version

如果得到如下响应，（即显示版本信息），说明安装成功，接下来就可以玩转hugo了。

1

Hugo Static Site Generator v0.70.0/extended windows/amd64 BuildDate: unknown

创建并配置站点

以下命令均在’Git Bash’中运行

进入你想存放 Hugo 网站文件夹的目录，执行以下命令：

1

hugo new site blog

添加主题

1

git clone https://github.com/dillonzq/LoveIt.git themes/LoveIt

附更新主题命令：

1
2

cd ./themes/LoveIt/
git pull

配置主题

将 根目录\themes\even\exampleSite路径下的config.toml文件复制到根目录下，覆盖掉根目录下的config.toml文件。然后，我们在notepad++中打开并对其作一定的修改就可以直接使用。

配置config.toml

略

设置文章模板

为了更好的使用附加功能，我们提前修改一下模板。这样，每次使用新建一篇文档时候就省去很多麻烦事。 使用Typora文档工具打开themes/tranquilpeak/archetypes中的post.md直接替换为以下的模板：

1
2
3
4
5
6
7
8

---
title: "{{ replace .Name "-" " " | title }}"
date: {{ .Date }}
lastmod: {{ .Date }}
draft: false
weight: false
categories: [""]
tags: [""]

　接下来在根目录下使用以下命令生成一篇文档吧：

1

hugo new post/XXXX.md

新建“关于”页面

1

hugo new about.md

config.toml相应位置添加：

1
2
3
4
5

[[menu.main]]
  name = "关于"
  weight = 50
  identifier = "about"
  url = "/about/"

启动博客的本地预览

建议在配置文件中设置好主题，或者使用 –t指令指定主题，在站点的根目录下使用命令进行本地启动，本地启动的命令如下：

1

hugo server -D

使用浏览器打开 http://localhost:1313 预览。

部署到coding

略

提交本地仓库

1
2
3
4
5
6
7
8
9

rm -rf public/*
hugo
cd public
git remote rm origin
git init
git remote add origin git@e.coding.net:iwyang/hugo/hugo.git
git add .
git commit -m "Add a new post"
git push --force origin master

备份脚本

为了后续更新方便起见，可以在根目录新建一个一键部署脚本，命名为deploy.sh（如果对配置不做大的改动（例如：更换主题等），后续的更新可以使用以下脚本）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

#!/bin/bash

echo -e "\033[0;32mDeploying updates to gitee...\033[0m"

# Removing existing files
rm -rf public/*
# Build the project
hugo
# Go To Public folder
cd public
git add .

# Commit changes.
msg="rebuilding site `date`"
if [ $# -eq 1 ]
  then msg="$1"
fi
git commit -m "$msg"

# Push source and build repos.
git push origin master --force

# Come Back up to the Project Root
cd ..

创建完脚本以后，不要忘了加权限

1

chmod 777 xxx

提交本地仓库

1
2
3
4
5
6
7
8
9

rm -rf public/*
hugo
cd public
git remote rm origin
git init
git remote add origin git@gitee.com:iwyang/iwyang.git
git add .
git commit -m "Add a new post"
git push origin master --force

备份hugo源码

1
2
3
4
5
6
7

git remote rm origin
git init
git checkout -b backup
git add .
git commit -m "备份源码"
git remote add origin git@gitee.com:iwyang/iwyang.git
git push origin backup --force

备份hugo源码

PS: 如果执行第三步git checkout -b backup后，提示fatal: A branch named 'backup' already exists.，则执行以下操作：

1
2

git branch -D backup    #删除分支:必须切换到其他的分之下才可操作
git checkout -b backup  #切换分支

备份到github master分支

1
2
3
4
5
6

git remote rm origin
git init
git add .
git commit -m "备份源码"
git remote add origin git@github.com:iwyang/hugo.git
git push --force origin master

PS:这里Git Bash开头会报错：warning: LF will be replaced by CRLF，解决方法：在git add .前面添加：

1

git config --global core.autocrlf false

最终效果：

1
2
3
4
5
6

# backup
git config --global core.autocrlf false
git add .
git commit -m "备份源码"
git remote add origin git@github.com:iwyang/hugo-backup.git
git push origin master --force

在部署脚本里也要作相应修改。

备份到Dropbox

这是一份为 Taihe 量身定制的完整教程。我们将配置 GitHub Actions，在你向 develop 分支推送代码时，自动将 bore.vip 的源码打包为 ZIP 格式，并上传到 Dropbox 的指定深度目录，且始终只保留最新一份。

第一阶段：准备 Dropbox 权限工具箱

由于 Dropbox 的普通 Token 会过期，我们需要获取一个永不过期的 Refresh Token。

  1. 创建 App：
  • 访问 Dropbox App Console。
  • 点击 Create app。
  • 选择 Scoped access -> Full Dropbox。
  • 命名你的 App（例如：Bore-Blog-Backup）。
  1. 勾选权限 (Permissions)：
  • 在 Permissions 选项卡中，务必勾选：files.content.write 和 files.content.read。
  • 点击页面底部的 Submit 保存。
  1. 获取 App Key 和 Secret：
  • 在 Settings 选项卡中，找到并记录 App key 和 App secret。
  1. 获取授权码 (Code)：
  • 在浏览器打开以下链接（替换 你的AppKey）： https://www.dropbox.com/oauth2/authorize?client_id=你的AppKey&token_access_type=offline&response_type=code
  • 点击“允许”后，复制显示的授权码。
  1. 换取 Refresh Token：
  • 在本地终端执行（需使用你的 10808 代理端口）：
1
2
3
4

curl -x http://127.0.0.1:10808 https://api.dropbox.com/oauth2/token \
     -d code=你的授权码 \
     -d grant_type=authorization_code \
     -u 你的AppKey:你的AppSecret
  • 保存返回 JSON 中的 refresh_token。

第二阶段：在 GitHub 仓库配置“保险箱”

为了保护你的隐私，我们需要将密钥存放在 GitHub 的 Secrets 中。

  1. 打开你的 GitHub 仓库（存放 Hugo 源码的仓库）。
  2. 点击 Settings -> Secrets and variables -> Actions。
  3. 点击 New repository secret，依次添加：
  • DROPBOX_APP_KEY
  • DROPBOX_APP_SECRET
  • DROPBOX_REFRESH_TOKEN

第三阶段：编写自动化脚本

在你的仓库根目录下创建文件：.github/workflows/backup.yml。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

name: Push to Dropbox (Develop Zip Backup)

on:
  push:
    branches:
      - develop  # 仅针对 develop 分支生效
  workflow_dispatch: # 允许手动点击按钮触发

jobs:
  backup:
    runs-on: ubuntu-latest
    steps:
      # 1. 下载代码
      - name: Checkout Code
        uses: actions/checkout@v4

      # 2. 创建 ZIP 压缩包
      # 使用 -r 递归压缩，-x 排除 .git。生成在 ../ 以避免文件变动报错。
      - name: Create Zip Archive
        run: zip -r ../backup.zip . -x "*.git*"

      # 3. 获取临时 Access Token
      - name: Refresh Dropbox Token
        id: dropbox_auth
        run: |
          RESPONSE=$(curl https://api.dropbox.com/oauth2/token \
            -d grant_type=refresh_token \
            -d refresh_token=${{ secrets.DROPBOX_REFRESH_TOKEN }} \
            -u ${{ secrets.DROPBOX_APP_KEY }}:${{ secrets.DROPBOX_APP_SECRET }})
          
          TOKEN=$(echo $RESPONSE | jq -r '.access_token')
          echo "ACCESS_TOKEN=$TOKEN" >> $GITHUB_ENV

      # 4. 上传并覆盖
      - name: Upload to Dropbox
        run: |
          # 目标路径：/资料/文档/个人/hugo blog backup/latest_backup.zip
          curl -X POST https://content.dropboxapi.com/2/files/upload \
            --header "Authorization: Bearer ${{ env.ACCESS_TOKEN }}" \
            --header "Dropbox-API-Arg: {\"path\": \"/资料/文档/个人/hugo blog backup/latest_backup.zip\",\"mode\": \"overwrite\",\"autorename\": false,\"mute\": true}" \
            --header "Content-Type: application/octet-stream" \
            --data-binary @../backup.zip

第四阶段：验证与运行

  1. 提交代码：将该配置文件提交并推送至 develop 分支。
  2. 查看状态：在 GitHub 仓库的 Actions 页面，你会看到名为 Push to Dropbox 的任务正在运行。
  3. 最终检查：
  • 打开 Dropbox。
  • 依次进入文件夹：资料 > 文档 > 个人 > hugo blog backup。
  • 确认 latest_backup.zip 已成功生成。

为什么选择这个方案？

  • 空间优化：使用 overwrite 模式，Dropbox 里永远只占一个文件的空间。
  • 兼容性高：ZIP 格式在你常用的 Windows/macOS 环境下兼容性极佳。
  • 分支隔离：完全符合你针对 develop 分支进行备份的需求。

既然你对自动化部署很有研究，需要我帮你再加一段脚本，在备份成功后向你的 Telegram 或企业微信发送一条通知吗？

还原源码

重装系统后，Algolia的自动提交索引功能要重新部署一遍，具体可查看：Hugo添加Algolia。最后还要在博客目录里重新关联远程仓库，还是一样先备份源码到github，再部署网页到相应服务器。

先备份源码，再部署网页，是为了GitInfo以及lastmod能够生效和更新，其实源码可以备份到github、gitee、coding中任意一个公开仓库都可以，当然备份到github最好。网页也无需和源码放在同一个代码托管平台上。

2022.3.4 如果使用Git Submodule子模块管理Hugo主题，将源码克隆到本地，使用下面这条命令才能将主题一同克隆到本地。

1

git clone -b develop git@github.com:iwyang/hugo.git hugo --recursive

总结

最好不要反复切换部署仓库，否则git会出现以下错误提示：

1
2
3
4
5

remote: error: The last gc run reported the following. Please correct the root cause
remote: and remove gc.log.
remote: Automatic cleanup will not be performed until the file is removed.
remote:
remote: warning: There are too many unreachable loose objects; run 'git prune' to remove them.

查资料，原来是自己本地一些 “悬空对象”太多(git删除分支或者清空stash的时候，这些其实还没有真正删除，成为悬空对象，我们可以使用merge命令可以从中恢复一些文件)

解决方法：

1.输入命令：git fsck --lost-found，可以看到好多“dangling commit”

2.清空他们：git gc --prune=now，完成

参考链接

Hugo
编辑此页 | #8b1ff38
© 2020 - 2026 Bore's Notes
最近更新：--| #c65615c
使用 Hugo 构建 | 主题 Stack 由 Jimmy 设计