3141 是什么

3141 是 Python 私有包索引工具 devpi 的默认端口：devpi-server 对外提供索引服务，内网 pip 通过它拉取依赖，同时它还能镜像上游 PyPI，在离线或受限网络中承担依赖分发。访问 http://host:3141 可以看到索引列表，其中常见的是作为公共源镜像使用的路径。

私有源的风险集中在上传通道

私有源的价值是可控与可缓存，风险同样集中在这里：如果允许匿名上传，供应链投毒只需要一个脚本，就能把与知名库同名的伪造包推到内网索引上，其他主机安装时静默中招。因此上传通道必须有账号与索引级权限隔离。

基本信息

典型使用场景

• 为离线或受限网络提供依赖源，缓存上游包以减少外网依赖
• 托管企业内部的私有 Python 包，供构建与部署环境安装
• 排查依赖安装失败时确认索引地址与镜像同步状态
• 统一依赖来源，避免不同机器装到不一致的版本
• 资产核查时确认私有源是否对非研发网段开放

服务与索引检查

ss -lntp | grep 3141                          # 确认监听地址
curl -s http://127.0.0.1:3141/ | head -c 200   # 查看索引首页
pip config list                                # 确认客户端实际使用的索引地址

客户端与权限配置

# ~/.pip/pip.conf 或 /etc/pip.conf
# [global]
# index-url = http://devpi.internal:3141/root/pypi/+simple/
# trusted-host = devpi.internal
# devpi 侧：创建独立上传账号与私有索引
# devpi user -c ci password=<口令>
# devpi index -c private bases=root/pypi

常见路径含义

与构建缓存的关系

私有索引常与构建机或持续集成环境的本地缓存配合：命中缓存直接复用已下载的包，未命中才回源拉取并写入索引。缓存目录被清理或索引不可达时，构建会集体变慢甚至失败，排查时要先区分是哪一侧出了问题。