刚帮朋友把一台NAS从“能跑”改到“稳定跑”，发现90%的问题都集中在这3类： 1）端口冲突（最常见） 症状：容器起不来 / 显示 address already in use 排查： - docker ps - lsof -i :你的端口 - 修改 compose 里的映射端口再 up -d 2）目录权限不对 症状：容器反复重启、日志报 permission denied 排查： - ls -al 数据目录 - 看 compose 的 PUID/PGID - 宿主机目录属主与容器用户保持一致 3）depends_on 误解 症状：A依赖B，但A启动就报连接失败 关键点：depends_on 只保证“先启动”，不保证“服务已就绪” 做法： - 给被依赖服务加 healthcheck - 在应用侧增加重试机制 我自己的习惯： 每次改 compose 前先备份： cp docker-compose.yml docker-compose.yml.bak 如果你愿意，我下一篇发： 《反向代理 + HTTPS + 自动续期》的最小可用模板（Nginx Proxy Manager版）。 #Docker #NAS #自部署 #家庭影音 #DockerCompose #折腾教程