AstrBot 安装指南:新手应该先从哪种安装方式开始
面向第一次接触 AstrBot 的用户,帮助你判断桌面端、启动器、Docker 和源码部署各自适合谁,以及安装完成后下一步该去哪里。
这篇适合谁
这篇给第一次接触 AstrBot 的新手,用来先选对安装起点,再进入部署和接入阶段。
先说明边界
这是一篇社区导读页,不是官方安装手册。你会在这里得到路径判断和成功标准,具体命令与参数请看文末官方文档。
安装前先判断这 3 件事
- 你当前目标是快速体验,还是后续要长期在线。
- 你更偏向图形化界面,还是可脚本化、可自动化的运行方式。
- 你是否已经具备稳定网络、基础运维能力和后续维护时间。
4 条常见起步路径怎么选
桌面客户端
适合零基础、想先在本机快速看效果的用户。安装门槛最低,但不应直接视为长期在线方案。
一键启动器
适合 Windows 用户先跑通最短路径。重点是先完成首次可用,不要一开始就追求复杂拓扑。
Docker
适合希望环境更可复现、后续可能迁移到服务器的用户。初次使用时保持单实例即可。
源码部署 / CLI
适合有开发背景、需要更高可控性的用户。路径更灵活,但也需要承担更多环境管理成本。
社区站推荐的新手起步顺序
- 先选一条最短路径,目标只设为“本机成功跑通一次”。
- 跑通后记录你的运行方式和关键依赖,不要马上切换第二条路线。
- 用同一套环境完成一次基础消息收发,确认不是“假成功”。
- 只有在目标变化时再切换到 Docker 或 CLI,不做无理由重装。
什么算安装成功
满足下面 3 条就可以判定“安装阶段完成”:
- AstrBot 可以稳定启动,且重启后仍可进入。
- WebUI 或管理入口可访问,核心配置可保存。
- 能完成至少一次基础消息交互,日志没有持续性报错。
AstrBot 文档