外面天黑了，而我正坐在电脑前发呆，努力尝试想起来某个文件的路径到底是什么。

脑袋开始混沌走神——我是怎么走到这一步的？我本来是要做什么来着？

想起来了。最初的问题，是 iCloud 空间不大够用来着。

……但是怎么变成现在这样了呢？

大概是“吾不识青天高，黄地厚；唯见月寒日暖，来煎人寿”吧。

从给 Github 库瘦身开始

iCloud 空间不大够用，我打算把不常用的文件挪到 NAS 上去。整理文件时，发现有两个文件夹异常巨大：一个是用来存放和生成 Blog 的文件夹，另一个是存放课程幻灯片的。

Blog 是用 Hugo 生成的静态网站，幻灯片是基于 impress.js 设计的一组网页和资源。这两个文件夹都有自己的 Github 仓库，而且幻灯片文件夹还作为子模块引入了 Blog 仓库。我使用 Github Pages 托管 Blog，把我的域名 yemengma.cn 指向了这个仓库，所以可以通过域名访问 Blog 和幻灯片。

因为是和 Github 同步，所以这两个文件夹下都有用来记录历史的 .git 文件夹；而因为幻灯片作为子模块引入了 Blog 仓库，所以幻灯片的历史也被完整保存在 Blog 仓库中。

这样一来，幻灯片文件夹本身的文件大概有 1G 左右，加上 .git 就有了 2G；而 Blog 仓库里存了一份幻灯片文件夹，还有相应的两份 .git 文件夹，平白多占用了 3G 空间。

本来这也不是什么大问题，几个 G 的空间也不算多……但是问题是我的 iCloud 只有 50G。让重复没用的文件占了 6%，这还能忍？

于是改吧。

所以总结一下， 情况大概是这样：

hugo-site/
  ├── content/
  ├── public/
  │   └── slides/  #  幻灯片文件夹作为子模块引用
  └── themes/

这种结构带来了几个问题：

• 幻灯片仓库被完整引入 Blog 仓库；
• 更新时需要同步子模块；
• 主仓库和子模块各自的 .git 文件夹都保存了完整历史；

所以解决方案也就很清晰了：

1. 将幻灯片从 Blog 中完全分离；
2. 重命名幻灯片仓库的主分支为 gh-pages，用 Github Pages 发布；
3. 删除远程主分支，重新设置分支追踪；
4. 设置域名解析，指向新的幻灯片地址；

第一步好办，删几个文件夹而已；第二步第三步也无非几个命令。

cd /path/to/slides
git branch -m main gh-pages
git push origin gh-pages
git push origin --delete main
git branch -u origin/gh-pages

删文件令人心情舒畅。修改完的结构如下：

/path/
  ├── hugo-site/    # Blog 内容
  └── slides/       # 独立的幻灯片内容

第四步要去阿里云上设置域名解析。打开了多年没有登录的阿里云，找到域名解析，添加一条新的 CNAME 记录，把 slides.yemengma.cn 指向 mammoth2008.github.io……

然后想起来，我的这个域名一直没备案。

那就顺手备一个吧。

备案需要服务器

网站备案需要域名和服务器，而我没有服务器——Github 非常良心地提供了免费服务。

所以租了低配的阿里云服务器，有 2 核 CPU、2G 内存、3M 带宽，运行 Ubuntu 20.4，第一年租金不到 100 块。看见域名很便宜，也顺手买了个新域名 lifeplayer.club（目前备案没完成，无法访问），把 lifeplayer.club、www.lifeplayer.club、slides.lifeplayer.club 都解析到这个服务器的 IP 地址。

浪费计算资源是要遭天谴的。于是把 Blog 和幻灯片都同步到服务器上，用 Nginx 配置两个站点，这样在国内访问的速度就会快很多——毕竟 Github 在国内的访问速度比较随机。

先安装 Hugo 和 Nginx。

sudo apt Update
sudo apt install hugo
sudo apt install nginx

然后把文件复制到云服务器上：

rsync -avz /local/hugo-site/ root@IPAddress:/home/admin/hugo-site/
rsync -avz /local/slides/ root@IPAddress:/home/admin/slides/

再写个 Nginx 配置文件：

# Blog 主站配置
server {
    listen 80;
    server_name lifeplayer.club www.lifeplayer.club IPAdress;
    root /home/admin/hugo-site/public;
    index index.html;
    error_page 404 /404.html;
    location / {
        try_files $uri $uri/ =404;
    }
    location /slides {
        alias /home/admin/slides;
        try_files $uri $uri/ =404;
    }
}

# slides 子域名配置
server {
    listen 80;
    server_name slides.lifeplayer.club;
    root /home/admin/slides;
    index index.html;
    error_page 404 /404.html;
    location / {
        try_files $uri $uri/ =404;
    }
}

应用配置，重启 nginx 就行了。

sudo ln -s /etc/nginx/sites-available/hugo /etc/nginx/sites-enabled/
sudo systemctl enable nginx
sudo nginx -t
sudo systemctl restart nginx

人总是能懒则懒的

所以总结一下，现在我修改完文件后，除了要提交到 Github 上之外，还要同步到云服务器上。

嗯……所以更新一下部署脚本吧。

以前我有一个部署脚本，用来在更新文件后提交到 Github 上。现在既然要改，不妨改大一点。除了更新 Github 和云服务器上的内容外，还要考虑特殊文件的处理，以及 Blog 在服务器上的重新生成。要尽量模块化，参数化，安全性也要增强一些。

改进后的部分脚本如下：

#!/bin/bash
check_git_status() {
    if [ -n "$(git status --porcelain)" ]; then
        info "检测到未提交的更改"
        git add .
        git commit -m "Update: $(date '+%Y-%m-%d %H:%M:%S')"
    fi
    local_commit=$(git rev-parse HEAD)
    remote_commit=$(git rev-parse @{u})

    if [ "$local_commit" != "$remote_commit" ]; then
        info "推送本地更改到远程仓库"
        git push || error_exit "推送失败"
    fi
}

sync_to_server() {
    info "开始同步到服务器"
    rsync -avz --exclude '.git*' \
        --exclude 'config.toml' \
        --exclude 'public/' \
        --exclude 'layouts/partials/language-selector.html' \
        ./ root@IPAddress:/home/admin/hugo-site/ || error_exit "同步失败"

    success "同步完成"
}

main() {
    check_git_status
    sync_to_server

    if [[ "$0" == *"deploy-blog"* ]]; then
        ssh root@IPAddress "cd /home/admin/hugo-site && hugo"
    fi
}
main

重启能解决 90% 问题

这次的“小问题”最终演变成了网站架构调整。现在的方案有几个明显改进：

存储更合理了。因为删除了重复的文件和历史记录，为 Blog 和幻灯片分别建立了独立的仓库，所以 iCloud 空间节省了约 5G。仓库结构更清晰，便于维护。

访问更便捷了。国内用户通过阿里云服务器快速访问，解决了相当大的问题。另外，依然保留 GitHub Pages 作为备用入口，也通过子域名让资源组织更清晰。

部署更高效了。使用自动化脚本处理了大部分重复工作，也有了更完善的错误处理。省去了许多重复操作。

还有点意外收获。重新捡起来了一点 Ubuntu 操作系统的用法——本来都已经忘差不多了。重新考虑网站架构，未来的扩展也很容易。

Edsger W. Dijkstra（那个著名图算法的发明者）说：“简单性是可靠性的先决条件。”

所以现在我的网站结构更简单了，访问更快捷了，维护更容易了，感觉天都更蓝了！

未标明出处的配图由 FLUX-dev 生成。