🎬 nowen-video

你的私人家庭影音中心 — 轻量、自托管、为 NAS 而生。

English • 快速开始 • 特性 • 配置 • 桌面客户端 • Android V2

---

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

🖥️ PC 桌面客户端 已上线，支持 MKV / HEVC / HDR / 杜比视界 / DTS / Atmos 零转码播放 → 详见 desktop/README.md

📱 Android V2 RC1 候选版 已具备服务器发现、扫码登录、媒体库、聚合搜索、剧集导航、原生播放和离线下载 → 详见 clients/android-v2/README.md

📸 功能截图

✨ 核心特性

• 🎬 媒体库 — 自动扫描（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+ 接口）
• 📱 Android 原生客户端 — Kotlin + Compose，局域网发现、二维码添加、聚合搜索、Media3 播放、Paging 3 和离线下载
• 💻 投屏 — DLNA / Chromecast 设备发现与控制
• 📊 统计 — 观影时长、按日图表、管理员仪表板
• 📁 文件管理 — 浏览/导入/重命名/批量刮削，AI 重命名建议，操作审计日志
• 🔗 分享与标签 — 带密码与过期时间的分享链接，自定义标签，批量移动，匹配规则
• 🛡️ 安全 — 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:/data                                 # 数据库与配置
      - ./cache:/cache                               # 转码缓存
      - /volume1/Media:/media:ro                     # 你的媒体目录
    devices:
      - /dev/dri:/dev/dri                            # 可选：硬件加速
    restart: unless-stopped

容器参数说明：

环境变量 / 参数	默认值	说明
PUID / PGID	1000	运行用户的 UID/GID（必须匹配宿主机媒体目录权限）
TZ	UTC	时区，建议 Asia/Shanghai
NOWEN_APP_PORT	8080	HTTP 端口
NOWEN_SECRETS_JWT_SECRET	(必填)	JWT 签名密钥 — 首次部署务必修改
NOWEN_APP_DATA_DIR	/data	数据目录（数据库 + 上传文件）
NOWEN_LOGGING_LEVEL	info	日志级别：debug / info / warn / error
/dev/dri 设备	—	透传 Intel/AMD GPU 用于硬件转码（NVIDIA 需用 runtime: nvidia）

三、源码构建

环境要求：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

四、Android V2 RC1

Android V2 最低支持 Android 8.0 / API 26。Debug 构建需要 JDK 17 和 Android SDK 35：

chmod +x android/gradlew
./android/gradlew -p clients/android-v2 testDebugUnitTest lintDebug assembleDebug
adb install -r clients/android-v2/app/build/outputs/apk/debug/app-debug.apk

正式签名、公开测试包安装、覆盖升级、旧版并行策略和真机检查表见：

• Android V2 README
• Release Guide
• Migration Guide
• RC1 Smoke Test

⚙️ 配置说明

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

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

config/ 目录下常用分片：

文件	用途
app.yaml	端口、调试、路径、FFmpeg 位置
database.yaml	SQLite 路径、WAL、连接池
secrets.yaml	JWT 密钥、第三方 API Key（⚠️ 切勿提交到 Git）
logging.yaml	日志级别、格式、轮转
cache.yaml	转码缓存目录与清理策略
ai.yaml	LLM 提供商配置（OpenAI / DeepSeek / 通义千问 / Ollama）

提示：硬件加速 / 并发数 / 转码预设 / CPU 资源限制等参数已由系统启动时自动调优，不再暴露为配置项。

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

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

Android V2 Kotlin · Jetpack Compose · Media3 · Paging 3 · WorkManager · Hilt · Retrofit · Android Keystore

部署 Docker (Alpine 3.19) · docker-compose

🗺️ 路线图

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

💬 交流与反馈

• QQ 群：1093473044
• Issues：欢迎在 GitHub 上提交问题与建议
• Android V2 问题：请使用 RC1 缺陷模板，不要公开 Token、密钥或私人服务器地址

☕ 赞赏支持

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

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

📜 开源协议

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

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