huanhq99/flixpilot repository overview

⁠FlixPilot

一个面板搞定用户管理、影视发现、求片审批、缺集扫描、播放监控、AI 字幕翻译、TG Bot、115 网盘联动等所有日常需求，告别"装一堆容器拼凑功能"的折腾。

🌐 GitHub: https://github.com/huanhq99/FlixPilot⁠ 📦 Docker Hub: https://hub.docker.com/r/huanhq99/flixpilot⁠ 💬 TG 交流群: https://t.me/EmbyCockpit⁠

⁠✨ 核心功能

⁠🎬 影视浏览

• 发现页：10 大流媒体平台（爱奇艺 / 腾讯 / 优酷 / B站 / Netflix / Disney+ / Max / Apple TV+ / Amazon / Hulu）专属入口
• 趋势页：14 个分区横滚（本周热门 / 各平台热剧 / 高分榜 / 即将上映）
• 追剧日历：剧集更新日历，标注库存状态
• 个性化推荐：基于观看历史的智能推荐

⁠👥 用户体系

• 完整会员 / 积分 / 邀请码 / 卡密兑换体系
• 每日签到、影巢自动签到
• 流量配额管理（接入 GoEdge）
• 设备管理（自动 / 手动注册）

⁠📩 求片系统

• 用户提交 → 自动检查入库 / 重复 → 投票 → 审批
• 审批通过自动通知用户（TG / 邮件 / Bark / ServerChan / Webhook）
• 联动 MoviePilot 自动下载

⁠🔧 媒体库治理

• 缺集管理：Emby vs TMDB 对比，定位缺失集数
• 库品质审计：分辨率 / 编码 / 大小分析
• 去重管理：精确删除重复版本，联动清理 115 网盘真实文件 ⭐
• 播放监控：实时播放状态、直播流监控

⁠🤖 Telegram Bot

• 用户：搜片 / 求片 / 签到 / 查积分 / 兑换
• 影巢集成：一键解锁 + 转存 115
• 115 链接自动解析转存
• 管理员：通知 / 封禁 / 抽奖

⁠🧠 AI 能力

• 字幕翻译：Gemini AI 翻译 SRT / ASS
• 公告助手：AI 辅助撰写公告
• 观影报告：个人观看统计

⁠🛡️ 安全

• JWT 认证 + PBKDF2 密码哈希
• SSRF 防护 / 登录限流 / Webhook 验证
• 备份导出自动遮蔽敏感字段

⁠🚀 部署方法

⁠一、准备 docker-compose.yml

services:
  flixpilot:
    image: huanhq99/flixpilot:latest
    container_name: flixpilot
    restart: unless-stopped
    ports:
      - "3005:3005"
    volumes:
      - ./data:/app/data
      # CloudNAS 挂载（可选但强烈推荐）：去重删除联动清理 115 真实文件需要
      # 群晖 / 飞牛: /volume1/docker/CloudNAS:/CloudNAS:rslave
      - ./CloudNAS:/CloudNAS:rslave
    environment:
      - NODE_ENV=production
      - DATA_DIR=/app/data
      - TZ=Asia/Shanghai
      - REDIS_URL=redis://redis:6379
    depends_on:
      redis:
        condition: service_healthy

  redis:
    image: redis:7-alpine
    container_name: flixpilot-redis
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 5s
      retries: 5

⁠二、启动

docker compose up -d

首次启动会自动生成 JWT / Cron 密钥到 ./data/ 目录。

⁠三、访问

浏览器打开 http://NAS_IP:3005

默认管理员账号：admin / admin123（首次登录后立刻改密码）

⁠四、配置

进入 设置 页面填入：

• Emby 地址 + API Key
• TMDB API Key
• Telegram Bot Token（可选）
• Gemini API Key（可选，AI 功能用）
• 115 Cookie（可选，网盘联动用）

完整配置示例见 data/config.example.json⁠

⁠🆙 升级

docker compose pull && docker compose up -d

⁠📌 镜像架构

• ✅ linux/amd64
• ✅ linux/arm64（群晖 / 飞牛 / 树莓派）

⁠📂 数据持久化

所有数据都在 ./data/ 目录：

• config.json — 全局配置
• users.json — 用户账号
• flixpilot.db — SQLite（TMDB 缓存 / 播放历史 / 媒体库）
• 其余业务 JSON 文件

定期备份此目录即可。

⁠📜 License

MIT — 完全开源，数据在自己手里，无遥测。