自动保持你的 KmDDNS 记录处于最新状态,让玩家可以随时找到你的服务器——即使你的 IP 地址发生变化。
无需路由器配置,无需静态 IP。只需安装并运行即可。
功能说明
KmDDNS 为你的 Minecraft 服务器提供一个永久地址,例如 myserver.ddns.kmathers.co.uk。每当服务器启动时,模组会检查你当前的公网 IP 并自动更新 DNS 记录。玩家始终可以通过同一地址连接。
隧道模式(Tunnel mode) 更进一步——如果你无法或不想进行端口转发,模组会连接到中继服务器,通过 KmDDNS 基础设施路由玩家流量。完全不需要端口转发。
特性
- 自动将你的子域名指向当前 IP
- 将服务器的 MOTD 和在线人数发送到 KmDDNS API(在查询页面上显示)
- 隧道模式 — 无需端口转发,流量通过中继代理
- 游戏内设置向导 — 无需退出游戏即可完成注册或配置
/kmddns status可一目了然地查看当前地址、IP 和连接状态- 可配置的心跳间隔、端口和标签
设置指南
1. 获取子域名
在游戏中运行 /kmddns setup 打开向导。你可以:
- 注册新子域名 — 选择一个名称并即时获取令牌
- 使用现有令牌 — 如果你已经拥有 KmDDNS 账户
向导将引导你完成端口检测、更新间隔以及是否启用隧道模式的设置。确认后将保存配置并立即开始运行。
2. 完成
你的服务器现在将出现在 yourname.ddns.kmathers.co.uk。玩家使用该地址即可连接。
隧道模式
如果你位于 CGNAT 之后、防火墙策略严格,或者只是不想折腾端口转发,请在设置期间启用隧道模式。
在隧道模式下:
- 模组会与 KmDDNS 保持 WebSocket 连接
- 当玩家连接到你的子域名时,中继会将他们路由到你的服务器
- 你的服务器无需直接从互联网可达
可在 /kmddns setup 期间启用它,或在配置文件中设置 tunnel = true,并通过 API 切换开启。
命令
| 命令 | 描述 |
|---|---|
/kmddns status |
显示当前 IP、子域名、隧道状态及上次更新时间 |
/kmddns setup |
打开交互式设置向导 |
/kmddns setup token <token> |
使用现有令牌进行配置 |
/kmddns setup new |
注册新子域名 |
配置文件
首次启动时会自动创建配置文件 config/kmddns.toml。
[kmddns]
enabled = true
token = "your-token-here"
api_base = "https://ddns.kmathers.co.uk/v1"
port = 0 # 0 = 从 server.properties 自动检测
update_interval = 300 # 心跳之间的秒数(最小值为 30)
tags = ["minecraft"]
metadata_motd = true # 向 API 发送服务器 MOTD
metadata_player_count = true
log_updates = true
tunnel = false # 设为 true 以启用隧道模式
要求
- 仅限服务端 — 玩家无需安装此模组
- Fabric 或 NeoForge
- Minecraft 1.21.1、1.21.4、1.21.5 或 1.21.11
- 一个 KmDDNS 账户(免费,可通过
/kmddns setup new创建)
温馨提示
我出于乐趣和社区精神开发这些工具。维持其正常运行确实涉及实际的维护成本,哪怕只有 1 美元也能发挥很大作用。
如果你喜欢这些工具并希望回馈,可以在这里支持我:请我喝杯咖啡。无论是否支持都毫无压力——感谢你的到来。
Automatically keeps your KmDDNS record up to date so players can always find your server — even when your IP changes.
No router config. No static IP. Just install and run.
What it does
KmDDNS gives your Minecraft server a permanent address like myserver.ddns.kmathers.co.uk. Whenever your server starts, the mod checks your current public IP and updates the DNS record automatically. Players always connect to the same address.
Tunnel mode takes this further — if you can't or don't want to forward ports, the mod connects to a relay that routes player traffic through KmDDNS infrastructure. No port forwarding required at all.
Features
- Keeps your subdomain pointing at your current IP automatically
- Sends your server's MOTD and player count to the KmDDNS API (shown on the lookup page)
- Tunnel mode — no port forwarding needed, traffic is proxied through a relay
- In-game setup wizard — register or configure everything without leaving the game
/kmddns statusto see your current address, IP, and connection state at a glance- Configurable heartbeat interval, port, and tags
Setup
1. Get a subdomain
Run /kmddns setup in-game to open the wizard. You can:
- Register a new subdomain — pick a name and get a token on the spot
- Use an existing token — if you already have a KmDDNS account
The wizard walks you through port detection, update interval, and whether to use tunnel mode. When you confirm, it saves the config and starts immediately.
2. That's it
Your server will now appear at yourname.ddns.kmathers.co.uk. Players connect using that address.
Tunnel mode
If you're behind CGNAT, a strict firewall, or just don't want to mess with port forwarding, enable tunnel mode during setup.
In tunnel mode:
- The mod keeps a WebSocket connection open to KmDDNS
- When a player connects to your subdomain, the relay routes them through to your server
- Your server doesn't need to be reachable from the internet directly
Enable it during /kmddns setup, or set tunnel = true in the config and toggle it on via the API.
Commands
| Command | Description |
|---|---|
/kmddns status |
Show current IP, subdomain, tunnel state, and last update time |
/kmddns setup |
Open the interactive setup wizard |
/kmddns setup token <token> |
Configure with an existing token |
/kmddns setup new |
Register a new subdomain |
Config
The config file is created automatically at config/kmddns.toml on first launch.
[kmddns]
enabled = true
token = "your-token-here"
api_base = "https://ddns.kmathers.co.uk/v1"
port = 0 # 0 = auto-detect from server.properties
update_interval = 300 # seconds between heartbeats (minimum 30)
tags = ["minecraft"]
metadata_motd = true # send server MOTD to the API
metadata_player_count = true
log_updates = true
tunnel = false # set true to use tunnel mode
Requirements
- Server-side only — players do not need this mod
- Fabric or NeoForge
- Minecraft 1.21.1, 1.21.4, 1.21.5, or 1.21.11
- A KmDDNS account (free, created via
/kmddns setup new)
A quick note
I build these tools for fun and for the community. Keeping everything running does have real maintenance costs, and even $1 goes a long way.
If you enjoy the tools and want to give back, you can support me here: Buy me a coffee. No pressure either way — thanks for being here.
下载 KmDDNS
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 KmDDNS
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 KmDDNS
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 KmDDNS
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 KmDDNS
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 KmDDNS
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 KmDDNS
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 KmDDNS
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
暂无更新日志
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
缓冲的原始输入和线程化的事件轮询
模组
可定制的鞘翅模组,支持装饰纹饰、旗帜图案等更多功能!
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
原版世界生成优化模组
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
评论 0
登录后参与评分
还没有评论,来抢沙发吧