developlog

本地配置

本地环境配置

1. Python

2. OSS2

3. hugo

安装hugo

方式一：直接下载 exe（最简单）

  1. 打开 Hugo 的 GitHub Release 页面： 👉 https://github.com/gohugoio/hugo/releases

  2. 下载适合你的版本（64 位 Windows）：

    • 一般选择 hugo_extended_x.xx.x_Windows-64bit.zip（带 extended 的版本，支持 SCSS）。

  3. 解压后会得到一个 hugo.exe。

  4. 把 hugo.exe 放到一个目录，比如 C:\Hugo\bin\。

  5. 配置环境变量：

    • 在 环境变量 → Path 里添加 C:\Hugo\bin\

  6. 打开 cmd 或 powershell，输入：

    hugo version

    如果显示版本号，就装好了 ✅

    本来是打算将hugo部署到云服务器的，避免更换设备需要重新部署hugo，将构建网站这一功能放在云端，但是因为之前的设想是使用webdav来将本地文件同步到云端，云端自动进行构建和更新，这样就可以保证我在多台设备上更快捷创作。

    实际上GPT建议我不要用webdav，对冲突不友好，而且无法感知“已同步”从而自动化，建议我使用git。经过一番考虑，还是决定使用本地编辑+本地构建+云端push的思路，这样有以下几个好处：

    1. 文件都在自己手里，可以通过传输、U盘、坚果云、小米云等多种方式进行备份，不用害怕网站被封/服务器过期等情况；
    2. 这种方式转移成本低，一个是资料都在自己手里，一个是分布式存储，还有一个就是我不一定会一直使用云端服务器，有可能用回github，也可能自己搭建一个便宜的服务器；

好的，我现在已经下载好了hugo、git、Python，oss2库，使用hugo构建静态网页还差什么？

ChatGPT 说：

很好 👍 你现在已经具备了完整的基础环境：

  • Hugo → 负责把 Markdown 文件生成静态网页
  • Git → 负责版本管理、推送到远程仓库（比如 GitHub、云服务器）
  • Python + oss2 → 负责脚本化上传到阿里云 OSS

接下来要完整跑通 Hugo 构建静态网页，还差几个关键点：

✅ 1. Hugo 站点初始化

在你打算存放博客的文件夹里执行：

hugo new site myspace

它会生成一个 Hugo 项目的目录结构。

✅ 2. 选择并安装主题

Hugo 本身是引擎，还需要主题才能美化网页。

进入 myspace 目录后：

cd myspace
git init
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke

然后编辑 hugo.toml（在项目根目录），加上：

theme = 'ananke'

✅ 3. 新建文章（Markdown 文件） 

hugo new posts/first.md

这会在 content/posts/ 下生成一个 Markdown 文件，你可以直接编辑它。

✅ 4. 本地预览 

hugo server -D

然后浏览器打开 http://localhost:1313，就能看到效果。

✅ 5. 生成静态网页 

hugo

生成的静态文件会放到 public/ 文件夹里，这个文件夹就是要 同步/上传到云服务器或 OSS 的内容。

4. Git

typora通用设置

image-20251001105844266

typora上传设置，命令出填写自己的脚本位置

image-20251001105435167

下载oss2

命令行输入pip install oss2

配置OSS AccessKey位环境变量

用户变量和系统变量都可以

image-20251001105123306

二、搭建云端Git

绝大多数 Linux 发行版默认仓库里都有 Git，直接用包管理器安装：

Ubuntu / Debian 系 

sudo apt update
sudo apt install git -y

CentOS / Rocky / AlmaLinux 

sudo yum install git -y

安装完成后检查版本：

git --version

（只要显示版本号就说明安装成功了，比如 git version 2.43.0）

三、创建一个 Git 专用用户（推荐）

为了安全起见，最好不要用 root 用户来托管 Git 仓库。新建一个 git 用户：

sudo adduser git

（按提示设置密码，可以一路回车跳过详细信息）

然后切换到 git 用户：

su - git

四、初始化裸仓库

我们先建一个仓库目录（裸仓库，不带工作区，用于 push/pull）：

mkdir -p ~/repos/blog.git
cd ~/repos/blog.git
git init --bare

这样，你的云端 Git 仓库就创建好了，地址是：

/home/git/repos/blog.git

五、在本地测试连接

在你本地电脑（假设已安装 Git）上，添加远程仓库：

cd ~/Cloud   # 你的文章目录
git init
git remote add origin ssh://git@你的云服务器IP:/home/git/repos/blog.git

第一次连接时需要输入 git 用户密码（或配置 SSH key 登录，这个后面可以优化）。

image-20250926131723615

六、验证推送

本地提交并推送一篇测试文章：

git add .
git commit -m "first commit"
git push origin master

如果能成功推送，就说明你的云服务器 Git 服务搭建成功了 🎉。

因为没有创建工作区，所以云服务器上是看不到提交内容的；

可以通过一下命令来验证是否成功：

```

git status git log –oneline

```

如果显示有提交记录，说明本地已经 commit 了。

12

git remote -v ，确保远程地址指向云服务器裸仓库