运维与验证

本文概括当前配置入口、启动约束和已有验证证据。架构边界见架构说明；简要项目说明见 README。当前 Prism 整合包的本地验收结果见验收记录，实际部署仍需按自身网络与并发规模验证。

配置和启动

默认配置模板为 strataproxy.yml。发行包将配置放在 config/，插件 JAR 放在 plugins/。相对 plugins.directory 从所选配置文件所在目录解析；plugins.enabled 以插件实现类全名为键，空映射不启用外部插件。插件可用设置由各插件在启动时校验。

本地安装发行包并启动：

.\gradlew.bat :proxy-core:installDist
.\proxy-core\build\install\strataproxy\bin\strataproxy.bat --validate-config .\proxy-core\build\install\strataproxy\config\strataproxy.yml
.\proxy-core\build\install\strataproxy\bin\strataproxy.bat --config .\proxy-core\build\install\strataproxy\config\strataproxy.yml

--validate-config 校验核心 YAML、静态后端注册和服务器列表图标；它不会加载插件，所以不会验证已启用插件的设置、后端连通性或登录流程。未知核心配置键会报错。

采用统一事件模型后，已有配置中的 plugins.accessTimeoutSeconds 需要改为 plugins.eventTimeoutSeconds；旧键已删除，启动时会被当作未知配置拒绝。

服务器列表

status:
  motd: "StrataProxy"
  maxPlayers: 100
  # icon: "server-icon.png"

motd 是允许换行的纯文本，最多 1024 个 Unicode 码点。maxPlayers 是客户端列表展示人数，范围为 1–1,000,000，不影响实际连接上限 maxConnections；在线人数来自代理已发布的玩家会话。省略 status 时使用上面的默认文本与人数。

可选 icon 必须是 64×64 PNG，文件不超过 64 KiB，使用相对配置文件所在目录的路径。完整 STATUS 响应还须满足协议字符串 32,767 UTF-8 字节上限，文本与图标组合过大时配置校验失败。启动和 --validate-config 读取并校验图标，错误时停止；运行中的状态查询复用预构造数据，不读磁盘，也不派发插件事件。更改列表配置需要重启。

认证、监听和容量边界

必须显式设定 authentication: OFFLINE 或 ONLINE_BUNGEE。随附示例使用 OFFLINE 并绑定字面量 127.0.0.1。OFFLINE 信任客户端提交的名字；没有显式设置 allowOfflinePublicAccess: true 时只允许字面量回环 IP，避免主机名解析改变监听范围。
对外服务使用 ONLINE_BUNGEE，并将后端限制为代理可达，禁止客户端绕过代理直连；后端需启用兼容的旧版 Bungee 身份转发。会话验证与加密路径有自动化测试，当前正版账号的真实 Mojang 会话验证、UUID 和皮肤签名转发也已完成端到端实测。
maxConnections 默认 4096，范围为 1–1,000,000；计数包括登录中的客户端。达到上限时新连接直接关闭。按部署资源和连接规模配置，不将其解释为后端容量。
plugins.eventTimeoutSeconds 为统一事件链期限，默认 5 秒，可设为 1–30 秒。玩家准入事件按订阅注册顺序共享一个期限；无订阅者时跳过派发。准入队列容量为 128，最多 1024 个未决请求。队列饱和、超时、异常或空结果都会拒绝当前访问：连接准入阶段关闭 TCP 连接，玩家准入阶段返回通用错误文本；插件可通过显式拒绝结果提供登录断开原因。生命周期通知有独立的单线程 FIFO 队列，容量 128，最多一个事件正在派发；单事件链受同一事件期限约束。过载时尽力丢弃并聚合记录，不影响连接处理。
未认证帧上限为 4 KiB；后端 Login Success 后切换到协议 5 PLAY 帧上限。握手/身份验证与后端连接/登录各自有 15 秒期限；初始选服默认 15 秒，可由 plugins.initialPlacementTimeoutSeconds 设为 1–120 秒。成功登录后，客户端须在两分钟内完成首次 PLAY/Forge 握手。
登录拒绝、插件主动断开以及后端关闭/读失败的已提交前端写入最多排空等待 5 秒。转服切换阶段有 15 秒期限；Forge 客户端切换后目标握手最多等待 30 秒。各期限届满可能使当前登录失败或关闭当前会话。

可选后端发现

DNS 示例配置见 strataproxy-dns.example.yml。它将静态 backends 设为空，并通过 plugins.enabled 启用 DNS 插件，设置 DNS 主机名、端口、名称前缀和刷新周期。DNS 查找失败暂时保留旧地址；连续三次失败后移除过期地址。DNS 查询明确返回地址族无记录时，该族地址会按解析结果更新。localhost 使用系统回环地址解析；普通主机名由插件自己的解析器查询，不依赖 JVM 的全局地址缓存。

Agent 示例见发现插件和 AgentDiscoveryPlugin。启用其 HTTP 注册监听前，应在受控网络中配置随机共享密钥，并按插件的端口、并发和租约约束部署。代理核心没有内置云实例发现或健康探测。

玩家准入事件 API、检查顺序与 Ban 插件边界见插件接入说明。连接准入拒绝发生在 Minecraft 协议开始前，因此没有 Login Disconnect 可供显示；玩家准入发生在身份解析后。ONLINE_BUNGEE 仍由核心完成会话验证后才发出玩家事件，离线模式的身份由客户端提供且 authenticated 为 false。会话通知不保证 Forge 或玩法世界就绪，也不能用于可靠审计或计费。

验证命令和现有证据

源码测试集中在四个模块。项目定义的常规验证入口为：

.\gradlew.bat check

该任务包含插件 API、核心、DNS/Agent 插件测试，并在核心 check 中依赖安装发行包后的帮助、版本及配置校验烟测。详细烟测、性能测量方法与历史记录见验证方法。

现有测试可用于定位行为范围：

登录、认证和协议：proxy-core/src/test/java/dev/strataproxy/core/auth/ 与 proxy-core/src/test/java/dev/strataproxy/core/protocol/
会话、断开、转服与缓冲：proxy-core/src/test/java/dev/strataproxy/core/session/，重点包括 SessionTransferTest、SessionTransferDispatchTest、TransferFrameBufferTest
插件生命周期、访问检查和 API：proxy-core/src/test/java/dev/strataproxy/core/plugin/PluginHostTest.java、proxy-core/src/test/java/dev/strataproxy/core/session/ProxySessionListenerTest.java、proxy-core/src/test/java/dev/strataproxy/app/ProxyConfigurationTest.java 与 proxy-plugin-api/src/test/
发现器：plugins/dns-discovery/src/test/ 与 plugins/agent-discovery/src/test/

仓库另有本地 Uranium 协议探针和 Prism Forge 客户端记录，见 smoke/results、转服记录和真实客户端记录。这些记录支持其明确写出的单机环境、软件版本和探针路径。已知也出现过真实 Forge 客户端转服候选后端登录停滞，见调查记录；已有成功样例不构成稳定性或生产验收。

后续当前整合包验收补充了真实在线认证、20 次连续转服及真实模组后端的配对测量。跨物理主机部署、长时间并发容量和完整模组玩法仍未由这些单机证据覆盖。Ban 数据库及封禁策略由业务插件实现，核心提供已测试的准入事件。

7.8 KiB Raw Blame History Unescape Escape