wangwuli/streamsnap repository overview

docker run -d --name streamsnap -p 5000:5000 \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/images:/image_new \
  -e APP_USERNAME=admin \
  -e APP_PASSWORD=admin \
  wangwuli/streamsnap:0.0.1
或用 docker compose:


services:
  streamsnap:
    image: wangwuli/streamsnap:0.0.1
    restart: unless-stopped
    ports:
      - "5000:5000"
    volumes:
      - ./data:/app/data        # 配置持久化
      - ./images:/image_new     # 截图输出(save_path 默认 /image_new)
    environment:
      - APP_USERNAME=admin
      - APP_PASSWORD=admin
      - TZ=Asia/Shanghai
访问 http://localhost:5000,默认账号 admin/admin。

⚙️ 环境变量
变量	默认值	说明
APP_USERNAME	admin	Web 登录用户名
APP_PASSWORD	admin	Web 登录密码,生产环境务必修改
TZ	Asia/Shanghai	时区,影响截图文件名时间戳
STREAMS_CONFIG_FILE	/app/data/streams_config.json	配置文件路径,一般无需改
FFMPEG_PATH / FFPROBE_PATH	jellyfin-ffmpeg	一般无需改

💾 持久化(务必挂载)
/app/data — 配置文件 streams_config.json
/image_new — 截图输出目录(save_path 默认值)。不在 /app/data 卷内,需单独挂载,否则容器重建后图片丢失

🎮 NVDEC 硬解(可选)
启动加 --gpus all(compose 用 deploy.resources.reservations.devices),并在 Web「设置」里把 hw_accel 设为 true。

完整文档与源码见 [Gitee 仓库](https://gitee.com/wangwuli/stream-snap)