cropflre/nowen-video

轻量级家庭媒体服务器镜像

镜像概述

本镜像是一个轻量级家庭媒体服务器解决方案，基于Go后端、React前端、SQLite数据库构建，并集成AI大模型功能。旨在为家庭用户提供简单、高效的媒体文件管理与播放体验，支持自动刮削媒体元数据、格式转码及硬件加速，资源占用低，易于部署和使用。

核心功能与特性

技术架构优势

• 轻量级设计：采用Go语言开发后端，性能高效且资源占用低；React前端提供直观交互界面；SQLite数据库无需额外配置，简化部署流程
• AI增强能力：集成AI大模型，支持智能媒体分类、内容推荐及元数据优化，提升媒体管理智能化水平

媒体管理核心功能

• 自动刮削：自动从网络获取电影、电视剧等媒体文件的元数据（海报、简介、演员信息等），无需手动编辑
• 全格式转码：支持多种媒体格式转换，适配不同设备播放需求
• 硬件加速：集成硬件加速技术（如Intel Quick Sync、AMD VCE等），降低转码过程中的CPU占用，提升处理效率

使用场景与适用范围

• 家庭媒体中心：适合家庭用户搭建个人媒体库，集中管理电影、电视剧、音乐等各类媒体文件
• 低配置设备部署：轻量级架构可在树莓派、NAS等低配置设备上稳定运行
• 媒体元数据自动化整理：满足对媒体文件元数据自动分类、整理的需求
• 多设备适配：支持转码为手机、平板、智能电视等多设备兼容格式

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name home-media-server \
  -p 8080:8080 \
  -v /path/to/your/media:/media \
  -v /path/to/your/config:/config \
  --device /dev/dri:/dev/dri \  # 启用硬件加速（如支持）
  your-image-name:latest

参数说明：

• -p 8080:8080：映射容器端口到主机，默认Web访问端口为8080
• -v /path/to/your/media:/media：挂载本地媒体文件目录，替换为实际媒体存储路径
• -v /path/to/your/config:/config：挂载配置文件目录，用于持久化保存设置和数据库
• --device /dev/dri:/dev/dri：如主机支持硬件加速，添加此参数启用GPU加速转码

Docker Compose配置

yaml
version: '3'
services:
  home-media-server:
    image: docker.xuanyuan.run/your-image-name:latest
    container_name: home-media-server
    ports:
      - "8080:8080"
    volumes:
      - /path/to/your/media:/media
      - /path/to/your/config:/config
    devices:
      - /dev/dri:/dev/dri  # 硬件加速支持
    restart: unless-stopped

环境变量配置

通过环境变量自定义服务器行为，常用配置项如下：

访问与使用

部署完成后，通过浏览器访问 http://<主机IP>:8080 进入Web管理界面，按照引导完成初始配置：

1. 设置媒体库扫描路径
2. 配置刮削器偏好（语言、数据源等）
3. 启用/调整硬件加速选项
4. 开始媒体库扫描与元数据获取

系统将自动整理媒体文件并生成可视化媒体库，支持按类别、年份、评分等多维度筛选和播放。