RoyirinRosmontis/maa-online
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
73250c91b6adf15bdd173a388ea82a5f2ab9718a
maa-online/README.md
T
RoyirinRosmontis 73250c91b6 更新 README.md
2026-09-16 12:08:27 +08:00

5.2 KiB
Raw Blame History

maa-online

在 Linux 无图形服务器上，通过网易云游戏运行《明日方舟》，并让官方 MAA/maa-cli 执行日常任务的实验性适配层。

本项目调用网易云游戏未公开的 HTTP、WebSocket 与 WebRTC 协议，可能随平台更新失效，也可能不符合平台服务条款。请仅用于个人研究，自行承担账号及服务风险；禁止多账号、商业代练或规避平台限制。

上游项目

本仓库是在以下开源项目及实验原型基础上整理的适配代码，不包含完整第三方源码、官方 MAA 二进制或任何用户凭据：

backend/ 与 backend/sdk/ 分别保留了相应上游的 Apache-2.0 LICENSE。MAA 和 maa-cli 由安装脚本从官方渠道下载，其许可证仍以各自上游为准。

工作原理

官方 maa-cli / MaaCore
        │ 标准 ADB 命令
        ▼
  bin/adb-cloud
        │ loopback HTTP
        ▼
backend/server.py
        │ 网易 HTTP + WebSocket + WebRTC
        ▼
  网易云游戏中的明日方舟

没有修改官方 MaaCore。adb-cloud 将 MaaCore 的截图、点击、滑动、文字输入和启动/停止命令转换成本地 HTTP 请求，因此官方 maa self update、maa update 与 maa hot-update 仍可使用。

环境要求

  • Linux x86_64（其他架构需自行验证）
  • Python 3.10+
  • python3-venv、Git、curl
  • 可访问网易云游戏和 GitHub
  • 已完成实名认证的网易云游戏账号
  • 已有或可登录的《明日方舟》官服账号

安装

git clone https://git.rrrosmontis.icu/RoyirinRosmontis/maa-online.git
cd maa-online
./install.sh

安装脚本会在仓库内部创建被 Git 忽略的 runtime/，安装 Python 依赖、官方 maa-cli、官方 MaaCore 和资源；不会下载或保存本仓库维护者的账号数据。

登录网易云游戏

runtime/venv/bin/python backend/login.py request <手机号>
runtime/venv/bin/python backend/login.py verify <短信验证码>

生成的 token 位于 backend/token，权限为 0600，且已被 .gitignore 排除。不要将 token、手机号、验证码、身份证信息、游戏截图或日志提交到 Git。

实名认证请在网易云游戏网页或 App 中自行完成，不要通过 Issue、聊天或配置文件提供身份证信息。

启动与运行

终端一：

bin/maa-online-server

终端二：

curl -X POST http://127.0.0.1:22888/start
bin/maa-online startup Official --batch -v

编辑日常配置：

bin/maa-online-config

验证配置：

bin/maa-online run daily --dry-run --batch

执行日常：

bin/maa-online run daily --batch -v

退出云游戏：

curl -X POST http://127.0.0.1:22888/exit

服务默认仅监听 127.0.0.1:22888，不要直接暴露到公网。

默认日常模板

user_config/daily.example.toml 是脱敏示例。首次安装时复制为被 Git 忽略的 user_config/daily.toml，包括：

  • 基建一键轮换；
  • 自动公招；
  • 刷 1-7 清理理智；
  • 信用商店与好友访问；
  • 日常、周常及邮件奖励；
  • 完成后退出云游戏。

示例默认不吃理智药、不碎石、不使用加急许可。运行前务必检查 stage、公招次数、信用商店列表和邮件领取选项。全部参数说明见 user_config/README.md。

更新

bin/maa-online-update

该脚本更新官方 maa-cli、MaaCore、基础资源和热更新资源。适配代码位于官方管理目录之外，不会被 maa update 清理。

离线测试

启动假后端：

runtime/venv/bin/python tests/fake_backend.py

另一个终端验证官方 MaaCore → ADB 适配层：

LD_LIBRARY_PATH="$PWD/runtime/home/.local/share/maa/lib" \
  runtime/venv/bin/python tests/smoke_maa_connect.py

预期：

MaaCore -> adb-cloud -> fake backend: PASS

已知限制

  • 网易私有协议可能随时变化；
  • 云视频压缩与网络抖动会降低 MAA 图像识别稳定性；
  • 高频截图在低性能服务器上较慢，基建换班可能耗时较长；
  • Home/ESC 等键值尚未完整验证；
  • 断线自动恢复仍有限；
  • 后端可能出现少量 H.264 解码丢包警告；
  • 游戏自动化会真实消耗招聘许可、理智、信用等资源，请先 dry-run 并审阅配置。

许可证

本仓库自有代码按 Apache License 2.0 发布，详见 LICENSE。派生文件及第三方组件同时受对应上游许可证约束。

Reference in New Issue View Git Blame Copy Permalink