cguertz/cguertin.dev

基于Hugo的个人网站Docker镜像

镜像概述

本镜像基于Hugo（高性能静态网站生成器）构建，旨在提供快速部署个人网站的解决方案。Hugo以构建速度快、配置灵活著称，适合创建个人博客、作品集展示、个人简历或小型项目文档站点，生成的静态页面加载迅速且服务器资源占用低。

核心功能与特性

• 高效构建：基于Hugo最新稳定版本，利用其并行构建能力，快速生成静态网站内容
• Markdown支持：原生支持Markdown格式内容编写，降低内容维护门槛，便于版本控制
• 主题生态：兼容Hugo官方主题库，支持通过环境变量或配置文件快速切换主题
• 轻量部署：输出纯静态HTML/CSS/JS文件，无需动态服务器支持，可直接通过Nginx、CDN或静态托管服务（如GitHub Pages）部署
• 自定义配置：支持挂载本地配置文件（config.toml/json/yaml）及内容目录，实现个性化网站设置

使用场景

• 个人博客系统搭建（技术分享、生活记录等）
• 设计师/开发者作品集展示页面
• 简洁的个人简历或个人介绍主页
• 开源项目的轻量级文档站点

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动个人网站容器，默认使用内置示例内容和主题：

bash
docker run -d \
  --name hugo-personal-site \
  -p 8080:80 \
  username/hugo-personal-website:latest

访问 http://localhost:8080 即可查看网站效果。

挂载自定义内容与配置

若需使用本地内容（如文章、图片）和自定义配置，可通过 -v 参数挂载目录：

bash
docker run -d \
  --name hugo-personal-site \
  -p 8080:80 \
  -v /path/to/local/content:/app/content \  # 本地内容目录（Markdown文章、图片等）
  -v /path/to/local/config.toml:/app/config.toml \  # 自定义配置文件
  -v /path/to/local/themes:/app/themes \  # 本地主题目录（如需使用自定义主题）
  username/hugo-personal-website:latest

环境变量配置

通过环境变量调整网站基础设置（优先级：环境变量 > 配置文件）：

示例（指定主题和语言）：

bash
docker run -d \
  --name hugo-personal-site \
  -p 8080:80 \
  -e HUGO_THEME="minimal" \
  -e HUGO_LANGUAGE="zh-cn" \
  -e HUGO_TITLE="我的个人博客" \
  username/hugo-personal-website:latest

Docker Compose配置示例

创建 docker-compose.yml 文件简化部署与管理：

yaml
version: '3.8'

services:
  hugo-site:
    image: username/hugo-personal-website:latest
    container_name: hugo-personal-site
    ports:
      - "80:80"  # 映射到主机80端口（需root权限或调整端口）
    volumes:
      - ./content:/app/content       # 本地内容目录（建议Git版本控制）
      - ./config.toml:/app/config.toml  # 核心配置文件
      - ./themes:/app/themes         # 主题目录（可存放多个主题）
      - ./static:/app/static         # 静态资源（如CSS覆盖、图片库）
    environment:
      - HUGO_THEME=terminal          # 使用"terminal"主题
      - HUGO_BASEURL=https://blog.example.com  # 生产环境URL
      - HUGO_LANGUAGE=zh-cn          # 中文语言配置
    restart: unless-stopped  # 容器退出时自动重启（除手动停止外）

启动服务：

bash
docker-compose up -d

注意事项

1. 内容目录结构：本地挂载的content目录需遵循Hugo标准结构（如content/posts/存放博客文章），具体可参考Hugo官方文档
2. 主题安装：若使用第三方主题，需先将主题文件下载至本地themes目录（可通过git clone获取Hugo主题库项目）
3. 性能优化：生产环境建议配合Nginx反向代理，启用Gzip压缩和HTTP/2，进一步提升访问速度
4. 更新策略：如需更新Hugo版本或镜像，建议先备份本地内容与配置文件，再拉取新版本镜像重启容器