在 Kali Linux 上遇到安装 docker-compose 报错时，优先推荐使用 apt 包管理器进行安装，若必须使用 pip3 则需先补全系统编译依赖，避免 Python 环境冲突。
先说结论：系统级工具建议走 apt 通道，pip 仅作为特定版本需求的补充方案，且需注意 Python 版本兼容性。
- 先确认：检查是 apt 依赖损坏还是 pip 缺少编译库
- 先处理：优先修复 apt 破损依赖，再尝试安装
- 再验证：通过版本命令确认工具可用性
命令速用版
如果希望快速恢复环境，可依次尝试以下命令。若 apt 安装失败，再考虑 pip 方案。
sudo apt `--fix-broken` install sudo apt update sudo apt install docker-compose
若必须使用 pip 安装，请确保先安装基础依赖：
sudo apt install python3-pip libffi-dev python3-dev openssl-dev pip3 install `--upgrade` pip pip3 install docker-compose
为什么会这样
Kali Linux 基于 Debian 滚动发行版，系统包管理器 apt 与 Python 包管理器 pip 存在管辖权冲突。公开资料中没有看到可靠的量化数据说明哪种方式绝对更好，但社区经验表明，直接使用 apt 安装系统工具更稳定。
报错通常由以下原因导致：
- 依赖缺失：pip 安装某些包时需要编译，缺少 libffi、openssl 等开发库会导致 gcc 编译失败。
- 环境冲突：Python 3.12 及以上版本中，pip 安装依赖方式逐步弃用，因为软件包已通过 APT 管理，混用可能破坏环境。
- 文件损坏：下载的安装文件不完整，可能导致脚本首行出现 html 内容而非正确的解释器声明。
分步处理
按照以下顺序排查，每一步完成后请确认是否解决问题。
1. 修复 apt 依赖状态
如果 apt 安装过程中报错，可能是之前安装中断导致依赖破损。运行以下命令尝试自动修复：
sudo apt `--fix-broken` install
修复完成后，更新列表并重新安装：
sudo apt update sudo apt install docker-compose
2. 补全 pip 编译依赖
如果必须使用 pip 安装（例如需要特定版本），请先安装系统级开发库，避免报错“Python.h: No such file or directory”：
sudo apt install python3-pip libffi-dev python3-dev openssl-dev
随后升级 pip 工具本身，再安装 docker-compose：
pip3 install `--upgrade` pip pip3 install docker-compose
3. 检查文件完整性
若提示“html: No such file or directory”，可能是下载的文件损坏。检查文件首行是否为正确的 shebang（如 #!/usr/bin/env python3），必要时重新下载或手动修正文件权限：
chmod +x /usr/local/bin/docker-compose
怎么验证是否生效
安装完成后，使用以下命令检查版本信息，若能正常输出版本号则说明安装成功：
docker-compose `--version`
或者：
docker-compose -version
若命令未找到，请检查 /usr/local/bin 是否在环境变量 PATH 中。
常见坑
- 混用管理器：不要同时用 apt 和 pip 管理同一个包，容易导致环境混乱。
- Python 版本限制：在新版 Kali（Python ≥ 3.12）中，pip 安装系统依赖可能被限制，建议优先使用 apt 或 pipx。
- 网络源问题：pip 安装失败有时是因为网络超时，可尝试指定国内源，但需注意安全性。
- 权限不足：安装系统目录文件时务必使用 sudo，避免权限报错。
参考来源
- CSDN 博客 - Kali Linux 系统安装 Docker-compose
- 技术社区记录 - 解决 Kali Linux 中 pip 安装报错问题
- 技术社区记录 - 解决在 Kali Linux 上安装 docker-compose 时出现的错误
- 技术社区记录 - kali 无法安装 docker 问题解决
- 技术社区记录 - 使用 pip 安装 docker-compose 报错问题
原文链接：https://www.zjcp.cc/ask/10253.html