开始
打开网页后提示不安全，或者证书无效
在 2025 年 12 月底，华立开始给二维码页面使用 HTTPS，所以 UsagiPass 必须安装 CA 证书才能继续使用。请确保你已经正确安装了 UsagiPass 的 CA 证书。
了解 DXPass
DXPass 是日服限定的，可以在制卡机上制作的具有特殊功能的实体卡片。通常印有玩家信息、角色立绘、区域背景等元素，有提升跑图距离、解锁上位难度的谱面等等功能。
虽然国服无法制作 DXPass，但是独特的微信登录机制使我们有了动态生成 DXPass 的可能，UsagiPass 应运而生。
安装 UsagiPass
安装 UsagiPass 需要你具有一定的动手能力，下面我们将逐步讲解如何安装 UsagiPass：
第一步：安装 CA 证书
UsagiPass 需要代理 HTTPS 流量以实现二维码页面的替换功能，故需要安装 CA 证书。
安卓设备（安装为用户证书）
使用浏览器下载 https://up.turou.fun/ca.pem 并记住存放位置，通常保存在内部存储中的
/Download目录下打开设备设置，选择安全设置，选择“加密与凭据”（实际选项和操作顺序根据不同厂商设定会有所不同）
在“加密与凭据”界面下，选择安装证书->CA 证书，此时你的设备会弹出安全警示，选择仍然安装
系统会跳转至默认文件管理器，在保存的目录找到证书文件并点击即可完成证书安装流程。
成功安装后系统会在通知界面常驻一个风险提示，忽略即可。😃
安卓设备（安装为系统证书，需要 root）
警告！此方法高度依赖动手能力，除非你安装用户证书后无效，否则不推荐此方法！
本教程不对你因使用此方法而对设备造成的任何损害负责！
警告！此方法高度依赖动手能力，除非你安装用户证书后无效，否则不推荐此方法！
本教程不对你因使用此方法而对设备造成的任何损害负责！
警告！此方法高度依赖动手能力，除非你安装用户证书后无效，否则不推荐此方法！
本教程不对你因使用此方法而对设备造成的任何损害负责！
以任何方法将安装后的证书移动至 /system/etc/security/cacerts/ 目录下
也可加入 UsagiPass 用户群，在群文件获取 Magisk 模块：363346002
更多细节可参阅这篇文章，本文不再赘述
iOS 设备
安装证书：去设置->通用->VPN与设备管理，点击证书安装
信任证书：设置->通用->关于本机->证书信任设置，打开开关
第二步：配置代理软件
UsagiPass 需要代理才能运行，请根据你的设备选择合适的代理软件：
安卓设备
推荐使用 Mihomo：
下载安装 Mihomo：
- Github（推荐）：https://github.com/MetaCubeX/ClashMetaForAndroid/releases
- 蓝奏云（国内）：https://wwps.lanzouj.com/iXMCk2cydjmd
- 加入 UsagiPass 用户群，在群公告处获取：363346002
导入 UsagiPass 配置：
- 一键导入：导入 Clash 配置
- 复制链接到 Clash 导入：
https://up.turou.fun/UsagiPass.yaml - 从群文件获取配置：363346002
iOS 设备
推荐使用 Singbox：
切换外区账号，在 AppStore 中搜索 Singbox VT 并下载
Profiles -> New Profile -> Name: 随意，Type: Remote，URL:
https://up.turou.fun/UsagiPass.json-> Create确保选择了 UsagiPass 配置，点击启动代理即可生效！
第三步：访问 UsagiPass
在微信 -> 舞萌|中二公众号中正常打开玩家二维码
你应该已经跳转到 UsagiPass 的登录界面
使用水鱼或落雪查分器账号进行登录
登录后即可进入 UsagiPass 主页，享受可登录的国服 DXPass 功能
使用 UsagiPass 更新查分器
UsagiPass 支持从公众号同步你的成绩并更新至 UsagiLab 通行证绑定的查分器，且在系统缺少证书的状态下仍可工作，假如你不想安装证书或证书已安装但无效，还可有限地使用 UsagiPass。在完成第二步配置代理软件后：
启用代理
发送 https://up.turou.fun 或 https://up.turou.fun/auth/login 至微信任意聊天并访问
注册或登录你的 UsagiLab 通行证（此步为必需，请不要使用访客模式）
在设置页面按照提示绑定你的查分器账号，已有绑定可跳过
回到主页，点击卡片左下角的小火箭图标，等待系统提示即可更新数据
请注意：此方式下无法使用二维码美化功能，且若未安装证书那么在代理启用下二维码页面也将无法正常打开。
支持 UsagiPass
如果觉得 UsagiPass 好用的话，不妨给我们的仓库点一个 ⭐ 吧。
我们也开放了爱发电入口，如果你愿意赞助 UsagiPass 我们会在特别感谢中提到你的名字。
常见问题
Q: 打开网页后提示不安全，或者证书无效
A: 请确保你已经正确安装了 UsagiPass 的 CA 证书。
Q：我不清楚 UsagiPass 的代理具体如何配置
A：可以在左侧的目录（手机用户请点击左上角 Menu 按钮）中找到受支持代理的详细介绍。如果仍有疑问，可以加群进行询问。
Q：IOS 使用小火箭需要购买
A：可以使用 Sing-box 方案，Sing-box 是一款在外区商店可以免费下载的代理软件。
Q：IOS 我不知道应该如何获得外区账号
A：可以在 B 站搜索相关关键词，这类视频还是挺多的，请尽量不要在群内讨论相关话题。
Q：在按照步骤配置后，我无法打开 UsagiPass 网页或更新公众号数据出现异常
A：UsagiPass 目前使用腾讯云托管，域名使用阿里云个人版云解析，并且已经在工信部备案，可保证国内各地区的正常访问。
若你在自行诊断后仍然出现无法连接的问题，请加群联系我们，我们会根据你的地区向服务商发起工单，尝试解决你的问题。
另外，如果你的错误代码在下面表格中列出：
- ERR_PROXY_CONNECTION_FAILED
- ERR_CONNECTION_TIMED_OUT
- ERR_HTTP_RESPONSE_CODE_FAILURE
可能是代理连接不正确，请重启代理、重启手机、更换代理软件后重试。