Mirai 的安装与配置 ​

本章将会从 Java 的选择与 MCL 的安装两方面进行讲解。

安装 Java ​

当你看到这个标题，你肯定会觉得，“这有什么好教的”。这你就不懂了，就像 Python 也有如 “PyPy” 之类的其他解释器，所以，Java 也有很多种 JVM 和 JDK 可供选择。

安装 Java 的简单方法 ​

如果你怕麻烦，那我们先从简单的安装方法说起，以下是各系统安装 OpenJDK 的方法：

# 请注意，只有 Windows 10 1709 （非 LTS 版）及以上或 Windows 11 才自带 winget 命令
# 事实上，截至目前，winget 的默认仓库中有足足 7 个来自不同厂商的 OpenJDK
# 这里就用 Windows 发行商 Microsoft 发行的 JDK 举例
winget install Microsoft.OpenJDK.17

# 适用于 Ubuntu / Debian 等系统
# 非 root 的情况下记得最前面加上 sudo
apt update
apt install openjdk-17-jre

# 非 root 的情况下记得最前面加上 sudo

# 适用于 CentOS 8 / Rocky Linux 8
dnf install java-latest-openjdk
# 适用于 CentOS 7
yum install java-latest-openjdk

pacman -S jdk-openjdk

# 此处假设你提前安装了 brew cask
# 没有的话就先 "brew install brew-cask-completion"
# 事实上，brew 也能够安装足足 4 个厂商的 JDK
# 不过我们就按默认的来就好
brew cask install java

# 不太建议在 termux 运行 MCL，因为可能会出现各种各样的 bug 和问题（比如功能突然失效，然后下一次触发时又莫名其妙的恢复了，或者触发时出现错误，可以用 Proot 安装一个原生 Linux 系统，但是触发时包含的中文字符可能会乱码）
# 可以看看后面的 MiraiAndroid，占用会低一点
pkg install openjdk-17

常见的 OpenJDK 发行版 ​

事实上，因为 Java 是开源的，因此所有人和公司都可以发行属于自己的 Java 发行版。

通常我们把非官方的 Java 发行版叫做 OpenJDK

但是，不同厂商发行的 OpenJDK 可能会加入一些属于自己的私货，或者部分厂商所发行 OpenJDK 相对更完整，包括 OpenJFX 等其他 OpenJDK 需要另外安装的组件。

以下列举一些常见的 OpenJDK 发行版：

• 【推荐】Azul Zulu OpenJDK
• 【推荐】BellSoft Liberica OpenJDK
• 【推荐】Microsoft Build of OpenJDK
• 【推荐】Oracle OpenJDK
• Adoptium Eclipse Temurin 前身为 AdoptOpenJDK
• OpenLogic OpenJDK

下载并解压 MCL ​

下面将介绍使用命令行安装 MCL，你也可以直接用浏览器打开 MCL 的 Latest Releases 页面 并在其中下载名为 mcl-2.x.x.zip 的压缩包，然后解压到任意文件夹（如果你连打开浏览器下载解压都不会，还是别打算写机器人了~）。

Windows ​

假设你使用的是现代化的 Windows，请打开你的 Powershell，然后依次执行下面每一行命令：

不要说你不知道 Powershell 是什么，不知道你不会百度吗，这玩意 Windows Vista（比 7 还早）就自带了。

$mcl_release = (Invoke-RestMethod -Uri "https://api.github.com/repos/iTXTech/mirai-console-loader/releases/latest").assets[0]
Start-BitsTransfer -Source $mcl_release.browser_download_url -Destination $mcl_release.name
Expand-Archive -Path $mcl_release.name -Destination mcl2
cd mcl2

Linux/macOS ​

如果你使用的是没有图形界面的 Linux/macOS 系统，请打开终端，然后依次执行下面每一行命令：

服务器没有图形界面没有终端就不用打开终端，直接在命令行界面执行命令即可。
如果你用的是有图形界面的 Linux，不要说你不知道终端是什么噢，不会吧不会吧不会有人啥都不会就用 Linux 了吧。

