AuthBack

模组

· 作者 litetex

即使身份验证服务器宕机,也能让你正常游玩

0 本站下载 0 关注 更新于 2 天前

需要前置:Fabric API

最新 1.9.1 · 26.3 · Fabric

一键开服(送7天)

即使 Mojang 的身份验证服务器宕机,也能让你正常游戏。 此外,它还改善了网络行为。

它是如何工作的?

  1. Mojang 的 Web 服务/API 的响应会被本地缓存一段时间。
    如果发生宕机,则使用之前缓存的响应。
    例如,这使得你的皮肤能够正确显示。
  2. 每个客户端都会本地存储(或生成如果不存在)一个密钥对,当 Mojang 的身份验证服务器宕机时,该密钥对将用作与服务器进行身份验证的回退方案(参见 公钥加密)。
    请注意:
    • 服务器也必须安装此模组
    • 你必须在过去 36 天内至少加入过一次该服务器

该模组对客户端和服务器都是可选的。
但是,如果一方缺少该模组,当 Mojang 的身份验证服务器/API 宕机时,将无法加入服务器。

用法

命令

你可以在安装了该模组的服务器上,使用 /authback 命令来管理你自己的或其他玩家(如果你是管理员)的公钥。

配置

客户端

你可以通过以下方式配置该模组:

  • 选项 > 在线... > AuthBack...
  • 或者如果安装了 ModMenu:模组 > AuthBack > 点击图标/设置

通用

配置动态加载自以下位置(按优先级从高到低排序)
  • 环境变量
    • 以 AUTHBACK_<variant> 为前缀
      • 其中 variant 是 SERVER 或 CLIENT
    • 以 AUTHBACK_ 为前缀
    • 所有属性均为大写,并使用 _ 代替 . 或 -
  • 系统属性
    • 以 authback.<variant> 为前缀
      • 其中 variant 是 server 或 client
    • 以 authback. 为前缀
  • 位于 .config/authback-<variant>.json 中的配置文件
    • 其中 variant 是 server 或 client
完整的配置选项列表

请注意,预配置的值通常开箱即用。
在进行修改时,你应该确切地知道自己在做什么。

通用(客户端和服务器)
属性 类型 默认值 备注
discovery-cache.default-reuse-minutes int 120 (2h) Mojang API 的 discovery 端点的响应几乎从不更改。此选项指示模组重用最后保存的响应,持续指定的分钟数,而不是再次联系 API。使用缓存的响应要快得多,并且在频繁重启游戏时节省网络流量。
global-public-keys-cache.default-reuse-minutes int 120 (2h) 与上面的 discovery-cache 相同,但针对 global-public-keys。截至编写本文档时,这些密钥在过去 3 年多时间内未发生过更改。
game-profiles.delete-after-days int 36 选择 36 天作为默认值,是因为当玩家更改其用户名时,该名称将在 37 天内不可用
game-profiles.max-cache-size int 250 在缓存中保留的最大游戏档案数量。如果超出最大值,最旧的条目将被移除,直到列表降至配置最大值的 90%。
username-to-id-resolver.use-vanilla bool false 使用原始的/“原版”用户名到 ID 解析器
username-to-id-resolver.expire-after-days int 36 缓存条目被删除前的天数。
选择 36 天作为默认值,是因为当玩家更改其用户名时,该名称将在 37 天内不可用。
原版实现使用的是 1 个月。
username-to-id-resolver.refresh-before-expire-days int 14 在过期前的天数,当缓存条目被访问时将会刷新。
username-to-id-resolver.max-cache-size int 1000 在缓存中保留的用户名和 ID 的最大数量。如果超出最大值,最旧的条目将被移除,直到列表降至配置最大值的 90%。
username-to-id-resolver.resolve-offline-users-by-default bool true 是否应缓存离线用户(例如未验证的账户)?
请注意
  • 离线用户缓存与在线用户缓存完全分离,且永远不会持久化
  • 这只是初始值
  • 客户端将始终解析离线用户,而服务器仅在禁用 online-mode 时才会这样做
