Skip to content

Commit 7d72e3a

Browse files
SoulterSoulter
committed
docs: update FAQ with details on first login account and random password generation
1 parent 37d6159 commit 7d72e3a

2 files changed

Lines changed: 118 additions & 15 deletions

File tree

‎docs/en/faq.md‎

Lines changed: 60 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,17 +6,69 @@
66

77
Download `dist.zip` from the [release](https://github.com/AstrBotDevs/AstrBot/releases) page, extract it, and move it to `AstrBot/data`. If it still doesn't work, try restarting your computer (based on community feedback).
88

9-
### Forgot Dashboard Password
9+
### First Login Account and Random Password
10+
11+
On first startup, the WebUI account is `astrbot` by default, and the default password is randomly generated (it is not a fixed hardcoded value). Check the startup logs and log in with the random initial password shown there:
12+
13+
```text
14+
[00:27:40.590] [Core] [INFO] [dashboard.server:523]:
15+
✨✨✨
16+
AstrBot v4.24.3 WebUI is ready
1017
11-
If you forgot your AstrBot dashboard password, you can modify the `"dashboard"` field in the `AstrBot/data/cmd_config.json` configuration file, where `"username"` is your username and `"password"` is your password encrypted with MD5.
18+
➜ Local: http://localhost:6185
19+
➜ Initial username: astrbot
20+
➜ Initial password: UiYVpZxnW8k22IWqf0ru5pOy
21+
➜ Change it after logging in
22+
✨✨✨
23+
Set dashboard.host in data/cmd_config.json to enable remote access.
24+
```
1225

13-
To modify your account credentials, follow these steps:
26+
The random initial password may be different each first startup, so please change it as soon as possible in WebUI settings after logging in.
27+
28+
### Forgot Dashboard Password
1429

15-
1. Modify the `"username"` field, keeping the `""` quotation marks. If you don't want to change the username, skip this step
16-
2. Visit the website: [Online MD5 Generator](https://www.metools.info/code/c26.html)
17-
3. Enter your new password in the input text box
18-
4. Select MD5 encryption (32-bit), make sure to choose the 32-bit option
19-
5. Paste the converted string into the configuration file, keeping the `""` quotation marks
30+
If you forgot your AstrBot dashboard password, find the `"dashboard"` field in `AstrBot/data/cmd_config.json`, for example:
31+
32+
```json
33+
"dashboard": {
34+
"enable": true,
35+
"username": "astrbot",
36+
"password": "81e0c3dxxxxxxxxxxx78862e78",
37+
"pbkdf2_password": "pbkdf2_sha256$600000$1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
38+
"password_storage_upgraded": true,
39+
"password_change_required": true,
40+
"jwt_secret": "5e1b0280bcxxxxxxxxxxxxxxxxf4a",
41+
"host": "127.0.0.1",
42+
"port": 6185,
43+
"disable_access_log": true,
44+
"ssl": {
45+
"enable": false,
46+
"cert_file": "",
47+
"key_file": "",
48+
"ca_certs": ""
49+
}
50+
},
51+
```
52+
53+
Delete the `username`, `password`, `pbkdf2_password`, `password_storage_upgraded`, `password_change_required`, and `jwt_secret` fields (with their values), then save.
54+
The segment should look like:
55+
56+
```json
57+
"dashboard": {
58+
"enable": true,
59+
"host": "127.0.0.1",
60+
"port": 6185,
61+
"disable_access_log": true,
62+
"ssl": {
63+
"enable": false,
64+
"cert_file": "",
65+
"key_file": "",
66+
"ca_certs": ""
67+
}
68+
},
69+
```
70+
71+
After restart, AstrBot will automatically generate a random password with the fixed username `astrbot`; check the startup logs.
2072

2173
## Bot Core Related
2274

‎docs/zh/faq.md‎

Lines changed: 58 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,17 +6,68 @@
66

77
在 [release](https://github.com/AstrBotDevs/AstrBot/releases) 页面下载 `dist.zip`，解压拖到 `AstrBot/data` 下。还不行请重启电脑（来自群里的反馈）
88

9+
10+
### 首次登录的默认账号和随机密码
11+
12+
首次启动时，WebUI 的默认账号为 `astrbot`，默认密码会随机生成，不会写死为固定值。请在启动日志中查找以下内容并使用日志中的随机初始密码登录：
13+
14+
```text
15+
[00:27:40.590] [Core] [INFO] [dashboard.server:523]:
16+
✨✨✨
17+
AstrBot v4.24.3 WebUI is ready
18+
19+
➜ Local: http://localhost:6185
20+
➜ Initial username: astrbot
21+
➜ Initial password: UiYVpZxnW8k22IWqf0ru5pOy
22+
➜ Change it after logging in
23+
✨✨✨
24+
Set dashboard.host in data/cmd_config.json to enable remote access.
25+
```
26+
927
### 管理面板的密码忘记了
1028

11-
如果你忘记了 AstrBot 管理面板的密码，你可以在 `AstrBot/data/cmd_config.json` 配置文件中找到 `"dashboard"` 字段进行修改，其中 `"username"` 是你的用户名，`"password"` 是你的密码（经过 MD5 加密）。
29+
如果你忘记了 AstrBot 管理面板的密码，你可以在 `AstrBot/data/cmd_config.json` 配置文件中找到 `"dashboard"` 字段，如下：
30+
31+
```json
32+
"dashboard": {
33+
"enable": true,
34+
"username": "astrbot",
35+
"password": "81e0c3dxxxxxxxxxxx78862e78",
36+
"pbkdf2_password": "pbkdf2_sha256$600000$1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
37+
"password_storage_upgraded": true,
38+
"password_change_required": true,
39+
"jwt_secret": "5e1b0280bcxxxxxxxxxxxxxxxxf4a",
40+
"host": "127.0.0.1",
41+
"port": 6185,
42+
"disable_access_log": true,
43+
"ssl": {
44+
"enable": false,
45+
"cert_file": "",
46+
"key_file": "",
47+
"ca_certs": ""
48+
}
49+
},
50+
```
1251

13-
如果想要修改账号密码，你可以这样做：
52+
删除 `username`, `password`, `pbkdf2_password`, `password_storage_upgraded`, `password_change_required`, `jwt_secret` 五个字段（连同值一起），然后保存。上述片段修改类似如下：
53+
54+
55+
```json
56+
"dashboard": {
57+
"enable": true,
58+
"host": "127.0.0.1",
59+
"port": 6185,
60+
"disable_access_log": true,
61+
"ssl": {
62+
"enable": false,
63+
"cert_file": "",
64+
"key_file": "",
65+
"ca_certs": ""
66+
}
67+
},
68+
```
1469

15-
1. 修改 `"username"` 字段，注意保留 `""`；如果不想修改用户名，可以不修改
16-
2. 进入网站：[在线 MD5 生成](https://www.metools.info/code/c26.html)
17-
3. 在转换前文本框输入你的新密码
18-
4. 选择 MD5 加密（32 位），请确认选择 32 位选项
19-
5. 将转换后的字符粘贴至配置文件，注意保留 `""`, 且字母使用小写
70+
重启后 AstrBot 将会自动生成随机的密码以及固定的用户名 `astrbot`，请在日志查看。
2071

2172
## AstrBot 使用相关
2273

0 commit comments

Comments
 (0)