你是不是也遇到过这种情况：npm install 的时候，进度条卡在某个包上一动不动，等半天最后报错超时？或者 maven 下载依赖，眼看着 jar 包从国外服务器慢慢爬，真想自己搞个加速通道。这时候淘宝镜像站就香了，但很多人以为只能直接用别人的，其实你自己也能搭一个。今天就把我这几年踩过的坑和实操经验摊开来聊聊。

先别急着动手，咱们得把“搭建”这两个字掰扯清楚。大部分人说的“搭建淘宝镜像站”，其实有两层意思：一是配置本地环境直接使用淘宝的 npm 或 maven 镜像（这个最简单，一行命令搞定），二是真的在自己服务器上搭一个同步淘宝源的镜像站（给团队或公司用）。你问的是哪种？我看很多新手一说“搭建”就蒙了，其实就是没分清楚这两步。

先说最实际的场景：你只是想让自己电脑上的 npm 或 maven 下载快一点。那根本不是搭建，而是“配置”。你只需要在终端里跑一行：  
`npm config set registry https://registry.npmmirror.com`  
然后把 node_modules 删了重新 install，速度直接起飞。maven 也一样，在 settings.xml 里加一段 mirror 配置指向 `https://maven.aliyun.com/repository/public`。这件事三分钟搞定，网上教程多得是，我就不赘述了。但如果你看到这还觉得自己“搭建”完成了，那可能误会了标题的意思。

真正要自己搭一个镜像站，本质是什么？就是找一台有公网 IP 的服务器，装上同步工具，定时从淘宝镜像（或者直接上游 npm 源）拉取包，然后开放给局域网或者特定用户用。为什么要这么干？因为淘宝镜像虽然快，但毕竟是公共的，一旦你团队几十号人同时拉包，还是可能遇到限流或者带宽瓶颈。自己搭一个，内网缓存下来，第二次再下载几乎秒传，而且你还能控制同步哪些包。

具体怎么操作？我推荐两个工具，对新手特别友好：Verdaccio 和 Nexus Repository。Verdaccio 轻量又简单，适合纯 npm 场景；Nexus 功能全面，能同时管 npm、maven、pypi，甚至 Docker 镜像。

先说 Verdaccio。你找一台 Linux 服务器（CentOS 或 Ubuntu 都行），先装好 Node.js 和 npm。然后全局安装 Verdaccio：  
`npm install -g verdaccio`  
启动它：  
`verdaccio`  
默认监听 4873 端口。然后你需要配置 upstream 指向淘宝源。编辑配置文件 `~/.config/verdaccio/config.yaml`，找到 `uplinks` 部分，改成：  
```yaml
uplinks:
  taobao:
    url: https://registry.npmmirror.com/
    timeout: 60s
    max_fails: 10
    fail_timeout: 2m
```
再在 `packages` 里把 `@*/*` 和 `*` 的 `proxy` 都设成 `taobao`。保存重启，你就有了一个本地镜像站。局域网内其他人只要把 npm registry 改成 `http://你的服务器IP:4873`，就能从你这边拉包，第一次会去淘宝同步，缓存下来后速度就快了。

但这里有个坑要注意：Verdaccio 默认不会自动同步所有包，它是“按需缓存”，有人访问某个包才会去上游拉。如果你想提前把常用包都缓存下来，得手动提前“预热”一下。比如写个脚本遍历 package.json 里的依赖，一个个 `npm install` 一遍。另外，如果服务器硬盘不大，缓存太多可能爆盘，建议定时清理或者设置缓存过期时间。

再说 Nexus。下载官方压缩包或者用 Docker 跑：  
`docker run -d -p 8081:8081 sonatype/nexus3`  
启动后访问 `http://你的IP:8081`，默认密码在容器日志里。然后创建 proxy 类型的仓库，Remote Storage 填淘宝 maven 地址（比如 `https://maven.aliyun.com/repository/public`）或者 npm 地址（`https://registry.npmmirror.com`）。Nexus 的优势在于它有 UI，配置直观，还能设置定时同步任务，甚至能做权限管理。但缺点是吃资源，如果服务器只有 1G 内存，跑起来会很吃力。

不管用哪种工具，搭建之后最关键的是维护。淘宝镜像本身也会有更新延迟（官方说是 10 分钟同步一次上游），你