username-to-id-resolver.update-on-game-profile-fetch bool true 获取游戏档案时:是否应将信息中继给用户名到 ID 解析器/缓存?
仅当需要时(例如未知的用户名/ID 或条目不存在)才会更新缓存
username-to-id-resolver.use-game-profile-cache bool true 当所有主缓存失败时,使用 GameProfileCacheManager 作为二级缓存。
这种情况应该极少发生,但如果缓存损坏等情况下可能会发生
skip-extract-profile-action-types bool false 调试选项
服务器
属性 类型 默认值 备注
keys.max-keys-per-player int 3 每个玩家存储的公钥最大数量
keys.delete-after-unused-days int 36 如果用户在此时间段内未使用公钥登录,该密钥将被删除。选择 36 天作为默认值是因为当玩家更改用户名时,旧名称将在 37 天内不可用
fallback-auth.allow-always bool true 始终允许使用备用身份验证。如果只想在服务器无法在玩家登录期间与 Mojang API 通信时才允许备用身份验证,请设置为 false
fallback-auth.rate-limit.requests-per-ip-per-minute int 20 默认设置允许每 3 秒发起一次请求。如果值设置为 0 或更小,速率限制器将禁用
fallback-auth.rate-limit.bucket-size int 1000 存储的 IP 地址数量(在内存中)
fallback-auth.rate-limit.ignore-private-addresses bool true 是否不对 私有 IP 地址 进行速率限制?
fallback-auth.rate-limit.ipv6-network-prefix-bytes int 8 IPv6 的网络前缀字节数(不是比特!)。默认值 8 对应 /64。
force-disable-enforce-secure-profile bool true 强制禁用 enforce-secure-profile
skip-old-user-conversion bool true 跳过迁移 1.7.6(2014-04 发布)之前服务器使用的用户文件。这种情况极不可能需要,且涉及联系 Mojang API。因此默认跳过迁移
disable-legacy-query-handler bool true 禁用传统/1.7 之前(2013-10 发布)的查询/心跳处理程序
log-connection-init-ips bool false 记录所有初始化/开始连接到 INFO 级别的所有远程 IP
客户端

所有特定于客户端的选项都可以在游戏选项 UI 中更改/描述(见上文)。

常见问题解答

我在哪里可以找到我的公钥?

公钥可以在以下位置找到/复制:

  • Options > Online... > AuthBack... > Key management
  • 或者如果安装了 ModMenu:Mods > AuthBack > Click Icon/Settings > Key management

身份验证服务器宕机,我在服务器上安装了模组但无法加入

这是因为服务器不知道你的公钥。

你可以通过以下方式修复此问题:

  1. 确保你在不到一个月前登录过该服务器
    • 这是因为在这种情况下将使用的 usercache.json 中的条目将在一个月后过期
  2. 确保你可以透过服务器控制台/RCON 运行命令
  3. 将模组添加到本地客户端/游戏中并启动它
  4. 然后从中复制公钥(详见上文)
  5. 然后在服务器上将该公钥与你的账户关联:
    • /authback public_key add name <yourName> <yourPublicKey>
    • 或 /authback public_key add id <yourUUID> <yourPublicKey>

你现在应该可以像往常一样登录了。
但是请注意,与配置文件相关的内容(如皮肤)将不会显示。

建议在故障结束后重启服务器,以正确加载现有的配置文件。

身份验证服务器宕机,我的朋友安装了模组但无法加入我的服务器

这是因为他们以前从未带着模组加入过。

如果你是管理员,你可以通过以下方式修复此问题:

  1. 告诉你的朋友使用模组启动游戏
  2. 并将他们的公钥(见上文“我在哪里可以找到我的公钥?”)发送给你
  3. 通过在服务器上运行 /authback public_key add name <yourFriendsPlayerName> <yourFriendsPublicKey> 将公钥与他们在服务器上关联

我如何测试备用身份验证?

  1. 确保服务器知道你的公钥(你可以在服务器上通过 /authback public_key list 检查)
  2. 确保服务器上启用了 fallback-auth.allow-always(默认情况下应已启用)
  3. 以离线模式启动客户端
  4. 在客户端选项中启用 Suppress any joinServer error
  5. 你现在应该能够使用备用身份验证加入服务器。请查看日志以获取详细信息。

模组将其数据存储在哪里?

在游戏目录(例如 %APPDATA%\.minecraft)内的 .mods\authback 目录中。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源