NAS 版常见问题

下载失败、直播录制中断等与安装方式无关的问题，处理方法与桌面版相同，见下载失败排查和直播录制中断。

本页命令里的 lianloader 是默认容器名；执行 docker 命令提示没有权限（permission denied）时，在命令前加 sudo。

安装与启动复制本节链接

一键安装提示“当前用户不能操作 Docker”复制本节链接

命令里要带 sudo：

curl -fsSL https://download.cdhub.top/products/lianloader-server/install-latest.sh | sudo sh

一键安装提示已经有同名的容器或端口被占用复制本节链接

已有名为 lianloader 的容器时，通常是之前用别的方式装过。要更新它，到它的 compose.yaml 所在目录执行 docker compose pull && docker compose up -d；确定不再需要时，先删除旧容器再运行脚本。端口被占用时，重新运行脚本并换一个端口。

启动报错 mounts denied 或提示路径没有共享复制本节链接

compose.yaml 中下载目录写的路径在机器上不存在，或者是没改的占位路径（例如 /path/to/downloads）。改成真实存在的目录并先建好，或者直接用 ./downloads，表示 compose.yaml 所在文件夹里的 downloads。在 macOS 的 Docker Desktop 上，可以用 /Users/<你的用户名>/Downloads/lianloader 这类目录；不需要在宿主机上直接看到文件时，也可以改用 Docker 管理的命名卷，此时 compose.yaml 末尾要声明这个卷：

    volumes:
      - ./data:/data
      - lianloader-downloads:/downloads

volumes:
  lianloader-downloads:

拉取镜像很慢或失败复制本节链接

镜像从 ghcr.io 下载。在 Docker 的设置里配置镜像加速或代理后重试；NAS 的 Docker 应用一般在“设置”里。

网页打不开复制本节链接

先执行 docker logs lianloader 查看启动日志，再确认端口映射和 NAS 的防火墙放行了这个端口。

使用中复制本节链接

网页能打开，但一点按钮就失败复制本节链接

通常是反向代理没有保留原始 Host，按从外网访问调整配置。

疯狂URL、手机 App 或第三方程序连不上复制本节链接

先确认“设置 → 远程访问与 API”中已打开“启用 API 服务”，它默认关闭；再确认用的令牌类型对应这个用途，并且没有过期。见接收疯狂URL的投递。

更新后网页还是旧的复制本节链接

网页提示“已升级，刷新后才能用上新功能”时，刷新页面即可。

网页顶部出现红色的“当前版本已停止使用”复制本节链接

这个版本发现了严重问题，新的下载、录制和转换暂停，进行中的任务不受影响。按更新到新版本操作后自动恢复。

只有 root 账号能装吗复制本节链接

能装。PUID、PGID 不能写 0，是因为程序在容器里不以 root 身份运行，它处理的是从网上下载来的内容；这和由谁来部署无关。只有 root 账号的云服务器，PUID、PGID 都填 1000，并把安装文件夹交给这个编号（chown -R 1000:1000 /opt/lianloader）。宿主机上不必真有这个用户，root 照样能管理这些文件。

下载的文件删不掉，或属主不对复制本节链接

把 compose.yaml 中的 PUID、PGID 改成你平时登录 NAS 的账号（SSH 里执行 id 查看），不能设为 0，然后执行 docker compose up -d 重建容器。已经下载的文件属主不会自动改变，需要时手动改，例如 sudo chown -R 1000:1001 /vol1/1000/lianloader/downloads（数字换成你的 PUID、PGID，路径换成你的下载目录）。macOS 的 Docker Desktop 不受这两项影响。

想把文件存到另一块硬盘复制本节链接

NAS 版的输出目录都在“存储根目录”之下，也就是挂载到 /downloads 的目录。要换硬盘，改 compose.yaml 中 /downloads 的挂载并重建容器；只想让某一类产物放到别的硬盘，可以把那块硬盘挂载到 /downloads 下对应的子目录。

授权复制本节链接

激活时提示激活码无效复制本节链接

确认用的是 Docker 版激活码。桌面版激活码与 NAS 版不互通。

激活时提示“此激活码正被另一实例使用”复制本节链接

先在旧实例的“授权”页释放授权，再在新实例激活；旧实例已经无法打开时，等一段时间后再试。见迁移到新机器。

忘记管理员密码复制本节链接

在 NAS 上执行 docker exec -it lianloader lianloader-server admin reset-password，用显示的新设置码重新设置账号。见账号与密码。