Ansible 安装

在生产环境部署 Moltbot 的推荐方式是通过 moltbot-ansible —— 一套安全优先的自动化安装方案。

快速开始

一键安装：


curl -fsSL https://raw.githubusercontent.com/moltbot/moltbot-ansible/main/install.sh | bash

📦 完整指南：github.com/moltbot/moltbot-ansible
moltbot-ansible 仓库是 Ansible 部署的权威来源，本页仅为简要概览。

你将获得

🔒 防火墙优先安全：UFW + Docker 隔离（仅开放 SSH + Tailscale）
🔐 Tailscale VPN：安全远程访问，无需公网暴露服务
🐳 Docker：隔离沙箱容器，仅绑定 localhost
🛡️ 纵深防御：四层安全架构
🚀 一键部署：数分钟内完成部署
🔧 Systemd 集成：开机自启并加固

环境要求

操作系统：Debian 11+ 或 Ubuntu 20.04+
权限：root 或 sudo
网络：可访问互联网以安装依赖
Ansible：2.14+（快速安装脚本会自动安装）

安装内容

Ansible playbook 会安装并配置：

Tailscale（用于安全远程访问的 mesh VPN）
UFW 防火墙（仅开放 SSH + Tailscale 端口）
Docker CE + Compose V2（用于 agent 沙箱）
Node.js 22.x + pnpm（运行时依赖）
Moltbot（宿主机运行，非容器化）
Systemd 服务（开机自启并加固）

说明：网关在宿主机上直接运行（不在 Docker 内），但 agent 沙箱使用 Docker 做隔离。详见沙箱。

安装后配置

安装完成后，切换到 moltbot 用户：


sudo -i -u moltbot

安装后脚本会引导你完成：

入门向导：配置 Moltbot 设置
Provider 登录：连接 WhatsApp/Telegram/Discord/Signal
网关测试：验证安装
Tailscale 配置：接入你的 VPN mesh

常用命令


# 查看服务状态
sudo systemctl status moltbot

# 实时日志
sudo journalctl -u moltbot -f

# 重启网关
sudo systemctl restart moltbot

# Provider 登录（以 moltbot 用户执行）
sudo -i -u moltbot
moltbot channels login

安全架构

四层防御

防火墙 (UFW)：仅对外暴露 SSH (22) + Tailscale (41641/udp)
VPN (Tailscale)：网关仅能通过 VPN mesh 访问
Docker 隔离：DOCKER-USER iptables 链阻止对外暴露端口
Systemd 加固：NoNewPrivileges、PrivateTmp、非特权用户

验证

测试对外攻击面：


nmap -p- YOUR_SERVER_IP

应只显示 22 端口（SSH）开放，其余服务（网关、Docker）均被锁定。

Docker 用途

Docker 用于 agent 沙箱（隔离执行工具），不用于运行网关本身。网关仅绑定 localhost，通过 Tailscale VPN 访问。沙箱配置见沙箱；多 agent 隔离见 Multi-Agent Sandbox & Tools（英文）。

手动安装

若希望自行控制自动化流程：


# 1. 安装前置依赖
sudo apt update && sudo apt install -y ansible git

# 2. 克隆仓库
git clone https://github.com/moltbot/moltbot-ansible.git
cd moltbot-ansible

# 3. 安装 Ansible collections
ansible-galaxy collection install -r requirements.yml

# 4. 执行 playbook
./run-playbook.sh

# 或直接执行（之后需手动执行 /tmp/moltbot-setup.sh）
# ansible-playbook playbook.yml --ask-become-pass

更新 Moltbot

Ansible 安装器将 Moltbot 配置为手动更新。标准更新流程见更新。若要重新执行 Ansible playbook（例如修改配置）：


cd moltbot-ansible
./run-playbook.sh

说明：可重复执行，具有幂等性。

故障排查

防火墙阻断连接

若无法连接：

确保能先通过 Tailscale VPN 访问
SSH（22 端口）始终允许
网关仅能通过 Tailscale 访问，此为设计如此

服务无法启动


# 查看日志
sudo journalctl -u moltbot -n 100

# 检查权限
sudo ls -la /opt/moltbot

# 手动启动测试
sudo -i -u moltbot
cd ~/moltbot
pnpm start

Docker 沙箱问题


# 确认 Docker 在运行
sudo systemctl status docker

# 查看沙箱镜像
sudo docker images | grep moltbot-sandbox

# 若缺少沙箱镜像则构建
cd /opt/moltbot/moltbot
sudo -u moltbot ./scripts/sandbox-setup.sh

Provider 登录失败

确保以 moltbot 用户运行：


sudo -i -u moltbot
moltbot channels login

进阶配置

安全架构与故障排查详见：