利用 sighup 信号无缝更新 nginx geoip 数据库的核心做法是：在后台启动一个独立的进程（如 python 脚本）负责下载新版本的 maxmind 数据库文件，待下载完成后，通过 `os.kill` 向 nginx 主进程发送 `sighup` 信号。nginx 收到该信号后，会优雅地重新加载配置文件并打开新的 `.mmdb` 文件句柄，而正在处理的请求不会中断，从而实现零停机更新。
Nginx 如何处理 SIGHUP 信号
Nginx 的 `ngx_http_geoip_module` 模块在配置文件中指定了数据库路径。当 Nginx 主进程接收到 `SIGHUP` 信号时，它会执行配置重载流程。在这个过程中，Nginx 会关闭旧的数据库文件描述符，并打开新的文件。由于 Nginx 的工作进程（Worker Processes）是独立于主进程的，它们会在下一次处理请求或根据特定的清理机制时，切换到新的文件句柄。这种机制确保了正在进行的 HTTP 请求能够继续读取旧的数据直到结束，而新请求则使用新数据，实现了平滑过渡。
import os
import signal
import time
import requests
def update_geoip():
# 假设这是你的 Nginx 主进程 PID
nginx_pid = 12345
db_path = '/etc/nginx/GeoLite2-City.mmdb'
temp_db_path = '/tmp/GeoLite2-City-new.mmdb'
# 1. 下载新数据库
print("Downloading new GeoIP database...")
response = requests.get('https://download.maxmind.com/app/geoip_download', params={'edition_id': 'GeoLite2-City', 'license_key': 'YOUR_KEY', 'suffix': 'tar.gz'})
# 这里简化为直接下载二进制文件，实际需解压 tar.gz
with open(temp_db_path, 'wb') as f:
f.write(response.content)
# 2. 验证新文件 (可选)
if not os.path.exists(temp_db_path):
print("Download failed")
return
# 3. 原子替换文件 (确保 Nginx 看到的是完整文件)
# 注意：Nginx 通常通过文件路径访问，如果直接覆盖可能引起竞争条件
# 更安全的做法是移动到最终位置，然后发信号
os.replace(temp_db_path, db_path)
print("Database updated successfully.")
# 4. 发送 SIGHUP 给 Nginx
try:
os.kill(nginx_pid, signal.SIGHUP)
print(f"Sent SIGHUP to Nginx PID {nginx_pid}")
except ProcessLookupError:
print("Nginx process not found")
if __name__ == '__main__':
update_geoip()
上述代码演示了一个简单的更新脚本。它首先下载新的 GeoIP 数据库到临时文件，然后使用 `os.replace` 将其原子性地移动到 Nginx 配置中指定的路径。最后，它通过 `os.kill` 发送 `SIGHUP` 信号。关键在于 `os.replace` 操作在 Unix-like 系统上是原子的，这意味着 Nginx 要么看到旧文件，要么看到新文件，不会出现部分写入的情况。配合 `SIGHUP`，Nginx 会重新打开这个路径的文件，从而加载新内容。
如何自动化并监控更新过程
为了在生产环境中可靠地执行此操作，需要将上述逻辑集成到定时任务（如 Cron）或编排系统中，并加入错误处理和日志记录。自动化的核心在于确保只有当新数据库下载成功且校验通过后，才触发 Nginx 的重载。同时，需要监控 Nginx 的状态，以确认重载是否成功。可以通过检查 Nginx 的错误日志或发送 `SIGUSR1` 来滚动日志，以便追踪更新时间点后的请求情况。此外，建议保留旧数据库的备份，以便在更新失败时可以快速回滚。
#!/bin/bash
# Automated GeoIP Update Script
NGINX_PID=$(cat /var/run/nginx.pid)
DB_PATH="/usr/share/GeoIP/GeoLite2-City.mmdb"
BACKUP_PATH="/usr/share/GeoIP/GeoLite2-City.mmdb.bak"
TEMP_DB="/tmp/GeoLite2-City.mmdb"
# Download new database
curl -L -o $TEMP_DB "https://download.maxmind.com/app/geoip_download?edition_id=GeoLite2-City&license_key=YOUR_KEY&suffix=tar.gz"
if [ $? -ne 0 ]; then
echo "Download failed" >> /var/log/geoip_update.log
exit 1
fi
# Extract if necessary (assuming tar.gz for this example)
tar -xzf $TEMP_DB -C /tmp/
NEW_MMDB=$(find /tmp -name "*.mmdb" | head -n 1)
if [ ! -f "$NEW_MMDB" ]; then
echo "Extraction failed or no .mmdb found" >> /var/log/geoip_update.log
exit 1
fi
# Backup current DB
cp $DB_PATH $BACKUP_PATH
# Atomically replace
mv $NEW_MMDB $DB_PATH
# Send SIGHUP to Nginx
kill -HUP $NGINX_PID
echo "$(date): GeoIP updated and Nginx reloaded" >> /var/log/geoip_update.log
这段 Bash 脚本展示了如何在 Linux 环境下自动化更新过程。它使用 `curl` 下载数据库，解压后找到 `.mmdb` 文件，备份当前数据库，然后使用 `mv` 命令原子性地替换旧文件。最后，通过 `kill -HUP` 发送信号。这种脚本可以放入 Crontab 中定期执行，例如每周一次。务必替换 `YOUR_KEY` 为你的 MaxMind 许可证密钥，并确保脚本有执行权限和适当的文件读写权限。
SIGHUP 发送后 Nginx 的行为细节
当 Nginx 主进程收到 `SIGHUP` 后，它会 fork 出新的工作进程，这些新工作进程会使用新的配置文件和新打开的 GeoIP 数据库文件。旧的工作进程在处理完当前的所有请求后才会退出。因此，在更新后的短时间内，系统中可能同时存在新旧两个版本的工作进程。这可能导致极短的时间窗口内，不同请求可能命中不同版本的数据库，但这种情况通常发生在毫秒级，对业务影响微乎其微。如果需要严格的版本一致性，可以考虑在低峰期手动触发更新，或者使用更复杂的部署策略如蓝绿部署，但对于 GeoIP 这种只读数据的更新，`SIGHUP` 通常是足够且标准的做法。
