部署方式怎么选:八种途径的适用场景对比
这个项目被吐槽过「部署方式比功能还多」,其实每种方式对应的用户画像很清晰。先回答两个问题:跑在什么机器上?打算运维到什么程度?
八条路线一览
| 方式 | 适合谁 | 一句话特征 |
|---|---|---|
| 桌面客户端 | 纯新手、个人电脑 | 装完点开就用,图形界面拉起 |
| 一键启动器 | 想要图形化管理但会用电脑的用户 | 官方 Launcher 安装包,自动处理环境 |
| Docker | 云服务器、长期运行 | 生产环境首选,隔离干净、升级方便 |
| uv / pip | 熟悉 Python 命令行的用户 | 两条命令装完,轻量直接 |
| 源码部署 | 想改代码的开发者 | clone 仓库自己跑,改哪都行 |
| Kubernetes | 有集群的团队 | 官方提供编排配置 |
| 宝塔面板 | 用宝塔管服务器的站长 | 应用商店搜一下装 |
| 云平台镜像 | 连环境都不想配 | 雨云一键部署、优云智算镜像 |
按场景推荐
个人电脑上先试试:直接桌面客户端,装完即用,不满意卸载也干净。数据在家目录的 .astrbot 目录下。
云服务器长期挂机:Docker 部署。没有特殊情况不要用桌面客户端跑服务器——官方文档明确不建议。Docker 的好处是数据卷挂载清晰、重置密码有内置 CLI、升级就是换镜像。
服务器上不想碰 Docker:uv 安装是最省事的替代,uv tool install 一条命令。
已经用宝塔管站:宝塔的 Docker 应用商店里能搜到,装完记得在面板安全页放行 6185 端口,云厂商安全组同步放行。
完全不想配环境:雨云等云平台提供一键部署镜像,点开即用;优云智算提供带 Ollama 的整合镜像,连模型服务都预装好了。
选型上的三个坑
- Windows 老式 PowerShell 安装器(AstrBotLauncher)现在官方已标注不推荐,需要自备 Python 3.10–3.13,新用户直接用新版启动器
- Docker 在大陆拉镜像可能失败,换镜像源前缀即可,命令在 Docker 部署页有现成写法
- 无论哪种方式,跑起来之后的操作完全一样:浏览器访问 6185 端口进管理面板,部署方式只影响「怎么启动」,不影响「怎么使用」