Ansible 基础操作指南（Windows 10 环境下）

小塔猫2025-07-28 10:18

一、Ansible 安装（Windows 10 + WSL2 + Ubuntu）

1. 安装 WSL2

  • 以管理员身份打开 PowerShell，执行命令：

    powershell

    css 复制代码 
    wsl --install

  • 安装完成后重启电脑。

2. 启动并配置 WSL2（Ubuntu）

  • 从开始菜单打开 "Ubuntu"，首次启动需设置用户名和密码。

3. 在 WSL2 中安装 Ansible

依次执行以下命令：

sql 复制代码 
sudo apt update
sudo apt install python3-pip -y
sudo apt install ansible-core

二、Ansible 基础配置

1. 创建工作目录与配置文件

创建工作目录

bash 复制代码 
mkdir ansible-upload && cd ansible-upload

创建主机清单（inventory.ini）

ini 复制代码 
[linux_servers]
your_server_ip ansible_user=your_ssh_username ansible_ssh_pass=your_ssh_password

（替换 your_server_ip、your_ssh_username、your_ssh_password 为实际值）

编写 Playbook（upload.yaml）

yaml 复制代码 
- name: 从 Windows 上传 1.txt 到 Linux 服务器
  hosts: linux_servers
  gather_facts: no
  become: yes  

  tasks:
    - name: 确保目标目录存在
      ansible.builtin.file:
        path: /www/wwwroot
        state: directory
        mode: '0755'
        owner: root
        group: root
    
    - name: 上传 1.txt 文件
      ansible.builtin.copy:
        src: /mnt/c/files/1.txt  # WSL2 访问 Windows 文件路径
        dest: /www/wwwroot/1.txt 
        mode: '0644'
        owner: root
        group: root

三、关键模块与命令说明（ansible.builtin）

模块 / 命令 功能说明
ansible.builtin.file 管理文件 / 目录（创建、删除、权限、所有者等）
ansible.builtin.copy 本地文件复制到远程主机
ansible.builtin.fetch 远程文件下载到本地
ansible.builtin.template 用 Jinja2 模板生成远程文件（支持变量替换）
ansible.builtin.lineinfile 修改文件特定行（替换配置、添加行）
ansible.builtin.blockinfile 向文件插入 / 替换整块内容（带标记防重复）
ansible.builtin.unarchive 解压压缩包（本地传远程 / 远程直接解压）
ansible.builtin.archive 远程文件 / 目录打包压缩（支持 tar、zip）
ansible.builtin.command 远程执行命令（不经过 shell，不支持管道 / 变量）
ansible.builtin.shell 通过 shell 执行远程命令（支持管道、重定向）
ansible.builtin.script 本地脚本传远程并执行（自动处理权限）
ansible.builtin.service 管理系统服务（启动、停止、开机自启等）
ansible.builtin.package 通用包管理（适配 yum/apt，安装 / 卸载软件）
ansible.builtin.user 管理系统用户（创建、删除、密码、所属组）
ansible.builtin.group 管理用户组（创建、删除、属性修改）
ansible.builtin.stat 获取远程文件 / 目录信息（是否存在、权限、校验和）
ansible.builtin.find 远程查找文件（按名称、大小、时间筛选）
ansible.builtin.replace 批量替换文件字符串（支持正则）
ansible.builtin.get_url 从 URL 下载文件到远程主机（HTTP/HTTPS/FTP）
ansible.builtin.set_fact 定义自定义变量（Playbook 跨任务使用）

四、进阶场景示例

1. 多服务器差异化操作

yaml 复制代码 
- name: 多服务器差异化上传
  hosts: linux_servers
  gather_facts: no
  become: yes

  tasks:
    - name: 101.37.28.194 创建 pay 目录
      ansible.builtin.file:
        path: /www/wwwroot/pay
        state: directory
        mode: 0755
        owner: root
        group: root
      when: inventory_hostname == '101.37.28.194'

    - name: 101.37.28.194 上传 cesi.zip
      ansible.builtin.copy:
        src: /mnt/d/tool/phpstudy_pro/www/project/python/ansible-upload/cesi.zip
        dest: /www/wwwroot/pay/cesi.zip
        mode: 0644
        owner: root
        group: root
      when: inventory_hostname == '101.37.28.194'

