Multipass云初始化配置中SSH密钥传递问题解析

在使用Multipass创建Ubuntu虚拟机时，通过--cloud-init参数传递用户SSH密钥可能会遇到预期外的行为。本文将深入分析这一问题的根源，并提供完整的解决方案。

问题现象

当用户尝试通过Multipass的cloud-init配置创建包含自定义用户和SSH密钥的Ubuntu虚拟机时，可能会发现：

1. 系统为默认的ubuntu用户自动生成了SSH密钥
2. 自定义用户的SSH密钥未能正确写入authorized_keys文件
3. 导致无法通过SSH直接登录自定义用户账户

根本原因分析

经过深入排查，发现这一问题通常由以下几个因素导致：

1. cloud-init配置语法错误：特别是ssh_authorized_keys字段的拼写问题（英式英语vs美式英语）
2. 文件路径检查误区：用户可能检查了错误的.ssh/authorized_keys文件路径
3. 权限问题：新创建的用户目录权限设置不正确

详细解决方案

1. 正确的cloud-init配置

确保使用美式英语拼写ssh_authorized_keys（注意"z"而非"s"）：

#cloud-config

users:
  - default
  - name: customuser
    sudo: ALL=(ALL) NOPASSWD:ALL
    ssh_authorized_keys:
      - "ssh-rsa AAAAB3... customuser"

2. 验证密钥写入位置

创建实例后，通过Multipass shell进入实例，检查正确的文件路径：

multipass shell vm-name
sudo cat /home/customuser/.ssh/authorized_keys

注意：不要混淆/home/ubuntu/.ssh/authorized_keys和自定义用户的对应文件。

3. 权限设置

确保.ssh目录和authorized_keys文件具有正确的权限：

chmod 700 /home/customuser/.ssh
chmod 600 /home/customuser/.ssh/authorized_keys

4. 日志分析

如果问题仍然存在，检查cloud-init日志获取详细信息：

cat /var/log/cloud-init.log
cat /var/log/cloud-init-output.log

最佳实践建议

1. 双重验证：在cloud-init配置中添加write_files部分，写入测试文件确认配置被正确解析
2. 逐步测试：先测试简单配置，再逐步增加复杂度
3. 跨平台注意：在Windows上使用Multipass时，注意文件路径的反斜杠转义问题

总结

Multipass与cloud-init的集成提供了强大的虚拟机配置能力，但需要注意配置细节。通过本文介绍的方法，用户可以确保SSH密钥正确传递并实现自动化登录。记住检查日志和验证文件路径是解决此类问题的关键步骤。

对于更复杂的自动化场景，建议先手动验证配置有效性，再集成到Ansible等自动化工具中。