NAS 怎么用 Docker Compose 一次启动多个容器
一个服务拆成好几个容器,逐个点启动又慢又容易漏。讲清 Compose 文件怎么写、路径怎么放,以及改完配置怎么让它生效。
家里 NAS 上跑的容器一多,逐个点启动就变成负担:装个下载器要先起它的数据库,顺序错了还会报错。Docker Compose 解决的就是这件事,把一组容器写进一个文件,一条命令全起、全停。
入口在哪
Compose 不是套件商店里的独立应用,它是 Docker 自带的一层编排工具,入口在命令行:先通过 SSH 登录到 NAS,再在存放配置的目录里放一个 docker-compose.yml 文件。
部分 NAS 的容器管理套件里也有项目或堆栈这一类入口,可以粘贴同样的配置直接创建。名称和位置因版本而异,不同版本名称略有差别,在设置里搜关键词最快。
动手前先确认有没有 Compose:执行 docker compose version。命令中间是空格的是较新版,中间是短横线的是旧版,两者参数基本一致,按你机器实际显示的那一种来。
具体步骤
- 给这个服务单独建一个目录,例如在共享文件夹里建
stacks/photo,配置和数据都放在里面。以后备份只要打包这一个目录。 - 在目录里新建
docker-compose.yml。文件里写服务列表,每个服务给一个名字,再写镜像、端口映射、数据卷和重启策略。 - 端口映射写成「宿主机端口:容器端口」,冒号左边改成本机没被占用的号,右边保持镜像文档给出的值。
- 数据卷一律写绝对路径,指向第 1 步建好的目录。相对路径容易跟着当前工作目录漂移,重启之后数据就找不到了。
- 把重启策略设为
unless-stopped,NAS 重启后容器会自己回来,不用手动点。 - 保存后在配置文件所在目录执行
docker compose up -d,-d表示后台运行。 - 第一次拉镜像较慢,看
docker compose logs -f的输出,等报出监听端口或就绪字样再访问。
几个坑
- 带密码和密钥的配置别直接写进这个文件,以免跟着共享文件夹被同步到网盘。单独放一个环境变量文件,并确认它不在公开位置。
- 删容器和删数据是两件事。执行
docker compose down只停容器,加上-v参数才会连带删除数据卷,手滑一次数据就没了,删除之前先确认备份在哪。 - 端口冲突最常见。容器起不来先看日志里有没有端口被占用的字样,换一个宿主机端口即可。
- 权限问题。容器里的用户编号和 NAS 上的用户对不上时写入会失败,日志里常是拒绝访问,需要把目录属主或环境变量里的用户编号调成一致。
- 镜像标签别随手写最新。上游一更新行为可能变,出问题时难以回到原来的状态,建议固定一个具体版本号。
- 多套配置文件放在同一层目录里,项目名会撞车,建议一个服务一个目录。
怎么验证
先看状态:执行 docker compose ps,几个服务的状态都应该是运行中,而不是反复重启。
再看端口:从另一台电脑访问映射地址,能打开说明链路通了。打不开就先在本机用 curl 试同一地址,区分是服务没起来还是防火墙挡住。
最后做一次重启验证,把 NAS 重启,等它起来后不手动干预,直接看容器是不是自己回来了。这一步能同时验证重启策略和数据卷路径。
常见问题
改了配置怎么让它生效
改完文件在同一目录再执行一次 docker compose up -d,Compose 会自己比对差异,只重建有变化的部分。只有改了镜像标签才需要额外拉取。改动没生效时,先确认改的是不是正在使用的那个文件。
能不能不登录命令行就管理
部分 NAS 的容器套件支持直接粘贴 Compose 配置创建项目,也有第三方图形界面,但底层还是同一个引擎。图形界面省事,出问题时仍要回命令行看日志,建议把基本命令记住。
多个服务要按顺序启动怎么办
Compose 里的依赖声明只能保证启动先后,不能保证前一个真的准备好。稳妥的做法是给依赖服务加健康检查,再让后一个服务等待健康状态,否则后启动的服务会连不上数据库反复重启。
一句话总结:Compose 把一组容器收进一个文件,路径写绝对、端口错开、数据卷别随手删,就能一条命令起停整套餐。