GeoLite2 自动搬运仓库使用手册

总结摘要

本文详细介绍了如何通过 Fork 开源项目并配置 GitHub Actions，实现 MaxMind GeoLite2 数据库（City/Country/ASN）的自动下载与 Release 发布。用户只需提供 MaxMind 免费 License Key，即可每 3 天自动同步最新 IP 地理数据库，并通过直链或 Git 克隆方式在内网或生产环境中稳定获取 .mmdb 文件，适用于 Nginx、OpenResty 等服务的 geoip2 模块集成。

利用 GitHub Actions 每 3 天自动拉取 MaxMind 官方 GeoLite2-City/Country/ASN 数据库并发布 Release，供内网或生产环境 wget 使用。

前置条件

项目	说明
GitHub 账号	需能创建公开仓库
MaxMind 账号	免费申请，用于获取 `license_key`（白名单地区建议选 US/JP）注册步骤： MaxMind 免费账号注册
浏览器	用于配置仓库密钥

一键 Fork 仓库

打开 https://github.com/P3TERX/GeoLite.mmdb
点击右上角 Fork → 选择你的账号 → 完成
得到自己的仓库地址：
https://github.com/<你的用户名>/GeoLite.mmdb

配置密钥（Secrets）

路径：Settings → Secrets and variables → Actions → New repository secret

Name	Value 获取方式
`LICENSE_KEY`	MaxMind 免费账号注册
`GITHUB_TOKEN`	无需手动创建，Actions 自动注入，留空即可

触发运行

方式	操作
手动	进入仓库 → Actions → Publish GeoLite.mmdb → Run workflow → Run
自动	默认每 3 天 01:00 UTC 自动执行（`.yml` 内 `cron: 0 1 /3 *`）

## 下载最新 `.mmdb`

单文件直链（推荐）

# 城市库
wget -O GeoLite2-City.mmdb \
  https://github.com/<你的用户名>/GeoLite.mmdb/releases/latest/download/GeoLite2-City.mmdb

# 国家库
wget -O GeoLite2-Country.mmdb \
  https://github.com/<你的用户名>/GeoLite.mmdb/releases/latest/download/GeoLite2-Country.mmdb

# ASN 库
wget -O GeoLite2-ASN.mmdb \
  https://github.com/<你的用户名>/GeoLite.mmdb/releases/latest/download/GeoLite2-ASN.mmdb

整库克隆（含全部 `.mmdb`）

1
2
3

git clone -b download --depth 1 https://github.com/<你的用户名>/GeoLite.mmdb.git
cd GeoLite.mmdb
ls *.mmdb

目录结构（download 分支）

1
2
3

GeoLite2-City.mmdb
GeoLite2-Country.mmdb
GeoLite2-ASN.mmdb

常见问题

现象	原因	解决
Actions 日志 `ERROR 451`	账号地区被限制	换新账号（地区选 US/JP）或改用镜像
Release 页面无文件	密钥未填或填错	检查 `LICENSE_KEY` 是否正确
旧 Release 堆积	正常	脚本自动保留最近 2 个，其余会删除

更新历史查看

进入仓库 → Releases → 标签即为打包日期（例 2025.10.10）

一键更新脚本（可放服务器 crontab）

#!/bin/bash
DIR=/opt/geoip2
mkdir -p $DIR
for DB in City Country ASN; do
  wget -q -O $DIR/GeoLite2-${DB}.mmdb \
    https://github.com/<你的用户名>/GeoLite.mmdb/releases/latest/download/GeoLite2-${DB}.mmdb
done
# 重载你的服务
systemctl reload nginx

给执行权限并加入定时任务即可实现自动更新。

推荐订阅源

云野开源志

前置条件

一键 Fork 仓库

配置密钥（Secrets）

触发运行

## 下载最新 `.mmdb`

单文件直链（推荐）

整库克隆（含全部 `.mmdb`）

目录结构（download 分支）

常见问题

更新历史查看

一键更新脚本（可放服务器 crontab）

推荐订阅源

云野开源志

前置条件

一键 Fork 仓库

配置密钥（Secrets）

触发运行

## 下载最新 .mmdb

单文件直链（推荐）

整库克隆（含全部 .mmdb）

目录结构（download 分支）

常见问题

更新历史查看

一键更新脚本（可放服务器 crontab）

## 下载最新 `.mmdb`

整库克隆（含全部 `.mmdb`）