Windows安装Ansible教程：WSL配置远程管理方法

在Windows系统上原生运行Ansible存在限制，本文系统梳理了四种主流可行方案：首选推荐通过WSL2安装Ubuntu并配置Ansible，可获得完整功能与最佳兼容性；其次可借助Docker Desktop+WSL2运行官方Ansible容器，适合多环境隔离与快速切换；第三种源码编译安装则面向开发者，支持调试与前沿特性验证；而Chocolatey安装虽操作简便，但仅限基础模块且SSH功能不可用，属实验性质。无论你是运维工程师、DevOps实践者还是Ansible爱好者，都能从中找到适配自身需求的高效部署路径。

如果您希望在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运行正常

三、在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客户端集成

今天关于《Windows安装Ansible教程：WSL配置远程管理方法》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！