- 版权类型
- 原创
- 插件中文名称
- 封禁IP
- 插件英文名称
- IPBan
- 原帖地址
- #
- 支持的核心(服务端)
- Paper
- Folia
- Purpur
- Leaves
- 语言支持
- 中文(简体)
- 适配版本(Java)
- 最新版本
- 26.x
- 1.21
配置文件
代码:
# IPBan 默认配置文件
# 自定义封禁踢出消息
# 支持颜色代码:&a &c &6 等
# 占位符:
# {reason} - 封禁原因
# {ip} - 玩家的IP地址
# {time} - 封禁创建时间
# {unban} - 解封时间(如果是永久则显示"永久")
message: |
&c你的IP地址已被封禁!
&7原因: &f{reason}
&7封禁时间: &f{time}
&7解封时间: &f{unban}
&7如有疑问请联系管理员。
# 时间显示格式
time-format: "yyyy-MM-dd HH:mm:ss"
geo:
enabled: true
# 内网 / 本机 / 保留地址直接放行
# 本机开服、局域网联机、经过内网反向代理时建议保持 true
allow-private: true
# IPv6 地址的处理方式:
# auto - 按 IP 库中的大陆 IPv6 段判定(推荐)
# allow - 一律放行(玩家走 IPv6 时不会被误拦)
# block - 一律拦截
ipv6: auto
# IP 库不可用或尚未生成时的兜底策略
# true - 放行(避免误锁全服)
# false - 拦截
fail-open: true
# 是否在控制台记录被拦截的登录尝试
log-blocked: true
# IP 库文件名,位于 plugins/IPBan/ 下
# 首次启动会从插件内置数据释放;也可以手动替换为更新版本后 /banip reload
data-file: china-cidr.txt
# IP 库缺失时,是否自动从 APNIC 官方分配数据生成
# 生成在后台线程进行,不会卡住开服;完成前按 fail-open 处理
auto-download: true
download-url: "http://ftp.apnic.net/apnic/stats/apnic/delegated-apnic-latest"
# 下载的连接 / 读取超时(秒)
download-timeout-seconds: 15
# 拦截时显示的踢出消息
# 占位符:{ip} 玩家 IP,{player} 玩家名
kick-message: |
&c本服务器仅允许中国大陆 IP 进入
&7你的 IP: &f{ip}
&7如有疑问请联系管理员。
# 白名单:这些 IP 或 CIDR 段不受限制(同样适用于境外地址)
whitelist-ip:
- "127.0.0.1"
# 白名单玩家名(不区分大小写),例如服主或海外友人
whitelist-players: []
常用命令
| 命令 | 说明 | 权限 |
|---|---|---|
/banip <IP/CIDR> [时长] [原因] | 封禁一个 IP 或网段,时长支持 1d 12h 30m 60s,省略为永久 | ipban.ban |
/banip list [页码] | 查看封禁列表,游戏内可点击翻页 | ipban.ban |
/banip reload | 重载配置并踢出仍被匹配的在线玩家 | ipban.reload |
/unbanip <IP/CIDR> | 解封 | ipban.unban |
/ipgeo | 查看境外 IP 拦截状态与 IP 库信息 | ipban.geo |
/ipgeo on / /ipgeo off | 在线开启 / 关闭境外 IP 拦截(写回 config.yml) | ipban.geo.toggle |
/ipgeo check <IP|玩家名> | 检查某个地址会被放行还是拦截 | ipban.geo |
/ipgeo wl list [页码] | 查看当前白名单(每页 10 条,游戏内可点击翻页) | ipban.geo.whitelist |
/ipgeo wl add <IP|CIDR|玩家名> | 加入白名单(自动区分 IP 与玩家名) | ipban.geo.whitelist |
/ipgeo wl remove <IP|CIDR|玩家名> | 移出白名单 | ipban.geo.whitelist |
1d(天)、12h(小时)、30m(分钟)、60s(秒)