NetwatchZ

插件

· 作者 KartoffelChipss

一个高度可配置的 IP、VPN 和地理封锁插件

0 本站下载 0 关注 更新于 1 年前

最新 1.1.1 · 1.21.10 · Velocity

一键开服(送7天)

NetwatchZ Banner


NetwatchZ 是一款适用于 Spigot、Paper 和 Velocity 的 Minecraft 插件,它通过 IP 屏蔽、地理屏蔽和 VPN 检测等功能,帮助保护你的服务器免受机器人和其他恶意活动的侵害。

功能特性

  • ✅ IP 查询(例如 Geolite2、ip-api.com)
  • ✅ IP 黑名单
  • ✅ 动态获取 IP 列表
  • ✅ 地理屏蔽
  • ✅ 配置任意 IP 信息服务
  • ✅ 自动下载并刷新 Geolite2 数据库
  • ✅ VPN 屏蔽(例如 vpnapi.io、proxycheck.io)

权限

  • netwatchz.ipinfo - 获取玩家的 IP 及 IP 信息
  • netwatchz.admin.debug - 生成调试报告

配置

你可以在 plugins/NetwatchZ 文件夹中找到配置文件。主配置文件是 config.yml。

config.yml
#
#    _   _      _                 _       _       ______
#   | \ | |    | |               | |     | |     |___  /
#   |  \| | ___| |___      ____ _| |_ ___| |__      / /
#   | . ` |/ _ \ __\ \ /\ / / _` | __/ __| '_ \    / /
#   | |\  |  __/ |_ \ V  V / (_| | || (__| | | |  / /__
#   |_| \_|\___|\__| \_/\_/ \__,_|\__\___|_| |_| /_____|
#

# 将语言设置为 "lang" 文件夹中找到的任何代码(不要添加 .yml 扩展名)
# 你可以添加自己的语言文件。使用 https://github.com/ZetaPlugins/NetwatchZ/tree/main/src/main/resources/lang/en-US.yml 作为模板
# 如果你想帮助翻译此插件,请参阅本文:https://docs.zetaplugins.com/localization
#  | en-US | de-DE |
lang: "en-US"

# 如果设置为 true,OP 玩家将始终被允许加入
always_allow_ops: true

ip_list:
  # 启用或禁用 IP 列表功能。
  enabled: true

  # 如果模式为 "blacklist"(黑名单),则列表中的 IP 将被屏蔽。
  # 如果模式为 "whitelist"(白名单),则只允许列表中的 IP 接入。
  mode: "blacklist"

  # 设置要屏蔽或允许的 IP 或 CIDR 范围列表。
  # 这些是位于 "plugins/NetwatchZ/ipLists" 文件夹内的文件。
  lists:
    - "vpn_list.txt"
    # - "another_list.txt"

  fetch_jobs:
    vpn_list:
      # 设置用于获取 IP 列表的 URL。
      url: "https://raw.githubusercontent.com/X4BNet/lists_vpn/refs/heads/main/output/vpn/ipv4.txt"

      # 设置保存获取到的列表的文件名。该文件将保存在 "plugins/NetwatchZ/ipLists" 文件夹中。
      filename: "vpn_list.txt"

      # 设置获取列表的频率(以小时为单位)。
      # 最小值为 1 小时。
      update_interval_hours: 24

    # 你可以在这里添加更多获取任务。例如:
    # another_list:
    #   url: "https://example.com/another_list.txt"
    #   filename: "another_list.txt"
    #   update_interval_hours: 12

geo_blocking:
  # 启用或禁用地理屏蔽。
  enabled: false

  # 以下列表是黑名单还是白名单。
  # 如果设置为 true,则列表中的国家将被屏蔽。
  # 如果设置为 false,则列表中未包含的国家将被屏蔽。
  blacklist: true

  # 设置要屏蔽或允许的国家列表。
  # 国家代码的格式取决于 IP 信息提供商,但通常是两位字母的国家代码(ISO 3166-1 alpha-2)。
  # 示例:["US", "CA", "GB"]
  countries: []

