如何5分钟用Docker快速部署Spacebot：新手零门槛入门指南-育师

如何5分钟用Docker快速部署Spacebot：新手零门槛入门指南

【免费下载链接】spacebotAn AI agent for teams, communities, and multi-user environments.项目地址: https://gitcode.com/gh_mirrors/spac/spacebot

Spacebot 是一个面向团队、社区和多用户环境的 AI 智能体（AI agent）框架，而Docker 部署 Spacebot是新手上手最快的方式：无需安装 Rust 工具链、无需编译源码，一条docker run命令就能让这个具备记忆系统、任务系统和多渠道消息能力的 AI 智能体在你的服务器上跑起来。

为什么新手首选Docker部署Spacebot？

很多 AI agent 项目要求你先装语言运行时、装依赖、跑编译，新手很容易被劝退。Spacebot 的 Docker 镜像把一切都打包好了：

✅单条命令启动：内置前端界面、Rust 核心、消息适配器，无需任何构建步骤
✅数据持久化：所有数据存放在一个挂载卷里，升级不丢数据
✅浏览器能力内置：智能体的浏览器工具会在首次使用时自动下载 Chromium 并缓存，无需额外镜像
✅自动健康检查：镜像自带 healthcheck，Docker 会持续监测服务状态

镜像采用多阶段构建（Dockerfile），运行时基于精简的 Debian 镜像，体积小、依赖少。完整说明见 docs/docker.md。

部署前准备：只需2样东西

准备项	说明
Docker	任意版本，运行`docker --version`确认可用
至少一个 LLM API Key	Anthropic、OpenAI 或 OpenRouter 任选其一

端口方面，Spacebot 默认使用19898（API + Web 界面），请确认该端口未被占用。

一键安装步骤：最快部署命令

打开终端，执行以下命令（把sk-ant-...换成你的 API Key）：

docker run -d \ --name spacebot \ -e ANTHROPIC_API_KEY="sk-ant-..." \ -v spacebot-data:/data \ -p 19898:19898 \ ghcr.io/spacedriveapp/spacebot:latest

三个关键参数详解：

参数	作用
`-v spacebot-data:/data`	创建持久化数据卷，智能体的记忆、配置、数据库全部存在这里
`-p 19898:19898`	把 Web 界面端口映射到本机
`-e ANTHROPIC_API_KEY`	通过环境变量注入 LLM 密钥，无需手写配置文件

💡 如果你用的是 OpenAI 或 OpenRouter，把-e参数换成OPENAI_API_KEY或OPENROUTER_API_KEY即可。

镜像启动时，入口脚本 docker-entrypoint.sh 会自动检测环境变量，自动生成config.toml并创建默认的main智能体——你什么都不用配置，开箱即用。

验证部署是否成功：3步确认

# 1. 查看容器是否在运行 docker ps # 2. 查看启动日志 docker logs -f spacebot # 3. 健康检查接口（内置 healthcheck） curl http://localhost:19898/api/health

只要健康检查返回正常，恭喜，你的 Spacebot 已经上线了 🎉

打开Web控制台：5分钟配置你的智能体

浏览器访问：

http://localhost:19898

你会看到 Spacebot 的 Web 控制台——左侧是概览导航，主区域展示各个频道（Channels）的实时对话、Workers 任务卡片和 Cortex 事件流。

如果部署时没有传入 API Key，界面会引导你在Settings中填写密钥，效果相同。配置完成后，你就可以直接在 WebChat 频道与智能体对话，或继续接入 Discord、Telegram 等消息平台。

进阶：用Docker Compose稳定运行

生产环境建议使用 Compose 管理，方便重启策略和后续升级：

services: spacebot: image: ghcr.io/spacedriveapp/spacebot:latest container_name: spacebot restart: unless-stopped ports: - "19898:19898" volumes: - spacebot-data:/data environment: - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY} # 可选：接入 Discord # - DISCORD_BOT_TOKEN=${DISCORD_BOT_TOKEN} volumes: spacebot-data:

保存为docker-compose.yml后执行docker compose up -d即可。

数据都存在哪里？

容器内所有持久化数据都在/data目录（也就是你挂载的spacebot-data卷）：

/data/ ├── config.toml # 自动生成的配置文件 ├── agents/main/ # 智能体身份文件（SOUL.md / IDENTITY.md / ROLE.md） │ ├── workspace/ # 智能体工作目录（沙箱边界） │ └── data/ # SQLite / LanceDB / redb 数据库 └── logs/ # 日志（每日轮转）

首次运行时会自动下载约 100MB 的本地 Embedding 模型并缓存到该卷中，之后重启直接命中缓存，启动更快。

版本更新与常见问题

升级镜像只需两步：

docker compose pull spacebot docker compose up -d --force-recreate spacebot

常见问题	解决方法
端口 19898 被占用	修改`-p`为`-p 19899:19898`，再访问新端口
界面提示缺少 API Key	在 Web 控制台 Settings 中补填，或带`-e`参数重建容器
首次启动较慢	正在拉取镜像和下载 Embedding 模型，属正常现象