安装 Hugo
文章目录
- 准备服务器
- 安装Go
- Hugo版本类型区别
- 下载Hugo
- 创建新站点
- 添加主题
- 添加基础配置
- 创建示例内容
- 启动本地服务器
准备服务器
系统版本：Rocky Linux9.5mini 2C4G-40G硬盘
sed -i 's/^SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config && sudo setenforce 0
systemctl disable --now firewalld
dnf install -y wget tar zip unzip chrony nodejs npm
# 时间同步
bash -c 'echo "server ntp.ntsc.ac.cn iburst" >> /etc/chrony.conf'
systemctl restart chronyd
chronyc sources -v
chronyc tracking
安装Go
dnf install golang -y
# 配置go国内代理
echo "export GOPROXY=https://goproxy.cn,direct" >> ~/.bashrc
source ~/.bashrc # 立即生效
Hugo版本类型区别
| 版本类型 | 功能特点 | 适用场景 |
|---|---|---|
hugo_\*.tar.gz（标准版） | 仅支持基本功能（Markdown → HTML），不支持 SCSS/SASS 编译 | 纯静态站点，无需 CSS 预处理 |
hugo_extended_\*.tar.gz（扩展版） | 包含 LibSASS/Dart Sass，支持 SCSS/SASS 编译 | 使用 SCSS/SASS 的主题（如 reimu 主题） |
hugo_extended_withdeploy_\*.tar.gz | 扩展版 + 内置部署工具（如 Hugo Deploy） |
下载Hugo
wget https://github.com/gohugoio/hugo/archive/refs/tags/v0.147.6.tar.gz
tar -zxvf v0.147.6.tar.gz
cd hugo-0.147.6
go install# 验证安装
~/go/bin/hugo version# 将 Hugo 加入系统 PATH
echo 'export PATH=$PATH:$HOME/go/bin' >> ~/.bashrc
source ~/.bashrc
hugo version
创建新站点
hugo new site mysite
cd mysite
# 会生成如下目录结构：
mysite/ # 项目根目录
├── archetypes/ # 内容模板（Front Matter预设）
├── assets/ # 需要Hugo管道处理的静态资源（SCSS/JS等）
├── content/ # 网站内容（Markdown文件）
├── data/ # 自定义数据文件（YAML/JSON/TOML）
├── hugo.toml # 主配置文件（旧版可能是config.toml）
├── i18n/ # 国际化翻译文件
├── layouts/ # 自定义模板（覆盖主题默认布局）
├── static/ # 静态文件（直接复制到输出目录）
└── themes/ # 存放主题的目录
添加主题
更多主题可以浏览 Hugo 官方主题站：https://themes.gohugo.io/
cd mysite# 添加示例主题，主题贡献者给出的便捷安装命令
npm create thulite@latest -- --template dokscd thulite-project
# 安装项目依赖
npm install
# 启动开发服务器
npm run dev# 编辑 hugo.toml，添加主题配置
echo 'theme = "LoveIt-0.3.0"' >> hugo.toml
添加基础配置
编辑hugo.toml
[root@192 mysite]# pwd
/root/hugo-0.147.6/mysite[root@192 mysite]# cat hugo.toml
baseURL = "http://192.168.226.158:1313/"
languageCode = "en-us"
title = "My Hugo Site"
theme = "LoveIt-0.3.0"
创建示例内容
生成一篇测试文章：
hugo new posts/welcome.md
编辑 content/posts/welcome.md：
[root@192 mysite]# cat content/posts/welcome.md
+++
date = '2025-05-30T00:45:13+08:00'
draft = false
title = 'Welcome'
+++
## 这是一篇测试文章欢迎来到我的 Hugo 网站！这里是一些测试内容：- Hugo 是一个快速的静态网站生成器
- PaperMod 是一个简洁美观的主题
- 这里使用了 Markdown 格式### 代码示例
```go
package mainimport "fmt"func main() {fmt.Println("Hello, Hugo!")
}
```
启动本地服务器
hugo server -D --bind=0.0.0.0 --disableFastRender --baseURL=http://192.168.226.158
浏览器访问站点：http://192.168.226.158
启动本地服务器*
hugo server -D --bind=0.0.0.0 --disableFastRender --baseURL=http://192.168.226.158
浏览器访问站点：http://192.168.226.158
浏览器访问文章内容：http://192.168.226.158:1313/posts/welcome/