ip_info_provider:
  # 设置要使用的 IP 信息提供商。
  # 可能的值包括:
  # - "ip-api" (https://ip-api.com)
  # - "ipwhois" (https://ipwhois.app)
  # - "geolite2" (MaxMind GeoLite2 数据库 - 推荐)
  # - "custom" (使用下面定义的自定义 IP 信息提供商)
  provider: "ip-api"

  geolite2:
    # 设置 GeoLite2 数据库的 URL。这些数据库每 7 天自动刷新一次。
    # 这些可以是包含你许可证密钥的官方 MaxMind GeoLite2 数据库的 tar.gz 文件链接,也可以是你自己托管的数据库链接(也支持直接下载 .mmdb 文件)。
    # 你可以通过在 https://www.maxmind.com/en/geolite2/signup 创建账户来获取免费许可证密钥。
    asn_url: "https://download.maxmind.com/app/geoip_download?edition_id=GeoLite2-ASN&license_key=YOUR_KEY&suffix=tar.gz"
    city_url: "https://download.maxmind.com/app/geoip_download?edition_id=GeoLite2-City&license_key=YOUR_KEY&suffix=tar.gz"
    country_url: "https://download.maxmind.com/app/geoip_download?edition_id=GeoLite2-Country&license_key=YOUR_KEY&suffix=tar.gz"

    # 归属声明:本产品包含由 MaxMind 创建的 GeoLite2 数据,可从 https://www.maxmind.com 获取

  custom:
    # 设置自定义 IP 信息提供商的 URL。它应返回 JSON 响应。
    # 使用 %ip% 作为 IP 地址的占位符。
    url: "https://api.example.com/json/%ip%"

    # 设置自定义 IP 信息提供商的请求头。
    headers:
      Authorization: "Bearer YOUR_API_KEY"

设置自定义 IP 信息提供程序的查询参数。

parse_fields:
  # 键为所需的数据,值为响应中的 JSON 键。
  # 如果 API 未提供某些数据,可以将其省略。
  country: "country"
  countryCode: "countryCode"
  regionName: "regionName"
  region: "region"
  city: "city"
  lat: "latitude"
  lon: "longitude"
  timezone: "timezone"
  isp: "isp"
  org: "organization"
  asn: "asn"
  ip: "ip"

vpn_block 设置用于在线服务,以提供有关 IP 是否为 VPN 或代理的信息。

这与 ip_list 功能独立,后者也可用于阻止 VPN。

vpn_block:

启用或禁用 VPN 阻止功能。

enabled: false

设置要使用的 VPN 信息提供程序。

可能的值为:

- "vpnapi" ()

- "proxycheck" ()

- "custom"(使用下面定义的自定义 VPN 信息提供程序)

provider: "vpnapi"

如果使用 vpnapi 或 proxycheck,请在此处设置你的 API 密钥

api_key: ""

custom: # 设置自定义 VPN 信息提供程序的 URL。它应返回 JSON 响应。 # 使用 %ip% 作为 IP 地址的占位符。 url: "

# 设置自定义 VPN 信息提供程序的标头。
headers:
  Authorization: "Bearer YOUR_API_KEY"

# 设置自定义 VPN 信息提供程序的查询参数。
parse_fields:
  # 键为所需的数据,值为响应中的 JSON 键。
  # 如果 API 未提供某些数据,可以将其省略。
  vpn: "security.vpn"
  proxy: "security.proxy"
  tor: "security.tor"
  relay: "security.relay"
  hosting: "security.hosting"

设置当检测到特定类型的 VPN/代理时该做什么。

is_vpn: # 如果检测到 IP 为 VPN,是否阻止连接。 block: true

is_proxy: block: false

is_tor: block: true

is_relay: block: false

is_hosting: block: false

</details>

## 免责声明

本插件支持 GeoLite2 用于 IP 地理定位。本产品包含由 MaxMind 创建的 GeoLite2 数据,可从 https://www.maxmind.com 获取。服务器所有者必须使用自己的 MaxMind 账户和许可证密钥下载 GeoLite2,并在插件设置中配置下载 URL。该数据不用于识别特定的家庭或个人。


## 支持

如果你需要帮助设置插件,或者发现了错误,你可以加入我们的 Discord [这里](https://strassburger.org/discord)。

[![discord-plural](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/social/discord-plural_vector.svg)](https://strassburger.org/discord)
[![gitbook](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/documentation/gitbook_vector.svg)](https://docs.zetaplugins.com/netwatchz)

---

[![Usage](https://bstats.org/signatures/bukkit/NetwatchZ.svg)](https://bstats.org/plugin/bukkit/NetwatchZ/27376)


[![Usage](https://bstats.org/signatures/velocity/NetwatchZ.svg)](https://bstats.org/plugin/velocity/NetwatchZ/27407)

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源