Windows 上改 Docker 配置,其实就是改那个 JSON
记录一次在 Windows 上修改 Docker 守护进程配置的完整过程,包含文件路径、权限问题、JSON 格式陷阱以及重启服务的两种方式。
支持通配符SSL证书、多域名证书、IP证书。适配ACME接口, 支持Zerossl、Let's Encrypt和Google等渠道。登录已有账号
2026-07-24 12:00:41 Docker Docker Compose 故障排查
docker-compose: 未找到命令,这个报错做容器的朋友应该都见过。
有时候是压根没装,有时候是装了但系统不认识路径。我把常见的排查套路和不同系统的安装方式整理了一下,下次遇到可以直接对照着搞。
先确认到底装没装。跑一下 docker-compose --version 就知道了。如果返回类似 Docker Compose version v2.23.0 的信息,说明二进制文件已经在系统里了,只是 PATH 没配对,或者你用的命令版本不对。
如果直接提示 command not found,那要么没装,要么装错位置了。
这里有一个容易踩坑的点:Docker Compose 分 v1 和 v2,命令不一样。v1 是独立二进制文件,命令是 docker-compose(带横杠);从 v2 开始,Compose 变成了 Docker CLI 的插件,推荐的用法是 docker compose(中间是空格)。
如果你装的是 v2,但习惯性敲 docker-compose,也会报找不到。反过来,系统里只装了 v1,敲 docker compose 同样不行。所以先搞清楚自己装的是哪个版本,再决定用哪种命令。
Linux 下安装,最省事的方式是用 Docker 官方的插件安装法。创建目录 /usr/local/lib/docker/cli-plugins,然后从 GitHub 下载对应版本的二进制文件,放到这个目录下,文件名就叫 docker-compose,最后给个执行权限。
之后就可以用 docker compose version 验证了。具体命令如下:
mkdir -p /usr/local/lib/docker/cli-plugins
curl -SL https://github.com/docker/compose/releases/download/v2.25.0/docker-compose-linux-x86_64 -o /usr/local/lib/docker/cli-plugins/docker-compose
chmod +x /usr/local/lib/docker/cli-plugins/docker-compose
docker compose version
如果你还在用老版本的独立二进制安装方式,那就把文件下载到 /usr/local/bin/docker-compose,然后执行 docker-compose --version。下面是独立安装的命令:
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
docker-compose --version
macOS 和 Windows 用户,只要装了 Docker Desktop,Compose 功能已经内置在里面了,不用额外折腾。打开终端直接敲 docker compose 就能用。
如果装完了还是提示找不到命令,十有八九是 PATH 的问题。用 echo $PATH 看一下当前环境变量里有没有包含 /usr/local/bin(对应 v1 独立安装)或 /usr/local/lib/docker/cli-plugins(对应 v2 插件)。要是没有,就在你的 shell 配置文件里加一行。Bash 用户编辑 ~/.bashrc,Zsh 用户编辑 ~/.zshrc,加入 export PATH=$PATH:/usr/local/bin,然后 source 一下让配置生效。
v2 插件目录一般情况下 docker 客户端会自动查找,不需要手动加到 PATH 里,但如果你偶尔需要直接执行那个 docker-compose 二进制文件,把插件目录加进去也行,知道有这么回事就好。
不想改 PATH 的话,也可以直接用绝对路径运行。v1 版本:/usr/local/bin/docker-compose up -d;v2 插件版本:/usr/local/lib/docker/cli-plugins/docker-compose up -d。临时用一下可以,长期这么敲就太累了。
另外,如果你之前通过 pip 装过 docker-compose,可能会和现在的二进制版本冲突。建议顺手卸载掉:
sudo pip uninstall docker-compose
这种历史遗留问题,本地用着没事,线上跑起来问题就出来了,提前清掉省心。
基本上按这套走下来,docker-compose 找不到命令的情况都能解决。
如果还有坑,大概率是权限或者系统架构没对上,回头检查一下二进制有没有执行权限,下载的版本跟你的 CPU 架构是不是匹配。
记录一次在 Windows 上修改 Docker 守护进程配置的完整过程,包含文件路径、权限问题、JSON 格式陷阱以及重启服务的两种方式。
一次在 CentOS 上 Docker 怎么都起不来的经历,记录从看日志、查配置到解决 SELinux 与网桥冲突的完整过程。
还在为Socket.IO客户端频繁断线重连而头疼吗?本文为你揭秘其核心重连机制,手把手教你通过调整Manager参数,轻松解决跨域、版本不兼容等常见连接问题。快速掌握关键技巧,让你的Socket.IO应用告别“掉线”烦恼,即刻拥有稳定连接!
Docker镜像拉取慢到怀疑人生?别担心!这份超详细指南将彻底解决您的超时烦恼。从快速配置国内镜像源,到巧妙运用阿里云加速器,再到终极手动下载方案,每一步都清晰明了。更有网络环境自查清单,让您轻松找出症结。立刻掌握这些技巧,让Docker镜像拉取如飞,效率倍增!
想快速拥有强大的向量数据库?本指南教你如何在Docker Desktop上零门槛部署Weaviate!从Docker Compose一键启动,到集成text2vec-openai,再到Python/Java客户端轻松连接,我们手把手解决所有配置难题。告别复杂,立即为你的AI语义搜索和推荐系统注入强劲动力!