cropflre/nowen-video repository overview

基于 Go + React 构建的轻量级家庭媒体服务器，类似 Jellyfin / Emby，专为 NAS 部署优化。 单二进制 + SQLite，Docker 一键启动，零配置即可使用。

⁠📸 功能截图

⁠✨ 核心特性

• 🎬 媒体库 — 自动扫描（MKV/MP4/AVI/MOV/WebM/TS/RMVB 等），FFprobe 元数据提取，外挂字幕，NFO 兼容（Kodi/Emby/Jellyfin），fsnotify 实时监控
• 📺 智能播放 — 浏览器兼容格式直接播放，不兼容格式按需 HLS 转码，ABR 自适应码率，键盘快捷键，画中画，书签
• ⚡ 硬件加速 — 自动检测 Intel QSV / VAAPI / NVIDIA NVENC，软件兜底，转码缓存复用
• 🎨 多源刮削 — Provider Chain 调度链：TMDb → 豆瓣 → TheTVDB → Bangumi → Fanart.tv → AI 兜底
• 📂 剧集与合集 — 自动识别 S01E01 / 1x01 / 第01集 / EP01；TMDb 电影系列合集
• 🔤 字幕 — 外挂字幕（SRT/ASS/SSA/VTT/SUB/IDX/SUP）+ 内嵌提取，在线搜索，AI ASR 生成
• 👨‍👩‍👧‍👦 多用户 — JWT 认证，独立观看历史/收藏/播放列表，家长控制，每日观看时长，内容分级
• 🧠 AI 助手 — 自然语言搜索、推荐理由、元数据增强、智能重命名、场景识别（章节/精彩片段）
• 📡 Emby API 兼容 — Infuse / Kodi / Emby 原生客户端无缝接入（140+ 接口）
• 💻 投屏 — DLNA / Chromecast 设备发现与控制
• 📊 统计 — 观影时长、按日图表、管理员仪表板
• 📁 文件管理 — 浏览/导入/重命名/批量刮削，AI 重命名建议，操作审计日志
• 🔗 分享与标签 — 带密码与过期时间的分享链接，自定义标签，批量移动，匹配规则
• 💓 Pulse 动态 — 社区活动流，点赞与评论
• 🛡️ 安全 — JWT、bcrypt、CORS、安全响应头、限流、访问日志
• 🌐 国际化 — 简体中文 / English / 日本語
• 🪶 轻量 — 单二进制 + SQLite (WAL)，Alpine Docker 镜像，健康检查，PUID/PGID

⁠🚀 快速开始

⁠一、Docker 部署（推荐）

git clone https://github.com/your-repo/nowen-video.git
cd nowen-video
docker-compose up -d

打开浏览器访问 http://你的主机IP:8080 — 默认管理员：admin / admin123

⁠二、NAS 部署（群晖 / 威联通 / Unraid）

编辑 docker-compose.yml：

services:
  nowen-video:
    image: nowen-video:latest
    container_name: nowen-video
    ports:
      - "8080:8080"
    environment:
      - PUID=1000                                    # 通过 `id` 命令查看
      - PGID=1000
      - NOWEN_SECRETS_JWT_SECRET=change-me-please    # ⚠️ 必须修改
      - TZ=Asia/Shanghai
    volumes:
      - ./data:/app/data                             # 数据库与配置
      - ./cache:/app/cache                           # 转码缓存
      - /volume1/Media:/media:ro                     # 你的媒体目录
    devices:
      - /dev/dri:/dev/dri                            # 可选：硬件加速
    restart: unless-stopped

容器参数说明：

⁠三、源码构建

环境要求：Go 1.22+、Node.js 20+、FFmpeg

go mod tidy
cd web && npm install && cd ..

# 开发模式
make dev          # 启动后端
make dev-web      # 启动前端（另开终端）

# 生产构建
make build
./bin/nowen-video

⁠⚙️ 配置说明

配置加载顺序（后者覆盖前者）：

1. 内置默认值        → 零配置可运行
2. config.yaml       → 主配置文件（旧版扁平 / 新版嵌套均支持）
3. config/*.yaml     → 分片配置文件（按模块分类）
4. NOWEN_* 环境变量  → 例如 NOWEN_APP_PORT=8080

config/ 目录下常用分片：

⁠AI 提供商示例

# OpenAI
ai: { provider: openai,   api_base: https://api.openai.com/v1,                  model: gpt-4o-mini }
# DeepSeek
ai: { provider: deepseek, api_base: https://api.deepseek.com/v1,                model: deepseek-chat }
# 通义千问
ai: { provider: qwen,     api_base: https://dashscope.aliyuncs.com/compatible-mode/v1, model: qwen-turbo }
# Ollama（本地部署）
ai: { provider: ollama,   api_base: http://localhost:11434/v1,                  model: llama3 }

⁠🏗️ 技术栈

后端 Go 1.22 · Gin · GORM + SQLite (WAL) · Zap · Viper · gorilla/websocket · fsnotify · FFmpeg

前端 React 18 · TypeScript · Vite · Tailwind CSS · Zustand · HLS.js · React Router · Framer Motion

部署 Docker (Alpine 3.19) · docker-compose

⁠🗺️ 路线图

• ✅ v0.1 – v0.9 核心播放、刮削、多用户、AI 助手、文件管理、Pulse 动态、分享、标签
• ✅ v0.9.5 完整 Emby API 兼容层（Infuse / Kodi / Emby 原生客户端）
• 🔄 v1.0 ABR 无缝码率切换、FFmpeg 节流、移动端响应式、PWA、测试覆盖率 > 60%、Prometheus 监控
• 🚀 v1.1+ 移动原生 App、4K/HDR、WebDAV、分布式转码、AV1、插件市场

⁠💬 交流与反馈

• QQ 群：1093473044
• Issues：欢迎在 GitHub 上提交问题与建议

⁠☕ 赞赏支持

如果这个项目对你有帮助，欢迎请作者喝杯咖啡 / 买个键盘 / 修个 Bug 🙏

Drug 的赞赏码 — "支持作者买键盘 / 修 Bug"

⁠📜 开源协议

本项目采用 GNU General Public License v3.0⁠（GPL-3.0）开源协议发布。

你可以自由地运行、研究、修改和分发本软件。基于本项目的任何派生作品在对外分发时，必须同样以 GPL-3.0 协议开源，并保留原作者版权声明。本软件按"原样"提供，不附带任何明示或默示的担保。