想到能否用 docker 运行 Jekyll。因为以前尝试 Jekyll 本地预览时，要装这装那。尤其是 Ruby 版本和 macOS 自带的 Ruby 还不一样，安装过程很折腾。咨询大模型后可行，就开始测试！
参考 B 站资料 1 增加了国内仓库源。添加完成后的配置文件如下：
{
"builder": {
"gc": {
"defaultKeepStorage": "20GB",
"enabled": true
}
},
"experimental": false,
"registry-mirrors": [
"https://docker.1ms.run",
"https://docker.m.daocloud.io",
"https://docker.1panel.live",
"https://dockerproxy.net",
"https://docker.xuanyuan.me",
"https://docker-0.unsee.tech",
"https://registry.cyou"
]
}
主要是添加在 registry-mirrors 下面，其余信息维持原样没有改动。
咨询大模型后，得到拉取镜像命令如下：
docker pull jekyll/jekyll:latest
拉取完成后查看镜像：
~ % docker image ls
REPOSITORY TAG IMAGE ID CREATED SIZE
jekyll/jekyll latest 3c7afda80cab 3 years ago 829MB
执行命令启动容器：
docker run -it -v ~/gdweb/log:/srv/jekyll -p 4000:4000 jekyll/jekyll jekyll serve
报错如下：
docker run -it -v ~/gdweb/log:/srv/jekyll -p 4000:4000 jekyll/jekyll jekyll serve
ruby 3.1.1p18 (2022-02-18 revision 53f5fc4236) [x86_64-linux-musl]
Configuration file: none
Source: /srv/jekyll
Destination: /srv/jekyll/_site
Incremental build: disabled. Enable with --incremental
Generating...
done in 0.036 seconds.
Auto-regeneration: enabled for '/srv/jekyll'
------------------------------------------------
Jekyll 4.2.2 Please append `--trace` to the `serve` command
for any additional information or backtrace.
------------------------------------------------
<internal:/usr/local/lib/ruby/site_ruby/3.1.0/rubygems/core_ext/kernel_require.rb>:85:in `require': cannot load such file -- webrick (LoadError)
from <internal:/usr/local/lib/ruby/site_ruby/3.1.0/rubygems/core_ext/kernel_require.rb>:85:in `require'
from /usr/gem/gems/jekyll-4.2.2/lib/jekyll/commands/serve/servlet.rb:3:in `<top (required)>'
from /usr/gem/gems/jekyll-4.2.2/lib/jekyll/commands/serve.rb:179:in `require_relative'
from /usr/gem/gems/jekyll-4.2.2/lib/jekyll/commands/serve.rb:179:in `setup'
from /usr/gem/gems/jekyll-4.2.2/lib/jekyll/commands/serve.rb:100:in `process'
from /usr/gem/gems/jekyll-4.2.2/lib/jekyll/command.rb:91:in `block in process_with_graceful_fail'
from /usr/gem/gems/jekyll-4.2.2/lib/jekyll/command.rb:91:in `each'
from /usr/gem/gems/jekyll-4.2.2/lib/jekyll/command.rb:91:in `process_with_graceful_fail'
from /usr/gem/gems/jekyll-4.2.2/lib/jekyll/commands/serve.rb:86:in `block (2 levels) in init_with_program'
from /usr/gem/gems/mercenary-0.4.0/lib/mercenary/command.rb:221:in `block in execute'
from /usr/gem/gems/mercenary-0.4.0/lib/mercenary/command.rb:221:in `each'
from /usr/gem/gems/mercenary-0.4.0/lib/mercenary/command.rb:221:in `execute'
from /usr/gem/gems/mercenary-0.4.0/lib/mercenary/program.rb:44:in `go'
from /usr/gem/gems/mercenary-0.4.0/lib/mercenary.rb:21:in `program'
from /usr/gem/gems/jekyll-4.2.2/exe/jekyll:15:in `<top (required)>'
from /usr/gem/bin/jekyll:25:in `load'
from /usr/gem/bin/jekyll:25:in `<main>'
咨询大模型后得到如下方案。依次执行就可以了。其中
cd ~/gdweb/log
# 创建新的 Jekyll 站点
docker run --rm -it -v $(pwd):/srv/jekyll jekyll/jekyll jekyll new . --force
# 安装 webrick
docker run --rm -it -v $(pwd):/srv/jekyll jekyll/jekyll bundle add webrick
# 启动服务
docker run --rm -v $(pwd):/srv/jekyll -p 4000:4000 jekyll/jekyll jekyll serve
其中，第1个命令“创建新的 Jekyll站点”，运行后没有退出，按 ctrl+c 后退出。
3个命令依次执行后，在本地浏览器输入 localhost:4000 就可以看到网页了。
在 github 上创建仓库 blog ，过程略。
然后在本地依次执行以下命令，就可以把内容推动到 github 了。
cd ~/gdweb/blog
git remote add origin git@github.com:georgedonnev2/blog.git
git branch -M master
git status
git add .
git commit -m "1st commit"
git push -u origin master
大致使用以下信息和大模型做交互：
1、用docker-compose运行jekyll latest
2、使用 primer 主题。不适用默认的minima主题
3、docker的持久化目录在 ~/gdweb/blog。而不是日志在 ~/gdweb/blog
4、本地可预览
5、github pages上，仓库是 georgedonnev2/blog ，网站内容在 /docs
6、最精简的配置，先跑起来。
7、只有一个 index.md
在 github.com 上，网站内容放在仓库的 /docs 中。在 Github Pages 中有相关设置的，此处从略。因此折腾了几次，最终可运行以后的目录结构大致如下：
~/gdweb/blog % tree -a -I ".git" -F --gitignore
./
├── .gitignore
├── .nojekyll
└── docs/
├── 404.html
├── Gemfile
├── Gemfile.lock
├── _config.yml
├── about.md
├── docker-compose.yml
├── index.md
├── swug/
│ ├── index.md
│ └── vscode-mac.md
└── wsb/
├── index.md
└── jekyll-local.md
1、.gitignore 的内容如下：
# Jekyll 生成的文件
_site/
.jekyll-cache/
.jekyll-metadata
# 也不一定要忽略
CNAME
2、.nojekyll。要或不要，似乎没有什么影响。
3、docs/Gemfile 的内容如下：
# 要增加 source 否则本地编译时报错
source "https://rubygems.org"
gem "github-pages", group: :jekyll_plugins
gem "github-pages", group: :jekyll_plugins 是复制了 github 上 Primer 主题的内容。在本地编译时要装一堆无关的 theme。尝试精减，但会报错。就这样子，只是 docker compose up 首次多花一些时间，后续再启动时也很快。
4、docs/_config.yml 内容如下：
remote_theme: pages-themes/primer@v0.6.0
plugins:
- jekyll-remote-theme # add this line to the plugins list if you already have one
title: George Donne's Blog # 增加title 否则报错
description: George Donne's Blog # 增加 description 否则报错
repository: georgedonnev2/blog
# 关键：指定源文件目录和输出目录
# source: ./docs # 从 docs 目录读取 markdown 文件
# destination: ./_site # 构建输出到 _site 目录
baseurl: ""
# url: "https://georgedonnev2.github.io"
# 构建配置
markdown: kramdown
kramdown:
input: GFM
hard_wrap: false
# 排除不需要的文件（本地构建时就不会生成到 destination[./_site] 目录中）
exclude:
- docker-compose.yml
- Gemfile
- Gemfile.lock
- README.md
- vendor/
- node_modules/
- .git/
- .github/
# 可选：禁用 GitHub metadata 以避免错误
# github: [metadata] # 如果出现 metadata 错误可以启用
# 禁用其他主题的自动安装
# safe: true
# 设置时区
timezone: Asia/Shanghai
一点点试试。希望有个统一的 _config.yml，适用于 georgedonnev2.github.io/blog 和 CNAME 后的 blog.georgedonne.cn。当前的 _config.yml，在 georgedonnev2.github.io/blog 下的 css 有点不对，比如普通正文匹配到了 p，而不是期望的 .markdown-body p。后续再研究。
5、docker-compose.yml 文件内容如下：
services:
jekyll:
image: jekyll/jekyll:latest
container_name: gdv2blog # 容器名称
ports:
- "4000:4000"
volumes:
- ~/gdweb/blog/docs:/srv/jekyll
command: >
sh -c "
cd /srv/jekyll &&
jekyll build &&
jekyll serve --host 0.0.0.0 --watch --force_polling
"
也是一点点试。后续再好好研究。
先切换到 docs 目录，再执行 docker-compose 命令。如下：
~/gdweb/blog % cd docs
~/gdweb/blog/docs % docker compose up
更新 Gemfile
cd ~/gdweb/log
echo 'gem "jekyll-primer-spec"' >> Gemfile
查看 Gemfile，行末增加了 gem "jekyll-primer-spec"。
更新 _config.yml
先保存一份，mv _config.yml _config.yml_bk
再执行以下命令：
cat > _config.yml << 'EOF'
title: "我的博客"
description: "使用 jekyll-primer-spec 主题"
baseurl: "" # 根路径
# url: "https://georgedonnev2.github.io" # 你的 GitHub Pages 地址
# 主题设置
theme: jekyll-primer-spec
# 构建输出目录（GitHub Pages 使用 docs 目录）
destination: ./docs
# 插件
plugins:
- jekyll-feed
# Markdown 设置
markdown: kramdown
highlighter: rouge
EOF
先注释掉 url: "https://georgedonnev2.github.io"
创建新的首页：
# 备份原来的 index.markdown
mv index.markdown index.markdown.backup
# 创建新的首页
cat > index.md << 'EOF'
---
layout: home
title: 首页
---
# 欢迎来到我的博客
这是一个使用 jekyll-primer-spec 主题的博客。
## 关于
更多内容正在建设中...
EOF
创建 docker_compose.yml
cat > docker-compose.yml << 'EOF'
version: '3'
services:
jekyll:
image: jekyll/jekyll:latest
ports:
- "4000:4000"
volumes:
- ~/gdweb/log:/srv/jekyll
command: >
sh -c "bundle install &&
bundle exec jekyll serve --host 0.0.0.0 --watch --force_polling"
EOF
更新 .gitingnore
cat >> .gitignore << 'EOF'
# Jekyll 生成的文件
_site/
.jekyll-cache/
.jekyll-metadata
# 构建输出目录（docs 需要提交，所以不加 docs/）
EOF
执行 docker-compose up 后报错如下：
~/gdweb/log % docker-compose up
WARN[0000] /Users/george1442/gdweb/log/docker-compose.yml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
[+] Running 2/2
✔ Network log_default Created 0.1s
✔ Container log-jekyll-1 Created 0.1s
Attaching to jekyll-1
jekyll-1 | Fetching gem metadata from https://rubygems.org/..........
jekyll-1 | Could not find gem 'jekyll-primer-spec' in rubygems repository
jekyll-1 | https://rubygems.org/ or installed locally.
jekyll-1 exited with code 7
终止。网络问题，无法访问 github page 228
2026最新零基础安装，10分钟学会跑本地AI/n8n/Ollama —— Docker Desktop 保姆级教学 —— 附汉化+国内镜像源，B站，小in分享，2026-01-09 ↩