最新

NAS 怎么用 Docker Compose 一次启动多个容器

一个服务拆成好几个容器,逐个点启动又慢又容易漏。讲清 Compose 文件怎么写、路径怎么放,以及改完配置怎么让它生效。

家里 NAS 上跑的容器一多,逐个点启动就变成负担:装个下载器要先起它的数据库,顺序错了还会报错。Docker Compose 解决的就是这件事,把一组容器写进一个文件,一条命令全起、全停。

入口在哪

Compose 不是套件商店里的独立应用,它是 Docker 自带的一层编排工具,入口在命令行:先通过 SSH 登录到 NAS,再在存放配置的目录里放一个 docker-compose.yml 文件。

部分 NAS 的容器管理套件里也有项目或堆栈这一类入口,可以粘贴同样的配置直接创建。名称和位置因版本而异,不同版本名称略有差别,在设置里搜关键词最快。

动手前先确认有没有 Compose:执行 docker compose version。命令中间是空格的是较新版,中间是短横线的是旧版,两者参数基本一致,按你机器实际显示的那一种来。

具体步骤

  1. 给这个服务单独建一个目录,例如在共享文件夹里建 stacks/photo,配置和数据都放在里面。以后备份只要打包这一个目录。
  2. 在目录里新建 docker-compose.yml。文件里写服务列表,每个服务给一个名字,再写镜像、端口映射、数据卷和重启策略。
  3. 端口映射写成「宿主机端口:容器端口」,冒号左边改成本机没被占用的号,右边保持镜像文档给出的值。
  4. 数据卷一律写绝对路径,指向第 1 步建好的目录。相对路径容易跟着当前工作目录漂移,重启之后数据就找不到了。
  5. 把重启策略设为 unless-stopped,NAS 重启后容器会自己回来,不用手动点。
  6. 保存后在配置文件所在目录执行 docker compose up -d,-d 表示后台运行。
  7. 第一次拉镜像较慢,看 docker compose logs -f 的输出,等报出监听端口或就绪字样再访问。

几个坑

  • 带密码和密钥的配置别直接写进这个文件,以免跟着共享文件夹被同步到网盘。单独放一个环境变量文件,并确认它不在公开位置。
  • 删容器和删数据是两件事。执行 docker compose down 只停容器,加上 -v 参数才会连带删除数据卷,手滑一次数据就没了,删除之前先确认备份在哪。
  • 端口冲突最常见。容器起不来先看日志里有没有端口被占用的字样,换一个宿主机端口即可。
  • 权限问题。容器里的用户编号和 NAS 上的用户对不上时写入会失败,日志里常是拒绝访问,需要把目录属主或环境变量里的用户编号调成一致。
  • 镜像标签别随手写最新。上游一更新行为可能变,出问题时难以回到原来的状态,建议固定一个具体版本号。
  • 多套配置文件放在同一层目录里,项目名会撞车,建议一个服务一个目录。

怎么验证

先看状态:执行 docker compose ps,几个服务的状态都应该是运行中,而不是反复重启。

再看端口:从另一台电脑访问映射地址,能打开说明链路通了。打不开就先在本机用 curl 试同一地址,区分是服务没起来还是防火墙挡住。

最后做一次重启验证,把 NAS 重启,等它起来后不手动干预,直接看容器是不是自己回来了。这一步能同时验证重启策略和数据卷路径。

常见问题

改了配置怎么让它生效

改完文件在同一目录再执行一次 docker compose up -d,Compose 会自己比对差异,只重建有变化的部分。只有改了镜像标签才需要额外拉取。改动没生效时,先确认改的是不是正在使用的那个文件。

能不能不登录命令行就管理

部分 NAS 的容器套件支持直接粘贴 Compose 配置创建项目,也有第三方图形界面,但底层还是同一个引擎。图形界面省事,出问题时仍要回命令行看日志,建议把基本命令记住。

多个服务要按顺序启动怎么办

Compose 里的依赖声明只能保证启动先后,不能保证前一个真的准备好。稳妥的做法是给依赖服务加健康检查,再让后一个服务等待健康状态,否则后启动的服务会连不上数据库反复重启。

一句话总结:Compose 把一组容器收进一个文件,路径写绝对、端口错开、数据卷别随手删,就能一条命令起停整套餐。