运维,ubuntu,树莓派··约 9 分钟读完·639 次观看
树莓派 Ubuntu 系统登录问题完整指南:解决 Permission denied (publickey)错误
树莓派安装Ubuntu Server后常见SSH登录失败问题(Permission denied (publickey))的解决方案。主要原因是Ubuntu默认禁用密码登录且要求SSH密钥认证。提供四种解决方案:1)通过控制台或SD卡修改启用SSH;2)临时启用密码认证;3)配置SSH密钥(推荐);4)使用Cloud-init自动化配置。特别说明首次启动需修改密码和网络配置注意事项。强调最终应恢复禁用密码登录的安全配置。
linux运维ubuntu
树莓派 Ubuntu 系统登录问题完整指南:解决 Permission denied (publickey)错误
问题背景在树莓派上安装 Ubuntu Server 后,无论是尝试用 root 还是 ubuntu 用户登录,都可能遇到:
bash
1
ssh root@192.168.200.55
2
root@192.168.200.55: Permission denied (publickey).
3
4
ssh ubuntu@192.168.200.55
5
ubuntu@192.168.200.55: Permission denied (publickey).
这是 Ubuntu Server 的默认安全机制,本文将全面解析原因并提供解决方案。
问题根源分析
1. Ubuntu Server 的默认用户机制
Ubuntu Server 镜像(特别是云版本)的特点:
- 默认创建
ubuntu用户(而非 root) - SSH 配置禁止密码登录:
bash
1 # /etc/ssh/sshd_config 默认设置 2 PasswordAuthentication no 3 PermitRootLogin prohibit-password - 需要 SSH 密钥:首次启动时,系统会注入云平台的公钥
2. 树莓派的特殊情况
如果您使用的是:
- 官方 Ubuntu Server 镜像:通常需要首次启动时设置密码
- 云镜像移植到树莓派:可能残留云平台的 SSH 密钥配置
- 手动安装:可能未创建用户或未配置 SSH
3. 日志分析
查看树莓派日志(需通过控制台或已登录的用户):
bash
1
sudo tail -f /var/log/auth.log
典型错误:
text
1
Authentication failure for root from 192.168.200.33
2
Authentication failure for ubuntu from 192.168.200.33
解决方案(按推荐顺序)
方案一:使用控制台/物理访问(最可靠)
如果无法 SSH 登录,必须先通过其他方式访问树莓派:
方法 A:HDMI +键盘
直接连接显示器和键盘登录。
方法 B:SD 卡修改(无头模式)
bash
1
# 在电脑上挂载 SD 卡的 boot 分区
2
# 创建空文件(启用 SSH):
3
touch ssh
4
5
# 创建用户数据文件:
6
echo "I2N1c2VyOiB1YnVudHU6CiAgICBwYXNzd29yZDogJHlvdXJfcGFzc3dvcmQKICAgIGxvY2tf cGFzc3dvcmQ6IGZhbHNlCg==" | base64 -d > user-data
方案二:启用密码认证(快速但需权衡安全)
适用场景:内网测试环境,有防火墙保护
步骤 1:通过控制台登录树莓派
使用上述方法登录(默认用户 ubuntu,首次登录会要求修改密码)。
步骤 2:修改 SSH 配置
bash
1
sudo nano /etc/ssh/sshd_config
修改以下参数:
bash
1
# 启用密码认证
2
PasswordAuthentication yes
3
4
# 允许 root 登录(如果需要)
5
PermitRootLogin yes
6
步骤 3:重启 SSH 服务
bash
1
sudo systemctl restart ssh
2
sudo systemctl status ssh # 确认服务正常
步骤 4:设置 root 密码(如需要)
bash
1
sudo passwd root # 设置 root 密码
2
sudo passwd ubuntu # 确认 ubuntu 密码
步骤 5:从远程登录
bash
1
ssh ubuntu@192.168.200.55 # 输入密码
2
# 或
3
ssh root@192.168.200.55 # 输入密码
方案三:配置 SSH 密钥(推荐长期使用)
如果已启用密码登录:
bash
1
# 上传到 ubuntu 用户
2
ssh-copy-id ubuntu@192.168.200.55
3
4
# 上传到 root 用户(如需要)
5
ssh-copy-id root@192.168.200.55
如果无法密码登录(通过控制台执行):
bash
1
# 在树莓派上
2
sudo mkdir -p /home/ubuntu/.ssh
3
sudo chmod 700 /home/ubuntu/.ssh
4
5
# 将本地公钥内容复制到树莓派
6
sudo nano /home/ubuntu/.ssh/authorized_keys
7
# 粘贴您的公钥(~/.ssh/id_ed25519.pub 内容)
8
9
sudo chmod 600 /home/ubuntu/.ssh/authorized_keys
10
sudo chown -R ubuntu:ubuntu /home/ubuntu/.ssh
11
12
# 对于 root(如需要)
13
sudo mkdir -p /root/.ssh
14
sudo chmod 700 /root/.ssh
15
sudo nano /root/.ssh/authorized_keys
16
# 粘贴公钥
17
sudo chmod 600 /root/.ssh/authorized_keys
步骤 4:测试登录
bash
1
ssh ubuntu@192.168.200.55 # 无需密码
2
ssh root@192.168.200.55 # 无需密码(如配置)
步骤 5:恢复安全配置(重要)
bash
1
sudo nano /etc/ssh/sshd_config
确保:
bash
1
PasswordAuthentication no
2
PermitRootLogin prohibit-password # 或 no
重启 SSH:
bash
1
sudo systemctl restart sshd
方案四:Cloud-init 自动化配置
如果使用 cloud-init 配置树莓派:
yaml
1
#cloud-config
2
hostname: rpi-ubuntu
3
manage_etc_hosts: true
4
5
# 创建用户并设置密码(可选)
6
users:
7
- name: ubuntu groups: users,adm,dialout,audio,netdev,video,plugdev,cdrom,games,input,sudo
8
shell: /bin/bash
9
lock_passwd: false
10
passwd: $6$... # 使用 mkpasswd 生成
11
sudo: ALL=(ALL) NOPASSWD:ALL - name: root
12
lock_passwd: false passwd: $6$... # 仅在测试环境
13
14
#配置 SSH 允许密码(测试环境)
15
ssh_pwauth: true
16
17
# 禁用首次登录强制修改密码(可选)
18
chpasswd:
树莓派 Ubuntu特殊注意事项
1. 首次启动密码设置
Ubuntu Server 首次登录会强制修改密码:
bash
1
# 首次通过控制台登录 ubuntu 用户
2
# 系统会要求立即修改密码
2. 网络配置
确保树莓派网络正常:
bash
1
# 在树莓派上检查
2
ip a # 查看 IP 地址
3
ping 8.8.8.8 # 测试外网
3. WiFi 配置(如使用)
如果使用 WiFi,配置:
bash
1
sudo nano /etc/netplan/50-cloud-init.yaml
示例:
yaml
1
network:
2
version: 2
3
wifis:
4
wlan0:
5
dhcp4: true
6
access-points:
7
"YourWiFiSSID":
8
password: "YourWiFiPassword"
应用配置:
bash
1
sudo netplan apply