layue13/MoonBridge
1
0 Fork 0
mirror of https://github.com/layue13/MoonBridge.git synced 2026-10-25 18:46:18 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
307 Commits 17 Branches 2 Tags
main
Commit Graph
12 Commits
Author SHA1 Message Date
layue13andClaude Opus 5.5 b7d6497ca8 perf: WebSocket 经 CDN：wss 改用 BoringSSL、保活 Ping、整合包形态基准 
- ProxySessionBenchmark 新增 --profile modded（仿大型整合包的双向包组与 2 MiB 登录突发，逐字节校验）、
  --websocket-tls 1（keytool 一次性证书的 wss）和 --client-coalesce 1。
- wss 监听改用随包附带的 BoringSSL（netty-tcnative-boringssl-static 2.0.84）：TLS 占 wss 代理 I/O CPU 的 55%，
  换用后每帧 CPU 在每一对配对测量中都更低（窗口 1 -22%，窗口 8 -36%），帧率 +31%/+34%；其他平台回落 JDK，
  启动日志标明所用实现。jar 由 10.4 MB 增至 16.5 MB。
- 新增 websocket.pingIntervalSeconds（默认 30，0 关闭）：升级后代理静默不超过该时长，期间无写出就发空 Ping，
  避免 CDN/负载均衡在安静的登录、选服阶段按空闲超时断开。IdleStateHandler 版本在窗口 8 多耗 7.6% CPU，
  未达规则；改为写时置位标志、每半个间隔检查的实现，JFR 中几乎不可见。
- 文档：WebSocket 接入新增“经 CDN 部署”，更正消息大小描述；记录见
  testing/benchmarks/results/2026-10-23-websocket-cdn.md。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-23 16:40:48 +08:00
layue13andClaude Opus 5.5 284c2f81cf feat: 管理控制台（JLine）与内置命令 
- core.admin.AdminView：在线玩家（地址、TCP/WebSocket、所在服务器、在线时长）、服务器
  （地址、人数、来源）与状态（版本、运行时长、传输层、监听地址、堆内存、最近 10 分钟活动）
  的只读快照；不从控制台线程直接读取会话状态
- Session 在发布玩家时记录连接详情；ProxySessionListener.onlinePlayers()
- ConnectionLog 用 RecentCounter（10 个一分钟桶）统计加入、离开、拒绝、转服与失败；
  连接数上限与插件池拒绝计入过载
- app.console：Console 在终端中使用 JLine（提示符固定在底部、历史、Tab 补全），否则按行读取
  标准输入；ConsoleLogAppender 让日志打印在提示符上方并为警告/错误着色
- 内置命令 help/list/servers/player/status/send/kick/loglevel/stop，先于插件控制台命令；
  同名插件命令在启动时警告；send/kick/loglevel/stop 写入 moonbridge.admin
- 依赖：JLine 3.30.17（reader、terminal、FFM 提供者），logback 改为编译期依赖
- 文档：operations.md 控制台命令、logging.md、CLAUDE.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-22 21:59:09 +08:00
layue13andClaude Opus 5.5 fc02bbdda6 feat: 插件之间的依赖、类共享与类型化服务 
- 可选的 META-INF/moonbridge-plugin.yml（id、version、main、dependencies，可选依赖），
  没有描述文件的插件照旧加载
- 加载顺序按依赖图（PluginGraph）：依赖先 onLoad/onEnable、后 onDisable；缺少依赖、
  依赖未启用、循环依赖、重复 id、描述文件不合法时给出准确原因并启动失败
- PluginClassLoader 在插件 API 与自身之后查找声明的依赖（含传递依赖）；只有声明过的依赖可见
- PluginContext.services()：每个类型一个提供方，只对提供方和依赖它的插件可见，随停用注销
- PluginContext.plugins()：已加载的带描述文件插件（id、版本、依赖）
- plugins.enabled 可以用 id 作键；数据目录仍按实现类名，无需迁移
- LuckPerms 平台插件的描述文件 id 为 luckperms，版本在构建时写入
- 文档：docs/plugins.md「依赖其他插件」

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-22 17:31:35 +08:00
layue13andClaude Opus 5.5 7f68e5682e feat: 运维日志策略、玩家与服务器事件日志、滚动日志文件 
- docs/logging.md 规定各级别写什么、永远不写什么，以及新增日志的做法
- core.log.ConnectionLog 统一写玩家（加入、离开、转服、转服失败、未能加入）和服务器
  （注册、地址变更、注销、不可达/恢复）事件，logger 为 moonbridge.players / moonbridge.servers
- LogText 清理对端与插件文本（控制字符、双向文字控制字符、长度上限），防止伪造日志行
- logging.playerAddresses 开关：false 时玩家地址写成 [hidden]
- Session 记录结束原因（先记录者为准），在 closePair 中写离开或未能加入的原因
- 合并的 WARN（ThrottledWarning）：连接数上限、插件命令/补全/事件/初次选服过载
- 控制通道：租约过期、注册被拒（按地址和原因去重）；插件启用/停用；启动与关闭摘要
- logback：控制台 + logs/latest.log，按天压缩滚动保留 14 天；测试只写控制台

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-22 16:44:27 +08:00
layue13andClaude Opus 5.5 afea023bce build: 代理发行包改为单个可运行的 moonbridge.jar 
发行包去掉 bin/ 启动脚本和 lib/ 下的 42 个依赖 jar，改为与其他代理服务端一样
用 java -jar moonbridge.jar 启动：
- proxy-core 用 shadow 打出含全部依赖的 moonbridge.jar（合并 META-INF/services，
  清单写入 Main-Class、Multi-Release 与 Enable-Native-Access: ALL-UNNAMED）