你是不是也遇到过这种情况：npm install 的时候，进度条卡在某个包上一动不动，等半天最后报错超时？或者 maven 下载依赖，眼看着 jar 包从国外服务器慢慢爬，真想自己搞个加速通道。这时候淘宝镜像站就香了，但很多人以为只能直接用别人的，其实你自己也能搭一个。今天就把我这几年踩过的坑和实操经验摊开来聊聊。

先别急着动手，咱们得把“搭建”这两个字掰扯清楚。大部分人说的“搭建淘宝镜像站”，其实有两层意思：一是配置本地环境直接使用淘宝的 npm 或 maven 镜像（这个最简单，一行命令搞定），二是真的在自己服务器上搭一个同步淘宝源的镜像站（给团队或公司用）。你问的是哪种？我看很多新手一说“搭建”就蒙了，其实就是没分清楚这两步。

先说最实际的场景：你只是想让自己电脑上的 npm 或 maven 下载快一点。那根本不是搭建，而是“配置”。你只需要在终端里跑一行：  
`npm config set registry https://registry.npmmirror.com`  
然后把 node_modules 删了重新 install，速度直接起飞。maven 也一样，在 settings.xml 里加一段 mirror 配置指向 `https://maven.aliyun.com/repository/public`。这件事三分钟搞定，网上教程多得是，我就不赘述了。但如果你看到这还觉得自己“搭建”完成了，那可能误会了标题的意思。

真正要自己搭一个镜像站，本质是什么？就是找一台有公网 IP 的服务器，装上同步工具，定时从淘宝镜像（或者直接上游 npm 源）拉取包，然后开放给局域网或者特定用户用。为什么要这么干？因为淘宝镜像虽然快，但毕竟是公共的，一旦你团队几十号人同时拉包，还是可能遇到限流或者带宽瓶颈。自己搭一个，内网缓存下来，第二次再下载几乎秒传，而且你还能控制同步哪些包。

具体怎么操作？我推荐两个工具，对新手特别友好：Verdaccio 和 Nexus Repository。Verdaccio 轻量又简单，适合纯 npm 场景；Nexus 功能全面，能同时管 npm、maven、pypi，甚至 Docker 镜像。

先说 Verdaccio。你找一台 Linux 服务器（CentOS 或 Ubuntu 都行），先装好 Node.js 和 npm。然后全局安装 Verdaccio：  
`npm install -g verdaccio`  
启动它：  
`verdaccio`  
默认监听 4873 端口。然后你需要配置 upstream 指向淘宝源。编辑配置文件 `~/.config/verdaccio/config.yaml`，找到 `uplinks` 部分，改成：  
```yaml
uplinks:
  taobao:
    url: https://registry.npmmirror.com/
    timeout: 60s
    max_fails: 10
    fail_timeout: 2m
```
再在 `packages` 里把 `@*/*` 和 `*` 的 `proxy` 都设成 `taobao`。保存重启，你就有了一个本地镜像站。局域网内其他人只要把 npm registry 改成 `http://你的服务器IP:4873`，就能从你这边拉包，第一次会去淘宝同步，缓存下来后速度就快了。

但这里有个坑要注意：Verdaccio 默认不会自动同步所有包，它是“按需缓存”，有人访问某个包才会去上游拉。如果你想提前把常用包都缓存下来，得手动提前“预热”一下。比如写个脚本遍历 package.json 里的依赖，一个个 `npm install` 一遍。另外，如果服务器硬盘不大，缓存太多可能爆盘，建议定时清理或者设置缓存过期时间。

再说 Nexus。下载官方压缩包或者用 Docker 跑：  
`docker run -d -p 8081:8081 sonatype/nexus3`  
启动后访问 `http://你的IP:8081`，默认密码在容器日志里。然后创建 proxy 类型的仓库，Remote Storage 填淘宝 maven 地址（比如 `https://maven.aliyun.com/repository/public`）或者 npm 地址（`https://registry.npmmirror.com`）。Nexus 的优势在于它有 UI，配置直观，还能设置定时同步任务，甚至能做权限管理。但缺点是吃资源，如果服务器只有 1G 内存，跑起来会很吃力。

不管用哪种工具，搭建之后最关键的是维护。淘宝镜像本身也会有更新延迟（官方说是 10 分钟同步一次上游），你