lifj25/carvas repository overview

⁠Carvas 画映

Carvas 是一个连接 Emby 的轻量网页播放器，适合部署在 NAS、家庭服务器或 Linux 服务器上。管理员完成一次设置后，普通用户直接使用 Carvas 账号登录即可。

⁠【注意：浏览器支持音频格式有限，非全能播放器，部分音频需要用Nas/服务器中转、转码，介意勿扰】

目前确定中转的音频格式：AC3、E-AC3、DTS / DTS-HD 需要Emby转码的格式：TrueHD / MLP

⁠软件特色

• 兼容 302 网盘播放和本地硬盘资源。
• 支持 Emby 服务器转码；需要时可在单次播放中手动切换转码和分辨率。
• 支持智能音频转码，部分音频格式无需 Emby 服务器转码即可播放
• 因浏览器限制，部分音频需要部署carvas设置中转流量「不是转码」，目前需要中转的音频格式：AC3、E-AC3、DTS / DTS-HD，需要Emby转码的格式：TrueHD / MLP
• 支持电影、电视剧、继续播放、收藏、搜索、排序和演员信息。
• 支持多用户独立使用，同一账号在新设备登录后，旧设备会收到下线提醒。
• 支持 PWA 安装到手机、平板或车机浏览器，账号设置和播放进度按用户保存。
• 管理员可以统一设置 Emby、管理用户、设置到期时间和配置邮件提醒。

⁠快速部署H

⁠Docker Compose（host模式）

创建 compose.yaml：

services:
  carvas:
    image: lifj25/carvas:latest
    container_name: carvas
    restart: always
    network_mode: host
    environment:
      CARVAS_PORT: 18100
      TZ: Asia/Shanghai
    volumes:
      - ./config:/config

⁠Docker Compose（bridge模式）

创建 compose.yaml：

services:
  carvas:
    image: lifj25/carvas:latest
    container_name: carvas
    restart: always
    environment:
      CARVAS_PORT: 18100
      TZ: Asia/Shanghai
    volumes:
      - ./config:/config
    ports:
      - 18100:18100

启动：

docker compose up -d

浏览器访问 http://服务器IP:18100。

⁠Docker CLI

mkdir -p carvas/config
cd carvas

docker run -d \
  --name carvas \
  --restart always \
  -e CARVAS_PORT=18100 \
  -e TZ=Asia/Shanghai \
  -p 18100:18100 \
  -v "$(pwd)/config:/config" \
  lifj25/carvas:latest

⁠Host 网络

Linux 服务器也可以使用 Host 网络：

docker run -d \
  --name carvas \
  --restart always \
  --network host \
  -e CARVAS_PORT=18100 \
  -e TZ=Asia/Shanghai \
  -v "$(pwd)/config:/config" \
  lifj25/carvas:latest

Host 模式不需要 -p，访问地址仍是 http://服务器IP:18100。桥接模式和 Host 模式选择一种即可。

⁠端口和数据保存

• 默认端口为 18100，桥接模式需要同时修改 CARVAS_PORT 和端口映射。
• 所有配置、账号、授权状态和播放相关数据保存在挂载的 /config 目录中。
• 升级或重建容器时请保留 config 目录，不要把它删除。

⁠首次使用

1. 打开 Carvas 地址，首次进入时创建超级管理员账号和密码。
2. 管理员进入后，激活验证，如无授权码，可前往：https://pay.onestrm.cn⁠
3. 管理员进入“设置”，填写统一的 Emby 地址和管理员信息。
4. 普通用户使用 Carvas 账号登录，系统会自动连接已配置的 Emby。
5. 管理员可以在“用户管理”中新增用户、设置邮箱、到期日期和启用状态。

⁠播放说明

Carvas 默认保持原始播放方式。遇到设备无法播放的格式时，在播放器中手动选择 Emby 服务器转码；转码是当前这一次播放的选择，不会永久改变所有视频的播放方式。支持时还可以选择转码分辨率。

⁠管理员功能

• Emby 设置：统一配置 Emby 地址、管理员账号和默认用户配置。
• 用户管理：新增、编辑、停用用户，设置邮箱、到期日期和授权名额。
• 系统设置：配置 SMTP、到期提醒时间、过期提醒以及过期账号清理规则。
• 产品授权：查看授权状态、可用用户数和授权绑定信息。

⁠更新

docker compose pull
docker compose up -d

使用 CLI 部署时，拉取新镜像后按原来的 docker run 命令重新创建容器即可。升级前请备份 config 目录。

⁠WiKi

更详细的指引，前往：https://wiki.onestrm.cn⁠

⁠安全提醒

请注意驾驶安全。禁止在驾驶过程中观看影片、操作播放器或分散驾驶注意力。请在车辆停稳并确保安全时使用；行车过程中请由乘客操作，驾驶员不得观看视频。使用本软件产生的任何交通事故、伤害或损失，由使用者自行承担责任。

Carvas 仅提供媒体播放和管理功能，不提供任何绕过版权保护或访问未获授权内容的功能。请遵守当地法律法规以及媒体服务的使用规则。