Docker Compose 部署

这是给熟悉 Docker 和 Compose 的用户使用的部署方式。QPlay 使用公开生产镜像，不需要下载源码，也不需要自行构建镜像。

1. 创建数据目录

mkdir -p ~/qplay/config ~/qplay/media
cd ~/qplay

config 保存账号、授权和运行设置，media 保存 QPlay 生成的 STRM。两个目录都需要长期保留。

2. 创建 Compose 文件

在 ~/qplay 中创建 docker-compose.yml：

services:
  qplay:
    image: xiaoyue199/qplay:latest
    container_name: qplay
    restart: unless-stopped
    environment:
      TZ: Asia/Shanghai
      CONFIG_DIR: /config
      LOG_DIR: /config/logs
    ports:
      - "7735:7735"
      - "8099:8099"
    volumes:
      - ./config:/config
      - ./media:/media
    extra_hosts:
      - "host.docker.internal:host-gateway"

不要把授权码、Cookie、API Key 或其他隐私信息写入 Compose 文件。

3. 启动

docker compose config
docker compose pull
docker compose up -d
docker compose ps

确认 qplay 正在运行后，浏览器打开：

http://服务器IP:7735

健康检查：

curl http://127.0.0.1:7735/health

看到包含 "status":"ok" 即可继续授权和首次设置。

4. Emby 配置

• Emby 客户端连接 QPlay 的 8099 入口；
• Emby 媒体库使用宿主机的同一份 media 目录；
• QPlay 中的 Emby 地址填写 QPlay 能访问的 Emby 地址；
• 详细设置见首次登录与基础设置和连接 Emby。

5. 常用命令

docker compose logs -f qplay    # 查看日志
docker compose restart          # 重启
docker compose stop             # 停止但保留数据
docker compose start            # 再次启动
docker compose down             # 删除容器但保留挂载目录
docker compose pull             # 拉取新镜像
docker compose up -d            # 使用新镜像更新

不要执行 rm -rf config 或 rm -rf media。

NAS 用户不需要使用本页，直接参见NAS 容器管理器安装。