使用指南
# 数据来源
本插件目前默认有六种方式获取ip归属地 如果你有你的想法或渠道也可以让我添加
- offline 本地数据源模式 (支持ipv4/ipv6 99%数据准确性)
- ipPlus360 (opens new window) 在线api模式 (支持ipv4/ipv6,付费)
- ipApi (opens new window) 在线api模式 (支持ipv4/ipv6,免费但是有分钟请求次数限制)
- whois (opens new window) 在线api模式 (支持ipv4/ipv6,免费)
- voreApi (opens new window) 在线api模式 (支持ipv4/ipv6,免费)
- tencent (opens new window) 腾讯地图在线api模式 (需要应用Key和SecretKey)
# 优缺点分析
| 类型 | 费用 | 数据准确度 | 是否需要网络 | 支持网络 | 支持级别(最高) | 官网 |
|---|---|---|---|---|---|---|
| offline | 免费 | 99% | 不需 | ipv4和ipv6 | 城市级 | 官网 (opens new window) |
| ipPlus360 | 付费 | 99.999% | 需 | ipv4和ipv6 | 区县级 | 官网 (opens new window) |
| ipApi | 免费 | 99.9% | 需 | ipv4和ipv6 | 城市级 | 官网 (opens new window) |
| whois(1.3.0+) | 免费 | 99.9% | 需 | ipv4和ipv6 | 区县级 | 官网 (opens new window) |
| voreApi(1.3.0+) | 免费 | 99.9% | 需 | ipv4和ipv6 | 区县级 | 官网 (opens new window) |
| tencent(2.3.0+) | 按官方规则 | 以官方为准 | 需 | 以官方为准 | 城市级 | 官网 (opens new window) |
# 特别说明
offline 类型从插件 2.0.0+开始不在内置数据需要自己下载后放到plugins/ip2region目录下
123盘: 点击前往 (opens new window)
github: 点击前往 (opens new window)
ipPlus360 如需购买,推荐购买城市级
ipv4 (opens new window) ipv6 (opens new window)
如需区县级别的
请根据官网的api说明自己在config.yml添加如下配置,其他级别自己修改
ipPlus360Ipv4Url: "https://api.ipplus360.com/ip/geo/v1/district/"
ipPlus360Ipv6Url: "https://api.ipplus360.com/ip/geo/v1/ipv6/district/"
tencent 模式需要先在腾讯地图控制台创建应用，开启 WebServiceAPI 并启用签名校验，然后配置：
dataSource: tencent
tencentAppKey: "腾讯地图应用Key"
tencentAppSecret: "腾讯地图SecretKey"
# 测试说明
offline、ipApi和tencent模式 config.yml中添加 然后重载插件后测试玩家重新登录
testIp: 测试IP
ipPlus360模式 config.yml中添加 然后重载插件后测试玩家重新登录 (同时只能添加一个,俩个都添加默认执行ipv4)
testIp4: 测试IP
testIp6: 测试IP