Metadata
| id | combo-mirror-setup | recorded | 2026-08-29 |
|---|---|---|---|
| members | 4 | status | partial |
Members (4)
| tool | role | version | install | guide |
|---|---|---|---|---|
pip | 清华 PyPI 镜像 | pip >= 21(旧版 pip 对 index-url 支持一致,无硬性要求) | | — |
npm | npmmirror 镜像 | npm >= 7(`npm config set` 行为一致,无硬性要求) | | — |
Go | goproxy.cn | Go >= 1.13(模块代理机制自 1.13 起为默认) | | — |
Docker | daemon.json registry-mirrors | Docker Engine >= 20.10(registry-mirrors 字段长期支持) | | — |
Install order
- pip → npm → Go:三个用户级配置互不依赖,按「使用频率」顺序配;每步配完立刻验证(
config list/config get/go env),失败只影响单步。 - Docker 放最后:系统级 + 重启 daemon 影响运行中容器,非必须(仅 Docker Hub 拉取失败时启用;对应问题条目 docker-hub-pull-fail 即此场景)。
- 与代理共存:开着代理时 mirror 依然生效(包管理器直连 mirror 更快);校园网/流量环境下 mirror 是主通道,代理作为 mirror 失效时的备选——不要同时配「代理 + 指向被墙源的 mirror」。
Dependency warnings
- 冲突:四成员相互无共享写面(pip.conf / .npmrc / go env / daemon.json 互不重叠)→ compatible;与「已配置代理」场景:mirror 与代理可共存,但 npm/pip 若设了全局 proxy 会优先走代理,验证命令以实际下载测速为准(possible-compatible,构造性判定)。
- 版本:pip/npm/go/docker 均无硬性版本下限之外的要求;docker 步骤需要 Docker Engine 已安装。
- 环境:pip/npm/go 三项纯用户级(无需 root、不重启任何服务);docker 项需 root + daemon 重启(影响运行中容器,务必备份 daemon.json)。
- 国内网络:本组合包全部命令无外部下载(只写配置),配源本身零流量;验证建议用真实小下载(
pip3 download/npm view/go mod download)在 mirror 与官方源之间对比。
Linked problems
Evidence
Evidence details kept locally (2026-08-29)