e7db/ifconfig

ifconfig

镜像概述和主要用途

ifconfig 是一个用于检查在线信息的工具，兼容任何HTTP客户端（包括浏览器、cURL、HTTPie、GNU Wget和FreeBSD fetch等），支持输出HTML、纯文本、JSON、XML和YAML多种格式。可用于获取公网IP、客户端信息等在线数据，并支持地理位置信息增强、速率限制等扩展功能。

Demo地址：ip.e7d.io

核心功能和特性

• 多客户端支持：兼容所有HTTP客户端，无需特定工具
• 多格式输出：提供HTML、纯文本、JSON、XML、YAML五种输出格式
• 地理位置信息：通过MaxMind GeoLite2数据库提供IP地理位置解析
• 灵活配置：支持环境变量和挂载文件自定义服务行为
• 性能优化：可选内存数据库加速数据访问，支持本地DNS缓存提升解析速度
• 安全防护：内置速率限制功能，防止服务滥用

使用场景和适用范围

• 个人用户快速查询公网IP及网络信息
• 开发调试中获取客户端IP、User-Agent等请求信息
• 自动化脚本中通过JSON/XML格式获取IP数据
• 需要展示地理位置信息的Web服务集成
• 对API访问频率有控制需求的服务部署

详细使用方法和配置说明

基本部署

通过Docker快速启动服务：

bash
docker run --name ifconfig -d -p 80:80 e7db/ifconfig

配置选项

基础设置

高级性能配置

• 内存数据库：通过内存文件系统提升数据库访问速度（需Docker 17.0.6+）

  bash
  docker run --name ifconfig -d -p 80:80 --mount type=tmpfs,destination=/tmpfs e7db/ifconfig
  

  注：会增加约100MB内存占用

• 速率限制：限制特定IP在指定时间窗口内的请求次数

  bash
  docker run --name ifconfig -d -p 80:80 -e RATE_LIMIT=500 -e RATE_LIMIT_INTERVAL=60 e7db/ifconfig
  

  • RATE_LIMIT：时间窗口内最大请求数（默认500）
  • RATE_LIMIT_INTERVAL：时间窗口时长（秒，默认1）

• 本地DNS缓存：启用本地DNS缓存加速名称解析

  bash
  docker run --name ifconfig -d -p 80:80 -e DNS_CACHE=true e7db/ifconfig
  

MaxMind GeoLite2数据库配置

地理位置功能需GeoLite2数据库支持，可通过以下两种方式配置：

通过许可证密钥自动下载

1. 注册MaxMind账户：GeoLite2注册
2. 登录账户：MaxMind登录
3. 生成许可证密钥：进入"My License Key" → "Generate new license key"
4. 启动容器时配置密钥：

   bash
   docker run --name ifconfig -d -p 80:80 -e MAXMIND_LICENSE_KEY=你的密钥 e7db/ifconfig
   

   如需自动更新数据库，添加-e DATABASE_AUTO_UPDATE=true -e MAXMIND_ACCOUNT_ID=你的账户ID

通过本地文件挂载

1. 下载数据库文件：
   • 登录MaxMind账户后进入"Download Files"
   • 下载"GeoLite2 ASN"和"GeoLite2 City"的GZIP压缩包
   • 解压得到GeoLite2-ASN.mmdb和GeoLite2-City.mmdb
2. 挂载数据库目录：

   bash
   docker run --name ifconfig -d -p 80:80 -v /本地数据库路径:/var/databases e7db/ifconfig
   

速率限制响应头说明

启用速率限制后，响应将包含以下头信息（遵循IETF草案，前缀X-）：

X-RateLimit-Limit: 500, 500;window=60  # 限制次数及时间窗口
X-RateLimit-Remaining: 483              # 剩余请求次数
X-RateLimit-Reset: 47                   # 重置剩余时间（秒）
X-RateLimit-Reset: Tue, 23 Jun 2020 13:49:57 +0000  # 重置时间（UTC）

当请求超限，服务返回429 Too Many Requests状态码，并包含：

Retry-After: 12  # 重试等待时间（秒）
Retry-After: Tue, 21 Jun 2020 17:29:27 +0000  # 重试时间（UTC）

本地DNS缓存说明

本地DNS缓存通过减少重复DNS查询提升性能，实际效果取决于当前DNS服务器性能和网络链路质量，适用于DNS解析延迟较高的环境。