
GeoRestrict
为 Minecraft 服务器和代理提供友好的地理访问控制。
GeoRestrict 允许你制定关于连接来源地的实用规则。可以阻止来自少数几个国家的流量,让私人服务器仅对特定地区开放,拦截来自令人头疼的主机网络的流量,或者在遭受攻击时启用 VPN 规则。策略保存在你自己的 config.yml 中,你可以随时阅读和修改它。
由 Nexeu Hosting 赞助
为您的 Minecraft 服务器提供高性能、经济实惠的主机服务。高端硬件,即时部署,全天候支持。
实用功能
- 国家白名单和黑名单
- 针对单个 ISP 和主机网络的 ASN 规则
- 可配置的 VPN、代理和主机检测
- Geyser / Floodgate (Bedrock) 集成,支持自定义绕过选项
- 开发者 API (
GeoRestrictAPI),适用于 Paper、BungeeCord 和 Velocity(地理路由、VPN 查询、ASN 查找) - 一个 v2.0.2 jar 文件即可兼容 Bukkit、Spigot、Paper、Purpur、Folia、BungeeCord 和 Velocity
- 本地有界缓存,支持原子保存和自动过期清理
- 当查找服务暂时不可用时,行为清晰明确
- Discord 阻断通知,默认启用 IP 掩码
/georestrict check、cachestats、purgecache和reload命令- 在兼容 Bukkit 的服务器上支持
georestrict.bypass权限
从小处着手
- 将
georestrict-2.0.2.jar放入服务器或代理的plugins/文件夹。 - 重启一次以生成
plugins/GeoRestrict/config.yml。 - 选择
BLOCKLIST(黑名单)或ALLOWLIST(白名单),并添加两位字母的国家代码。 - 运行
/georestrict reload。 - 使用
/georestrict check <ip>在邀请所有人回归前确认结果。
你不需要在第一天就启用所有功能。对于许多社区来说,国家规则已经足够;ASN 和 VPN 控制可以等到你有具体问题需要解决时再启用。
当查找失败时
v2.0.2 在缓存为空且查找服务不可用时默认进行阻断。玩家会收到你的 kickMessageLookupFailure 踢出消息。如果保持服务器在故障期间可达比严格过滤更重要,请设置 blockOnLookupFailure: false。
实时统计
隐私保护,没有模糊的承诺
在缓存未命中时,连接的 IP 会被发送到配置的查找服务以获取国家、ASN 和代理数据。GeoRestrict 不运行中央玩家面板或玩家分析服务。每个平台都提供标准的聚合 bStats 指标;bStats 不会从本插件接收玩家名称或 IP 地址。大多数社区可以保持生成的网络设置不变。
要求
- GeoRestrict 针对 Java 17 字节码;请使用你的平台所需的较新 Java 版本
- 查看 wiki 中的测试版本表以了解你的 Minecraft 发行版
- 受支持的 Bukkit 服务器或代理平台
- 对配置查找服务的出站 HTTPS 访问权限
帮助和项目链接
GeoRestrict 最初由 linuxaddict 创建,现由 Demonz Development 开源社区维护。采用 GPL-3.0 许可证。

GeoRestrict
Friendly geographic access control for Minecraft servers and proxies.
GeoRestrict lets you make practical rules around where connections come from. Block a short list of countries, keep a private server open to one region, stop traffic from a troublesome hosting network, or add a VPN rule while an attack is active. The policy stays in your own config.yml, where you can read it and change it.
Sponsored by Nexeu Hosting
High-performance, affordable hosting for your Minecraft server. Premium hardware, instant setup, 24/7 support.
The useful bits
- Country allowlists and blocklists
- ASN rules for individual ISPs and hosting networks
- Configurable VPN, proxy and hosting detection
- Geyser / Floodgate (Bedrock) integration with custom bypass options
- Developer API (
GeoRestrictAPI) for Paper, BungeeCord, and Velocity (Geo-Routing, VPN queries, ASN lookups) - One v2.0.2 jar for Bukkit, Spigot, Paper, Purpur, Folia, BungeeCord, Waterfall and Velocity
- Local, bounded cache with atomic saves and automatic expiry cleanup
- Clear behavior when the lookup service is temporarily unavailable
- Discord block notifications with IP masking enabled by default
/georestrict check,cachestats,purgecacheandreloadgeorestrict.bypasson servers compatible with Bukkit
Start small
- Put
georestrict-2.0.2.jarin the server or proxyplugins/folder. - Restart once to create
plugins/GeoRestrict/config.yml. - Pick
BLOCKLISTorALLOWLISTand add two letter country codes. - Run
/georestrict reload. - Use
/georestrict check <ip>to confirm the result before inviting everyone back.
You do not need to enable every feature on day one. Country rules are enough for many communities; ASN and VPN controls can wait until you have a specific problem to solve.
When a lookup fails
v2.0.2 blocks by default when the cache is empty and the lookup service is unavailable. The player receives your kickMessageLookupFailure. Set blockOnLookupFailure: false if keeping the server reachable during an outage matters more than strict filtering.
Live Statistics
Privacy, without vague promises
On a cache miss, the connecting IP goes to the configured lookup service for country, ASN and proxy data. GeoRestrict does not run a central player panel or player analytics service. Standard aggregate bStats metrics are available per platform; bStats does not receive player names or IP addresses from this plugin. Most communities can keep the generated network settings unchanged.
Requirements
- GeoRestrict targets Java 17 bytecode; use the newer Java version required by your platform
- Check the tested version table in the wiki for your Minecraft release
- A supported Bukkit server or proxy platform
- Outbound HTTPS access to the configured lookup service
Help and project links
- Source code
- Download on Modrinth
- Documentation
- Privacy Policy
- Terms and Conditions
- Bug reports
- Demonz Development
GeoRestrict was originally created by linuxaddict and is now maintained by the Demonz Development open source community. Licensed under GPL-3.0.
下载 Geo Restrict
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Geo Restrict
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Geo Restrict
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Geo Restrict
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Geo Restrict
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Geo Restrict
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Geo Restrict
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Geo Restrict
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Geo Restrict
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Geo Restrict
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
GeoRestrict v2.1.0
更新内容
- 本地连接访问控制:可选的
blockLocalConnections功能可在地理定位查询之前,拒绝回环地址(127.0.0.1)、RFC1918 局域网、链路本地地址以及唯一本地 IPv6 地址。 - 国家规则中的 LOCAL 评估:在国家
BLOCKLIST(黑名单)中设置LOCAL将使用kickMessageCountry踢出本地连接。 - 多加载器服务器模组适配器:适用于 Fabric、Forge、NeoForge 和 Sponge 的专用服务器模组共享统一规则引擎和本地缓存。
- Geyser 与 Floodgate Bedrock 集成:解决可信 Bedrock 客户端套接字问题,并遵循 Bedrock 绕过规则。
- Fail-Closed(故障关闭)架构:Cloudflare Worker 边缘路由器支持多提供商故障转移,并提供自托管的本地 DB-IP MMDB 回退服务器。
- 开发者 API (GeoRestrictAPI):支持异步查询、国家路由、ASN 以及 VPN 查询。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
评论 0
登录后参与评分
还没有评论,来抢沙发吧