猫头虎分享已解决Bug || Permission denied (publickey). 解决方案

虎头金猫

于 2024-08-10 09:32:18 发布

阅读量867

点赞数 26

分类专栏：已解决的Bug 文章标签： bug issue centos 容器 jenkins 服务器运维

本文链接：https://blog.csdn.net/2301_76147196/article/details/141086122

版权

已解决的Bug 专栏收录该内容

145 篇文章 2 订阅

订阅专栏

猫头虎分享已解决Bug || `Permission denied (publickey).` 解决方案 🛠️

今天猫头虎带您解决一个在运维过程中非常常见的错误提示：Permission denied (publickey).。这个问题常常出现在开发者和运维人员在通过SSH连接服务器时，尤其是在配置不当或公钥认证出现问题的情况下。

本文摘要：

在这篇博客中，我们将详细探讨为什么会出现Permission denied (publickey).错误，可能的根本原因是什么，以及如何一步一步地解决它。关键词：SSH连接、公钥认证、服务器访问、错误修复。除此之外，我们还将展示一些实用的命令和配置技巧，帮助您避免日后再次遇到类似问题。

猫头虎是谁？

大家好，我是猫头虎，别名猫头虎博主，擅长的技术领域包括云原生、前端、后端、运维和AI。我的博客主要分享技术教程、bug解决思路、开发工具教程、前沿科技资讯、产品评测图文、产品使用体验图文、产品优点推广文稿、产品横测对比文稿，以及线下技术沙龙活动参会体验文稿。内容涵盖云服务产品评测、AI产品横测对比、开发板性能测试和技术报告评测等。

目前，我活跃在CSDN、51CTO、腾讯云开发者社区、阿里云开发者社区、知乎、微信公众号、视频号、抖音、B站和小红书等平台，全网拥有超过30万的粉丝，统一IP名称为猫头虎或者猫头虎博主。希望通过我的分享，帮助大家更好地了解和使用各类技术产品。

作者名片 ✍️

博主：猫头虎
全网搜索关键词：猫头虎
作者微信号：Libin9iOak
作者公众号：猫头虎技术团队
更新日期：2024年08月08日
🌟 欢迎来到猫头虎的博客 — 探索技术的无限可能！

加入我们AI共创团队 🌐

猫头虎AI共创社群矩阵列表：
- 点我进入共创社群矩阵入口
- 点我进入新矩阵备用链接入口

加入猫头虎的共创圈，一起探索编程世界的无限可能！ 🚀

部分专栏链接：

🔗 精选专栏：

《面试题大全》 — 面试准备的宝典！
《IDEA开发秘籍》 — 提升你的IDEA技能！
《100天精通鸿蒙》 — 从Web/安卓到鸿蒙大师！
《100天精通Golang（基础入门篇）》 — 踏入Go语言世界的第一步！
《100天精通Go语言（精品VIP版）》 — 踏入Go语言世界的第二步！

文章目录

**猫头虎分享已解决Bug** || `Permission denied (publickey).` 解决方案 🛠️

1. 背景介绍：SSH连接与公钥认证

在运维工作中，SSH（Secure Shell）是一种常见的网络协议，它允许用户通过不安全的网络安全地访问远程计算机。通常，我们使用公钥和私钥来认证和加密SSH连接。这种方式不仅安全，而且方便。但当配置出现问题时，就会产生我们今天要讨论的错误——Permission denied (publickey).。

1.1 为什么会出现这个错误？

原因1： 服务器上没有公钥：客户端尝试连接时，服务器找不到与之匹配的公钥，导致认证失败。

原因2： 权限配置问题：用户目录、.ssh目录或authorized_keys文件的权限不正确，导致公钥认证失败。

原因3： 公钥不匹配：客户端提供的公钥与服务器端的authorized_keys文件中存储的公钥不一致。

2. 解决方案：逐步排查与修复

猫哥的建议是从以下几个步骤依次检查和解决：

2.1 确认公钥是否正确传输到服务器 📁

在客户端生成公钥（如果还没有的话）：

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

将生成的公钥复制到服务器：

ssh-copy-id user@server_address

此命令会自动将您的公钥追加到远程服务器的~/.ssh/authorized_keys文件中。如果您手动复制公钥，请确保公钥正确添加到了authorized_keys文件中。

2.2 检查文件权限是否正确 🔒

SSH对文件权限非常敏感。如果文件权限设置不当，可能会导致公钥认证失败。确保以下目录和文件的权限设置正确：

chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

2.3 验证SSH服务端配置 ⚙️

有时候，服务器的SSH配置文件/etc/ssh/sshd_config中可能禁用了公钥认证。确保以下设置被正确配置：

# 确保以下行未被注释并设置为yes
PubkeyAuthentication yes
AuthorizedKeysFile .ssh/authorized_keys

修改后，别忘了重启SSH服务：

sudo systemctl restart sshd

2.4 检查是否有多余的身份认证方式 🔍

有时，客户端会尝试使用不正确的身份验证方式，这可能导致连接失败。您可以通过强制指定身份验证方式来解决这个问题：

ssh -i ~/.ssh/id_rsa user@server_address

这样做可以确保SSH只使用指定的私钥进行认证。

3. 常见问题 (QA)

Q1： 为什么在执行这些步骤后，仍然出现Permission denied (publickey)？

A：请检查服务器端是否存在其他可能影响连接的安全配置，或者是否有防火墙阻止SSH访问。

Q2： 我如何确保以后不会再遇到这个问题？

A：定期检查服务器的权限配置，特别是在更改用户或移动服务器时，并确保公钥文件安全无误。

4. 本文总结与未来展望

通过以上步骤，您应该可以解决常见的SSH连接问题。正如我们所看到的，Permission denied (publickey)问题通常源于简单的配置错误或权限设置问题。在未来，随着自动化工具的普及，类似的配置问题可能会更加容易被自动检测和修复。

这是高亮加粗大一号斜体的道奇蓝色courier New字体 更多最新AI运维资讯欢迎点击文末加入猫头虎AI共创社群！

表格总结：

步骤	命令/检查点	描述
生成公钥	`ssh-keygen -t rsa -b 4096`	生成新的SSH公钥
复制公钥	`ssh-copy-id user@server_address`	将公钥复制到服务器
权限设置	`chmod 700 ~/.ssh` & `chmod 600 ~/.ssh/authorized_keys`	设置正确的文件权限
配置检查	检查`/etc/ssh/sshd_config`	确保公钥认证已启用
强制身份认证	`ssh -i ~/.ssh/id_rsa user@server_address`	指定私钥进行连接