bretfisher/jekyll-serve

Jekyll Docker容器镜像（仅用于本地开发，不用于服务器）

镜像概述和主要用途

本镜像提供了运行在Docker容器中的最新版Jekyll，旨在简化静态站点生成器(SSG)的本地开发流程。它将Jekyll环境容器化，避免了本地环境配置冲突，让开发者能够快速启动Jekyll开发环境。注意：此镜像仅适用于本地开发场景，不建议用于生产服务器部署。

项目地址：https://github.com/BretFisher/jekyll-serve

核心功能和特性

• 最新Jekyll版本：内置当前最新稳定版Jekyll，确保支持最新功能和安全更新
• 容器化环境：通过Docker隔离开发环境，消除本地系统依赖冲突，实现"一次配置，多环境一致"
• 开发友好设计：默认配置适合本地开发流程，支持Jekyll的实时重载功能，修改文件后自动刷新预览
• 轻量部署：镜像体积优化，启动快速，资源占用低

使用场景和适用范围

适用场景

• 个人博客、静态网站的本地开发和调试
• Jekyll主题开发与测试
• 需要快速搭建Jekyll环境的教学或演示场景
• 团队协作中统一开发环境，避免"在我电脑上能运行"问题

适用范围

• 静态站点开发者（SSG开发者）
• 熟悉Jekyll但希望简化环境配置的用户
• 需要临时使用Jekyll而不想在本地安装完整依赖的场景

不适用场景：生产环境服务器部署、高并发访问的静态站点服务

使用方法和配置说明

基本使用步骤

1. 确保本地已安装Docker和Docker Compose
2. 准备Jekyll项目目录（若无可通过镜像初始化新项目）
3. 通过docker run命令启动容器，挂载本地项目目录并映射端口

Docker Run示例

启动现有Jekyll项目

bash
# 进入本地Jekyll项目目录
cd /path/to/your/jekyll/project

# 启动容器，映射4000端口（Jekyll默认开发端口），挂载当前目录到容器内/site
docker run -p 4000:4000 -v $(pwd):/site bretfisher/jekyll-serve

初始化新项目

若本地无Jekyll项目，可通过容器初始化：

bash
# 创建并进入项目目录
mkdir my-jekyll-site && cd my-jekyll-site

# 运行容器初始化Jekyll项目（需挂载空目录并执行jekyll new命令）
docker run --rm -v $(pwd):/site bretfisher/jekyll-serve jekyll new .

访问开发服务器

容器启动后，通过浏览器访问 http://localhost:4000 即可预览Jekyll站点，修改本地项目文件后将自动触发站点重建和页面刷新。

自定义配置

环境变量

目前镜像未提供额外环境变量配置，主要通过挂载本地_config.yml文件实现Jekyll配置自定义。

端口映射

默认Jekyll开发服务器监听容器内4000端口，可通过-p参数自定义本地映射端口，例如映射到8080端口：

bash
docker run -p 8080:4000 -v $(pwd):/site bretfisher/jekyll-serve

自定义Jekyll命令

可在启动容器时指定额外Jekyll命令参数，例如指定配置文件或启用调试模式：

bash
docker run -p 4000:4000 -v $(pwd):/site bretfisher/jekyll-serve jekyll serve --config _config.dev.yml --verbose

注意事项

• 本地项目目录需有正确的Jekyll项目结构（包含_config.yml、Gemfile等）
• 首次启动时容器会自动安装Gemfile中指定的依赖，可能需要几分钟时间
• 若修改Gemfile，需重启容器以重新安装依赖
• 镜像仅用于本地开发，生产环境建议使用Jekyll生成静态文件后通过Nginx等服务器部署