HUGO创建网站
第一步:在Gitee 新建空仓库
以 Gitee 为例:
- 登录 GitHub,右上角点「+」→「New repository」。 «««< HEAD
- 仓库名随便起,比如
my-hugo-blog。 - 选择选 Private,后面要配置 SSH 密钥
- 点击「Create repository」,记下仓库地址 =======
- 仓库名随便起,比如
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 执行提交、推送操作
- 下载:https://git-scm.com/download/win
- 默认下一步安装即可,安装后重启思源笔记
- 打开 Windows cmd/PowerShell,输入
git --version,能输出版本号即为正常
2. Windows 配置 SSH 密钥(免密拉 / 推 Gitea)
避免每次输账号密码,同时后面 Actions 远程部署也要用到密钥
打开 Git Bash(开始菜单找到)
生成密钥(一路回车,不要设置密码)
复制公钥全部内容(
id_rsa.pub用记事本打开全选复制)
3. Gitea 添加 Windows 公钥
- 浏览器打开你的 Gitea 地址
http://服务器IP:3000登录账号 - 右上角头像 → 设置 → SSH/GPG 密钥
- 粘贴刚才复制的公钥,填写标题(如
Windows-PC)→ 点击添加密钥
二、Windows 本地克隆 Gitea 的 hugo-my-site 仓库
1. 选一个本地文件夹存放仓库
示例路径(自行替换,建议纯英文、无空格、无中文):D:\hugo-my-site
2. Git Bash 执行克隆命令
右键文件夹 → Git Bash Here
Windows 记事本保存的文件换行符、编码会导致 SSH 不识别,不要用 notepad 编辑:
先删掉旧配置文件rm -f ~/.ssh/config
用 Git Bash 内置编辑器新建(推荐)vim ~/.ssh/config
按 Esc,输入 :wq 回车保存退出。如果用txt记事本编辑了文档,注意删除.txt后缀
在 Gitea 打开你的
hugo-my-site仓库,复制 SSH 地址(优先用 SSH,不要用 HTTP)
格式示例:git@服务器IP:用户名/hugo-my-site.git- 执行克隆:
末尾
.表示直接克隆到当前文件夹,不用新建子目录
- 测试拉取 / 推送:
git pull
无报错、不弹密码框,说明免密配置成功。
3. 确认本地仓库目录结构
进入 D:\hugo-my-site,能看到 Hugo 原有目录:content、themes、config.toml、static 等,和服务器仓库一致即可。
=======
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. 保存设置
全部填完 → 点击保存。