ghcr.io/maxmind/geoipupdate:v5.1

GeoIP Update

GeoIP Update程序可自动更新GeoIP和GeoLite二进制数据库。不支持CSV数据库。

安装

我们提供适用于Linux、macOS（darwin）和Windows的版本。最新版本请参见Releases标签页。

安装GeoIP Update后，请参考我们的文档了解配置信息。

如果从GeoIP Update 3.x升级，请参见我们的升级指南。

通过压缩包在Linux上安装

下载并解压适用于您系统的压缩包。最终会得到一个目录，名称类似geoipupdate_5.0.0_linux_amd64，具体取决于版本和架构。

将geoipupdate复制到您希望的位置。要将其安装到/usr/local/bin/geoipupdate，请运行类似sudo cp geoipupdate_5.0.0_linux_amd64/geoipupdate /usr/local/bin的命令。

geoipupdate默认会查找配置文件/usr/local/etc/GeoIP.conf。

通过PPA在Ubuntu上安装

MaxMind为最新版本的Ubuntu提供了PPA。要将PPA添加到源中，请运行：

$ sudo add-apt-repository ppa:maxmind/ppa

然后通过运行以下命令安装geoipupdate：

$ sudo apt update
$ sudo apt install geoipupdate

通过deb包在Ubuntu或Debian上安装

您也可以使用压缩包。

下载适用于您系统的.deb包。

运行dpkg -i path/to/geoipupdate_5.0.0_linux_amd64.deb（根据需要替换版本号和架构）。您需要具有root权限。对于Ubuntu，可在命令前添加sudo。这会将geoipupdate安装到/usr/bin/geoipupdate。

geoipupdate默认会查找配置文件/etc/GeoIP.conf。

通过rpm包在RedHat或CentOS上安装

您也可以使用压缩包。

下载适用于您系统的.rpm包。

运行rpm -Uvhi path/to/geoipupdate_5.0.0_linux_amd64.rpm（根据需要替换版本号和架构）。您需要具有root权限。这会将geoipupdate安装到/usr/bin/geoipupdate。

geoipupdate默认会查找配置文件/etc/GeoIP.conf。

通过压缩包在macOS（darwin）上安装

与通过压缩包在Linux上安装的步骤相同，只是选择名称中包含“darwin”的压缩包。

通过Homebrew在macOS上安装

如果您使用macOS且已安装Homebrew，可以通过brew安装geoipupdate：

$ brew install geoipupdate

在Windows上安装

下载并解压适用于您系统的zip包。最终会得到一个目录，名称类似geoipupdate_5.0.0_windows_amd64，具体取决于版本和架构。

将geoipupdate.exe复制到您希望的位置。

geoipupdate默认会在系统驱动器上查找配置文件\ProgramData\MaxMind\GeoIPUpdate\GeoIP.conf。

通过Docker安装

请参见我们的Docker文档。

通过Proto安装

要使用Proto工具链管理器安装，请运行：

$ proto plugin add geoipupdate "https://raw.githubusercontent.com/maxmind/geoipupdate/refs/heads/main/proto.yaml"
proto install geoipupdate

从源码或Git安装

您需要Go编译器（1.25+）。可在Go官网获取。

最简单的方法是通过go install：

$ go install github.com/maxmind/geoipupdate/v7/cmd/geoipupdate@latest

这会将geoipupdate安装到$GOPATH/bin/geoipupdate。

配置

有关如何配置GeoIP Update的说明，请参见我们的在线指南。

文档

有关geoipupdate程序和GeoIP.conf配置文件的文档，请参见我们的文档。

默认配置文件和数据库目录路径

我们为配置文件和数据库目录定义了默认路径。如果这些默认值不适合您，可以在构建时使用标志修改：

go build -ldflags "-X main.defaultConfigFile=/etc/GeoIP.conf \
-X main.defaultDatabaseDirectory=/usr/share/GeoIP"

错误报告

请通过我们的GitHub issue跟踪器提交issue来报告错误。

版权和许可

本软件版权所有 (c) 2018 - 2026 MaxMind, Inc.。

本软件为自由软件，根据您的选择，可遵循Apache License, Version 2.0或MIT License许可。