如何让Ansible识别同一物理服务器的多主机名避免重复执行？

完全可以实现这个需求，核心思路是将同一物理机的多个连接地址抽象为单个主机条目，通过前置任务自动检测并切换可达的连接地址，确保playbook只执行一次。以下是具体实现方案：

方法一：单主机条目 + 动态选择连接地址（推荐） #

这种方式最简洁，直接在inventory中定义一个代表物理服务器的主机，再通过变量配置所有可能的连接地址，最后用前置任务筛选可达地址。

1. 配置Inventory和主机变量 #

首先在你的inventory文件（比如hosts.ini）中定义单个主机：

[servers]
my_physical_server

然后在host_vars/my_physical_server.yml文件中配置所有候选连接地址（按优先级排序，比如本地地址优先）：

# 候选主机名，顺序决定优先级（本地在前，VPN在后）
possible_hosts:
  - local-server.lan
  - ts-server.tailscale.net
ansible_user: your_ssh_username
ansible_ssh_private_key_file: ~/.ssh/your_key

2. 编写Playbook实现自动切换 #

在playbook中添加前置任务，先检测所有候选地址的连通性，筛选出第一个可达的地址作为实际连接目标：

- name: 确定可达的服务器连接地址
  hosts: my_physical_server
  gather_facts: no  # 先不收集facts，等确定连接地址后再执行
  tasks:
    - name: 测试每个候选地址的SSH端口连通性
      wait_for:
        host: "{{ item }}"
        port: 22
        timeout: 3  # 超时时间可根据网络调整
      register: connectivity_check
      loop: "{{ possible_hosts }}"
      ignore_errors: true  # 忽略不可达地址的错误

    - name: 选择第一个可达的地址作为连接目标
      set_fact:
        ansible_host: "{{ item.item }}"
      when: item is succeeded
      loop: "{{ connectivity_check.results }}"
      loop_control:
        stop: yes  # 找到第一个可达地址就停止循环

    - name: 无可用地址时终止执行
      fail:
        msg: "本地和Tailscale地址均不可达，无法连接服务器"
      when: ansible_host is not defined

- name: 执行服务器配置任务
  hosts: my_physical_server
  gather_facts: yes
  become: true
  tasks:
    - name: 示例任务：更新系统包
      apt:
        update_cache: yes
        upgrade: dist

    - name: 其他配置任务...
      # 这里的所有任务只会执行一次，因为只针对单个主机条目

方法二：多主机条目 + 按物理机分组去重 #

如果一定要在inventory中保留两个主机名条目，可以通过标记唯一物理机ID，再筛选可达主机并确保任务只执行一次。

1. 配置Inventory #

给两个主机条目添加相同的server_unique_id变量，标记为同一物理机：

[servers]
local_server ansible_host=local-server.lan server_unique_id=my_server_01
tailscale_server ansible_host=ts-server.tailscale.net server_unique_id=my_server_01

[servers:vars]
ansible_user: your_ssh_username

2. 编写Playbook去重执行 #

通过分组和run_once参数，确保同一物理机只执行一次任务：

- name: 检测所有主机的连通性
  hosts: servers
  gather_facts: no
  tasks:
    - name: 测试SSH端口连通性
      wait_for:
        host: "{{ ansible_host }}"
        port: 22
        timeout: 3
      register: conn_result
      ignore_errors: true

    - name: 按物理机ID和连通性分组
      group_by:
        key: "reachable_{{ server_unique_id }}_{{ conn_result is succeeded }}"

- name: 针对每个物理机的可达地址执行一次任务
  hosts: reachable_*_True
  gather_facts: yes
  become: true
  tasks:
    - name: 示例配置任务
      debug:
        msg: "正在配置服务器 {{ ansible_host }}"
      run_once: true  # 确保同一物理机只执行一次

    - name: 其他配置任务...
      run_once: true

关键优势 #

• 自动切换：优先使用本地地址，本地不可达时自动切换到Tailscale地址
• 避免重复：无论有几个可达地址，playbook只会对同一物理机执行一次
• 灵活扩展：后续新增连接地址（比如其他VPN），只需在possible_hosts中添加即可

内容的提问来源于stack exchange，提问作者Tiim