# video_playback

**Repository Path**: jun-wan/video_playback

## Basic Information

- **Project Name**: video_playback
- **Description**: 一个简洁的录像文件管理和回放系统，支持多设备管理、自动清理和响应式界面。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-06
- **Last Updated**: 2026-02-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 📹 录像回放管理系统

一个简洁的录像文件管理和回放系统，支持多设备管理、自动清理和响应式界面。

## 技术栈

<p>
  <img src="https://img.shields.io/badge/Python-3.8+-3776AB?style=flat-square&logo=python&logoColor=white" />
  <img src="https://img.shields.io/badge/Flask-2.0+-000000?style=flat-square&logo=flask&logoColor=white" />
  <img src="https://img.shields.io/badge/Vue.js-3.x-4FC08D?style=flat-square&logo=vue.js&logoColor=white" />
  <img src="https://img.shields.io/badge/Docker-Ready-2496ED?style=flat-square&logo=docker&logoColor=white" />
</p>

## 预览

### PC端

![仪表盘](./screenshots/image-20260206172427765.png)

![录像回放](./screenshots/image-20260206172535228.png)

### 移动端

![移动端](./screenshots/image-20260206172716616.png)

## 功能特性

- 📊 仪表盘统计概览
- 🎬 视频回放（支持连续播放）
- 📱 响应式设计
- 🗑️ 自动清理策略
- 📋 系统日志

## 部署

### 普通部署

```bash
# 安装依赖
pip install -r requirements.txt

# 启动服务
python app.py
```

访问 `http://localhost:8088`

### Docker 部署

#### 使用 docker-compose（推荐）

```bash
cd docker
docker-compose up -d
```

#### 手动运行

```bash
docker run -d \
  --name video-playback \
  -p 8088:8088 \
  -v /你的录像存储路径:/vol1/EasyNVR/easynvr_rec:ro \
  -v ./config.json:/app/config.json \
  -e TZ=Asia/Shanghai \
  tannic666/video-playback:latest
```

#### 挂载说明

| 挂载路径 | 容器路径 | 说明 |
|---------|---------|------|
| `/你的录像存储路径` | `/vol1/EasyNVR/easynvr_rec` | 录像文件目录（只读） |
| `./config.json` | `/app/config.json` | 配置文件（持久化） |

> ⚠️ **重要**：录像目录必须与 `config.json` 中的 `storage_path` 一致

## 配置

编辑 `config.json` 配置存储路径和清理规则：

```json
{
  "storage_path": "/vol1/EasyNVR/easynvr_rec",
  "server_port": 8088,
  "cleanup": {
    "enabled": true,
    "retention_days": 30,
    "min_free_percent": 10
  }
}
```

## License

MIT