必须用 /usr/local/bin/ 因为 ubuntu 24.04+ 等新发行版将 /usr/bin/ 锁定，写入后可能被 snap 或包管理器静默覆盖；官方推荐该路径，且需执行 sudo chmod +x 赋权，否则报错 permission denied 或 command not found。
docker-compose 二进制安装为什么必须用 /usr/local/bin/
因为 /usr/bin/ 在 Ubuntu 24.04+、Fedora 39+ 等新发行版中被 snap 或包管理器锁定，写入后可能被静默覆盖或忽略执行权限。官方文档也明确推荐 /usr/local/bin/ 作为用户级工具的标准路径。
安装命令要一次性到位：
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-composesudo chmod +x /usr/local/bin/docker-compose- 验证：
docker-compose --version应输出类似Docker Compose version v2.36.2（截至 2026 年 6 月最新稳定版）
别跳过 chmod +x —— 即使下载成功，没权限也会报 command not found 或 Permission denied。
pip3 install docker-compose 会出什么错
它在 2026 年仍频繁触发 ImportError: cannot import name 'DockerClient'，本质是 docker-py 版本与 docker-compose 不兼容。pip 安装的不是独立二进制，而是 Python 包，依赖链长、版本锁死难解。
除非你明确需要在虚拟环境中隔离使用，否则不建议走 pip 路径。如果已误装：
- 先卸载：
pip3 uninstall docker-compose docker-py - 再删残留：
rm -f ~/.local/bin/docker-compose - 最后用二进制方式重装，避免 PATH 冲突
docker-compose.yml 文件总提示 “No such file or directory”
不是文件真丢了，而是命名或路径不对。docker-compose 默认只认当前工作目录下的 docker-compose.yml 或 docker-compose.yaml，且严格区分大小写。
Docker Image Puller
下载
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
常见翻车点：
- 文件名写成
docker-compose.YML、compose.yml、docker-compose.yml.bak→ 全部失败 - 把文件放在
./prod/下却直接运行docker-compose up→ 必须加-f参数 - 缩进用了 Tab 或 4 个空格 →
docker-compose config直接报 YAML parse error
正确做法：
- 确认当前目录：
pwd；确认文件存在：ls -l docker-compose.yml - 跨目录调用：
docker-compose -f ./prod/docker-compose.yml up -d - 多环境叠加：
docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d
docker-compose up 后容器立刻 exit 1 怎么查
这不是网络或依赖问题，而是服务进程启动即崩溃。exit 1 表示主命令返回非零退出码，根本没跑起来。
排查顺序很关键：
- 先看日志：
docker-compose logs -f nginx（把nginx换成你的 service 名） - 再进容器调试：
docker-compose run --rm --entrypoint sh your-service，手动执行启动命令 - 检查镜像是否拉取成功：
docker images | grep nginx，避免因网络问题 fallback 到本地旧镜像 - 确认端口没被占：
ss -tuln | grep :8080，宿主机端口冲突会导致容器内进程主动退出
真正麻烦的是那些不打日志就挂的服务——比如某些 Go 二进制或 Node.js 应用未捕获异常时，logs 是空的，这时得靠 run --rm 进去手动复现。
