pdzhou/lux repository overview

⁠Lux — NAS 个人媒体库服务

Lux 是面向 NAS 的自托管媒体库服务，用 Rust 构建，提供 Web 界面和 Emby 兼容 API，用于管理本地电影、剧集和混合媒体库，并连接 VidHub、SenPlayer、Infuse 等第三方客户端。

Lux 专注于管理 NAS 上已有的媒体文件。

⁠功能

• 支持电影、电视剧和混合媒体库，可为媒体库配置多个根目录。
• 支持文件事件增量扫描和后台任务管理。
• 优先使用本地 NFO 与图片，支持元数据匹配和手动锁定。
• 提供 Emby 兼容接口，供第三方客户端浏览媒体和播放。
• 支持字幕、多媒体源和多版本选择。
• 支持 .strm 外部播放地址；远程媒体由有权限的客户端或配置的解析器处理。
• 默认使用 SQLite，也可选择外部 PostgreSQL。

⁠快速开始

需要 Docker Engine 和 Docker Compose v2：

services:
  lux:
    image: pdzhou/lux:latest
    container_name: lux
    ports:
      - "8097:8097"
    volumes:
      - ./config:/config:rw
      - /path/to/media:/media:rw
    restart: unless-stopped

启动后访问 http://<NAS-IP>:8097，按引导选择数据库并创建第一个管理员。之后在管理界面添加容器内的媒体路径，例如 /media/Movies。

/config 保存数据库、配置、插件和日志，请持久化此目录。若需要 Lux 写回 NFO 或图片，请让媒体挂载可读写。

⁠镜像标签

• pdzhou/lux:latest：从 main 分支发布。
• pdzhou/lux:test：从 test 分支发布。

镜像工作流构建 linux/amd64 和 linux/arm64。

⁠部署提示

建议先在局域网完成初始化，再通过 HTTPS 反向代理提供远程访问。不要将尚未初始化的页面直接暴露到公网。

⁠项目链接

• 源代码⁠
• 客户端兼容记录⁠
• Docker Hub 镜像⁠