82581d2949
Add TMDB search and media detail pages, HDHive resource ingestion flow, unified error handling, Docker single-container runtime, and project docs/config updates for local deployment. Co-authored-by: Cursor <cursoragent@cursor.com>
82 lines
2.1 KiB
Markdown
82 lines
2.1 KiB
Markdown
# media_crawler
|
||
|
||
资源爬取自动入库项目，采用前后端分层：
|
||
|
||
- `frontend/`: Vue + JavaScript 页面
|
||
- `backend/`: Python Flask API（编排 TMDB -> HDHIVE -> Emby -> CMS）
|
||
|
||
## 本地启动
|
||
|
||
### 1) 启动后端（Flask）
|
||
|
||
```bash
|
||
cd backend
|
||
python3 -m venv .venv
|
||
source .venv/bin/activate
|
||
pip install -r requirements.txt
|
||
cp .env.example .env
|
||
python app.py
|
||
```
|
||
|
||
默认端口：
|
||
- 后端：`14620`
|
||
- 前端：`14621`
|
||
|
||
后端 `.env` 中 `HDHIVE` 相关参数按 OpenAPI 文档配置：
|
||
|
||
- `HDHIVE_BASE_URL` 例如 `https://hdhive.com`
|
||
- `HDHIVE_API_KEY` 对应请求头 `X-API-Key`（必填）
|
||
- `HDHIVE_ACCESS_TOKEN` 对应 `Authorization: Bearer ...`（按授权场景可选）
|
||
|
||
后端 `CMS` 入库参数支持两种模式：
|
||
|
||
- 直接给固定 token：`CMS_TOKEN`
|
||
- 自动登录获取 token：`CMS_LOGIN_URL` + `CMS_USERNAME` + `CMS_PASSWORD`
|
||
|
||
入库接口地址使用 `CMS_ADD_SHARE_URL`（或 `CMS_BASE_URL` 自动拼接 `/api/cloud/add_share_down`）。
|
||
|
||
### 2) 启动前端（Vite）
|
||
|
||
```bash
|
||
cd frontend
|
||
cp .env.example .env
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
## 页面能力
|
||
|
||
- 主页面支持按关键词在 TMDB 搜索影视
|
||
- 点击影视封面进入详情页，展示 HDHive 资源列表
|
||
- 点击资源链接触发入库任务（按资源 slug 入库）
|
||
- 任务中心位于二级页面 `/tasks`
|
||
- 前端调用 Flask API：`POST /api/tasks`、`GET /api/tasks`、`GET /api/tasks/{taskId}/logs`
|
||
- 前端新增接口：`GET /api/media/search`、`GET /api/media/{type}/{tmdbId}`
|
||
- 任务状态、结果、错误和步骤日志展示
|
||
- 后端使用 SQLite 保存任务、资源和日志，并按 `tmdb_id` 做幂等控制
|
||
- 后端统一错误分类：`validation`、`authentication`、`authorization`、`rate_limit`、`not_found`、`business_rule`、`network`、`timeout`、`upstream`、`internal`
|
||
|
||
## Docker 单容器运行
|
||
|
||
项目提供了单容器运行前后端的 `Dockerfile`，容器内会同时启动：
|
||
|
||
- Flask 后端：`14620`
|
||
- 前端预览服务：`14621`
|
||
|
||
### 构建镜像
|
||
|
||
```bash
|
||
docker build -t media-crawler:latest .
|
||
```
|
||
|
||
### 运行容器
|
||
|
||
```bash
|
||
docker run --rm -it \
|
||
-p 14620:14620 \
|
||
-p 14621:14621 \
|
||
--env-file backend/.env \
|
||
media-crawler:latest
|
||
```
|
||
|