修改ansible.cfg中fact_path无效，如何自定义Ansible自定义事实路径？

核心检查与修复步骤 #

• 确保配置放在正确段：fact_path必须写在ansible.cfg的[defaults]区块下，放错位置会直接导致配置失效。正确格式如下：

  [defaults]
  fact_path = /home/ansible/facts.d
  

  注意：路径不要加单引号，末尾斜杠可加可不加，不影响生效。

• 检查路径权限：Ansible执行用户（本地执行的当前用户或远程的ansible用户）必须对目标目录和.fact文件有读权限。用以下命令验证：

  ls -ld /home/ansible/facts.d
  ls -l /home/ansible/facts.d/custom.fact
  

  权限不足时执行修正命令：

  chmod 755 /home/ansible/facts.d
  chmod 644 /home/ansible/facts.d/custom.fact
  

• 禁止使用shell变量/波浪线：Ansible配置文件不解析~、$HOME这类shell变量，必须写完整绝对路径，比如直接写/home/ansible/facts.d。

• Playbook中正确配置方式：如果在Playbook里指定路径，要通过setup模块的fact_path参数传递，而非定义全局变量。示例Playbook：

  - name: 加载自定义事实
    hosts: mygroup
    tasks:
      - name: 收集包含自定义路径的事实
        setup:
          fact_path: /home/ansible/facts.d
      - name: 查看自定义事实
        debug:
          var: ansible_local
  

• 验证配置是否生效：用以下命令确认当前生效的fact_path配置，排查是否加载了错误的配置文件（Ansible优先读取当前目录、用户家目录的配置，最后才是系统级/etc/ansible/ansible.cfg）：

  ansible-config dump | grep fact_path
  

• 检查.fact文件格式：自定义事实文件必须是有效的INI或JSON格式，格式错误会静默失败。示例INI格式：

  [custom]
  version = 1.0
  env = production
  

  示例JSON格式：

  {
    "custom": {
      "version": "1.0",
      "env": "production"
    }
  }
  

最终验证 #

配置完成后，可直接指定路径执行命令测试：

ansible mygroup -m setup -a "fact_path=/home/ansible/facts.d" | less

若配置文件已生效，直接执行原命令即可看到合并后的事实，自定义事实会出现在ansible_local节点下。

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