fletchto99/hexo-dev-blog

Hexo Dev Blog

该容器将静态博客平台Hexo容器化，支持自定义主题、插件和配置。运行示例可访问[***]

核心功能和特性

• 完整支持Hexo博客平台的容器化部署
• 允许自定义主题、插件和配置
• 自动生成默认配置文件和目录结构
• 支持通过hexo deploy部署到生产环境
• 提供开发环境与生产环境的灵活切换

使用场景

• 博客开发与测试环境搭建
• 快速原型设计和文章预览
• 个人或小型团队的静态博客部署
• 需要隔离环境的Hexo博客开发

使用方法

基本部署命令

bash
docker create \
  --name=blog \
  -v <数据路径>:/config \
  -e PGID=<gid> -e PUID=<uid>  \
  -e HEXO_PLUGINS=<hexo插件> \
  -p 8080:8080 \
  fletchto99/hexo-dev-blog

参数说明

• -p 8080:8080 - 容器运行端口
• -v <数据路径>:/config - 配置文件和生成的博客文件挂载路径

可选参数：

• -e HEXO_PLUGINS - 博客所需的Hexo插件，空格分隔。例如：hexo-sliding-spoiler hexo-wordcount hexo-deploy-rsync

配置目录设置

首次启动容器时，若挂载的config卷为空，将自动生成默认内容，包括：

• config/_config.yml - Hexo配置文件
• config/_posts - Markdown文章存放目录
• config/themes/ - 主题目录（与标准Hexo博客主题目录结构一致）
• config/public - 静态HTML文件生成目录（可复制到生产服务器部署）

高级用法

自定义主题

部分主题需要通过npm install等命令进行设置，步骤如下：

1. 将主题克隆到config/themes/<我的主题>目录
2. 进入Docker控制台，导航至/blog/themes/<我的主题>
3. 在容器内运行所需命令生成必要文件

完成后即可使用该主题，同时需配置主题相关设置。

部署配置

当前容器支持通过hexo-deploy-rsync插件进行博客部署。以下是部署配置示例，其中deploy_key是用于部署到生产服务器的RSA私钥，保存于config/deploy_key，通过挂载卷共享给容器。

yaml
deploy:
  type: rsync
  host: <生产服务器>
  user: <用户名>
  root: <博客目录路径>
  port: 22
  delete: true
  args: "-e ssh -i /config/deploy_key <用户名>@<生产服务器>"
  verbose: true
  ignore_errors: false

部署时，进入容器控制台并运行hexo deploy即可。