Windows上运行Ansible需通过WSL2安装Ubuntu并配置、Docker容器运行、源码编译安装，或实验性使用Chocolatey；前三种方法支持完整功能，最后一种仅限基础模块且SSH不兼容。
如果您希望在Windows系统上使用Ansible进行自动化运维，但原生Windows不支持Ansible直接运行，则需借助WSL（Windows Subsystem for Linux）环境部署。以下是多种可行的安装方法：
一、通过WSL2安装Ubuntu并配置Ansible
该方法利用官方Ubuntu发行版在WSL2中构建标准Linux运行环境，确保Ansible所有依赖可完整安装。需先启用WSL功能并安装Ubuntu发行版。
1、以管理员身份打开PowerShell，执行命令启用WSL：dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
2、执行命令启用虚拟机平台：dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
3、重启计算机后，下载并安装WSL2内核更新包（wsl_update_x64.msi）
4、在Microsoft Store中搜索“Ubuntu 22.04 LTS”，点击获取并安装
5、首次启动Ubuntu，等待初始化完成，设置用户名和密码
6、更新系统包索引：sudo apt update
7、安装Python3及pip：sudo apt install -y python3 python3-pip
8、升级pip并安装Ansible：python3 -m pip install --upgrade pip && python3 -m pip install ansible
9、验证安装：ansible --version，确认输出包含ansible [core 2.15.x]等有效版本信息
二、使用Docker Desktop配合WSL2运行Ansible容器
该方法不直接在WSL文件系统中安装Ansible，而是通过Docker容器提供隔离、可复用的Ansible运行时，适合多项目或版本切换频繁场景。
1、确保已安装Docker Desktop并启用WSL2后端，在设置中勾选“Use the WSL 2 based engine”
2、启动WSL2终端，运行命令拉取官方Ansible镜像：docker pull quay.io/ansible/ansible-runner:stable-2.15-devel
3、创建本地工作目录用于存放playbook：mkdir -p ~/ansible-playbooks && cd ~/ansible-playbooks
4、编写测试playbook文件site.yml：echo "- name: Test connection\n hosts: localhost\n gather_facts: false\n tasks:\n - debug:\n msg: 'Ansible is working'" > site.yml
5、执行容器内Ansible命令：docker run --rm -v $(pwd):/runner/project quay.io/ansible/ansible-runner:stable-2.15-devel run project
6、观察输出中出现"msg": "Ansible is working"即表示容器内Ansible运行正常
Windows 桌面自动化技能，支持鼠标控制（移动/点击/拖拽/滚轮/截图）、键盘输入（文字输入/按键/组合键）、窗口管理（查找/聚焦/最大化/最小化/关闭/移动）、截图并发送文件。提供两种截图方式：Python pyautogui 截图（集成在自动化流程中）和 PowerShell + .NET 零依赖截图（支持区域截图和多显示器）。当用户需要自动化 Windows 桌面操作、控制鼠标键盘、管理窗口、执行 GUI 自动化任务、截图发送文件时使用。
三、在WSL中通过Ansible源码编译安装
该方法适用于需要调试Ansible内部逻辑、参与开发或验证特定分支功能的用户，可获得最新未发布特性及完整调试能力。
1、在WSL中安装Git与构建依赖：sudo apt install -y git build-essential libffi-dev libssl-dev
2、克隆Ansible主仓库：git clone https://github.com/ansible/ansible.git ~/ansible-source
3、进入源码目录并检出稳定分支：cd ~/ansible-source && git checkout stable-2.15
4、创建并激活Python虚拟环境：python3 -m venv ~/venv-ansible && source ~/venv-ansible/bin/activate
5、安装基础依赖：pip install -r requirements.txt
6、执行本地安装：pip install -e .
7、配置环境变量使Ansible命令全局可用：echo 'export PATH="$HOME/venv-ansible/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
8、验证命令路径：which ansible，输出应为/home/username/venv-ansible/bin/ansible
四、使用Chocolatey在Windows主机侧安装Ansible（实验性）
该方法通过第三方包管理器Chocolatey尝试安装Windows原生Ansible封装版本，仅限基础模块调用，不推荐用于生产远程管理任务。
1、以管理员身份运行PowerShell，执行命令安装Chocolatey：Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
2、安装Ansible包：choco install ansible
3、安装完成后重启PowerShell，执行命令检查：ansible --version
4、注意此时Ansible无法调用SSH连接模块，报错提示"paramiko or pynacl is not installed"
5、手动安装Python依赖：pip install paramiko pynacl pywin32
6、再次执行ansible --version，若仍显示版本号但ssh连接失败，则表明该方式不支持Windows原生SSH客户端集成
