ip2location/mysql

docker-ip2location-mysql

镜像概述和主要用途

预配置的即用型MySQL服务器，集成IP2Location地理定位数据库设置脚本，旨在简化开发团队在MySQL服务器中安装和设置IP2Location地理定位数据库的流程。该设置脚本支持商业数据库包和免费LITE包。运行此镜像前需注册免费或商业账号，因设置过程需要下载令牌。

核心功能和特性

• 预配置即运行：无需手动配置，直接运行即可完成IP2Location数据库在MySQL中的安装
• 多数据库支持：兼容IP2Location的免费LITE数据库和商业数据库
• IP类型选择：可指定下载IPv4、IPv6或同时下载两者（默认同时下载）
• MySQL密码管理：支持自定义MySQL管理员密码，未指定时自动生成随机密码
• 安装状态可查：通过容器日志实时查看安装进度和结果
• 数据库更新：支持通过脚本一键更新至最新IP2Location数据库版本

使用场景和适用范围

适用于需要快速集成IP地址地理定位功能的开发团队，可用于开发需要查询IP地址所属国家、地区、城市等信息的应用，如网络安全分析、广告定向、内容分发优化等场景。

使用方法和配置说明

运行镜像

1. 使用从IP2Location LITE或IP2Location获取的下载令牌和产品代码，以守护进程方式运行此镜像：

   bash
   docker run --name ip2location -d -e TOKEN={下载令牌} -e CODE={下载代码} -e MYSQL_PASSWORD={MySQL密码} ip2location/mysql
   

   环境变量（ENV VARIABLE）

   • TOKEN：从IP2Location获取的下载令牌（必需）
   • CODE：数据库代码，可用代码如下：
     • 免费数据库：DB1-LITE、DB3-LITE、DB5-LITE、DB9-LITE、DB11-LITE
     • 商业数据库：DB1、DB2、DB3、DB4、DB5、DB6、DB7、DB8、DB9、DB10、DB11、DB12、DB13、DB14、DB15、DB16、DB17、DB18、DB19、DB20、DB21、DB22、DB23、DB24、DB25、DB26
   • IP_TYPE（可选）：指定下载IPv4、IPv6或两者数据库，默认下载两者：
     • IPV4：仅下载IPv4数据库
     • IPV6：仅下载IPv6数据库
     • BOTH：同时下载IPv4和IPv6数据库
   • MYSQL_PASSWORD（可选）：MySQL管理员密码，未指定时自动生成随机密码

2. 安装时间取决于数据库大小、下载速度和硬件规格，可通过查看容器日志检查安装状态：

   bash
   docker logs -f ip2location
   

   若安装成功，日志中会出现 => Setup completed 字样，并显示MySQL管理员登录信息：

   mysql -u admin -p{MYSQL_PASSWORD} ip2location_database
   

   请记录此密码，后续连接MySQL时需使用。

从容器连接IP2Location数据库

bash
docker run --link ip2location:ip2location-db -t -i 使用IP2Location数据的应用容器

注意：--link 标志已成为Docker的遗留功能，可能会被移除。建议使用网络桥接连接容器。可参考文章如何在Debian容器中连接IP2Location MySQL Docker了解更多。

查询IP信息示例

以下示例查询IP地址8.8.8.8的信息：

mysql
mysql -u admin -p{MYSQL_PASSWORD} -h ip2location-db ip2location_database -e 'SELECT * FROM `ip2location_database` WHERE INET6_ATON("8.8.8.8") <= ip_to LIMIT 1'

更新IP2Location数据库

要将IP2Location数据库更新至最新版本，运行以下命令：

bash
docker exec -it ip2location ./update.sh

文章和教程

有关此Docker镜像的更多信息，可访问：IP2Location文章和教程