bayelc/memorygallery repository overview

docker run -d \
  --name memory-gallery \
  -p 8080:8080 \
  -v ./data:/app/data \
  -e TZ=Asia/Shanghai \
  -e MONITOR_USERNAME=admin \
  -e MONITOR_PASSWORD=admin123 \
  --restart unless-stopped \
  bayelc/memorygallery:latest

# 访问
open http://localhost:8080

services:
  memory-gallery:
    image: bayelc/memorygallery:latest
    container_name: memory-gallery
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data      # 数据持久化（媒体文件、数据库、配置均在此目录）
    env_file:
      - .env
    restart: unless-stopped

# 假设你的媒体目录在 /path/to/photos
cp -r /path/to/photos/* "<your-data-dir>/memorygallery-data/data/media/"

> 服务启动时会自动扫描该目录并建立索引，放入照片后无需任何操作。
> 数据目录独立于项目源码，不会随 git 推送或 Docker 镜像分发。

---

## 环境变量

> 完整配置请参考 `.env.example` 模板文件。

| 变量 | 默认值 | 说明 |
|------|--------|------|
| `TZ` | Asia/Shanghai | 时区 |
| `MONITOR_USERNAME` | admin | 管理界面用户名 |
| `MONITOR_PASSWORD` | admin123 | 管理界面密码 |
| `AMAP_API_KEY` | - | 高德地图 API Key（用于地理编码） |
| `LOCAL_LLM_ENABLED` | false | 启用本地 LLM 生成 Caption |
| `LOCAL_LLM_API_URL` | - | 本地 LLM API 地址（如 `http://192.168.1.100:11434`） |
| `LOCAL_LLM_MODEL` | - | LLM 模型名（如 `qwen2.5vl:latest`） |
| `LOCAL_LLM_PROMPT` | - | 自定义 Caption prompt |
| `AI_CAPTION_ENABLED` | false | 启用云端 AI Caption |
| `AI_CAPTION_API_URL` | - | AI Caption API 地址 |
| `AI_CAPTION_API_KEY` | - | AI Caption API Key |
| `AI_CAPTION_MODEL` | - | AI Caption 模型名 |
| `AI_CAPTION_PROMPT` | - | Caption 生成提示词 |
| `BARK_ENABLED` | false | 启用 Bark 告警推送 |
| `BARK_URL` | - | Bark 通知地址（如 `https://api.day.app/YOUR_KEY`） |
| `WECHAT_WEBHOOK_URL` | - | 企业微信 Webhook 通知地址 |
| `MG_HEALTH_INTERVAL_SEC` | 300 | 健康检查上报间隔（秒），设为 0 关闭 |

---

## 配置说明

配置文件位于容器内 `/app/data/config.json`，可通过挂载覆盖：

```json
{
    "server": {
        "port": 8080,
        "host": "0.0.0.0",
        "media_dir": "media",
        "user_media_dir": "media_up",
        "import_dir": "import",
        "sample_dir": "samples"
    },
    "slideshow": {
        "interval": 10,
        "mode": "random",
        "preload_count": 2
    },
    "display": {
        "ken_burns": true,
        "ken_burns_style": "subtle",
        "ken_burns_duration": 6,
        "show_time": true,
        "time_position": "center",
        "date_format": "YYYY年MM月DD日",
        "show_weekday": true
    },
    "advanced": {
        "supported_formats": [".jpg",".jpeg",".png",".webp",".heic",".heif",".dng",".cr2",".cr3",".arw",".nef",".nrw",".raf",".orf",".rw2",".srw",".pef",".mp4",".mov",".avi",".mkv",".webm"],
        "video_transcode": true,
        "video_fps": 30,
        "video_codec": "h264",
        "video_crf": 23
    },
    "features": {
        "sample_mode": true,
        "auto_import": true,
        "watch_interval": 30,
        "play_video": true
    }
}

# 项目源码（git 仓库，Docker 镜像源）
./MemoryGallery/
├── backend/              # Flask 后端代码
├── frontend/             # 前端（HTML/CSS/JS）
├── bundled_samples/      # 项目自带示例库（公开，构建时嵌入镜像）
├── scripts/              # 构建/部署/运维脚本
├── tests/                # pytest 测试用例
├── Dockerfile            # 镜像构建
├── docker-compose.yaml   # 生产部署
└── .github/workflows/    # CI/CD

# 运行时数据（独立目录，git 忽略，不会推送/打包）
<your-data-dir>/memorygallery-data/
├── data/                 # 容器内 /app/data 的实际存储
│   ├── config.json       # 配置文件（运行时生成）
│   ├── media/                # 用户媒体库
│   ├── media_up/            # 用户上传目录
│   ├── import/              # 自动导入监控目录
│   └── samples/             # 用户自定义示例
└── logs/                 # 应用日志、监控日志
    └── memory-gallery.db   # 监控数据库（IP、API 错误、告警历史）

容器内完整路径：
/app/
├── backend/              # 后端代码
│   ├── server.py         # Flask 主服务
│   ├── config.py         # 配置管理
│   ├── medias.py         # 媒体扫描、EXIF、地理编码
│   ├── database.py       # SQLite 媒体库 + 异步 Caption 队列
│   ├── media_manager.py  # 文件管理、自动导入
│   ├── ai_caption.py     # 本地 LLM / 云端 AI Caption 生成
│   ├── monitor_db.py     # 指标/告警/事件数据库
│   ├── logger.py         # 统一日志模块
│   └── video_utils.py    # ffmpeg 视频处理
└── frontend/             # 前端界面

# 进入容器检查
docker exec -it memory-gallery /bin/sh

# 示例库：数据库位于 /app/sample/media.db
# 用户库：数据库位于 /app/data/logs/media.db（需先创建）
sqlite3 /app/sample/media.db "SELECT COUNT(*) FROM media;"

# 查看媒体文件
find /app/samples -type f | wc -l   # 示例库
find /app/data/media -type f | wc -l  # 用户库（如有）

cd /path/to/MemoryGallery
docker compose pull
docker compose up -d