uv 与 pip 包管理器部署：两条命令跑起来

不想碰容器、也不想 clone 源码，包管理器是最短路径。官方主推 uv，pip 同样可行。

用 uv 部署（官方推荐）

uv 支持 Linux、Windows、macOS。没装的先按 uv 官方文档装好，然后三条命令：

uv tool install astrbot
astrbot init
astrbot

• astrbot init 只在第一次部署时执行，作用是初始化工作目录，之后再启动直接跑 astrbot
• 启动后日志会打印管理面板地址和初始密码
• 这个工作目录就是以后的数据目录，配置、数据库都在这里

用 pip 部署

环境里有 Python 3.10+ 的话：

pip install astrbot
astrbot init
astrbot

装在哪套 Python 环境里，数据目录就跟着哪套环境的工作目录走。建议用虚拟环境隔离，避免和别的项目抢依赖。

升级方式

包管理器部署的升级就是更新包本身：

uv tool upgrade astrbot

pip 用户用 pip install -U astrbot。升级后重启程序生效；如果面板行为异常，参考升级与数据维护里清 dist 缓存的做法。

重置密码

uv / pip 部署自带 CLI，在 AstrBot 工作目录（就是当初 astrbot init 的目录）里执行：

astrbot password

需要同时改用户名加 --username 新用户名 参数，改完重启程序生效。

这种方式的边界

包管理器部署跑在前台终端里，SSH 断线进程就停了。长期挂机要么配合 systemd / pm2 之类的守护，要么回到 Docker 部署——后者在进程守护、开机自启上省心得多。调试和尝鲜用 uv，生产挂机用 Docker，是社区里最常见的分工。