dnf install 或 yum install 时出现网络连接失败或超时错误。ping mirrors.tencentyun.com -c 3
cat /etc/resolv.conf# 确保 nameserver 配置正确
# 检查本地防火墙firewall-cmd --list-all# 检查 HTTP 访问curl -I http://mirrors.tencentyun.com/tlinux/
dnf repolistdnf makecache
dnf makecache 或 dnf repolist 同步软件源缓存时，出现类似以下的报错：Error: Failed to synchronize cache for repo '...'
ls /etc/yum.repos.d/
系统版本 | 标准 repo 文件 |
TencentOS Server 3 | TencentOS.repo、epel.repo |
TencentOS Server 4 | TencentOS.repo、epol.repo |
# 备份现有 repo 文件mkdir -p /etc/yum.repos.d/backupmv /etc/yum.repos.d/*.repo /etc/yum.repos.d/backup/# 查看系统版本cat /etc/os-release# 重新配置标准源（TencentOS Server 4，与系统默认配置一致）cat > /etc/yum.repos.d/TencentOS.repo << 'EOF'[BaseOS]name=TencentOS Server $releasever - BaseOSbaseurl=http://mirrors.tencentyun.com/tlinux/$releasever/BaseOS/$basearch/os/http://mirrors.tencent.com/tlinux/$releasever/BaseOS/$basearch/os/gpgcheck=1enabled=1gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-TencentOS-4[AppStream]name=TencentOS Server $releasever - AppStreambaseurl=http://mirrors.tencentyun.com/tlinux/$releasever/AppStream/$basearch/os/http://mirrors.tencent.com/tlinux/$releasever/AppStream/$basearch/os/gpgcheck=1enabled=1gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-TencentOS-4[extras]name=TencentOS Server $releasever - extrasbaseurl=http://mirrors.tencentyun.com/tlinux/$releasever/extras/$basearch/os/http://mirrors.tencent.com/tlinux/$releasever/extras/$basearch/os/gpgcheck=1enabled=1gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-TencentOS-4EOF
dnf clean alldnf makecache
<package-name> 为实际的软件包名）：No match for argument: <package-name>Error: Unable to find a match
cat /etc/os-release
# 搜索软件包（模糊匹配）dnf search <关键词># 查询哪个包提供了某个命令或文件dnf provides /usr/bin/curldnf provides "*/libssl.so*"
# TencentOS Server 4：启用 EPOL（EPEL 的 TencentOS 适配版，标准镜像默认已安装）dnf install -y epol-release# 确认 EPOL 源配置文件存在ls /etc/yum.repos.d/epol.repo# 对于第三方软件（如 Docker），可添加官方 repodnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
dnf 或 yum 命令时，出现类似以下的报错，或命令完全无法执行：SyntaxError: invalid syntax
/usr/bin/python 软链接），导致 dnf/yum 脚本使用了错误的 Python 解释器。# 检查 /usr/bin/dnf 的 shebang 行head -1 /usr/bin/dnf# 应该是 #!/usr/bin/python3# 如果不对，修复它sed -i '1s|.*|#!/usr/bin/python3|' /usr/bin/dnf
head -1 /usr/bin/dnf# 应该是 #!/usr/bin/python3
python3 命令访问，不要修改 /usr/bin/python 软链接。如需管理多个 Python 版本，使用 pyenv：# 使用 pyenv 管理 Python 版本（不影响系统 Python）curl https://pyenv.run | bashpyenv install 3.11.0pyenv global 3.11.0
Error: Problem: package X requires Y, but none of the providers can be installed
# 查看依赖关系dnf deplist <package-name># 查看冲突原因dnf install --best <package-name># 跳过损坏的依赖（不推荐，可能导致系统不稳定）dnf install --skip-broken <package-name># 尝试直接下载 RPM 并安装（忽略 repo 依赖）dnf download <package-name>rpm -ivh --nodeps <package>.rpm
GPG key retrieval failed
# 临时跳过 GPG 验证（调试用）dnf install --nogpgcheck <package-name># 导入腾讯官方 GPG 密钥（系统内置）rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-TencentOS-4# 在 repo 文件中永久跳过 GPG（不推荐，降低安全性）# gpgcheck=0
dnf 相关操作时，出现类似以下的报错：OSError: [Errno 28] No space left on device
# 查看磁盘使用情况df -h# 清理 dnf 缓存dnf clean all# 缓存位置：/var/cache/dnf/# 清理旧内核（保留当前和上一个版本）dnf remove $(dnf repoquery --installonly --latest-limit=-2 -q)# 查看大文件du -sh /var/cache/dnf/
# 安装软件包dnf install -y <package-name># 更新所有软件包dnf update -y# 更新单个软件包dnf update -y <package-name># 删除软件包dnf remove <package-name># 搜索软件包dnf search <keyword># 查看软件包信息dnf info <package-name># 列出已安装的软件包dnf list installed# 查看软件包更新历史dnf history# 回滚到上一次 dnf 操作dnf history undo last# 清理缓存dnf clean all# 仅下载不安装dnf download <package-name>dnf download --resolve --alldeps <package-name> # 含所有依赖
文档反馈