如何借助Jinja2模板与Ansible正确配置HAProxy主机IP及使用hostvars？

API 探路者

2026-5-8

解决Ansible hostvars引用IP变量的问题

我来帮你理清这里的核心问题——你对hostvars的变量引用方式理解有偏差，这才导致生成的HAProxy配置里所有主机的IP都重复成同一个值了。

问题根源

hostvars是Ansible中存储所有主机变量的字典，每个键是主机名，对应的值是该主机的所有facts和自定义变量。但你在Jinja2模板里写的{{ ansible_default_ipv4.address }}，其实是当前正在执行Playbook的主机的默认IP，而不是循环中host对应的目标主机的IP。所以不管循环到哪个主机，都会输出同一个IP。

正确的解决方案

要获取循环中对应主机的IP，你需要通过hostvars字典来精准引用该主机的变量，具体有两种常用方式：

方式1：直接遍历hostvars并引用对应主机的变量

修改你的Jinja2模板片段为：

{% for host in hostvars %}
server {{ host }} {{ hostvars[host].ansible_default_ipv4.address }}
{% endfor %}

这里hostvars[host]会定位到循环中当前主机的变量集合，再加上.ansible_default_ipv4.address就能拿到该主机的正确IP了。

方式2：精准遍历目标主机组（更推荐）

如果你只需要servergroup组内的三台主机，直接遍历组名会更精准，避免意外包含inventory中其他主机：

{% for host in groups['servergroup'] %}
server {{ host }} {{ hostvars[host].ansible_default_ipv4.address }}
{% endfor %}

额外注意事项

要确保Ansible已经收集了所有主机的facts（也就是ansible_default_ipv4这类变量），如果你的Playbook没有开启事实收集，需要在Play级别加上gather_facts: yes，比如：

- name: Deploy HAProxy config
  hosts: servergroup
  gather_facts: yes
  tasks:
    - name: Template a HAProxy config
      template:
        src: ./haproxy.cfg.j2
        dest: /etc/haproxy/haproxy.cfg
        owner: root
        group: root
        mode: '0644'

如果已经开启了gather_facts，这一步可以忽略。