spurin/hexo

Hexo 🐋

镜像概述和主要用途

本镜像为Hexo博客框架的Docker化实现，集成了https://github.com/jaredly/hexo-admin%E7%AE%A1%E7%90%86%E7%95%8C%E9%9D%A2%E3%80%82%E5%8F%AF%E7%9B%B4%E6%8E%A5%E4%BB%8Ehttps://hub.docker.com/r/spurin/hexo/%E8%8E%B7%E5%8F%96%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E5%BF%AB%E9%80%9F%E6%90%AD%E5%BB%BA%E5%92%8C%E7%AE%A1%E7%90%86%E5%8D%9A%E5%AE%A2%EF%BC%8C%E5%B9%B6%E6%94%AF%E6%8C%81%E5%86%85%E5%AE%B9%E9%83%A8%E7%BD%B2%E5%88%B0GitHub/GitLab%E7%AD%89%E5%B9%B3%E5%8F%B0%E3%80%82

注意：最新更新将Node版本锁定为13-slim（而非默认的slim，当前为14版本）。虽然Hexo大部分功能在14版本下可正常工作，但存在hexo deploy命令无法使用的已知问题，详见https://github.com/hexojs/hexo/issues/4275%E3%80%82

核心功能和特性

• 集成Hexo博客框架与Hexo Admin管理界面，提供可视化博客管理
• 支持自定义主题安装和配置
• 自动生成部署密钥，方便与GitHub/GitLab集成
• 通过环境变量配置服务器端口、Git用户信息等
• 支持插件扩展，通过requirements.txt自动安装指定插件
• 数据持久化存储，博客内容保存在挂载卷中

使用场景和适用范围

• 个人博客搭建和管理
• 静态网站生成与部署
• 开发环境中快速测试Hexo主题和插件
• 需要简化博客部署流程的用户

使用方法和配置说明

开始使用

创建新的博客容器，需替换domain.com为实际域名，通过-v指定本地博客目录，并配置Git用户信息：

bash
docker create --name=hexo-domain.com \
-e HEXO_SERVER_PORT=4000 \
-e GIT_USER="Your Name" \
-e GIT_EMAIL="your.email@domain.tld" \
-v /blog/domain.com:/app \
-p 4000:4000 \
spurin/hexo

若/app目录（本地对应/blog/domain.com）未配置博客，容器启动时会自动创建博客并安装Hexo-Admin：

bash
docker start hexo-domain.com

访问容器

如需进行进一步配置（如安装自定义主题），可通过以下命令进入容器（卷中修改会持久化）：

bash
docker exec -it hexo-domain.com bash

GitHub/GitLab部署密钥

部署密钥在初始配置时自动生成，可在应用卷的.ssh目录中查看，或通过日志获取SSH公钥：

bash
docker logs --follow hexo-domain.com

安装主题

以https://github.com/ppoffice/hexo-theme-hueman%E4%B8%BB%E9%A2%98%E4%B8%BA%E4%BE%8B%EF%BC%8C%E5%AE%89%E8%A3%85%E6%AD%A5%E9%AA%A4%E5%A6%82%E4%B8%8B%EF%BC%9A

1. 克隆主题到应用卷的themes目录：

   bash
   cd /app
   git clone https://github.com/ppoffice/hexo-theme-hueman.git themes/hueman
   

2. 修改应用目录下的_config.yml，更新主题配置：

   yaml
   theme: hueman
   

3. 启用主题默认配置：

   bash
   mv themes/hueman/_config.yml.example themes/hueman/_config.yml
   

4. 退出容器并重启：

   bash
   exit
   docker restart hexo-domain.com
   

访问Hexo

通过以下地址访问默认博客界面：
http://<ip_address>:4000

访问Hexo-Admin

通过以下地址访问管理界面：
http://<ip_address>:4000/admin

生成内容

执行以下命令生成静态内容：

bash
docker exec -it hexo-domain.com hexo generate

部署生成的内容

执行以下命令部署内容：

bash
docker exec -it hexo-domain.com hexo deploy

添加Hexo插件

如需添加特定插件，在应用卷中创建requirements.txt文件（如app/requirements.txt），添加插件名称：

hexo-generator-json-content

容器启动时会自动安装requirements.txt中指定的插件。