ip2location/postgresql

docker-ip2location-postgresql

镜像概述

该镜像为预配置的即开即用PostgreSQL，内置IP2Location地理定位数据库设置脚本。旨在简化开发团队在PostgreSQL中安装和配置地理定位数据库的流程。支持商业数据库包和免费LITE包，使用前需注册IP2Location下载账户。

核心功能和特性

• 即开即用：预配置PostgreSQL环境，无需手动配置地理定位数据库
• 多版本支持：兼容IP2Location商业数据库和免费LITE数据库
• 灵活配置：支持IPv4/IPv6数据库选择，可自定义PostgreSQL密码
• 简化部署：通过环境变量快速配置，自动完成数据库下载与安装

使用场景

适用于需要在PostgreSQL中集成IP地址地理定位功能的开发场景，如：

• 网站访问者地理位置分析
• IP地址归属地查询服务
• 基于地理位置的内容优化
• 网络安全日志分析

使用方法

运行镜像

使用以下命令以守护进程模式运行镜像，需提供从IP2Location注册的下载令牌和代码：

bash
docker run --name ip2location -d \
  -e POSTGRESQL_PASSWORD=YOUR_POSTGRESQL_PASSWORD \
  -e TOKEN=YOUR_TOKEN \
  -e CODE=DOWNLOAD_CODE \
  ip2location/postgresql

环境变量说明

检查安装状态

安装时间取决于网络速度和硬件性能，可通过容器日志查看安装进度：

bash
docker logs YOUR_CONTAINER_ID

当日志中出现 => Setup completed 时，表示安装成功。

从应用连接

通过链接容器方式从应用连接数据库：

bash
docker run --link ip2location:ip2location-db -t -i application_using_the_ip2location_data

查询示例

使用psql连接数据库：

bash
psql -h ip2location-db --username=postgres -d ip2location_database

输入POSTGRESQL_PASSWORD密码后，可执行以下查询获取IP地址地理信息：

sql
SELECT * FROM ip2location_database WHERE ip2int('8.8.8.8') BETWEEN ip_from AND ip_to LIMIT 1;

注意事项

• IPv6查询需通过程序将IPv6地址转换为BigInt，PostgreSQL无内置转换函数
• 确保网络通畅，数据库下载可能需要较长时间
• 商业数据库需拥有有效授权许可

示例代码参考

更多使用示例请参考：[***]