用 Docker 安装

在 Linux、Windows、macOS 或任何装了 Docker 的 NAS 上，用一个 docker-compose.yml 装好 MovieClaw，5 分钟跑起来。

最后核对：2026-10-04

MovieClaw 只有一个官方镜像 movieclaw/movieclaw，单容器跑全部：不用另装数据库、不用配 Redis，TMDB Key 也已内置。同一个标签同时支持 x86_64 和 ARM64。群晖、威联通、Unraid 有图形界面的分步说明：群晖、威联通、Unraid。

准备

一台装好 Docker 和 Docker Compose 的机器（Windows、macOS 用 Docker Desktop）。
想好两个目录：媒体放在哪、下载器把文件存在哪。两个目录都要可写，整理入库、洗版都要动文件。

第 1 步：写 docker-compose.yml

新建一个文件夹（比如 movieclaw），在里面新建 docker-compose.yml，粘贴下面的内容：

services:
  movieclaw:
    image: movieclaw/movieclaw:latest
    container_name: movieclaw
    init: true
    ports:
      # 左边是宿主端口，被占了就改左边（比如 "8096:3000"），右边保持 3000
      - "3000:3000"
    volumes:
      # 运行数据，备份这个文件夹就够了（含隐藏文件 .secret_key）
      - ./data:/app/data
      - /volume1/media:/media  # ← 改成你的媒体目录
      - /volume1/downloads:/downloads  # ← 改成下载器的保存目录
    environment:
      - TZ=Asia/Shanghai  # ← 改成你的时区
    restart: unless-stopped

第 2 步：改成你自己的路径

规则只有一条：冒号左边是你机器上的目录，右边是 MovieClaw 在容器里看到的路径。之后在网页里填路径，填的都是右边那个（/media、/downloads）。多个媒体盘就每个加一行，比如 - /volume2/movies:/movies。

第 3 步：启动

在这个文件夹里运行：

docker compose up -d

首次启动快的机器十来秒，慢的 NAS 要一两分钟，这期间页面显示「正在连接服务…」属正常。docker logs movieclaw 里出现「前端反代已就绪」就是起来了。

第 4 步：打开网页

浏览器打开 http://<主机 IP>:3000，按引导创建管理员账号。接下来建媒体库、接下载器和站点，见首次配置。

只想用一条命令试试

docker run -d --name movieclaw --init -p 3000:3000 \
  --restart unless-stopped \
  -e TZ=Asia/Shanghai \
  -v "$(pwd)/data:/app/data" \
  -v /volume1/media:/media \
  -v /volume1/downloads:/downloads \
  movieclaw/movieclaw:latest

升级

日常升级在网页「设置 → 更新与维护」里点一下就行，下载的是几 MB 的更新包，容器重建也不丢；更新出问题可以在同一页回退。只有更新说明写明「需要升级 Docker 镜像」时，才需要运行：

docker compose pull && docker compose up -d

常见问题

3000 端口被占了

启动时报 address already in use，就改 ports 冒号左边，比如 "8096:3000"，之后用http://<主机 IP>:8096 访问。容器里的 3000 不用动。

刮削失败，日志说连不上 TMDB

所在网络直连不到 TMDB 时，到「设置 → 网络」配置代理或镜像地址，用页面上的连通性测试验证。

支持 PUID / PGID 吗

不支持，容器以 root 运行。data 里的文件属主是 root；挂进来的媒体目录要可写。

媒体库在 SMB / NFS 网络挂载上

建媒体库时关掉「实时文件监控」，网络挂载上的文件事件不可靠，靠定期对账和手动扫描更稳。