在 linux 中为 ansible 主机清单设置私钥路径,需通过主机变量 ansible_private_key_file 或全局配置 private_key_file 指定 ssh 私钥文件,支持 ini/yaml 清单格式及 ansible.cfg 配置,优先级为清单变量 > 全局配置,可配合 -i、-u、--private-key 命令行参数临时指定。

在 Linux 中为 Ansible 主机清单设置私钥路径,核心是让 Ansible 在连接远程主机时使用指定的 SSH 私钥文件,而不是默认尝试 ~/.ssh/id_rsa。这通常通过 主机变量 或 全局配置 实现,不建议在清单中硬编码密码(更安全、更推荐用密钥)。
以下是最常用且可靠的方式:
直接在主机清单中为单台主机或主机组指定私钥
使用 ansible_ssh_private_key_file 变量(Ansible 2.0+ 推荐简写为 ansible_private_key_file),支持 INI 或 YAML 格式。
INI 格式示例(如 /etc/ansible/hosts 或自定义清单):
[webservers] web1 ansible_host=192.168.1.10 ansible_user=ubuntu web2 ansible_host=192.168.1.11 ansible_user=ubuntu [webservers:vars] ansible_private_key_file=/home/admin/.ssh/webserver_key.pem
✅ 这样 web1 和 web2 都会自动使用 /home/admin/.ssh/webserver_key.pem 进行 SSH 认证。
YAML 格式示例(如 inventory.yml):
all:
children:
webservers:
hosts:
web1:
ansible_host: 192.168.1.10
ansible_user: ubuntu
web2:
ansible_host: 192.168.1.11
ansible_user: ubuntu
vars:
ansible_private_key_file: /home/admin/.ssh/webserver_key.pem
通过 ansible.cfg 全局设置(适用于所有主机)
编辑 /etc/ansible/ansible.cfg 或当前目录下的 ansible.cfg,在 [defaults] 段添加:
[defaults] inventory = /etc/ansible/hosts remote_user = ubuntu private_key_file = /home/admin/.ssh/id_rsa_ansible
⚠️ 注意:private_key_file 是 [defaults] 级别变量,对所有主机生效;若清单中某台主机又单独设置了 ansible_private_key_file,则以清单中的变量优先级更高(覆盖全局配置)。
验证是否生效
运行一个简单命令测试连接:
ansible webservers -m ping -i /path/to/your_inventory
如果返回 SUCCESS,说明私钥已正确加载并认证成功。
若报错 Permission denied (publickey),请检查:
- 私钥文件路径是否正确、是否存在、权限是否为
600(chmod 600 /path/to/key) - 对应公钥是否已部署到目标主机的
~ubuntu/.ssh/authorized_keys -
ansible_user是否与目标主机上拥有该authorized_keys的用户一致
补充:临时指定私钥(命令行方式)
不改配置时,也可用 -e 覆盖变量:
ansible all -m ping -i hosts -e "ansible_private_key_file=/tmp/mykey"
或者配合 -u 和 --private-key 参数(更简洁):
ansible all -m ping -i hosts -u ubuntu --private-key=/tmp/mykey
这种方式适合调试或一次性任务,但不适合长期维护。
不复杂但容易忽略。











