ginuerzh/blog.ginuerzh.xyz

blog.ginuerzh.xyz Docker镜像文档

镜像概述

blog.ginuerzh.xyz是一个面向个人用户的轻量级博客系统Docker镜像，旨在提供简单、高效的博客站点部署方案。该镜像封装了完整的博客运行环境，用户无需手动配置依赖，通过Docker即可快速搭建属于自己的个人博客，适用于技术爱好者、开发者及需要个人内容发布平台的用户。

核心功能与特性

• 轻量级部署：基于精简基础镜像构建，资源占用低，启动速度快，适合个人服务器或云主机环境部署。
• 简化配置：内置默认配置模板，支持通过环境变量或配置文件自定义博客信息（如标题、作者、主题等），无需复杂的手动配置。
• 静态页面支持：可能集成静态页面生成功能，减少服务器动态资源消耗，提升博客访问速度。
• 数据持久化：支持通过Docker卷挂载博客内容目录，确保博客文章、配置等数据持久化存储，避免容器重启导致数据丢失。
• 跨平台兼容：遵循Docker标准化部署，支持在Linux、macOS、Windows等主流操作系统的Docker环境中运行。

使用场景与适用范围

• 个人博客搭建：适合个人用户快速创建技术博客、生活记录博客等个人内容发布平台。
• 轻量级站点部署：用于搭建小型技术分享站点、个人作品集展示页面等低流量内容站点。
• 开发测试环境：作为博客系统开发或主题调试的临时测试环境，简化本地开发流程。

使用方法与配置说明

基本部署（docker run）

通过以下命令快速启动博客服务：

bash
docker run -d \
  --name blog-ginuerzh \
  -p 8080:80 \
  -v /path/to/blog/data:/app/data \
  -e BLOG_TITLE="My Personal Blog" \
  -e AUTHOR="John Doe" \
  docker.xuanyuan.run/blog.ginuerzh.xyz:latest

参数说明：

• -p 8080:80：将容器内80端口映射到主机8080端口，通过http://localhost:8080访问博客。
• -v /path/to/blog/data:/app/data：挂载主机目录到容器内/app/data，用于持久化存储博客文章、配置等数据。
• -e BLOG_TITLE：设置博客标题（可选，默认值："My Blog"）。
• -e AUTHOR：设置博客作者名称（可选，默认值："Admin"）。

Docker Compose配置

创建docker-compose.yml文件，简化多环境部署：

yaml
version: '3'
services:
  blog:
    image: docker.xuanyuan.run/blog.ginuerzh.xyz:latest
    container_name: blog-ginuerzh
    ports:
      - "80:80"  # 直接使用主机80端口（需确保无端口冲突）
    volumes:
      - ./blog-data:/app/data  # 当前目录下blog-data文件夹存储数据
    environment:
      - BLOG_TITLE="技术博客"
      - AUTHOR="技术爱好者"
      - THEME="default"  # 可选，指定博客主题（默认：default）
    restart: unless-stopped  # 容器退出时自动重启

启动服务：

bash
docker-compose up -d

核心配置参数（环境变量）

数据持久化

博客的文章内容、配置文件等数据存储在容器内/app/data目录，建议通过卷挂载实现持久化，避免容器删除或升级导致数据丢失。挂载方式参考上述docker run或docker-compose示例中的-v参数配置。

注意事项

• 首次启动后，可通过访问博客站点首页或指定管理路径（如http://localhost/admin）进行初始配置（具体路径请参考镜像内置文档）。
• 若需自定义主题或插件，可将主题文件放置于挂载的数据卷中对应目录（通常为/app/data/themes）。
• 生产环境部署时，建议结合Nginx反向代理配置HTTPS，提升站点安全性。