xemle/home-gallery

HomeGallery Docker镜像文档

镜像概述

本Docker镜像为开源自托管网络画廊HomeGallery提供容器化部署方案。HomeGallery是一个专注于个人媒体管理的工具，允许用户通过网页界面安全地存储、组织、浏览和分享个人照片与视频。Docker镜像封装了HomeGallery运行所需的全部依赖，简化部署流程，让用户无需手动配置复杂环境即可快速搭建个人媒体画廊。

核心功能与特性

• 自托管架构：数据存储在用户自有服务器，确保隐私安全，避免第三方平台数据泄露风险
• 开源免费：基于MIT许可证开源，代码透明可审计，支持自定义开发与扩展
• 全功能网络画廊：提供直观的网页界面，支持照片/视频预览、分类、搜索和幻灯片播放
• 媒体自动组织：可按时间、位置、标签等维度自动整理媒体文件，简化管理流程
• 跨设备访问：通过浏览器即可在电脑、手机、平板等多设备上访问媒体库
• 轻量级部署：Docker容器化设计，资源占用低，支持在个人服务器、NAS或树莓派等设备运行

使用场景与适用范围

• 个人媒体库管理：整理个人多年积累的照片与视频，构建数字化媒体档案
• 家庭照片共享：为家庭成员提供安全的照片分享平台，无需依赖第三方社交软件
• 小型团队媒体协作：用于工作室、兴趣小组等小型组织存储和共享项目相关媒体素材
• 隐私敏感场景：对数据隐私有较高要求，不愿将个人媒体上传至公有云的用户

部署与使用方法

基本部署（Docker Run）

使用以下命令快速启动HomeGallery容器：

bash
docker run -d \
  --name homegallery \
  -p 8080:80 \
  -v /path/to/your/media:/media \
  -v /path/to/homegallery/data:/app/data \
  homegallery/homegallery

参数说明：

• -d：后台运行容器
• --name homegallery：指定容器名称为homegallery
• -p 8080:80：将容器内80端口映射到主机8080端口（可根据需要修改主机端口）
• -v /path/to/your/media:/media：挂载本地媒体文件目录（存放照片/视频的位置）
• -v /path/to/homegallery/data:/app/data：挂载HomeGallery数据目录（用于持久化配置、缓存等数据）

使用Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  homegallery:
    image: homegallery/homegallery
    container_name: homegallery
    ports:
      - "8080:80"
    volumes:
      - /path/to/your/media:/media
      - /path/to/homegallery/data:/app/data
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

访问与配置

1. 部署完成后，通过浏览器访问 http://<服务器IP>:8080 进入HomeGallery界面
2. 首次使用需完成初始配置（如创建管理员账户、设置媒体库路径等）
3. 系统会自动扫描挂载的/media目录中的媒体文件，生成缩略图并建立索引
4. 通过网页界面可进一步设置媒体分类规则、用户权限、分享链接等功能

配置参数

环境变量

可通过-e参数设置环境变量自定义配置（完整列表请参考HomeGallery官方文档）：

• HG_ADMIN_USER：管理员用户名（默认：admin）
• HG_ADMIN_PASSWORD：管理员密码（首次启动需设置）
• HG_PORT：容器内服务端口（默认：80）
• HG_MEDIA_SCAN_INTERVAL：媒体文件扫描间隔（默认：24h，单位：h/m/s）

示例（自定义管理员账户）：

bash
docker run -d \
  --name homegallery \
  -p 8080:80 \
  -v /path/to/your/media:/media \
  -v /path/to/homegallery/data:/app/data \
  -e HG_ADMIN_USER="myadmin" \
  -e HG_ADMIN_PASSWORD="mypassword" \
  homegallery/homegallery

持久化存储

为确保数据不丢失，需持久化挂载以下目录：

• /app/data：HomeGallery应用数据（配置、索引、缩略图等）
• /media：媒体文件存储目录（可替换为用户现有媒体文件夹）

注意事项

• 媒体文件目录应确保有足够的读写权限，容器内用户需能访问挂载的媒体文件
• 首次扫描大量媒体文件时可能需要较长时间，具体取决于文件数量和服务器性能
• 建议定期备份/app/data目录，以防数据丢失
• 如需升级镜像，建议先备份数据，再通过docker pull homegallery/homegallery拉取最新镜像并重启容器