文档
安装
Ansible 安装

Ansible 安装

适用范围

在以下情况下使用本页面：

  • 您希望使用安全加固进行自动化服务器部署
  • 您需要具有 VPN 访问权限的防火墙隔离设置
  • 您正在部署到远程 Debian/Ubuntu 服务器

将 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：隔离的沙箱容器，仅限本地主机绑定
  • 🛡️ 深度防御：4层安全架构
  • 🚀 一键设置：在几分钟内完成完整部署
  • 🔧 Systemd 集成：启动时自动启动并加固

要求

  • 操作系统：Debian 11+ 或 Ubuntu 20.04+
  • 访问权限：Root 或 sudo 特权
  • 网络：用于软件包安装的互联网连接
  • Ansible：2.14+（由快速启动脚本自动安装）

安装内容

Ansible playbook 安装和配置：

  1. Tailscale（用于安全远程访问的网格 VPN）
  2. UFW 防火墙（仅 SSH + Tailscale 端口）
  3. Docker CE + Compose V2（用于代理沙箱）
  4. Node.js 22.x + pnpm（运行时依赖项）
  5. Moltbot（基于主机，非容器化）
  6. Systemd 服务（启动时自动启动并加固）

注意：网关直接在主机上运行（不在 Docker 中），但代理沙箱使用 Docker 进行隔离。有关详细信息，请参阅沙箱。

安装后设置

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

sudo -i -u moltbot

安装后脚本将指导您完成：

  1. 入职向导：配置 Moltbot 设置
  2. 提供商登录：连接 WhatsApp/Telegram/Discord/Signal
  3. 网关测试：验证安装
  4. Tailscale 设置：连接到您的 VPN 网格

快速命令 

# 检查服务状态
sudo systemctl status moltbot

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

# 重启网关
sudo systemctl restart moltbot

# 提供商登录（以 moltbot 用户身份运行）
sudo -i -u moltbot
moltbot channels login

安全架构

4层防御

  1. 防火墙（UFW）：仅 SSH (22) + Tailscale (41641/udp) 公开暴露
  2. VPN（Tailscale）：网关仅可通过 VPN 网格访问
  3. Docker 隔离：DOCKER-USER iptables 链防止外部端口暴露
  4. Systemd 加固：NoNewPrivileges、PrivateTmp、非特权用户

验证

测试外部攻击面：

nmap -p- YOUR_SERVER_IP

应该显示仅端口 22（SSH）打开。所有其他服务（网关、Docker）都已锁定。

Docker 可用性

安装 Docker 是为了代理沙箱（隔离的工具执行），而不是为了运行网关本身。网关仅绑定到本地主机，并通过 Tailscale VPN 访问。

有关沙箱配置，请参阅多代理沙箱和工具。

手动安装

如果您希望对自动化进行手动控制：

# 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 集合
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

提供商登录失败

确保您以 moltbot 用户身份运行：

sudo -i -u moltbot
moltbot channels login

高级配置

有关详细的安全架构和故障排除：

相关

MigratingBun（实验性）