2. 上传并解压压缩包

yaml 复制代码 
- name: 上传并解压
  hosts: linux_servers
  gather_facts: no
  become: yes

  tasks:
    - name: 101.37.28.194 创建 pay 目录
      ansible.builtin.file:
        path: /www/wwwroot/pay
        state: directory
        mode: 0755
        owner: root
        group: root
      when: inventory_hostname == '101.37.28.194'

    - name: 上传 cesi.zip 到 pay 目录
      ansible.builtin.copy:
        src: /mnt/d/tool/phpstudy_pro/www/project/python/ansible-upload/cesi.zip
        dest: /www/wwwroot/pay/cesi.zip
        mode: 0644
        owner: root
        group: root
      when: inventory_hostname == '101.37.28.194'

    - name: 解压 cesi.zip 到 pay 目录
      ansible.builtin.unarchive:
        src: /www/wwwroot/pay/cesi.zip
        dest: /www/wwwroot/pay/
        remote_src: yes
      when: inventory_hostname == '101.37.28.194'

3. 本地压缩 → 上传 → 解压 → 删除压缩包

yaml 复制代码 
- name: 本地压缩并上传解压
  hosts: linux_servers
  gather_facts: no
  become: yes

  pre_tasks:
    - name: 本地压缩 opencart 为 opencart.zip
      delegate_to: localhost
      become: false
      ansible.builtin.archive:
        path: /mnt/d/tool/phpstudy_pro/www/project/opencart
        dest: /mnt/d/tool/phpstudy_pro/www/project/python/ansible-upload/opencart.zip
        format: zip

  tasks:
    - name: 101.37.28.194 创建 pay 目录
      ansible.builtin.file:
        path: /www/wwwroot/pay
        state: directory
        mode: 0755
        owner: root
        group: root
      when: inventory_hostname == '101.37.28.194'

    - name: 上传 opencart.zip 到 pay 目录
      ansible.builtin.copy:
        src: /mnt/d/tool/phpstudy_pro/www/project/python/ansible-upload/opencart.zip
        dest: /www/wwwroot/pay/opencart.zip
        mode: 0755
        owner: root
        group: root
      when: inventory_hostname == '101.37.28.194'

    - name: 解压 opencart.zip 到 pay 目录
      ansible.builtin.unarchive:
        src: /www/wwwroot/pay/opencart.zip
        dest: /www/wwwroot/pay/
        remote_src: yes
      when: inventory_hostname == '101.37.28.194'

    - name: 删除 opencart.zip 压缩包
      ansible.builtin.file:
        path: /www/wwwroot/pay/opencart.zip
        state: absent
      when: inventory_hostname == '101.37.28.194'

4. 基于主机变量的批量定制操作

  1. 创建 host_vars 目录 ，按服务器 IP 定义变量文件（如 101.37.28.40.yml、101.37.28.194.yml）。

    • 101.37.28.40.yml：

      yaml

      javascript 复制代码 
      operation: upload_file
src_file: /mnt/d/tool/phpstudy_pro/www/project/python/ansible-upload/测试.txt
target_file: /www/wwwroot/测试.txt

    • 101.37.28.194.yml：

      yaml

      javascript 复制代码 
      operation: upload_and_unzip
src_folder: /mnt/d/tool/phpstudy_pro/www/project/opencart
zip_name: opencart.zip
target_dir: /www/wwwroot/pay
src_file: /mnt/d/tool/phpstudy_pro/www/project/python/ansible-upload/测试.txt
target_file: /www/wwwroot/pay/测试.txt

  2. 编写 Playbook：

