zoyo94/zoyo_hexo repository overview

⁠🚀 Zoyo-Hexo Docker 版：极致轻量且深度集成的创作系统

Zoyo-Hexo 官方 Docker 镜像现已全面重构为 v1.1.0 Alpine 版。在保持极小体积的同时，通过 Oh My Zsh 提供了生产级别的交互式终端，旨在为 Hexo 站长提供一个“开箱即用、管理自如”的写作与运维环境。

⁠💎 v1.1.0 核心特性

• 🐳 极致瘦身 (Alpine-Based): 完美迁移至 node:20-alpine 基础镜像，不仅体积骤降，启动速度比 Debian 提高约 40%。
• ⚡ 现代化终端 (Oh My Zsh): 容器内预装 Zsh + Oh My Zsh，并集成了：
  • 自动补全 (Auto-suggestions)
  • 语法高亮 (Syntax-highlighting)
  • Hexo 专属别名: hxc (clean), hxs (server), pm2 list 等一键触达。
• 📝 双编辑器架构: 完美兼容 md-editor-rt (现代级 React 体验) 与 Editor.md (经典极简)，统一后端，数据互通。
• 🛡️ 资产级安全性: 全路径防穿越 (Path Traversal Protection)、DiskStorage 流式上传，确保服务器内存与资产双重安全。
• 📊 状态看板: 后端 3001 端口提供可视化 API 交互文档与实时监控面板。

⁠⚡ 快速开始 (Getting Started)

⁠1. 🐳 一键 Docker 部署

支持 X86_64 与 ARM64 (Apple M 系列 / 树莓派) 全架构运行：

docker run -d \
  -p 4000:4000 -p 3001:3001 \
  --name zoyo_hexo \
  -v ./MD_files:/Hexo-app/blog/source/_posts \
  zoyo94/zoyo_hexo:latest

⁠2. 🏗️ Docker Compose 黄金配置 (推荐)

使用 docker-compose.yml 可以更优雅地管理您的持久化数据和主题配置：

version: '3.8'
services:
  zoyo_hexo:
    image: zoyo94/zoyo_hexo:latest
    container_name: hexo-site
    restart: always
    ports:
      - "4000:4000"   # Hexo 博客预览
      - "3001:3001"   # 编辑器后端看板
    volumes:
      - ./my_posts:/Hexo-app/blog/source/_posts       # 文章存储 (挂载该目录即可持久化)
      - ./_config.yml:/Hexo-app/blog/_config.yml      # Hexo 基础配置
      - ./_config.butterfly.yml:/Hexo-app/blog/_config.butterfly.yml # 主题配置
    stdin_open: true
    tty: true

⁠📖 核心访问入口

⁠🛠️ 进阶运维 (Operations)

⁠进入生产级 Zsh 终端

体验容器内顶配的 Shell 环境：

docker exec -it hexo-site zsh

⁠常用快捷指令 (Aliases)

在容器 Zsh 终端中，您可以享受以下加速指令：

• hxc: 执行 hexo clean
• hxg: 执行 hexo generate
• hxs: 执行 hexo server (预览模式)
• hxl: 查看后端 pm2 日志

⁠📅 更新日志 (Recent Updates)

⁠🏗️ 核心组件致谢 (Core Credits)

本 Docker 镜像集成了以下开源生态的卓越成果：

• Hexo⁠: 高性能静态博客引擎。
• Editor.md⁠ - 开源的可嵌入 Markdown 编辑器（经典版核心）。
• Md-Editor-RT⁠ - 现代化的 React Markdown 编辑器（RT 版核心）。
• Oh My Zsh⁠ - 为容器提供极致终端体验的框架。
• hexo-theme-butterfly⁠: 博客主题。

Designed with ❤️ by zoyo94⁠