HUGO创建网站

HUGO创建网站

第一步:在Gitee 新建空仓库

以 Gitee 为例:

  1. 登录 GitHub,右上角点「+」→「New repository」。 «««< HEAD
  2. 仓库名随便起,比如 my-hugo-blog
  3. 选择选 Private,后面要配置 SSH 密钥
  4. 点击「Create repository」,记下仓库地址 =======
  5. 仓库名随便起,比如 hugo-build

a0cfb9f (更新文章)

第二步:服务器 Hugo 站点绑定并推送到仓库

在你的服务器 /var/www/my-site 目录操作:

1. 初始化 Git 仓库

cd /var/www/my-site
# 初始化 Git(如果之前没做过)
git init

2. 配置 Git 身份

# 添加自建 Gitea 远程(SSH 方式)
git remote add origin ssh://git@127.0.0.1:2627/Roamer/hugo-my-site.git

3. 本地生成 SSH 密钥(免密)

把公钥复制,到 Gitea 网页:

  • 右上角头像 → 设置 → SSH 密钥 → 添加 → 粘贴 → 保存

3. 本地推送到自建仓库

git push -u origin main

(分支是 main,不是 master)


«««< HEAD

六、云服务器拉取并自动发布 Hugo(关键)

1. 服务器也配置 SSH 免密

同样把公钥添加到 Gitea 的 root 账号 SSH 密钥

2. 服务器测试克隆

3. 自动更新脚本 /opt/update-hugo.sh

#!/bin/bash
cd /var/www/my-site
git pull origin main
hugo --minify
chown -R www-data:www-data /var/www/my-site/public

授权:

chmod +x /opt/update-hugo.sh

七、思源笔记 Hugo 插件设置

  • Hugo 仓库路径:本地 hugo-my-site 目录
  • 远程仓库地址:ssh://git@你的服务器 IP:222/root/hugo-my-site.git
  • 勾选:导出后自动提交并推送

一、前置准备(Windows 本地)

1. Windows 安装 Git

必须装 Git,插件依赖 Git 执行提交、推送操作

  1. 下载:https://git-scm.com/download/win
  2. 默认下一步安装即可,安装后重启思源笔记
  3. 打开 Windows cmd/PowerShell,输入 git --version,能输出版本号即为正常

2. Windows 配置 SSH 密钥(免密拉 / 推 Gitea)

避免每次输账号密码,同时后面 Actions 远程部署也要用到密钥

  1. 打开 Git Bash(开始菜单找到)

  2. 生成密钥(一路回车,不要设置密码)

  3. 复制公钥全部内容id_rsa.pub 用记事本打开全选复制)

3. Gitea 添加 Windows 公钥

  1. 浏览器打开你的 Gitea 地址 http://服务器IP:3000 登录账号
  2. 右上角头像 → 设置SSH/GPG 密钥
  3. 粘贴刚才复制的公钥,填写标题(如 Windows-PC)→ 点击添加密钥

二、Windows 本地克隆 Gitea 的 hugo-my-site 仓库

1. 选一个本地文件夹存放仓库

示例路径(自行替换,建议纯英文、无空格、无中文):D:\hugo-my-site

2. Git Bash 执行克隆命令

  1. 右键文件夹 → Git Bash Here

  2. Windows 记事本保存的文件换行符、编码会导致 SSH 不识别,不要用 notepad 编辑:
    先删掉旧配置文件

    rm -f ~/.ssh/config
    用 Git Bash 内置编辑器新建(推荐)

    vim ~/.ssh/config

    按 Esc,输入 :wq 回车保存退出。如果用txt记事本编辑了文档,注意删除.txt后缀

  3. 在 Gitea 打开你的 hugo-my-site 仓库,复制 SSH 地址(优先用 SSH,不要用 HTTP)
    格式示例:git@服务器IP:用户名/hugo-my-site.git

    1. 执行克隆:

末尾 . 表示直接克隆到当前文件夹,不用新建子目录

  1. 测试拉取 / 推送:
git pull

无报错、不弹密码框,说明免密配置成功。

3. 确认本地仓库目录结构

进入 D:\hugo-my-site,能看到 Hugo 原有目录:contentthemesconfig.tomlstatic 等,和服务器仓库一致即可。

=======

a0cfb9f (更新文章)


三、思源笔记 Hugo 插件核心配置(重点)

打开思源笔记 → 左上角商店 → 已安装 → 找到 Hugo 发布 插件 → 进入设置

按下面逐项填写,严格对应

1. 基础路径配置

  • Hugo 仓库路径:填写你本地克隆的完整路径,示例:D:\Git\hugo-my-site

    必须是绝对路径,Windows 用反斜杠

  • 文章内容目录:Hugo 默认文章目录,绝大多数场景填:content/post

    如果你的旧文章不在 post 下,按你实际目录填写

2. 提交与推送配置

  • Git 提交信息模板:默认即可,例:docs: {title}
  • 导出后自动提交:✅ 开启
  • 导出后自动推送到远程仓库:✅ 开启
  • 远程仓库名称:默认 origin(不用改)
  • 分支名称:填你仓库主分支(一般是 main / master,以 Gitea 仓库为准)

3. 图片 & 格式配置(避坑必开)

  • 默认标记为草稿:根据需求勾选(不想前台显示就开,发布再取消)
  • 隐藏默认图片提示文本:✅ 必须开启(解决思源图片导出乱码 / 错位)
  • 其余选项保持默认即可

4. 保存设置

全部填完 → 点击保存


Friday, May 29, 2026