yaml 复制代码 
- name: 多主机定制操作
  hosts: linux_servers
  gather_facts: no
  become: yes

  pre_tasks:
    - name: 本地压缩 opencart（仅 101.37.28.194）
      delegate_to: localhost
      become: false
      ansible.builtin.archive:
        path: "{{ src_folder | default('') }}"
        dest: "/mnt/d/tool/phpstudy_pro/www/project/python/ansible-upload/{{ zip_name | default('') }}"
        format: zip
      when:
        - operation == 'upload_and_unzip'
        - inventory_hostname == '101.37.28.194'

  tasks:
    - name: 上传并解压 zip（仅 101.37.28.194）
      ansible.builtin.copy:
        src: "/mnt/d/tool/phpstudy_pro/www/project/python/ansible-upload/{{ zip_name }}"
        dest: "{{ target_dir }}/{{ zip_name }}"
        mode: 0755
        owner: root
        group: root
      when: operation == 'upload_and_unzip'

    - name: 解压 zip 到目标目录（仅 101.37.28.194）
      ansible.builtin.unarchive:
        src: "{{ target_dir }}/{{ zip_name }}"
        dest: "{{ target_dir }}/"
        remote_src: yes
      when: operation == 'upload_and_unzip'

    - name: 删除 zip 包（仅 101.37.28.194）
      ansible.builtin.file:
        path: "{{ target_dir }}/{{ zip_name }}"
        state: absent
      when: operation == 'upload_and_unzip'

    - name: 通用文件上传（任意主机）
      ansible.builtin.copy:
        src: "{{ src_file }}"
        dest: "{{ target_file }}"
        mode: 0644
        owner: root
        group: root
      when:
        - src_file is defined
        - target_file is defined

五、关键注意事项

  1. SSH 认证问题：

    • 若服务器禁用密码登录，需改用密钥认证，修改 inventory.ini：

      ini

      ini 复制代码 
      your_server_ip ansible_user=your_ssh_username ansible_ssh_private_key_file=/path/to/private_key

  2. 主机密钥检查：

    • 永久禁用可修改 ~/.ansible.cfg：

      ini

      ini 复制代码 
      [defaults]
host_key_checking = False

  3. 权限问题：

    • 确保 become: yes 获得足够权限，避免因权限不足导致操作失败。

  4. 路径一致性：

    • 本地文件路径需通过 WSL2 访问（如 /mnt/c/ 映射 Windows C 盘），确保路径拼写、大小写一致。

通过以上步骤，可在 Windows 10 环境下利用 Ansible 完成从基础文件上传到复杂多服务器、多场景的自动化操作。

相关推荐
微笑听雨37 分钟前
Java 设计模式之单例模式（详细解析）
java·后端
微笑听雨37 分钟前
【Drools】（二）基于业务需求动态生成 DRL 规则文件：事实与动作定义详解
java·后端
snakeshe101037 分钟前
Java运算符终极指南：从基础算术到位运算实战
后端
ezl1fe41 分钟前
RAG 每日一技（七）：只靠检索还不够？用Re-ranking给你的结果精修一下
后端
天天摸鱼的java工程师1 小时前
🔧 MySQL 索引的设计原则有哪些？【原理 + 业务场景实战】
java·后端·面试
snakeshe10101 小时前
Maven核心功能与IDEA高效调试技巧全解析
后端
*愿风载尘*2 小时前
ksql连接数据库免输入密码交互
数据库·后端
溟洵2 小时前
Qt 窗口 工具栏QToolBar、状态栏StatusBar
开发语言·前端·数据库·c++·后端·qt
ppo922 小时前
MCP简单应用：使用SpringAI + Cline + DeepSeek实现AI创建文件并写入内容
人工智能·后端
创码小奇客2 小时前
Talos 使用全攻略：从基础到高阶，常见问题一网打尽
java·后端·架构
热门推荐
01Qwen3-Coder 快速上手教程 | Qwen Code + Claude Code02扣子开源本地部署教程 丨Coze智能体小白喂饭级指南03Coze 开源了，送上保姆级私有化部署方案【建议收藏】04全球最强模型Grok4，国内已可免费使用！（附教程）05vue数据变化但页面不变06KGG转MP3工具|非KGM文件|解密音频07干翻 Typora！MilkUp：完全免费的桌面端 Markdown 编辑器！0801-开源版COZE-字节 Coze Studio 重磅开源！保姆级本地安装教程，手把手带你体验09腾讯还是太全面了，限时免费！超全CodeBuddy IDE保姆级教程！（附案例）10sqli-labs 靶场 less-8、9、10 第八关到第十关详解：布尔注入，时间注入