xiaomusic 下载的音乐宿主机打不开3 种容器用户权限配置一次搞定【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicxiaomusic 用 Docker 部署好歌也下载成功了可你一登录宿主机目录想拷文件却提示「权限不够」——文件全归 root 所有。这篇走一遍容器用户权限配置的 3 条路径让下载的音乐文件从出生起就属于你的宿主用户。一分钟看懂根因一个编号叫 UID不用钻内核一个类比就够每个文件身上都刻着「门禁工号」UID/GID。Linux 判断谁能读写只看编号不看名字。容器里的进程默认是 root工号 0。它在挂载的音乐目录里生成的文件全都盖着 0 号章。你的宿主普通用户是 1000 之类的工号。看到 0 号章的文件只能按权限位走经常写不了、删不掉。UNRAID 这类 NAS 尤其明显下载的音乐属主显示 root非 root 用户整理目录就会处处碰壁。所以权限问题的本质就一句话容器进程的工号和宿主用户的工号对不上。把容器进程的工号改成一样麻烦就消了。三条解决路径按场景选一条路径一临时试跑——给 docker run 加一行最快的验证方式。在你现有的启动命令上加一个-udocker run -u 1000:1000 -p 58090:8090 -v /xiaomusic_music:/app/music hanxi/xiaomusic前面是 UID、后面是 GID用你宿主用户的编号id 你的用户名可查。适合「先快速试一下行不行」的时刻重建容器时记得带上这行参数。路径二长期部署——写进 Compose正式部署就写进 compose 文件以后升级镜像、重建容器都不会丢services: xiaomusic: image: hanxi/xiaomusic user: 1000:1000 ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf restart: always核心就是user这一行其余是常规启动配置。/app/music音乐目录和/app/conf配置目录是容器内固定路径宿主机侧路径随意。首次启动前先把宿主机目录建好否则容器会报找不到目录。路径三进阶精细控制——用户命名空间映射多容器混跑、宿主机多用户需要区分归属时可以启用 user namespace 重映射在宿主机/etc/subuid、/etc/subgid里为容器用户配一段 UID 区间启动时加--userns-remap。容器内的 root 会被自动映射成宿主机上的一组普通用户编号新建文件自然归这个用户。这套方案最彻底但配置面较大前两条路满足不了再考虑。路径怎么选一张表对比场景推荐方式优点注意点验证方案、临时容器docker run -u一行生效零文件改动重建容器后需重新带上参数正式部署UNRAID/NASComposeuser持久、可纳入版本管理首启前建好目录并核对 UID/GID多容器、多用户环境--userns-remap subuid映射精细安全性最强配置影响面大先在测试容器验证落地检查清单宿主机执行id记下目标用户的 UID 和 GIDCompose 里加上user: UID:GID或 docker run 加-u UID:GID首次启动前创建宿主机音乐目录与配置目录并确认该用户可读写重启容器后下载一首歌用ls -l核对宿主目录里的文件属主容器内路径/app/music、/app/conf不要改动镜像里已用 VOLUME 声明见 Dockerfile常见踩坑 FAQQ改了 user 之后容器起不来了报权限错误 A容器进程不再是 root就写不动你挂载的宿主机目录了。启动前先确认音乐目录、配置目录对该用户有读写权限——在宿主机用该用户身份touch一个测试文件验证一下最稳。Q换用户会不会影响网页端和音箱设备连接 A不会。网页后台和设备列表依赖的是 conf 目录里的配置与运行用户无关。改完用户后打开后台确认歌曲列表和设置项都在即可。QUNRAID 挂载的目录宿主机访问还是提示拒绝 AUNRAID 有自己的权限体系容器 UID 只是其中一环。还要在 UNRAID 侧把对应共享目录的属主对齐到容器使用的 UID或放开该共享的 guest 访问。关键就一条容器工号、目录属主、访问用户的工号三者要能对得上。收尾权限问题的本质只是「容器进程的工号要和宿主用户的工号一致」。挑一条适合你的路径照着清单勾完xiaomusic 下载的音乐自然归你的宿主用户所有。更多部署细节可参考 docs/index.md。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考