GeoLite2 自动搬运仓库使用手册

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

GeoLite2 自动搬运仓库使用手册

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

前置条件

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

一键 Fork 仓库

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

配置密钥（Secrets）

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

NameValue 获取方式
LICENSE_KEYMaxMind 免费账号注册
GITHUB_TOKEN无需手动创建，Actions 自动注入，留空即可

触发运行

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

## 下载最新 .mmdb

单文件直链（推荐） 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 城市库
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） 

1
2
3
4
5
6
7
8
9

#!/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

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