Docker run 部署

这是给熟悉 Docker 命令的用户使用的部署方式。普通 NAS 用户请使用NAS 容器管理器安装。

1. 创建数据目录

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

2. 拉取镜像

docker pull xiaoyue199/qplay:latest

3. 创建容器

docker run -d \
  --name qplay \
  --restart unless-stopped \
  -e TZ=Asia/Shanghai \
  -e CONFIG_DIR=/config \
  -e LOG_DIR=/config/logs \
  --add-host host.docker.internal:host-gateway \
  -p 7735:7735 \
  -p 8099:8099 \
  -v "$PWD/config:/config" \
  -v "$PWD/media:/media" \
  xiaoyue199/qplay:latest

检查容器：

docker ps --filter name=qplay
curl http://127.0.0.1:7735/health

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

http://服务器IP:7735

4. Windows Docker Desktop

将两个挂载位置替换为实际的 Windows 路径，例如：

-v "C:\QPlay\config:/config"
-v "C:\QPlay\media:/media"

确认 Docker Desktop 已允许访问这两个文件夹。

5. 更新容器

cd ~/qplay
docker pull xiaoyue199/qplay:latest
docker rm -f qplay

然后重新执行本页的 docker run 命令。不要遗漏两个 -v 挂载，否则会创建空的数据目录。

6. 常用命令

docker logs -f qplay     # 查看日志
docker stop qplay        # 停止
docker start qplay       # 启动
docker restart qplay     # 重启
docker rm -f qplay       # 删除容器但保留挂载目录

不要删除宿主机上的 config 和 media 文件夹。