DockBridge

插件

· 作者 Freddi

基于 Docker 的 Velocity 服务器自动注册插件。

0 本站下载 0 关注 更新于 10 个月前

最新 2025.12.27 · 1.21.11 · Velocity

一键开服(送7天)

DockBridge

用于自动注册基于 Docker 的服务器(例如 Limbo)并在 Modrinth 上检查更新的 Velocity 插件。

功能

  • 自动发现:带有标签 net.uebliche.dockbridge.autoregister=true 的容器会被注册为 Velocity 服务器。主机名取自容器名称,端口取自标签 net.uebliche.dockbridge.server_port(备选方案:第一个暴露的端口,否则默认为 25565)。
  • 名称冲突处理:默认使用 suffix → 追加简短的容器 ID(basename-abcdef)。替代方案 overwrite → 保留基础名称,最后写入者胜出。
  • /dockbridge 命令(权限 dockbridge.command):显示标签过滤器、重复处理策略、上次扫描统计信息以及已注册的服务器(不包含敏感数据)。
  • 代理启动时检查 Modrinth 更新;拥有 dockbridge.update.notify 权限的玩家登录时会收到提示。

安装

  1. 从 Modrinth 下载最新的 DockBridge 版本(jar 文件)。
  2. 将 jar 文件放入 Velocity 的 plugins/ 文件夹中。
  3. (可选)如果 Velocity 运行在 Docker 中,请将 /var/run/docker.sock 挂载到 Velocity 容器中,以便 DockBridge 能够发现容器。
  4. 启动 Velocity。首次启动时,会在 Velocity 的数据文件夹中创建配置文件 dockbridge.conf;调整设置后重启。
  5. 权限说明:
    • dockbridge.command 用于 /dockbridge 命令
    • dockbridge.update.notify 用于登录时的更新提示

配置

dockbridge.conf(首次启动时在 Velocity 数据文件夹中创建):

docker.endpoint=unix:///var/run/docker.sock
docker.poll_interval_seconds=30
filters.proxy_group=default
docker.autoregister.label_key=net.uebliche.dockbridge.autoregister
docker.autoregister.label_value=true
docker.autoregister.name_label=net.uebliche.dockbridge.server_name
docker.autoregister.port_label=net.uebliche.dockbridge.server_port
docker.autoregister.duplicate_strategy=suffix   # suffix | overwrite

Docker 标签示例

net.uebliche.dockbridge.autoregister=true
net.uebliche.dockbridge.server_name=limbo
net.uebliche.dockbridge.server_port=30000

本地测试

Gradle 运行

./gradlew runVelocity

下载 Velocity,构建插件(shadowJar),并加载插件启动代理。

Docker Compose(Limbo 环境)

docker compose up --build        # 或:docker compose -f docker-compose.limbo.yml up --build

包含三个 Limbo 后端(端口 30000/30001/30002)和 Velocity(宿主机端口 26678)。Velocity 通过容器内的 runVelocity 运行,并挂载您的源代码/配置。

命令与权限

  • /dockbridge(权限 dockbridge.command):查看状态和已注册的服务器。
  • 登录时的更新提示:需要权限 dockbridge.update.notify。

故障排除

  • 没有服务器被注册?
    • 确保您的容器具有标签 net.uebliche.dockbridge.autoregister=true 以及有效的 net.uebliche.dockbridge.server_port。
    • 确保 Velocity 可以访问 Docker:挂载 /var/run/docker.sock(或将 docker.endpoint 设置为可达的 TCP 端点)。
    • 检查 /dockbridge 输出以查看上次扫描计数和已注册的服务器。
  • 端口不匹配或转发错误?
    • 验证 Limbo(或其他后端)的端口是否与标签和服务属性匹配。
    • 对于 Velocity 转发,请确保两端的转发密钥/模式一致。
  • 名称重复?
    • 默认策略是 suffix。如果您希望采用“最后写入者胜出”的策略,可通过 docker.autoregister.duplicate_strategy 切换为 overwrite。

构建

./gradlew build

生成位于 build/libs/DockBridge-<version>.jar 的阴影 jar 包。

贡献

  • 欢迎 Fork 和提交 PR。保持代码注释简洁但富有目的性。
  • 默认使用 Java 21、Gradle Kotlin DSL、Velocity API 3.4.0-SNAPSHOT 用于运行任务;3.1.1 用于 compileOnly/annotationProcessor。
  • 提交前请运行 ./gradlew build;基于 Docker 的测试是可选的。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源