问题现象

在使用1Panel面板（开源Linux运维面板）安装或更新应用时，可能遇到提示“依赖缺失”或“缺少必要软件包”，导致安装中断。常见依赖包括curl、wget、git、unzip、tar、docker-ce、compose等。

通用修复步骤

1. 通过官方脚本修复

1Panel提供了环境检测与修复脚本，可自动补齐缺失依赖：

curl -sSL https://resource.1panel.hk/quick_start.sh -o quick_start.sh && bash quick_start.sh

脚本运行后选择“修复环境”选项即可。

2. 手动安装常见依赖

如果自动脚本无效，请根据操作系统手动安装：

• CentOS / Rocky Linux / AlmaLinux

  yum install -y curl wget git unzip tar

• Ubuntu / Debian

  apt update && apt install -y curl wget git unzip tar

3. Docker与Compose依赖修复

部分1Panel功能依赖Docker及Compose，若缺少可执行：

curl -sSL https://get.docker.com | sh

安装Docker后，再安装Compose：

curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && chmod +x /usr/local/bin/docker-compose

校验依赖是否齐全

修复完成后，运行以下命令确认依赖已安装：

for cmd in curl wget git unzip tar docker docker-compose; do command -v $cmd &>/dev/null && echo "$cmd 已安装" || echo "$cmd 未安装"; done

常见错误排查

• 错误提示“Package not found”：请检查系统是否已配置正确的软件源（EPEL、阿里云源等）。
• 提示“Permission denied”：使用sudo或以root用户执行安装命令。
• Docker服务启动失败：查看systemctl status docker，并根据日志安装缺失内核模块或更新内核。

总结

1Panel依赖缺失问题多由系统环境未预装常见工具引起。优先使用官方修复脚本，次选手动安装。确保系统软件源正确后，可顺利解决绝大多数安装依赖报错。