- 泄漏检测默认关闭改由 ProxyMain 在加载 Netty 前设置，显式 -D 仍优先
- 移除不再使用的 application 约定插件
- 安装包检查、烟测与基准脚本改用发行包根目录作 classpath；文档同步

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-22 15:00:14 +08:00
layue13andClaude Opus 5.5 789648c82f refactor: 仓库根目录按用途分组 
- proxy/：core、plugin-api、luckperms 及其上游子模块 vendor/luckperms
- messaging/、backend/ 保持在根目录（messaging 是代理与后端共用的 API）
- build-logic/（原 proxy-build-logic）
- testing/：smoke/ 与 benchmarks/，不进入发行物

Gradle 项目名不变（settings.gradle.kts 映射目录），任务路径与 Maven 坐标照旧。
脚本的仓库根定位、文档与记录中的链接同步更新。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
 2026-10-22 14:34:01 +08:00
Claude d836f6c3d3 build: 统一 release 入口，CI 覆盖客户端 mod，文档同步新结构 
- 根任务 release：build/release/ 下收集服务器包、后端插件 JAR 与客户端 mod
  （经 client-mod 自身 wrapper 构建，-PskipClientMod 可跳过），附安装位置说明
  docs/release-layout.md
- verify.yml：-Pluckperms check，并新增 client-mod 构建测试 job；
  ci.yml：-Pluckperms check release，上传 build/release/，发布带 -Pluckperms
- gradlew 加可执行位
- README、CLAUDE.md、架构/发布/测试/权限/后端接入文档与 smoke 脚本改用新模块、
  新坐标与发行包 backend/ 目录

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GGL9BudzWm4dUQgBsQw4Qr
 2026-10-21 10:13:06 +00:00
Claude 6a482cfb7d refactor: 并掉 proxy-core 中只有一个类的包 
- core.relay.RawRelay → core.session.play（PLAY 数据通路）
- core.net.NetworkTransport → core.session.channel（与后端拨号同处）
- core.forwarding.BungeeLegacyForwarding → core.auth
- core.permission.PermissionService → core.event（会话调用插件运行时的端口）

纯内部移动，不影响插件 API；测试随类移动，文档与 CLAUDE.md 同步。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GGL9BudzWm4dUQgBsQw4Qr
 2026-10-21 10:02:13 +00:00
Claude 66ef6788f1 feat: 与 TCP 并存的 WebSocket 玩家监听 
新增可选 websocket 配置段，在原有 TCP listen 之外再开一个 WebSocket 监听，
供经 CDN 接入的客户端使用；两种入口共用会话、选服、转服和 maxConnections。

- core.websocket：升级握手（可选 TLS）、二进制消息与 Minecraft 字节流互转、
  可信代理真实 IP（X-Forwarded-For 从右取第一个不可信地址 / CF-Connecting-IP 等）
- SessionChannels.clientAddress 统一玩家地址，用于两类准入事件、Mojang 验证 IP
  与 Bungee 转发
- ConnectionGate 支持升级后才加入管线；登录等待守卫放在 WebSocket 适配器之后
- 未升级连接计入 maxConnections，并受 handshakeTimeoutSeconds 约束
- 测试：真实 socket 上 TCP 与 WebSocket 并存登录与转发、分片/合并/Ping、
  在线模式加密与转发 IP、不可信来源、404/文本帧、名额归还、wss 证书加载
- 文档：docs/websocket.md，并更新运行配置、插件、架构与默认配置示例

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GGL9BudzWm4dUQgBsQw4Qr
 2026-10-20 21:23:15 +00:00
Claude 4def198cc0 docs: 修正 CI 引用、拆出历史验证记录并统一中文文档 
- CLAUDE.md、testing.md、publishing.md 的 .gitea 路径改为实际的 .github/workflows；
  说明 verify.yml 在 PR 上运行 check
- testing.md 中带日期的逐轮结果迁到 docs/records/
- README 精简为简介、快速开始和入口；配置与迁移细节只保留在 operations.md
- channel-messaging-v2.md 更名为 channel-messaging-contract.md，与 transfer-coordination.md 一起译为中文
- benchmarks/results 中两个记录改为日期前缀命名
- 新增 compileBenchmarks 并挂到 check，防止 benchmarks/ 静默失效
- .gitignore 删除不存在的 deployment/ 条目

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GGL9BudzWm4dUQgBsQw4Qr
 2026-10-20 21:06:01 +00:00
layue13andClaude Sonnet 5.5 133e46f25b Split Session into login, routing, transfer and play packages 
Session delegates frontend login to FrontendLogin, first-backend dialing to
InitialRouter and the whole transfer state machine to TransferCoordinator
behind the TransferHost port. Per-frame PLAY handlers move to session.play and
dialing helpers to session.channel. Relay hot path is unchanged.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
 2026-10-06 03:16:09 -07:00
Claude 3d197e25e2 Add CLAUDE.md 
Build/test commands (including single-test runs and the bash ./gradlew
caveat), the module layout with the Java 8 backend constraint, and the
cross-file architecture: session threading, relay data path, transfers,
transport selection, the buffer-ownership rules behind running without
Netty leak detection, and the benchmark method used in this repository.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KcCN2hYyqmU22X2Xfg1nwe
 2026-10-06 01:16:04 +00:00