ibigbug/pypi-mirrors

ibigbug/pypi-mirrors镜像说明

镜像概述

ibigbug/pypi-mirrors是一个轻量级工具镜像，用于监控PyPI镜像的更新状态。它通过定期ping各PyPI镜像获取最后更新时间，结合Redis缓存提升效率，并支持地理位置查询和异常通知，帮助用户快速了解镜像同步情况。

核心功能

• PyPI镜像状态检测：定期ping镜像获取最后更新时间，直观展示同步状态；
• Redis缓存：缓存镜像数据，减少重复请求，优化查询性能；
• GeoIP地理位置查询：通过ipinfodb API获取镜像服务器的地理位置（需配置API密钥）；
• 多渠道通知：支持邮件和***通知，当镜像更新延迟时发送提醒（需配置对应环境变量）。

使用场景

• 开发者：查询PyPI镜像同步状态，选择最优镜像源加速包安装；
• 镜像维护者：监控自有PyPI镜像的同步情况，及时发现同步延迟问题；
• 团队：内部搭建PyPI镜像时，用于日常监控镜像可用性与同步效率。

配置说明

依赖服务

• Redis：用于缓存数据，默认假设本地运行（localhost:6379，db:1，无密码），可通过环境变量调整；
• GeoIP API：需从ipinfodb.com注册获取API密钥，设置IPLOC_API_KEY启用地理位置查询。

环境变量

关键环境变量如下：

• CACHE_REDIS_HOST：Redis服务器地址（默认localhost）；
• CACHE_REDIS_PORT：Redis端口（默认6379）；
• IPLOC_API_KEY：ipinfodb的GeoIP API密钥（可选）；
• 邮件通知：EMAIL_HOST/EMAIL_PORT/EMAIL_USER等（用于配置SMTP服务）；
• 通知：TWITTER_CONSUMER_KEY/TWITTER_CONSUMER_SECRET等（用于配置 API）；
• Sentry：SENTRY_DSN（可选，用于错误监控）。

Docker部署示例

bash
docker run \
    -e 'CACHE_REDIS_HOST=your-redis-host' \
    -e 'CACHE_REDIS_PORT=6379' \
    -e 'IPLOC_API_KEY=your-ipinfodb-key' \
    -e 'EMAIL_HOST=smtp.example.com' \
    -e 'EMAIL_PORT=587' \
    -e 'EMAIL_USER=***' \
    -e 'EMAIL_PASSWORD=your-email-pass' \
    -e 'EMAIL_TO=***' \
    ibigbug/pypi-mirrors \
    uwsgi -w wsgi --logto=/var/log/uwsgi/uwsgi.log --chdir=/src/ --chmod-socket=666