linknpm 正在检查服务

npm registry relay

从第一条命令开始，稳定使用 npm。

linknpm 是一个 npm 中转与缓存服务。它替你连接官方 npm 源，并缓存已下载的包，适合网络不稳定或首次配置开发环境的场景。

3 步开始使用 浏览常用工具

request flow

包下载如何到达你的终端

首次请求会回源并写入缓存，后续安装同一版本时优先直接返回缓存内容。

01

你的 npm / pnpm 发起请求

执行 npm install 时，客户端读取 registry 配置，并向 linknpm 请求包版本和下载地址。

02

linknpm 优先检查缓存

已缓存的版本会直接返回元数据和安装包；缓存不存在时，linknpm 才会代表你请求官方源。

03

首次请求回源并保存

官方 npm 源返回包后，linknpm 将其写入缓存。之后安装相同版本，通常无需再次走官方网络。

first-time setup

第一次使用，只需要 3 步

下面的命令可以直接复制到 macOS、Linux 或 Windows PowerShell 的终端中执行。

1配置地址

将公开包请求交给 linknpm

配置一次后，之后的 npm install 会默认使用这个中转地址。

npm config set registry https://registry.linknpm.com/
2验证连接

确认 registry 可以访问

看到 pong，说明终端已能通过 linknpm 请求 npm 服务。

npm ping
3开始安装

安装第一个开发 CLI

中转已经生效。现在可直接安装 Codex，后续工具也会自动使用该地址。

npm install -g @openai/codex@latest

ecosystem

常用 npm 生态

搜索会前往 npmjs.com 查看完整说明、版本与维护状态；下方可按用途筛选常用包。

运行时

tsx

直接运行 TypeScript 与现代 Node 脚本。

查看包信息

框架

SvelteKit

构建高性能 Web 应用的 Svelte 框架。

查看包信息

代码质量

TypeScript

JavaScript 的静态类型工具链。

查看包信息

代码质量

ESLint

可配置的 JavaScript 代码检查工具。

查看包信息

before you install

使用前，了解这几件事

  • 中转缓存公开 npm 包。首次下载某个版本时会从官方 npm 源回源，之后相同版本通常更快。
  • 私有包、付费包和带有公司凭据的 registry 请继续使用你组织指定的地址，不要切换到公开中转。
  • 安装后可通过 npm ping 检查服务；遇到依赖问题时先执行 npm cache verify。
  • 需要恢复官方 npm 源时，执行 npm config delete registry。

faq

pnpm 和 yarn 可以使用吗？

可以。pnpm 使用相同的 npm registry 配置；Yarn classic 也会读取该 registry。Yarn Berry 请在项目配置中设置 npmRegistryServer。

为什么有些包第一次下载仍需要等待？

尚未缓存的版本需要由中转服务器向官方 npm 源获取。完成后会保存在中转缓存中，后续相同版本无需重复回源。

能发布自己的包吗？

该服务定位为下载中转。若需要发布私有包，应使用受访问控制的私有仓库并配置独立的作用域 registry。