miantiao-me/ip-api
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.
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 ToolsREADME.md
OriginalIP-API
利用 Cloudflare Workers / Vercel Edge / Netlify Edge 快速搭一个获取 IP 地址和地理位置信息的接口。
使用方式
自动化调用
如果你有程序自动化调用需求,请使用下面的 API , 不限制请求和流量。
IP
curl https://ip.agi.li或者直接访问 https://ip.agi.licurl -4 https://ipv4.agi.li或者直接访问 https://ipv4.agi.licurl -6 https://ipv6.agi.li或者直接访问 https://ipv6.agi.li
IP GEO
curl https://ip.agi.li/geo或者直接访问 https://ip.agi.li/geocurl -4 https://ipv4.agi.li/geo或者直接访问 https://ipv4.agi.li/geocurl -6 https://ipv6.agi.li/geo或者直接访问 https://ipv6.agi.li/geo
以下接口不支持程序自动化调用,有限流。
IP
- 通过访问 Cloudflare 获取本机 IP:https://cloudflare-ip.html.zone
- 通过访问 Vercel 获取本机 IP:https://vercel-ip.html.zone
- 通过访问 Netlify 获取本机 IP:https://netlify-ip.html.zone
IP GEO
- 通过访问 Cloudflare 获取本机 IP 地理位置信息, https://cloudflare-ip.html.zone/geo
- 通过访问 Vercel 获取本机 IP 地理位置信息, https://vercel-ip.html.zone/geo
- 通过访问 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。