fetch模块默认为每台远程主机生成以主机名或IP命名的独立子目录，dest必须是目录而非文件路径，多主机时文件不会混用但路径嵌套；启用flat: yes可扁平化存放，但同名文件会被覆盖。
fetch 模块默认会为每台远程主机生成独立子目录（以主机名或 IP 命名），所以直接对多台主机运行 fetch，文件不会混在一起，但路径结构容易让人困惑——这是设计使然，不是 bug。
fetch 多主机时 dest 路径怎么写才不冲突
fetch 不支持把多台主机的同名文件“合并”到同一个本地路径。它会在 dest 下自动创建子目录：dest/hostname_or_ip/src_path。比如：
ansible web_servers -m fetch -a "src=/etc/hosts dest=/backup"
结果是：
/backup/192.168.1.10/etc/hosts/backup/192.168.1.11/etc/hosts
这个行为由 inventory 中主机的 inventory_hostname 决定；如果用了别名，就用别名，不是 IP。
常见错误：把 dest 写成带具体文件名的路径（如 /backup/hosts），这会报错，因为 dest 必须是目录。
想让所有主机的文件都落到同一级目录下，用 flat: yes
当只操作单台主机，或你确认所有主机上拉取的文件名互不相同（例如日志按日期命名），可以用 flat: yes 避免嵌套目录：
- name: fetch and flatten
ansible.builtin.fetch:
src: /var/log/nginx/access.log
dest: /tmp/logs/
flat: yes
这时文件会直接落在 /tmp/logs/access.log，但注意：多主机并发执行时，后执行的会覆盖先执行的同名文件。
适用场景：
一款AI工具，主要用于Codex 通用编排：利用 `update_plan` 与后台 PTY 终端并行运行 `codex exec` 工作进程，适合需要提升相关任务效率的用户。
- 调试阶段只拉一台机器
- 每台主机拉的文件名天然不同（如
/tmp/{{ ansible_date_time.date }}.log） - 后续用脚本统一重命名或归档
拉多个不同路径的文件，必须用 loop 或 with_items（Ansible
fetch 模块本身不支持一次指定多个 src，必须靠循环。Playbook 写法最稳妥：
- name: fetch multiple files
ansible.builtin.fetch:
src: "{{ item }}"
dest: /tmp/fetch/
loop:
- /var/log/syslog
- /etc/hostname
- /proc/version
关键点：
-
dest仍必须是目录，不能是文件路径 - 每个
item的远程路径会被映射为dest/hostname/item（除非加flat: yes） - 如果某台主机上某个
src不存在，默认会失败；加fail_on_missing: no可跳过
为什么 fetch 不能拉目录，以及替代方案
fetch 的 src 参数只接受文件，不支持目录（文档明确写 “must be a file, not a directory”）。尝试传目录会报错：src must be a file。
要拉整个目录，得先打包再拉：
- 用
command模块在远程执行tar -cf /tmp/dir.tar /path/to/dir - 再用
fetch拉/tmp/dir.tar - 最后本地解压（或用
archive模块配合fetch自动化）
这个绕路是 fetch 的硬限制，没有参数能绕过。别在 src 后面加 /* 或 **——没用，也不会报错，只是拉不到东西。
真正容易被忽略的是：fetch 不校验远程路径是否存在，直到传输开始才报错；而 fail_on_missing: no 在 Ansible 2.5+ 才默认生效，老版本需显式设置，否则一个文件缺失整条 task 就中断。
