
目录
如果您曾经需要逐台配置多台 VPS —— 安装 Nginx、配置防火墙、部署应用或更新系统包 —— 那么 Ansible 就是将数小时工作压缩为数分钟的工具。只需编写一次 Playbook,就能同时在数百台服务器上运行,每次获得相同的结果。
本指南从安装 Ansible 到生产环境最佳实践,附带可直接复制使用的 Playbook 示例。
1. 什么是 Ansible?为什么要使用它?
Ansible 是由 Red Hat 开发的开源 IT 自动化工具,用于配置管理(Configuration Management)、应用程序部署和编排(Orchestration)。其最突出的特点是无代理(Agentless)—— 无需在被管理的 VPS 上安装任何软件,仅通过 SSH 即可工作。
Ansible 的核心优势
- 无代理:通过 SSH 通信,远程服务器无需安装 Agent
- 基于 YAML:Playbook 使用 YAML 编写,易于阅读,无需特殊编程语言
- 幂等性:可以多次运行,结果始终一致,不会重复安装已存在的内容
- 庞大的生态系统:3,000+ 模块,支持云、容器、数据库、网络等
- 版本控制友好:Playbook 是文本文件,可立即存储在 Git 中
| 工具 | 类别 | 语言 | 无代理 | 最适合 |
|---|---|---|---|---|
| Ansible | 配置管理 | YAML | ✅ 是 | VPS 配置、应用部署、OS 设置 |
| Terraform | 基础设施 | HCL | ✅ 是 | 云资源配置 |
| Chef | 配置管理 | Ruby | ❌ 需要 Agent | 企业级、复杂工作流 |
| Puppet | 配置管理 | Puppet DSL | ❌ 需要 Agent | 大规模企业 |
| SaltStack | 配置管理 | Python/YAML | 可选 | 实时事件驱动自动化 |
2. 在控制节点上安装 Ansible
控制节点(Control Node)是安装 Ansible 并向受管节点(VPS 服务器)发送命令的机器,可以是您的笔记本电脑或一台专用管理 VPS。
Ansible 只能安装在 Linux/macOS(控制节点)上,但受管节点支持 Linux 和 Windows。
在 Ubuntu 22.04/24.04 上安装
# 更新软件包列表
sudo apt update
# 从官方 PPA 安装(版本比默认 apt 更新)
sudo apt install -y software-properties-common
sudo add-apt-repository --yes --update ppa:ansible/ansible
sudo apt install -y ansible
# 验证安装
ansible --version
通过 pip 安装(备选方案 — 始终获取最新版本)
pip3 install ansible
ansible --version
3. 为 Ansible 配置 SSH 密钥
Ansible 使用 SSH 连接受管节点,因此必须配置 SSH 密钥认证,避免每次操作都需要输入密码。
在控制节点上生成 SSH 密钥对
# 生成 SSH 密钥(按 Enter 跳过所有提示,不设置密码短语)
ssh-keygen -t ed25519 -C "ansible-key"
# 查看公钥
cat ~/.ssh/id_ed25519.pub
将公钥复制到每台 VPS
# 方法一:使用 ssh-copy-id(最简单)
ssh-copy-id -i ~/.ssh/id_ed25519.pub user@VPS_IP_1
ssh-copy-id -i ~/.ssh/id_ed25519.pub user@VPS_IP_2
# 方法二:循环处理多台服务器
for ip in 203.0.113.1 203.0.113.2 203.0.113.3; do
ssh-copy-id -i ~/.ssh/id_ed25519.pub user@$ip
done
Ansible 使用的 SSH 密钥应与个人 SSH 密钥分开。为自动化创建专用密钥,这样在必要时可以单独撤销。
4. 编写 Inventory:定义受管服务器
Inventory 文件告诉 Ansible 有哪些服务器以及如何分组。支持 INI 格式和 YAML 格式。
INI 格式 Inventory(最简单)
# inventory.ini
[webservers]
web1 ansible_host=203.0.113.1
web2 ansible_host=203.0.113.2
web3 ansible_host=203.0.113.3
[dbservers]
db1 ansible_host=203.0.113.10
db2 ansible_host=203.0.113.11
[all:vars]
ansible_user=ubuntu
ansible_ssh_private_key_file=~/.ssh/id_ed25519
ansible_python_interpreter=/usr/bin/python3
YAML 格式 Inventory(推荐用于生产环境)
# inventory.yml
all:
vars:
ansible_user: ubuntu
ansible_ssh_private_key_file: ~/.ssh/id_ed25519
children:
webservers:
hosts:
web1:
ansible_host: 203.0.113.1
web2:
ansible_host: 203.0.113.2
vars:
http_port: 80
dbservers:
hosts:
db1:
ansible_host: 203.0.113.10
vars:
db_port: 5432
使用 Ping 测试 Inventory
# Ping inventory 中的所有服务器
ansible all -i inventory.yml -m ping
# 只 Ping webservers 组
ansible webservers -i inventory.yml -m ping
5. 第一个 Playbook:在所有服务器安装 Nginx
Playbook 是定义在哪些服务器上按什么顺序执行哪些任务的 YAML 文件,就像服务器的"食谱"。
# nginx-setup.yml
---
- name: 在 Webservers 上安装和配置 Nginx
hosts: webservers
become: yes # 使用 sudo
tasks:
- name: 更新 apt 缓存
apt:
update_cache: yes
cache_valid_time: 3600
- name: 安装 Nginx
apt:
name: nginx
state: present # 如果不存在则安装
- name: 启用并启动 Nginx
systemd:
name: nginx
enabled: yes
state: started
- name: 通过 UFW 允许 80 端口
ufw:
rule: allow
port: '80'
proto: tcp
- name: 通过 UFW 允许 443 端口
ufw:
rule: allow
port: '443'
proto: tcp
运行 Playbook
# 先进行模拟运行(查看会更改什么,不实际执行)
ansible-playbook -i inventory.yml nginx-setup.yml --check
# 实际执行
ansible-playbook -i inventory.yml nginx-setup.yml
# 带详细输出运行
ansible-playbook -i inventory.yml nginx-setup.yml -v
多次运行此 Playbook 是安全的。如果 Nginx 已经安装并运行,Ansible 将跳过相关任务,不进行重复操作。
6. 使用变量和模板
变量使 Playbook 更加灵活。端口、路径和域名等值可以单独定义,而不必在每个任务中硬编码。
在 Playbook 中定义变量
# deploy-app.yml
---
- name: 部署 Web 应用程序
hosts: webservers
become: yes
vars:
app_name: myapp
app_port: 3000
deploy_path: /var/www/myapp
tasks:
- name: 创建应用目录
file:
path: "{{ deploy_path }}"
state: directory
owner: www-data
mode: '0755'
使用 Jinja2 模板生成配置文件
# templates/nginx.conf.j2
server {
listen 80;
server_name {{ domain_name }};
root {{ deploy_path }};
location / {
proxy_pass http://localhost:{{ app_port }};
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
7. 使用 Ansible Roles 组织代码
随着 Playbook 增大,Roles 帮助将任务划分为可重用的独立单元,类似于编程中的函数。
Role 目录结构
roles/
nginx/
tasks/
main.yml # 主要任务
handlers/
main.yml # 处理程序(如重新加载 nginx)
templates/
nginx.conf.j2 # Jinja2 模板
files/
index.html # 静态文件
vars/
main.yml # Role 专用变量
defaults/
main.yml # 默认值(可被覆盖)
使用 ansible-galaxy 创建 Role
# 自动生成 Role 结构
ansible-galaxy init roles/nginx
ansible-galaxy init roles/mysql
ansible-galaxy init roles/firewall
在 Playbook 中使用 Roles
# site.yml
---
- name: 配置 Web 服务器
hosts: webservers
become: yes
roles:
- nginx
- firewall
- name: 配置数据库服务器
hosts: dbservers
become: yes
roles:
- mysql
- firewall
8. 在生产环境中运行 Ansible
在生产环境部署时,这些选项有助于安全高效地工作。
Limit:针对特定服务器
# 只在 web1 上运行
ansible-playbook -i inventory.yml site.yml --limit web1
# 只在 webservers 组上运行
ansible-playbook -i inventory.yml site.yml --limit webservers
# 排除特定服务器
ansible-playbook -i inventory.yml site.yml --limit 'all:!db1'
调整并行执行
# 默认 forks=5(同时运行 5 台主机)
# 增加到同时 20 台
ansible-playbook -i inventory.yml site.yml -f 20
# 或在 ansible.cfg 中配置
[defaults]
forks = 20
9. 生产环境最佳实践
遵循这些最佳实践可以使您的 Ansible 设置在生产环境中保持可维护性和安全性。
使用 Vault 保护机密信息
# 使用 Ansible Vault 加密敏感数据
ansible-vault encrypt_string 'my_db_password' --name 'db_password'
# 创建加密变量文件
ansible-vault create group_vars/all/vault.yml
# 运行 Playbook 时提供 Vault 密码
ansible-playbook site.yml --ask-vault-pass
1. 始终先运行 --check | 2. 将 Playbook 存储在 Git 中 | 3. 使用 --limit 先在一台服务器上测试 | 4. 使用 Vault 保存所有密码 | 5. 在 CI/CD 中设置 ANSIBLE_NOCOWS=1
10. 常见问题
Ansible 和 Terraform 有什么区别?
Ansible 专注于配置管理 —— 配置操作系统、安装软件、部署应用程序。Terraform 专注于基础设施配置 —— 创建和管理云资源,如虚拟机、网络和存储。两者配合使用效果极佳:Terraform 创建 VPS,然后 Ansible 进行配置。
需要在每台 VPS 上安装 Agent 吗?
不需要。Ansible 是无代理的,直接通过 SSH 进行通信,无需在被管理的 VPS 上安装任何特殊软件。只需要 Python 3(Ubuntu 所有版本默认已包含)即可。
Ansible 可以管理 Windows 服务器吗?
可以。Ansible 通过 WinRM(Windows 远程管理)支持 Windows Server,而非 SSH,但需要额外配置。对于 Linux/Ubuntu VPS,Ansible 通过 SSH 即可立即连接,无需额外设置。
Ansible 能扩展到数百台 VPS 服务器吗?
可以。使用 --forks 参数提高并行执行能力(默认为 5,可增加到 50+ 取决于网络情况)。对于大规模部署,Ansible Tower 或 AWX 提供了 Web 界面、基于角色的访问控制和作业调度功能。
Ansible Tower 和 AWX 有什么区别?
AWX 是 Ansible Tower 的开源版本,免费使用但没有官方支持。Ansible Tower(现为 Red Hat Ansible Automation Platform)是商业版本,提供技术支持、SLA 保证和更多企业级功能。
Playbook 和 Ad-hoc 命令有什么区别?
Ad-hoc 命令适用于不需要重复执行的一次性任务,例如重启服务器或检查磁盘空间。Playbook 是存储可重复工作流程的 YAML 文件,可以进行版本控制,存储在 Git 中,并在团队间共享。
总结
Ansible 将管理多台 VPS 从重复的手动工作转变为可靠的自动化流程。从小型 Inventory 和简单 Playbook 开始,随着基础设施的增长,逐步使用 Roles 来组织工作。
最重要的习惯:始终先用 --check 进行测试,并将所有 Playbook 存储在 Git 中,以便团队协作并在需要时回滚。
需要适合 Ansible 的 VPS?
AsiaGB 提供完整 SSH 访问权限的 Ubuntu VPS,99% 正常运行时间,SSD 存储 — 立即开始 Ansible 自动化。
查看 VPS 方案