mirror of
https://github.com/openclaw/openclaw.git
synced 2026-04-24 03:18:38 +00:00
Docs: add zh-CN translations
This commit is contained in:
Josh Palmer
215
docs/zh-CN/install/ansible.md
Normal file
215
docs/zh-CN/install/ansible.md
Normal file
@@ -0,0 +1,215 @@
|
||||
---
|
||||
read_when:
|
||||
- 你需要通过安全加固进行自动化服务器部署
|
||||
- 你需要带 VPN 访问的防火墙隔离设置
|
||||
- 你要部署到远程 Debian/Ubuntu 服务器
|
||||
summary: 使用 Ansible、Tailscale VPN 和防火墙隔离进行自动化、安全加固的 OpenClaw 安装
|
||||
title: Ansible
|
||||
x-i18n:
|
||||
generated_at: "2026-02-01T21:05:32Z"
|
||||
model: claude-opus-4-5
|
||||
provider: pi
|
||||
source_hash: 896807f344d923f09039f377c13b4bf4a824aa94eec35159fc169596a3493b29
|
||||
source_path: install/ansible.md
|
||||
workflow: 14
|
||||
---
|
||||
|
||||
# Ansible 安装
|
||||
|
||||
将 OpenClaw 部署到生产服务器的推荐方式是使用 **[openclaw-ansible](https://github.com/openclaw/openclaw-ansible)** — 一个采用安全优先架构的自动化安装工具。
|
||||
|
||||
## 快速开始
|
||||
|
||||
一条命令安装：
|
||||
|
||||
```bash
|
||||
curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/install.sh | bash
|
||||
```
|
||||
|
||||
> **📦 完整指南：[github.com/openclaw/openclaw-ansible](https://github.com/openclaw/openclaw-ansible)**
|
||||
>
|
||||
> openclaw-ansible 仓库是 Ansible 部署的权威来源。本页面仅为简要概览。
|
||||
|
||||
## 你将获得
|
||||
|
||||
- 🔒 **防火墙优先的安全策略**：UFW + Docker 隔离（仅 SSH + Tailscale 可访问）
|
||||
- 🔐 **Tailscale VPN**：安全的远程访问，无需公开暴露服务
|
||||
- 🐳 **Docker**：隔离的沙箱容器，仅绑定 localhost
|
||||
- 🛡️ **纵深防御**：4 层安全架构
|
||||
- 🚀 **一条命令部署**：几分钟内完成完整部署
|
||||
- 🔧 **Systemd 集成**：开机自启并带有安全加固
|
||||
|
||||
## 前置要求
|
||||
|
||||
- **操作系统**：Debian 11+ 或 Ubuntu 20.04+
|
||||
- **访问权限**：Root 或 sudo 权限
|
||||
- **网络**：用于安装软件包的互联网连接
|
||||
- **Ansible**：2.14+（快速启动脚本会自动安装）
|
||||
|
||||
## 安装内容
|
||||
|
||||
Ansible playbook 会安装并配置以下组件：
|
||||
|
||||
1. **Tailscale**（用于安全远程访问的 mesh VPN）
|
||||
2. **UFW 防火墙**（仅开放 SSH + Tailscale 端口）
|
||||
3. **Docker CE + Compose V2**（用于智能体沙箱）
|
||||
4. **Node.js 22.x + pnpm**（运行时依赖）
|
||||
5. **OpenClaw**（基于主机安装，非容器化）
|
||||
6. **Systemd 服务**（带安全加固的自动启动）
|
||||
|
||||
注意：Gateway **直接运行在主机上**（不在 Docker 中），但智能体沙箱使用 Docker 进行隔离。详见 [沙箱](/gateway/sandboxing)。
|
||||
|
||||
## 安装后设置
|
||||
|
||||
安装完成后，切换到 openclaw 用户：
|
||||
|
||||
```bash
|
||||
sudo -i -u openclaw
|
||||
```
|
||||
|
||||
安装后脚本将引导你完成：
|
||||
|
||||
1. **上手引导向导**：配置 OpenClaw 设置
|
||||
2. **提供商登录**：连接 WhatsApp/Telegram/Discord/Signal
|
||||
3. **Gateway 测试**：验证安装
|
||||
4. **Tailscale 设置**：连接到你的 VPN mesh 网络
|
||||
|
||||
### 常用命令
|
||||
|
||||
```bash
|
||||
# 检查服务状态
|
||||
sudo systemctl status openclaw
|
||||
|
||||
# 查看实时日志
|
||||
sudo journalctl -u openclaw -f
|
||||
|
||||
# 重启 Gateway
|
||||
sudo systemctl restart openclaw
|
||||
|
||||
# 提供商登录（以 openclaw 用户运行）
|
||||
sudo -i -u openclaw
|
||||
openclaw channels login
|
||||
```
|
||||
|
||||
## 安全架构
|
||||
|
||||
### 4 层防御
|
||||
|
||||
1. **防火墙（UFW）**：仅公开暴露 SSH (22) + Tailscale (41641/udp)
|
||||
2. **VPN（Tailscale）**：Gateway 仅可通过 VPN mesh 网络访问
|
||||
3. **Docker 隔离**：DOCKER-USER iptables 链阻止外部端口暴露
|
||||
4. **Systemd 加固**：NoNewPrivileges、PrivateTmp、非特权用户
|
||||
|
||||
### 验证
|
||||
|
||||
测试外部攻击面：
|
||||
|
||||
```bash
|
||||
nmap -p- YOUR_SERVER_IP
|
||||
```
|
||||
|
||||
应当仅显示**端口 22**（SSH）为开放状态。所有其他服务（Gateway、Docker）均已锁定。
|
||||
|
||||
### Docker 可用性
|
||||
|
||||
Docker 用于**智能体沙箱**（隔离的工具执行），而非运行 Gateway 本身。Gateway 仅绑定到 localhost，通过 Tailscale VPN 访问。
|
||||
|
||||
沙箱配置详见 [多智能体沙箱与工具](/multi-agent-sandbox-tools)。
|
||||
|
||||
## 手动安装
|
||||
|
||||
如果你希望手动控制而非使用自动化：
|
||||
|
||||
```bash
|
||||
# 1. 安装前置依赖
|
||||
sudo apt update && sudo apt install -y ansible git
|
||||
|
||||
# 2. 克隆仓库
|
||||
git clone https://github.com/openclaw/openclaw-ansible.git
|
||||
cd openclaw-ansible
|
||||
|
||||
# 3. 安装 Ansible 集合
|
||||
ansible-galaxy collection install -r requirements.yml
|
||||
|
||||
# 4. 运行 playbook
|
||||
./run-playbook.sh
|
||||
|
||||
# 或直接运行（之后手动执行 /tmp/openclaw-setup.sh）
|
||||
# ansible-playbook playbook.yml --ask-become-pass
|
||||
```
|
||||
|
||||
## 更新 OpenClaw
|
||||
|
||||
Ansible 安装程序将 OpenClaw 设置为手动更新。标准更新流程详见 [更新](/install/updating)。
|
||||
|
||||
重新运行 Ansible playbook（例如配置变更时）：
|
||||
|
||||
```bash
|
||||
cd openclaw-ansible
|
||||
./run-playbook.sh
|
||||
```
|
||||
|
||||
注意：此操作是幂等的，可以安全地多次运行。
|
||||
|
||||
## 故障排除
|
||||
|
||||
### 防火墙阻止了我的连接
|
||||
|
||||
如果你被锁定在外：
|
||||
|
||||
- 确保先通过 Tailscale VPN 访问
|
||||
- SSH 访问（端口 22）始终是允许的
|
||||
- Gateway **仅**可通过 Tailscale 访问，这是设计如此
|
||||
|
||||
### 服务无法启动
|
||||
|
||||
```bash
|
||||
# 检查日志
|
||||
sudo journalctl -u openclaw -n 100
|
||||
|
||||
# 验证权限
|
||||
sudo ls -la /opt/openclaw
|
||||
|
||||
# 测试手动启动
|
||||
sudo -i -u openclaw
|
||||
cd ~/openclaw
|
||||
pnpm start
|
||||
```
|
||||
|
||||
### Docker 沙箱问题
|
||||
|
||||
```bash
|
||||
# 验证 Docker 是否运行
|
||||
sudo systemctl status docker
|
||||
|
||||
# 检查沙箱镜像
|
||||
sudo docker images | grep openclaw-sandbox
|
||||
|
||||
# 如果缺少沙箱镜像则构建
|
||||
cd /opt/openclaw/openclaw
|
||||
sudo -u openclaw ./scripts/sandbox-setup.sh
|
||||
```
|
||||
|
||||
### 提供商登录失败
|
||||
|
||||
确保你以 `openclaw` 用户运行：
|
||||
|
||||
```bash
|
||||
sudo -i -u openclaw
|
||||
openclaw channels login
|
||||
```
|
||||
|
||||
## 高级配置
|
||||
|
||||
有关详细的安全架构和故障排除：
|
||||
|
||||
- [安全架构](https://github.com/openclaw/openclaw-ansible/blob/main/docs/security.md)
|
||||
- [技术细节](https://github.com/openclaw/openclaw-ansible/blob/main/docs/architecture.md)
|
||||
- [故障排除指南](https://github.com/openclaw/openclaw-ansible/blob/main/docs/troubleshooting.md)
|
||||
|
||||
## 相关内容
|
||||
|
||||
- [openclaw-ansible](https://github.com/openclaw/openclaw-ansible) — 完整部署指南
|
||||
- [Docker](/install/docker) — 容器化 Gateway 设置
|
||||
- [沙箱](/gateway/sandboxing) — 智能体沙箱配置
|
||||
- [多智能体沙箱与工具](/multi-agent-sandbox-tools) — 按智能体隔离
|
||||
Reference in New Issue
Block a user