GeoLite2 自动搬运仓库使用手册
云野开源志
·
2025-10-10
·
via 云野开源志
总结摘要
本文详细介绍了如何通过 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
单文件直链（推荐）
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
|
给执行权限并加入定时任务即可实现自动更新。
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。
