文档/安装
硬件转码
让 Intel / AMD 核显、NVIDIA 显卡或一台 Apple Silicon Mac 来转码,播放器放不了的格式也能流畅播放。
最后核对:2026-10-04
MovieClaw 能直接播放就直接播放,只有播放器放不了的编码才转码,转码前会告诉你代价。Infuse 这类全解码播放器永远走直连,不需要转码。 没有硬件转码也能用软件转码,只是很吃 CPU。
| 硬件 | 方式 |
|---|---|
| Intel 核显 | QSV / VAAPI,挂载 /dev/dri |
| AMD 核显 | VAAPI,挂载 /dev/dri |
| NVIDIA 显卡 | NVENC,需要 NVIDIA Container Toolkit |
| Apple Silicon Mac | VideoToolbox,通过「MovieClaw 转码器」远程转码 |
启动时 MovieClaw 会真的跑一秒编码来自检,能不能硬件转码、缺什么,都会用中文写在设置的「播放」页和启动日志里。
Intel / AMD 核显
先在宿主机上运行 ls /dev/dri,能看到 renderD128 之类的设备再继续。ARM 机型和没有核显的机器通常没有。
services:
movieclaw:
# ……其余配置不变
devices:
- /dev/dri:/dev/driNVIDIA 显卡
NVIDIA 显卡不走 /dev/dri。先在宿主机装好 NVIDIA 驱动和 NVIDIA Container Toolkit,再加上:
services:
movieclaw:
# ……其余配置不变
runtime: nvidia
environment:
- TZ=Asia/Shanghai
- NVIDIA_VISIBLE_DEVICES=all
- NVIDIA_DRIVER_CAPABILITIES=all用 Mac 转码
macOS 上的 Docker 跑在虚拟机里,用不到 Mac 的 GPU。所以 MovieClaw 提供了一个菜单栏 App「MovieClaw 转码器」, 让一台常开的 Apple Silicon Mac(比如 Mac mini)用 VideoToolbox 帮服务器转码。服务器可以在 NAS 上,Mac 不用挂载 NAS,转码器通过网络读取源文件、回传结果。
- 在 MovieClaw 网页的「设置 → 播放」里打开远程转码。
- 从 GitHub Releases 下载
MovieClawTranscoder-macos-arm64.zip,解压后把 App 拖进「应用程序」。需要 macOS 12 及以上。 - 打开 App,选中局域网里找到的 MovieClaw(找不到就手动填地址,建议用局域网地址),点「连接并配对」。
- App 会打开批准页,用管理员账号核对配对码后批准。之后在「设置 → 设备」里可以看到和吊销这台 Mac。