shish2k/shimmie2

Shimmie2 Docker镜像文档

镜像概述

Shimmie2 Docker镜像是Shimmie2图片板系统的容器化分发形式。Shimmie2是一款轻量级、开源的图片管理与展示系统，主要用于构建个人或社区图片画廊，支持图片上传、分类、标签管理、评论互动等功能。该Docker镜像旨在简化Shimmie2的部署流程，通过容器化方式减少环境配置复杂度，实现快速启动和跨平台运行。

核心功能与特性

• 图片管理：支持多格式图片上传、自动缩略图生成、原图与缩略图分离存储
• 内容组织：提供标签系统、分类目录、收藏功能，便于图片检索与整理
• 用户互动：支持用户评论、评分、收藏及社交分享功能
• 权限控制：可配置用户角色与访问权限，支持公开/私有画廊模式
• 扩展性：通过插件系统支持功能扩展，如添加新的图片处理工具或社交功能
• 容器化优势：简化依赖管理，一键部署，支持数据持久化与版本控制

使用场景与适用范围

• 个人图片画廊：用于管理和展示个人摄影作品、插画或收藏图片
• 小型社区图片分享平台：供兴趣小组、创作社区共享图片内容
• 教学/展示用途：用于课程素材、设计作品的在线展示与管理
• 开发测试环境：快速搭建Shimmie2系统进行功能测试或二次开发

使用方法与配置说明

前置要求

• Docker引擎（20.10+版本推荐）
• Docker Compose（可选，用于多容器部署）
• 网络环境：确保容器可访问互联网（用于依赖下载）

基本使用流程

详细部署与配置说明请参考官方文档：https://github.com/shish/shimmie2/wiki/Docker

快速启动示例

通过以下命令可快速启动Shimmie2容器（基础配置）：

bash
docker run -d \
  --name shimmie2 \
  -p 8080:80 \
  -v shimmie2_data:/var/www/html/data \
  -v shimmie2_db:/var/www/html/db \
  shish/shimmie2

说明：

• -p 8080:80：将容器内80端口映射到主机8080端口，通过http://localhost:8080访问
• -v shimmie2_data:/var/www/html/data：持久化存储图片等用户数据
• -v shimmie2_db:/var/www/html/db：持久化存储SQLite数据库文件（默认数据库）

高级配置（使用Docker Compose）

对于需要自定义数据库（如MySQL）或配置环境变量的场景，建议使用docker-compose.yml：

yaml
version: '3'
services:
  shimmie2:
    image: shish/shimmie2
    ports:
      - "80:80"
    volumes:
      - ./data:/var/www/html/data
    environment:
      - DB_TYPE=mysql
      - DB_HOST=db
      - DB_NAME=shimmie2
      - DB_USER=shimmie
      - DB_PASS=secure_password
    depends_on:
      - db
  db:
    image: mysql:5.7
    volumes:
      - db_data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=root_password
      - MYSQL_DATABASE=shimmie2
      - MYSQL_USER=shimmie
      - MYSQL_PASSWORD=secure_password
volumes:
  db_data:

关键配置说明

• 环境变量：支持通过环境变量配置数据库连接（DB_TYPE、DB_HOST、DB_USER等）、管理员账户、存储路径等，具体变量请参考https://github.com/shish/shimmie2/wiki/Docker
• 数据持久化：必须挂载/var/www/html/data目录以保存上传的图片和用户数据，避免容器重启后数据丢失
• 网络配置：根据实际需求调整端口映射，如需HTTPS，可配合Nginx反向代理或添加SSL证书

访问与初始化

容器启动后，通过映射的端口访问应用（如http://localhost:8080），首次访问将进入初始化向导，完成管理员账户设置、基础配置等步骤，即可开始使用Shimmie2图片画廊系统。