davidforster/github-pages

本地GitHub Pages开发的Docker容器

https://images.microbadger.com/badges/image/davidforster/github-pages.svg](https://microbadger.com/images/davidforster/github-pages "在microbadger.com获取你自己的镜像徽章")

概述

这是一个基于Alpine系统的轻量级容器，用于本地GitHub Pages开发，帮助开发者在本地预览和测试GitHub Pages站点，确保环境与线上一致。

核心功能

• 轻量级：基于Alpine系统，镜像体积小、启动速度快
• 版本兼容：标签与GitHub Pages gem版本保持一致，避免环境差异问题
• 测试支持：未挂载源文件时提供默认index.html页面，验证容器运行状态
• 端口暴露：开放Jekyll默认端口4000，支持端口映射
• 卷管理：定义源文件和生成文件卷，方便文件交互

使用场景

• 本地开发GitHub Pages站点时快速搭建一致环境
• 预览站点效果，提前排查格式或功能问题
• 团队协作时统一开发环境，减少环境差异导致的冲突

配置说明

Docker使用

拉取镜像

拉取最新版本：

bash
docker pull davidforster/github-pages

拉取指定版本（替换nn为目标版本）：

bash
docker pull davidforster/github-pages:nn

运行容器

bash
docker run -p 4000:4000 davidforster/github-pages

未挂载源文件时，容器会生成默认测试页面，访问http://localhost:4000可验证运行状态。

Docker Compose配置

在docker-compose.yml中添加以下服务：

yaml
services:
  github-pages:
    image: davidforster/github-pages
    ports:
      - "4000:4000"
    volumes:
      - .:/home/jekyll/src

卷说明

• 源文件挂载路径：/home/jekyll/src（本地项目目录映射至此）
• 生成文件输出路径：/srv（可从中获取静态站点文件）

端口说明

暴露端口4000（Jekyll服务默认端口），可通过-p 本地端口:4000映射到本地。

用户说明

Jekyll进程以jekyll用户身份运行，该用户在镜像构建时创建，确保运行安全性。

许可证

本项目采用MIT许可证授权。