如何5分钟用Docker快速部署Spacebot新手零门槛入门指南【免费下载链接】spacebotAn AI agent for teams, communities, and multi-user environments.项目地址: https://gitcode.com/gh_mirrors/spac/spacebotSpacebot 是一个面向团队、社区和多用户环境的 AI 智能体AI agent框架而Docker 部署 Spacebot是新手上手最快的方式无需安装 Rust 工具链、无需编译源码一条docker run命令就能让这个具备记忆系统、任务系统和多渠道消息能力的 AI 智能体在你的服务器上跑起来。为什么新手首选Docker部署Spacebot很多 AI agent 项目要求你先装语言运行时、装依赖、跑编译新手很容易被劝退。Spacebot 的 Docker 镜像把一切都打包好了✅单条命令启动内置前端界面、Rust 核心、消息适配器无需任何构建步骤✅数据持久化所有数据存放在一个挂载卷里升级不丢数据✅浏览器能力内置智能体的浏览器工具会在首次使用时自动下载 Chromium 并缓存无需额外镜像✅自动健康检查镜像自带 healthcheckDocker 会持续监测服务状态镜像采用多阶段构建Dockerfile运行时基于精简的 Debian 镜像体积小、依赖少。完整说明见 docs/docker.md。部署前准备只需2样东西准备项说明Docker任意版本运行docker --version确认可用至少一个 LLM API KeyAnthropic、OpenAI 或 OpenRouter 任选其一端口方面Spacebot 默认使用19898API Web 界面请确认该端口未被占用。一键安装步骤最快部署命令打开终端执行以下命令把sk-ant-...换成你的 API Keydocker run -d \ --name spacebot \ -e ANTHROPIC_API_KEYsk-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 模型属正常现象写在最后到这里你已经用不到 5 分钟把一个具备持久记忆、任务系统、多渠道消息的 AI 智能体部署到了自己的服务器上。接下来推荐去官方文档继续探索智能体配置与记忆系统快速入门quickstart.mdx/quickstart.mdx)Docker 部署细节docker.md官方文档目录docs/【免费下载链接】spacebotAn AI agent for teams, communities, and multi-user environments.项目地址: https://gitcode.com/gh_mirrors/spac/spacebot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考