个人博客建站历程 Hugo & Blowfish

sudo apt update
sudo apt install hugo

hugo version

mkdir my_blog
cd my_blog
# 修改git默认分支为main
git config --global init.defaultBranch main
git init
touch .gitignore
nano .gitignore

# .gitignore
# others
node_modules
.hugo_build.lock

# OS generated files
.DS_Store
.DS_Store?
._*
.Spotlight-V100
.Trashes

# Hugo
public

# 然后进行第一次提交
git add .
git commit -m "New: First commit" # 此处可能会报错，填写一下邮箱账号就好

git config user.email "your@mail.domain"
git config user.name "yourname"
# 再次执行这句话
git commit -m "New: First commit"

# 添加远程仓库
git remote add origin https://yourgitplatform.domain/username/projectname
# push
git push --set-upstream origin main

hugo new site --force .

hugo server # 注意，此命令仅限用于调试，不得用在实际生产环境
# 如果你在没有图形化界面的机器上部署，可以使用：默认测试端口也是1313
# hugo server --bind=0.0.0.0

git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish

rm hugo.toml
mkdir -p ./config/_default
cp ./themes/blowfish/config/_default/*.toml ./config/_default # 如果你通过模块安装，不要将文件module.toml直接覆盖

config/_default/
├─ hugo.toml
├─ languages.en.toml
├─ markup.toml
├─ menus.en.toml
├─ module.toml # 如果你通过模块安装，不要将此文件直接覆盖
└─ params.toml

# 目标主机上
nano /etc/ssh/sshd_config
# 修改如下项为 yes
PubkeyAuthentication yes
# 确认可用后重启sshd服务
sudo systemctl restart sshd

# 计算base64加密后的私钥     -w 0 参数可以生成没有换行和空格的私钥喵
echo -n "-----BEGIN OPENSSH PRIVATE KEY-----
privatekeyexampleAAAAAAAAAAAAAAAAAexample
exampleexampleexampleexampleexampleexample
exampleexampleexampleexampleexampleexample
-----END OPENSSH PRIVATE KEY-----
" | base64 -w 0

stages:
  - build
  - deploy

# Hugo 渲染构建
build-job:
  tags:
    - your-runner-tag # gitlab的runner容器tags, 便于负载分离专机专用, 我这就一个runner, 直接选他就好
  stage: build
  image: hugomods/hugo:ci-0.151.1   # 这里是docker镜像, 请根据需要修改tags, 主包偷懒选了最新最大个的ci-0.151.1(((
  before_script:
    - git submodule update --init   # 这个必须带, 因为我是使用git submodule引入的主题模块
  script:
    - hugo --minify # 最小化部署
  artifacts:
    paths:
      - public # 产物保留给deploy
  after_script:
    - echo "Hugo build completed!"
  # 仅在 main 或 master 分支上触发
  only:
    - main
    - master

# 将静态文件推送到目标服务器
deploy_job:
  tags:
    - your-runner-tag
  stage: deploy
  image: hugomods/hugo:ci-0.151.1 # 镜像复用这一块/.
  before_script:
    # 安装 ssh 客户端和 rsync (rsync 比 scp 更高效)
    - apk update && apk add openssh-client rsync
    # 启动 ssh-agent 以管理密钥
    - eval $(ssh-agent -s)
    # 将我们存储在 CI/CD 变量中的私钥添加到 ssh-agent
    # 加入了base64解码 tr -d '\r'为了解决 Windows/Linux 换行符问题
    - echo "$SSH_PRIVATE_KEY" | base64 -d | tr -d '\r' | ssh-add -
    # 创建 .ssh 目录
    - mkdir -p ~/.ssh
    - chmod 700 ~/.ssh
    # 自动接受目标服务器的 host key，避免流水线因交互而卡住
    - ssh-keyscan -H $DEPLOY_SERVER_IP >> ~/.ssh/known_hosts
    - chmod 644 ~/.ssh/known_hosts

  script:
    # 使用 rsync 将 public 目录的内容同步到目标服务器
    # -a: 归档模式, -v: 显示详细信息, -z: 压缩传输, --delete: 删除目标目录中多余的文件
    - rsync -avz --delete ./public/ ${DEPLOY_USER}@${DEPLOY_SERVER_IP}:${DEPLOY_TARGET_PATH}
    - echo "✅ Deployment successful!"
  only:
    - main
    - master

services:
  web:
    image: nginx:1.29.2-alpine-slim
    container_name: hugo_blog_nginx
    restart: always
    ports:
      - "80:80" # 将服务器的 80 端口映射到容器的 80 端口
    volumes:
      - /yourpathtongnix/ngnix/public:/usr/share/nginx/html # 将存放 Hugo 产物的目录挂载到 Nginx
      - /yourpathtongnix/ngnix/conf.d:/etc/nginx/conf.d # 挂载 Nginx 配置文件

# conf.d/default.conf
server {
    listen 80;
    server_name _; # 替换成你的域名，如果没有就用 _ 这里我本地服务器仅实现静态部署，通过frp转发，所以就不加了

    root /usr/share/nginx/html;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

nano /etc/caddy/Caddyfile

# 添加到行尾
your.domain {
    # tls
    tls /etc/caddy/certs/yourdomain.pem /etc/caddy/certs/yourdomain.key
    # 反代
    # hugo&blowfish 博客流量转发
    reverse_proxy localhost:portnum
}

sudo systemctl restart caddy
sudo systemctl status caddy