# 假设你的系统十分的精简，记得安装 wget 和 unzip
mcl_release=$(curl -s https://api.github.com/repos/iTXTech/mirai-console-loader/releases/latest)
mcl_download_url=$(echo $mcl_release | sed -r -n 's/"browser_download_url": "(.+)",?/\1/p' | sed "s/[[:space:]]//g" | awk 'NR==1')
mcl_name=$(echo $mcl_release | sed -r -n 's/"name": "(mcl-.+)",?/\1/p' | sed "s/[[:space:]]//g" | awk 'NR==1')
wget $mcl_download_url -O $mcl_name
unzip $mcl_name -d mcl2
unset mcl_release mcl_download_url mcl_name
cd mcl2

或者你也可以使用 mcl-installer ​

从 Releases 页面 下载与你 CPU 架构和系统类型对应的 mcl-installer 版本。

下载并运行，根据提示信息操作即可安装 mcl（如遇到看不懂的英语句子，请咨询百度翻译、谷歌翻译、有道翻译、DeePL、必应翻译）。

Windows ​

如果你的系统是【64位操作系统，基于x64的处理器】，则你需要下载 amd64 版本， 如果你的系统是【32位操作系统，基于x64的处理器】或者【32位操作系统】，则你需要下载 x86 版本， 如果你的系统不是前面 3 者之一，很遗憾 mcl-installer 目前不适合你。

如果不确定你的CPU架构和系统类型可以按照以下步骤操作：

Windows 10 或以上 ​

以 Windwos 11 为例：

1. 打开系统设置
2. 点击左侧的系统选项，在右侧主窗口滚动到最下方点击系统信息，查看设备规格下的系统类型

Windwos 7 ​

右键计算机图标，选择属性，在新打开的窗口中查看系统类型

Linux ​

与 Windows 不同，Linux/macOS 只需确认系统类型就行，在终端输入并执行 uname -m 命令，然后根据输出内容进行判断。

如果输出值包含 i386、i686、i386、x86 其中之一，那么很遗憾 mcl-installer 目前不适合你， 如果输出值包含 X86_64、x64、amd64 其中之一则选择 amd64 版本， 如果输出值包含 arm、armel、arm_garbage、arm64、aarch64、armv8 其中之一，则选择 arm64 版本。

对于如何在 Linux 上允许一个可执行文件，是 Linux 用户必修课，此处不过多阐述。

添加 Mirai Api Http 插件 ​

首先在终端中进入到 mcl-2.1.2 文件夹中，然后使用如下命令添加 mirai-api-http 插件并启动 MCL。

./mcl --update-package net.mamoe:mirai-api-http --channel maven-stable --type plugin

添加 mirai-login-solver-sakura 插件 ​

Mirai Console 自带的登录非常地不方便，而且不正确的登录方法容易导致帐号被 tx 拉黑。 为了正确地登录 Bot 的 QQ，最好使用 mirai-login-solver-sakura 插件。

从其 Latest Releases 页面 下载名为 mirai-login-solver-sakura-x.x.x.mirai2.jar 的 jar 文件，并将其放入 mcl-2.1.2/plugins/ 文件夹中。

若使用滑动验证码+短信进行登录验证，则需要从上面提到的页面下载名为 apk-release.apk 的安卓安装包，安装 SakuraLoginSolver 到你的安卓手机上（请不要使用模拟器、WSA、太老或太冷门的设备）。

启动 MCL ​

在 MCL 文件夹内打开命令提示符/终端（或在终端中进入 MCL 文件夹），执行命令 ./mcl。然后稍作等待，如果你的 Java 安装正确，MCL 就会启动，等到显示以下这行，就代表 Mirai 成功启动了。

20xx-xx-xx xx:xx:xx I/main: mirai-console started successfully.
>

然后按键盘 Ctrl + C 退出 MCL（Mac 用户请使用 Command + .）。

配置 Mirai Api Http 参数 ​

依次打开 mcl-2.1.2/config/net.mamoe.mirai-api-http/ 文件夹，使用文本编辑器修改 setting.yml。

你可以直接复制下面的例子然后替换掉文件内原有的内容。
不过请注意，不懂的参数不要乱动，冒号后请保留空格， 不要使用中文冒号，不要随意删除空格，不要随意添加新行。

adapters:
  - http
  - ws
debug: false
enableVerify: true
verifyKey: GraiaXVerifyKey ## 你可以自己设定，这里作为示范
singleMode: false
cacheSize: 4096
adapterSettings:
  http:
    host: localhost
    port: 8080
    cors: [*]
  ws:
    host: localhost
    port: 8080
    reservedSyncId: -1

使用命令 ./mcl 重新启动 MCL，此时你应该在控制台看到如下提示：

2023-02-16 23:02:29 I/Mirai HTTP API: ********************************************************
2023-02-16 23:02:29 I/MahKtorAdapter[http,ws]: Autoreload is disabled because the development mode is off.
2023-02-16 23:02:30 I/MahKtorAdapter[http,ws]: Application started in 0.076 seconds.
2023-02-16 23:02:30 I/MahKtorAdapter[http,ws]: Responding at http://localhost:8080
2023-02-16 23:02:30 I/http adapter: >>> [http adapter] is listening at http://localhost:8080
2023-02-16 23:02:30 I/ws adapter: >>> [ws adapter] is listening at ws://localhost:8080
2023-02-16 23:02:30 I/Mirai HTTP API: Http api server is running with verifyKey: funnyguy
2023-02-16 23:02:30 I/Mirai HTTP API: adaptors: [http,ws]
2023-02-16 23:02:30 I/Mirai HTTP API: ********************************************************

其中第四行是 Ariadne 连接 Mirai 的地址，第七行最后则是连接所用的密钥，请确保配置 Ariadne 时所用的参数与此处一致，同时还应确保第八行的 adaptors: 之后同时有 http 和 ws 两个选项。

登录 ​

配置自动登录 ​

现在，我们添加一下自动登录的账号，在 Mirai 启动完毕后控制台的 > 后输入如下 Mirai Console 命令：

/autoLogin add <你的QQ号> <你的QQ密码>
# 如 /autoLogin add 114514 1919810

退出并重新启动 MCL，如果控制台显示如下信息：

2023-01-31 18:44:05 I/Bot.<bot QQ号>: Loaded account secrets from local cache.
2023-01-31 18:44:05 I/Bot.<bot QQ号>: Saved account secrets to local cache for fast login.
2023-01-31 18:44:05 I/Bot.<bot QQ号>: Login successful.
2023-01-31 19:40:00 V/Bot.<bot QQ号>: Event: BotOnlineEvent(bot=Bot(<bot QQ号>))
2023-01-31 18:44:07 I/Bot.<bot QQ号>: Bot login successful.
2023-01-31 18:44:07 I/main: mirai-console started successfully.

那么恭喜你，接下来不用看了，但如果不是，那你就继续看吧~

二维码登录 ​

如果你不想使用二维码，而想使用滑动验证码+短信验证的方式进行登录，请点击下方展开详细内容查看。

滑动验证码+短信验证

滑动验证码 ​

假设你在没有图形界面的 Linux 系统中启动 MCL， 如果没有自动登录成功，在添加了 mirai-login-solver-sakura 插件的情况下，会有如下提示：

sh

2023-02-14 23:18:20 I/main: Auto-login 123456789, protocol: IPAD, heartbeatStrategy: STAT_HB
请使用 SakuraLoginSolver 打开 http://<ip>:44643/request/request/50634119 来完成验证

1
2

上面提示中的 123456789 为要登录的 QQ 号，44643 为端口号，50634119 为请求码
这些数字仅作为示例，端口号和请求码 每一次运行 MCL 都不一样，请不要照抄。

此时，你需要在你的安卓手机上打开刚刚安装的 SakuraLoginSolver APP，在顶部中间的输入框中输入请求码（即 50634119）， 然后点击下一步进入滑动验证码界面，完成验证后，电脑上的 MCL 会提示你下一步操作。

如果直接使用请求码无法弹出滑动验证码界面，则使用请求地址：

使用请求地址进行滑动验证

假设你的 MCL 运行在你自己家的电脑上，电脑在你家的局域网内的 IP 为 192.168.1.101 打开 SakuraLoginSolver，在顶部中间的输入框中输入请求地址（即 http://192.168.1.101:44643/request/request/50634119） 并点击下一步进入滑动验证码界面，完成验证后，电脑上的 MCL 会提示你下一步操作。

输入请求地址/请求码	滑动验证

小知识

如果上面的图看不清，你可以右键/长按图片并选择在新标签页中打开。

TIP

1. SakuraLoginSolver 在首次运行时点击下一步可能会闪退，重新启动并输入即可
2. 在有图形界面的操作系统上，mirai-login-solver-sakura 可以显示二维码，然后通过 SakuraLoginSolver 扫描而不用输入一长串请求地址
3. 如果不使用二维码和请求码而是请求地址，假如你使用的是云服务器， 你需要在手机输入请求地址之前在云服务器提供商的控制面板上放行 mirai-login-solver-sakura 提示的端口，通常这项操作在一个叫做安全组的地方完成， 放行传入方向即可
4. 假如你在云服务器提供商处放行了端口后 SakuraLoginSolver 仍无法连接 MCL， 请检查系统内置防火墙是否启动及配置是否正确。在正常的 Windows 系统上，初次启动 MCL 时便会弹出防火墙窗口，请不要直接关掉，请勾选公用网络、专用网络后点击允许访问

短信验证 ​

当你完成滑动验证码后,还需要进行短信验证。此时，MCL 的控制台会显示如下信息：

DANGER

如果你没啥事，必须使用 sms 短信验证，不要使用 legacy 方式， 否则可能会 BAN IP 或帐号。

sh

请使用 SakuraLoginSolver 打开 http://<ip>:44643/request/request/50634119 来完成验证
可用方法：legacy, sms 
输入 「cancel」 取消 / 按下 「Ctrl+C」 取消 
> 

1
2
3
4

在 > 之后输入 sms 并按下回车键，此时会 MCL 控制台会显示手机号，若手机号无误，再次按下回车键发送验证码短信：

sh

请使用 SakuraLoginSolver 打开 http://<ip>:44643/request/request/50634119 来完成验证
可用方法：legacy, sms
输入 「cancel」 取消 / 按下 「Ctrl+C」 取消
> sms 
需要短信验证 -> (+86) 139*******2 
直接按下 「Enter」 发送短信，输入验证码完成验证 
按下 「Ctrl+C」 取消 
> 
短信已发出. 请自行留意短信重发时间 
高频请求验证码可能导致账户被停用 
> 

1
2
3
4
5
6
7
8
9
10
11

收到短信后，将验证码输入在最后一个 > 之后并按下回车建，若验证码无误 MCL 将成功登录并记住登录状态。

sh

短信已发出. 请自行留意短信重发时间
高频请求验证码可能导致账户被停用
> 567815 
2023-01-31 18:44:05 I/Bot.<bot QQ号>: Login successful. 
2023-01-31 18:44:05 I/Bot.<bot QQ号>: Saved account secrets to local cache for fast login.
2023-01-31 18:44:05 I/Bot.<bot QQ号>: Login successful.
2023-01-31 19:40:00 V/Bot.<bot QQ号>: Event: BotOnlineEvent(bot=Bot(<bot QQ号>))
2023-01-31 18:44:07 I/Bot.<bot QQ号>: Bot login successful.
2023-01-31 18:44:07 I/main: mirai-console started successfully.

1
2
3
4
5
6
7
8
9

至此，自动登录就配置成功了，如果有多个帐号需要登录，在 MCL 启动之后再次执行 /autologin 命令即可。

Mirai 出现问题（报错）怎么办？ ​

1. 登录时提示版本过低（235） ​

如果某次登录的时候提示如下信息：

Login failed: Error(bot=Bot(xxxxxxxxx), code=235, title=温馨提示，message=当前QQ版本过低，请升级至最新版本后再登录。点击进入下载页面，errorInfo=)
2023-01-20 05:39:20 E/console: net.mamoe.mirai.network.WrongPasswordException: Error(bot=Bot(xxxxxxxxx), code=235, title=温馨提示，message=当前QQ版本过低，请升级至最新版本后再登录。点击进入下载页面，errorInfo=) 

首先，你需要通过 ./mcl -u 命令更新 Mirai Core 及 Mirai Console 到最新版。

如果你的 Mirai Api Http 也是通过命令安装的话，那么他也会被更新。
如果你使用的是旧版的 Ariadne，那么更新后可能 Ariadne 会连不上 MAH， 此时建议把 Ariadne 也更新。

重新启动 MCL，如果仍然不行，你需要删除 mcl-2.1.2/bots/<xxxxxxxxx> 这个文件夹，<xxxxxxxxx> 为你的 Bot 的 QQ 号，删除之后重新登录即可。

2. 登录限制（45） ​

无解。

3. 登录限制（6） ​

如果是新注册账号，先在手机 QQ 登录后才能在 Mirai 正常使用， 如果是旧账号，请将 Mirai 升级到 2.15.0 版本以上

4.限制密码登录(238) ​

只针对 ANDROID_WATCH 和 MACOS 协议，需更新协议。

5.网络环境不稳定(237) ​

删除 mcl 文件夹中 bots/ 文件夹内的全部文件，保持机器人账号手机端 QQ 登录，在手机端 QQ 的【设置/账号安全/登陆设备管理】中将所有历史设备删除。