Skip to content
Projects

miantiao-me/ip-api has 372 GitHub stars and 158 forks. GitHot measured +1 stars in 24 hours. Last checked 2026-11-17 02:07 UTC. Last push 2026-10-17.

How these counts are measured

Measured star growth

in 24h
+1
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

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

Developer Tools

README.md

Original

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

Docker

构建并启动服务(默认端口 3000):

docker build -t ip-api .
docker run --rm -p 3000:3000 ip-api
# 自定义容器监听端口
# docker run --rm -e PORT=8080 -p 8080:8080 ip-api

服务监听 0.0.0.0,可通过 PORT 修改端口;客户端 IP 需由可信反向代理通过请求头提供,优先级为 cf-connecting-ipv6、cf-connecting-ip、x-real-ip。

/geo 从代理请求头读取地理信息:cf-ipcountry、cf-region、cf-ipcity、cf-ray、cf-iplatitude、cf-iplongitude、x-asn。

2. 绑定域名

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

3. IPv4/IPv6 Only

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

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