xiaomusic Docker 容器部署用户权限UID/GID配置的 3 种方式一次讲清【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic如果你在 UNRAID 或 NAS 上用 Docker 跑过 xiaomusic大概率撞过这个坑容器把歌下完了回到宿主机一看音乐目录里每个文件的属主都是 root普通用户连拷贝都不行。原因只有一个——容器里的用户权限没配。读完这篇你能自己把 xiaomusic 容器的 UID/GID 调成和宿主机用户一致之后新生成的文件直接归你所有不用再手动 chown 兜底。为什么下载的音乐会变成 root 所有容器默认以 root 身份运行容器内所有文件操作都相当于root 签的字。歌曲落到映射进容器的 /app/music 目录属主记录为容器内用户即 UID 0 的 root宿主机上自然对应 root。宿主机普通用户没有读写 UID 0 文件的权限复制、播放都会被拒。顺带说一句安全整个服务长期跑在 root 下也是坏习惯一旦容器被攻破攻击者拿到的是完整权限。这次修权限顺手把它一起改掉。如何把容器 UID/GID 配成宿主机用户先记住一个核心参数Docker 的-u UID:GID决定容器内进程以哪个用户、哪个组运行UID 是用户编号GID 是组编号。后面的 Composeuser字段作用完全一样理解一次即可。临时启动docker run 加一个参数就行平时习惯用命令启动的话在原有命令里加一行-udocker run -d \ -v /xiaomusic_music:/app/music \ -v /xiaomusic_conf:/app/conf \ -u 1000:1000 \ hanxi/xiaomusic把1000:1000换成宿主机账号的真实 UID 和 GID。适合正式部署前的快速验证跑起来下首歌看新文件属主对不对不对就改数字重来。长期部署Docker Compose 的 user 字段生产环境建议把配置写进 compose 文件重启、升级都不会丢services: xiaomusic: image: hanxi/xiaomusic user: 1000:1000 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/confuser与image同级即可镜像名以 README.md 中 Docker 部署一节为准。改完文件执行docker compose up -d生效。适合长期使用命令不用敲第二遍配置一眼可见注意 UID/GID 要和宿主机实际用户一致。进阶关于 PUID/PGID 与用户命名空间映射有些镜像支持 PUID/PGID 环境变量来设置用户但 xiaomusic 自身没有内置这类变量在它的设置里找不到很正常-u/user就是正解。如果你的宿主机需要更细粒度的 UID 映射Docker 还支持用户命名空间重映射配合 /etc/subuid 和 /etc/subgid 文件配置偏折腾只建议多用户、严格隔离的场景再考虑。动手前照着做这 3 步检查✅ 查清目标用户编号在宿主机执行id 用户名记下 uid 和 gid 后面的数字。✅ 确认挂载目录/xiaomusic_music、/xiaomusic_conf 两个目录的属主和权限要允许该用户读写Dockerfile 里声明的就是 /app/music 和 /app/conf 两个卷。✅ 改完配置重建容器docker compose up -d播放一首歌触发下载再用ls -ln查看新文件属主是否已是自己的账号。第 3 步通过后说明这条链路完全修好之后生成的文件归属正确既不用 chown也不用把目录权限开到 777 这种危险做法。守住最小权限原则现在就去重启你的容器容器用能完成任务的最小身份运行就好。改完 user 之后如果某个目录还报权限错正确姿势是修那个目录的属主而不是退回去用 root 跑。现在回到你的机器把 xiaomusic 容器重建一次几分钟的事。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考