Skip to content

Hapi 进阶:优选 IP 配置

本文介绍如何为 Hapi 配置优选 IP,以获得更低延迟和更稳定的连接体验。

为什么需要优选 IP?

PeterPark API 在全球部署了多个节点,不同地区的用户连接到不同节点的速度差异较大。通过优选 IP 功能,Hapi 可以自动测速并选择延迟最低的节点,显著提升响应速度。

开启优选 IP

方法一:自动优选(推荐)

在 Hapi 配置文件中开启自动优选:

json
{
  "api": {
    "baseUrl": "https://api.peterpark.cn/v1",
    "apiKey": "sk-pp-your-key-here"
  },
  "network": {
    "autoSelectIP": true,
    "testInterval": 300,
    "timeout": 3000
  }
}

配置说明:

  • autoSelectIP:开启自动优选
  • testInterval:测速间隔(秒),默认 300 秒重新测速一次
  • timeout:单次测速超时时间(毫秒)

方法二:手动指定 IP

如果你已知道延迟最低的节点,可以直接指定:

bash
# 测试各节点延迟
hapi-server ping

# 手动指定节点
hapi-server config --node cn-east-1

查看节点列表

bash
hapi-server nodes list

输出示例:

节点名称        地区        延迟
cn-east-1      华东        12ms  ✓ 当前
cn-south-1     华南        18ms
cn-north-1     华北        25ms
hk-1           香港        45ms
sg-1           新加坡      89ms

配置 DNS 优化

在某些网络环境下,DNS 解析可能影响连接速度。可以在配置中指定 DNS 服务器:

json
{
  "network": {
    "dns": ["223.5.5.5", "119.29.29.29"],
    "autoSelectIP": true
  }
}

推荐使用阿里 DNS(223.5.5.5)或腾讯 DNS(119.29.29.29)。

监控连接质量

Hapi 提供实时连接质量监控:

bash
# 查看实时连接状态
hapi-server monitor

# 查看历史延迟统计
hapi-server stats --days 7

常见问题

问:优选 IP 后延迟仍然很高?

答:尝试手动运行 hapi-server ping 查看各节点延迟,选择延迟最低的节点手动指定。

问:频繁切换节点导致请求中断?

答:适当增大 testInterval 值,减少测速频率,或关闭自动优选改为手动指定稳定节点。

PeterPark API 文档