JavaScript

ip-api

利用 Cloudflare Workers / Vercel Edge / Netlify Edge 快速搭一个获取 IP 地址和地理位置信息的接口。

M

miantiao-me

Dernière activité 7 déc. 2025
miantiao-me/ip-api

372

étoiles

161

forks

0

issues ouvertes

cloudflareipipgeoipgeolocationmyipvercel

Ce README est souvent en anglais.

IP-API

利用 Cloudflare Workers / Vercel Edge / Netlify Edge 快速搭一个获取 IP 地址和地理位置信息的接口。

使用方式

自动化调用

如果你有程序自动化调用需求,请使用下面的 API , 不限制请求和流量。

IP

IP GEO


以下接口不支持程序自动化调用,有限流。

IP

  1. 通过访问 Cloudflare 获取本机 IP:https://cloudflare-ip.html.zone
  2. 通过访问 Vercel 获取本机 IP:https://vercel-ip.html.zone
  3. 通过访问 Netlify 获取本机 IP:https://netlify-ip.html.zone

IP GEO

  1. 通过访问 Cloudflare 获取本机 IP 地理位置信息, https://cloudflare-ip.html.zone/geo
  2. 通过访问 Vercel 获取本机 IP 地理位置信息, https://vercel-ip.html.zone/geo
  3. 通过访问 Netlify 获取本机 IP 地理位置信息, https://netlify-ip.html.zone/geo

HTTP 响应头 x-client-ip 也是用户 IP 地址。

GEO 信息格式:

{
    "ip": "142.171.116.110",
    "city": "Los Angeles",
    "country": "US",
    "flag": "🇺🇸",
    "countryRegion": "California",
    "region": "LAX",
    "latitude": "34.05440",
    "longitude": "-118.24410",
    "asOrganization": "Multacom Corporation"
}

部署方式

1. 部署代码

# clone 此项目
git clone https://github.com/miantiao-me/ip-api.git

# 进入项目目录
cd ip-api
# 安装依赖
npm i

## 部署到 Cloudflare Workers
npm run deploy:cloudflare

## 部署到 Vercel Edge
npm run deploy:vercel

## 部署到 Netlify Edge
npm run deploy:netlify

2. 绑定域名

按照 Cloudflare/Vercel/Netlify 文档绑定域名即可。

3. IPv4/IPv6 Only

Cloudflare 支持 IPv4 和 IPv6 访问,如果想只支持单栈,可以只解析 A/AAAA 记录到 Cloudflare 的泛拨 IP。

比如: https://ipv4.agi.li 和 https://ipv6.agi.li

Projets similaires

查找适合自己当前网络环境的优选cloudflare anycast IP

Go
Bbadafans
3,5 k étoiles902

Google 全球 IP 地址库,按国家/地区整理并提供 npm 查询 API Google IP address list grouped by country with JSON data and query helpers.

TypeScriptgfwgoogleip
Jjustjavac
3,5 k étoiles1,1 k

Free & Open IP Information API | 免费 IP 信息查询 API 集合,支持 GET 请求,无需鉴权,开箱即用

ipip-geolocationipaddress-tracker
Iihmily
1,5 k étoiles147