softnetix/postgres-geoip

镜像概述

本镜像基于官方PostgreSQL镜像构建，额外集成了地理位置IP表（Geo IP Tables），旨在提供IP地址与地理位置信息（如国家、地区、城市等）的关联查询能力。适用于需要将IP数据与地理信息结合分析的场景，同时保留官方PostgreSQL的全部功能特性。

核心功能与特性

功能特性

• 完整继承官方PostgreSQL功能：支持PostgreSQL的全部数据类型、查询语法、事务管理及扩展能力
• 预集成地理位置IP表：包含IP段与地理位置属性（国家代码、地区名称、城市、经纬度等）的映射关系表
• 高效查询支持：针对IP地址查询优化表结构，支持快速IP定位（IPv4/IPv6）
• 数据可更新：提供地理位置数据定期更新机制，确保信息时效性

数据特性

• 包含基础地理维度：国家、地区、城市、邮政编码、经纬度
• IP段与地理信息一对一映射，支持CIDR格式IP范围查询
• 数据兼容主流地理位置数据库标准（如MaxMind GeoIP格式）

使用场景与适用范围

典型应用场景

• 日志分析：关联服务器访问日志中的IP地址与地理位置，分析访问来源分布
• 用户画像：统计应用用户的地理位置分布，优化产品区域策略
• 安全审计：追踪异常登录、***行为的IP地理来源，辅助安全分析
• 业务决策：基于用户地理位置数据优化服务部署、内容推送或广告投放

适用领域

• 互联网服务（用户行为分析）
• 网络安全（威胁情报分析）
• 电商平台（区域销售分析）
• 运维监控（服务器访问来源追踪）

使用方法与配置说明

快速启动

基础启动命令

bash
docker run -d \
  --name postgres-geoip \
  -e POSTGRES_PASSWORD=your_secure_password \
  -p 5432:5432 \
  [镜像名称]

自定义配置启动

bash
docker run -d \
  --name postgres-geoip \
  -e POSTGRES_PASSWORD=your_secure_password \
  -e POSTGRES_USER=geoip_user \
  -e POSTGRES_DB=geoip_db \
  -e GEOIP_TABLES=city,country \  # 指定加载的地理表类型（city/country/isp）
  -e GEOIP_UPDATE_SCHEDULE=weekly \  # 数据更新周期（daily/weekly/monthly）
  -v ./pgdata:/var/lib/postgresql/data \  # 持久化数据
  -p 5432:5432 \
  [镜像名称]

环境变量配置

数据查询示例

基础查询（IP转城市）

sql
-- 查询IP对应的城市信息
SELECT city_name, country_iso_code, latitude, longitude 
FROM geoip_city 
WHERE ip = '8.8.8.8';

批量IP分析

sql
-- 统计访问日志中各国家的访问次数
SELECT 
  g.country_iso_code, 
  g.country_name, 
  COUNT(l.id) AS visit_count 
FROM access_log l
LEFT JOIN geoip_country g ON l.client_ip = g.ip
GROUP BY g.country_iso_code, g.country_name
ORDER BY visit_count DESC;

IP段范围查询

sql
-- 查询特定IP段内的地理分布
SELECT country_name, COUNT(*) AS ip_count
FROM geoip_country
WHERE ip >= '192.168.0.0' AND ip <= '192.168.255.255'
GROUP BY country_name;

数据更新管理

手动触发更新

bash
# 进入容器执行更新脚本
docker exec -it postgres-geoip /usr/local/bin/update-geoip-data.sh

查看更新日志

bash
docker logs postgres-geoip | grep "GeoIP data update"

持久化与数据备份

数据持久化配置

通过挂载卷保存数据库数据（含地理表数据）：

bash
-v /host/path/to/postgres/data:/var/lib/postgresql/data

备份命令示例

bash
# 备份整个数据库（含地理表）
docker exec postgres-geoip pg_dump -U postgres geoip_db > geoip_backup.sql

# 仅备份地理表数据
docker exec postgres-geoip pg_dump -U postgres -t 'geoip_*' geoip_db > geoip_tables_backup.sql

Docker Compose 部署示例

yaml
version: '3.8'
services:
  postgres-geoip:
    image: [镜像名称]
    container_name: postgres-geoip
    environment:
      POSTGRES_PASSWORD: "secure_password_here"
      POSTGRES_USER: "geoip_admin"
      POSTGRES_DB: "geoip_analytics"
      GEOIP_TABLES: "city,country,isp"
      GEOIP_UPDATE_SCHEDULE: "daily"
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres_data:
    driver: local

注意：请将上述配置中的[镜像名称]替换为实际镜像标签。生产环境中建议通过环境变量文件（.env）管理敏感配置（如POSTGRES_PASSWORD）。