首次登录管理面板：初始密码在哪、怎么改

部署成功后，距离能用只差一次登录。这个项目的初始密码机制和很多工具不同：没有默认密码，每次安装随机生成。

找到初始密码

程序每次全新启动都会在日志里打印一段醒目的横幅，形如：

✨✨✨  AstrBot v4.x WebUI is ready
➜ Local: http://localhost:6185
➜ Initial username: astrbot
➜ Initial password: UiYVpZxnW8k22IWqf0ru5pOy
➜ Change it after logging in
✨✨✨

• 用户名固定为 astrbot
• Initial password 那行就是随机初始密码
• 不同部署方式看日志的位置不同：Docker 用 docker logs astrbot；uv / 启动器 / 桌面客户端直接看启动终端输出

登录与改密

1. 浏览器打开日志里给出的地址，本机部署就是 http://localhost:6185，云服务器把 localhost 换成服务器 IP
2. 用 astrbot 加日志里的随机密码登录
3. 使用初始密码登录后系统会自动引导进入账户设置环节，立即改成自己的密码
4. 公网部署建议顺手开启双因素认证，步骤见账号安全

首次进入的控制台就是上图的模样，左侧菜单从统计、消息平台、服务商接入到插件、知识库一字排开，后面所有的配置操作都发生在这里。

面板打不开的两种常见情况

• 404 错误：WebUI 静态文件没就位。去项目 Releases 页下载 dist.zip 解压到 data 目录下，重启程序；还不行重启电脑（社区里真实有效的玄学偏方）
• 连接超时：云服务器八成是端口没放行，检查云厂商安全组和主机防火墙的 6185 端口

密码忘了

按部署方式分三条路，全都整理在登录问题排查里：Docker 和 uv 部署有内置 password 命令，其他方式删配置文件里的密码字段让程序重新随机生成。

下一步

面板只是驾驶舱，车还没油。接上模型服务它才会说话：从接入模型原理开始。