静态博客Docker镜像文档

镜像概述

本镜像专注于简化静态博客的构建与部署流程，集成主流静态网站生成工具（如Hugo、Jekyll）和轻量级Web服务器（如Nginx），提供一站式解决方案。无需复杂的服务器配置，即可快速创建、构建并运行静态博客站点，适合各类静态内容场景的快速上线。

核心功能与特性

• 集成静态生成工具：支持Hugo、Jekyll等主流静态站点生成器，一键构建静态博客内容
• 内置Web服务器：包含Nginx轻量级Web服务器，直接提供静态文件访问服务，无需额外配置
• 轻量级设计：镜像体积小，资源占用低，适合个人服务器或云环境部署
• 灵活配置：支持自定义主题、插件及站点参数，通过环境变量或配置文件轻松调整
• 持久化存储：支持挂载本地目录存储博客源码和生成的静态文件，确保数据不丢失

使用场景与适用范围

• 个人博客：个人博主快速搭建个性化博客，专注内容创作而非服务器维护
• 技术文档站点：开发团队部署项目技术文档、API文档等静态内容站点
• 小型静态网站：企业宣传页、个人作品集、活动介绍等无需动态交互的小型站点
• 学与演示**：开发者学**静态网站构建流程的演示环境

使用方法与配置说明

1. 获取镜像

bash
docker pull [镜像名称]  # 替换为实际镜像名称，如static-blog:latest

2. 基本运行示例

直接运行生成并启动博客

bash
docker run -d \
  -p 80:80 \  # 映射容器80端口到主机80端口
  -v /本地博客源码目录:/app/source \  # 挂载本地博客源码（如Hugo/Jekyll项目）
  -v /本地生成文件目录:/app/public \  # 挂载生成的静态文件目录（可选，用于持久化）
  --name my-static-blog \
  [镜像名称]

指定静态生成器

通过GENERATOR环境变量指定使用的静态生成工具（默认支持hugo、jekyll）：

bash
docker run -d \
  -p 80:80 \
  -v /本地hugo项目:/app/source \
  -e GENERATOR=hugo \  # 指定使用Hugo生成
  [镜像名称]

3. 环境变量配置

4. 高级配置

自定义Nginx配置

如需调整Web服务器配置，可挂载自定义Nginx配置文件：

bash
docker run -d \
  -p 80:80 \
  -v /本地博客源码:/app/source \
  -v /本地nginx.conf:/etc/nginx/conf.d/default.conf \  # 挂载自定义Nginx配置
  [镜像名称]

构建后运行自定义脚本

通过挂载/app/post-build.sh脚本，可在静态文件生成后执行自定义操作（如文件压缩、备份等）：

bash
docker run -d \
  -v /本地博客源码:/app/source \
  -v /本地/post-build.sh:/app/post-build.sh \
  [镜像名称]

注意事项

• 确保本地博客源码目录结构符合所选静态生成器的要求（如Hugo需包含content、themes目录）
• 首次运行时，容器会自动执行构建命令生成静态文件，耗时取决于项目大小
• 如需更新博客内容，修改本地挂载的源码目录后，可通过docker exec [容器名] /app/build.sh重新构建

维护与更新

• 定期拉取最新镜像以获取功能更新：docker pull [镜像名称]
• 通过挂载目录备份博客源码和生成文件，避免数据丢失
• 如需升级静态生成器版本，可通过BUILD_CMD指定具体版本命令（如hugo version 0.111.3）