190 lines
4.5 KiB
Markdown
190 lines
4.5 KiB
Markdown
# Ansible 管理项目
|
||
|
||
这是一个用于自动化部署和管理多个服务器配置的 Ansible 项目，包括 Caddy 反向代理、frpc 内网穿透和 Docker Compose 服务。
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
ansible_management/
|
||
├── inventory.ini # Ansible 主机清单文件
|
||
├── deploy_caddy.yml # 部署 Caddy 配置
|
||
├── deploy_clash.yml # 部署 Clash 和 Docker Compose 服务
|
||
├── deploy_docker.yml # 部署 Docker Compose 应用
|
||
├── deploy_frpc.yml # 部署 frpc 服务
|
||
└── files/ # 配置文件目录
|
||
├── 192.168.31.101/ # 本地服务器配置
|
||
│ ├── Caddyfile
|
||
│ ├── clash/
|
||
│ ├── dify/
|
||
│ ├── frp/
|
||
│ │ ├── docker-compose.yml
|
||
│ │ └── frpc.toml
|
||
│ ├── lobe-chat-database/
|
||
│ └── openlist/
|
||
└── 192.238.204.39/ # 远程服务器配置
|
||
└── Caddyfile
|
||
```
|
||
|
||
## 前置要求
|
||
|
||
1. **Ansible**：在控制节点上安装 Ansible
|
||
```bash
|
||
# Ubuntu/Debian
|
||
sudo apt update && sudo apt install ansible
|
||
|
||
# macOS
|
||
brew install ansible
|
||
```
|
||
|
||
2. **SSH 访问**：确保可以通过 SSH 无密码访问目标服务器
|
||
```bash
|
||
# 生成 SSH 密钥（如果还没有）
|
||
ssh-keygen -t ed25519
|
||
|
||
# 复制公钥到目标服务器
|
||
ssh-copy-id root@192.168.31.101
|
||
ssh-copy-id root@192.238.204.39
|
||
```
|
||
|
||
3. **目标服务器要求**：
|
||
- 已安装 Python 3（Ansible 需要）
|
||
- 对于 Alpine Linux，可能需要预先安装 Python 3
|
||
|
||
## 配置说明
|
||
|
||
### 主机清单 (inventory.ini)
|
||
|
||
编辑 `inventory.ini` 文件，配置您的服务器信息：
|
||
|
||
```ini
|
||
[caddy_servers]
|
||
# 本地 1panel 服务器
|
||
192.168.31.101
|
||
|
||
# 远程 Ubuntu 服务器
|
||
192.238.204.39
|
||
|
||
[all:vars]
|
||
# 请替换成您登录服务器的用户名
|
||
ansible_user=root
|
||
|
||
# 可选：指定 SSH 密钥路径
|
||
192.168.31.101 ansible_ssh_private_key_file=~/.ssh/id_ed25519
|
||
192.168.204.39 ansible_ssh_private_key_file=~/.ssh/id_ed25519
|
||
```
|
||
|
||
### 配置文件
|
||
|
||
在 `files/` 目录下，为每个主机准备相应的配置文件：
|
||
|
||
- **Caddyfile**：Caddy 反向代理配置
|
||
- **frpc.toml**：frpc 内网穿透配置
|
||
- **docker-compose.yml**：Docker Compose 服务定义
|
||
|
||
文件命名规则：`files/<主机名>/<配置文件>`
|
||
|
||
## 部署命令
|
||
|
||
### 1. 测试连接
|
||
|
||
在部署前，先测试 Ansible 是否能连接到所有主机：
|
||
|
||
```bash
|
||
ansible caddy_servers -i inventory.ini -m ping
|
||
```
|
||
|
||
### 2. 部署 Caddy 配置
|
||
|
||
部署 Caddy 配置文件并重载服务：
|
||
|
||
```bash
|
||
ansible-playbook -i inventory.ini deploy_caddy.yml
|
||
```
|
||
|
||
### 3. 部署 frpc 服务
|
||
|
||
部署 frpc 配置并重启服务：
|
||
|
||
```bash
|
||
ansible-playbook -i inventory.ini deploy_frpc.yml
|
||
```
|
||
|
||
### 4. 部署 Docker Compose 服务
|
||
|
||
部署 Docker Compose 应用：
|
||
|
||
```bash
|
||
ansible-playbook -i inventory.ini deploy_docker.yml
|
||
```
|
||
|
||
### 5. 部署 Clash 服务
|
||
|
||
部署 Clash 相关配置：
|
||
|
||
```bash
|
||
ansible-playbook -i inventory.ini deploy_clash.yml
|
||
```
|
||
|
||
### 6. 部署所有服务
|
||
|
||
一次性部署所有服务：
|
||
|
||
```bash
|
||
ansible-playbook -i inventory.ini deploy_caddy.yml deploy_frpc.yml deploy_docker.yml deploy_clash.yml
|
||
```
|
||
|
||
## 服务说明
|
||
|
||
### Caddy
|
||
|
||
Caddy 是一个自动 HTTPS 的 Web 服务器，用于反向代理多个服务到公网域名。
|
||
|
||
- **配置文件**：`/etc/caddy/Caddyfile`
|
||
- **服务管理**：
|
||
- systemd: `systemctl reload caddy`
|
||
- OpenRC: `rc-service caddy reload`
|
||
|
||
### frpc
|
||
|
||
frpc 是 frp 的客户端，用于内网穿透，将内网服务暴露到公网。
|
||
|
||
- **配置文件**：`/root/frpc/data/frpc.toml`
|
||
- **Docker Compose**：`/root/frpc/docker-compose.yml`
|
||
- **管理命令**：`docker compose -f /root/frpc/docker-compose.yml up -d`
|
||
|
||
### Docker Compose 服务
|
||
|
||
支持通过 Docker Compose 部署的各种应用服务。
|
||
|
||
## 注意事项
|
||
|
||
1. **配置验证**：Caddyfile 会在部署前进行语法验证
|
||
2. **权限设置**：敏感配置文件（如 frpc.toml）使用 `0640` 权限
|
||
3. **系统兼容性**：
|
||
- 支持 systemd（Ubuntu/Debian）
|
||
- 支持 OpenRC（Alpine Linux）
|
||
4. **主机特定配置**：某些任务使用 `when` 条件仅在特定主机上执行
|
||
|
||
## 故障排查
|
||
|
||
### 查看详细输出
|
||
|
||
```bash
|
||
ansible-playbook -i inventory.ini deploy_caddy.yml -vvv
|
||
```
|
||
|
||
### 检查特定主机
|
||
|
||
```bash
|
||
ansible-playbook -i inventory.ini deploy_caddy.yml --limit 192.168.31.101
|
||
```
|
||
|
||
### 仅执行检查（不实际执行）
|
||
|
||
```bash
|
||
ansible-playbook -i inventory.ini deploy_caddy.yml --check
|
||
```
|
||
|
||
## 许可证
|
||
|
||
请参阅 [LICENSE](LICENSE) 文件了解详细信息。 |