动态生成可登录的 DXPASS

从零开始美化你的玩家二维码

DXPass 是日服限定的，可以在制卡机上制作的具有特殊功能的实体卡片。通常印有玩家信息、角色立绘、区域背景等元素，有提升跑图距离、解锁上位难度的谱面等功能。

虽然国服无法制作 DXPass，但是独特的微信登录机制使我们有了动态生成 DXPass 的可能，UsagiPass 应运而生。

• 动态生成：基于水鱼 / 落雪查分器的数据动态生成玩家的 DXPASS，用户个性化数据云端储存；
• 高度自定义：自定义 DXPASS 背景、外框、角色，支持使用预设素材或个性化上传自己的图片；
• 支持登录：通过代理直接嵌入微信玩家二维码页面，可直接扫描 DXPASS 上机，逼格满满；
• 更新查分器：支持一键更新水鱼/落雪查分器，无需复杂的配置。

1. 安装代理软件：

   • 安卓：Clash（推荐），Sing-box
   • iOS：Shadowrocket（推荐），Sing-box，QuantX

2. 启动代理：确保代理软件在手机后台运行中；

3. 打开微信二维码：在微信中打开舞萌或中二公众号的登入二维码，将自动跳转至 UsagiPass 登录界面；

4. 登录使用：使用水鱼或落雪查分器账号进行登录，登录后即可进入 UsagiPass 主页。

1. 登录后将显示默认个性化配置，点击画面右下方的齿轮图标进入设置页面；
2. 在设置中按照喜好调整个性化配置，切换背景、角色、边框等资源；
3. 请初次使用的玩家在设置中粘贴自己的好友代码（可在舞萌DX-好友页面查询）；
4. 修改完成后点击保存按钮应用设置。

UsagiPass 利用中间人代理（MITM）技术修改华立服务器的流量：

1. 通过代理替换 sys-all.cn 网页，将请求重定向到 dxpass.turou.fun；
2. 重定向时携带原网页中的查询参数（SGWCMAID），在前端以 JS 方式绘制二维码；
3. 支持更新查分器功能，原理类似 Bakapiano 方案，在适当时机转发 tgk-wcaime.wahlap.com 地址。

• 合适的 Linux 发行版（以 Debian 为例）
• 能够连接至 GitHub、DivingFish 或 LXNS 的网络环境
• Python 3.12+
• MySQL Community Server

• 前往对应的查分器网站申请开发者密钥并等待审核通过；
• 在 项目根目录 下创建 .env 文件, 可以根据 .env.example.mitm-only 模板文件进行配置，别忘了在 LXNS_DEVELOPER_TOKEN 或 DIVINGFISH_DEVELOPER_TOKEN 中填入你申请的开发者密钥；
• 执行 pip install poetry 全局安装 Poetry；
• 执行 poetry install 安装项目依赖；
• 执行 poetry run app 运行后端及代理；
• 执行 cd web && npm run dev 运行前端。

更新项目: git pull && poetry install && poetry run app

Q：我不清楚 UsagiPass 的某某功能如何使用

A：可以在官网中找到部分功能的详细介绍。如果仍有疑问，可以加群进行询问。

Q：IOS 使用小火箭需要购买

A：可以使用 Sing-box 方案，Sing-box 是一款在外区商店可以免费下载的代理软件。

Q：IOS 我不知道应该如何获得外区账号

A：可以在 B 站搜索相关关键词，这类视频还是挺多的，请尽量不要在群内讨论相关话题。

如果觉得 UsagiPass 好用的话，不妨给我们的仓库点一个 ⭐！

我们也开放了爱发电入口，如果你愿意赞助 UsagiPass，我们会在特别感谢中提到你的名字。

• 用户群：363346002

Copyright © 2019-2025 TuRou