通过原始HTTP请求测试NPM注册表 | AI生成和翻译

Home 2025.02 English 中文

---

要使用 curl 或 Insomnia 等工具通过原始 HTTP 请求测试你的 NPM 注册表，你可以通过检查连接性、身份验证以及提供包数据的能力来验证其功能，而无需依赖 NPM 客户端。由于你的注册表需要用户名和密码，你需要在请求中手动处理身份验证。以下是通过原始 HTTP 请求测试注册表的完整指南，假设它是一个支持基于令牌或基本身份验证的 NPM 兼容注册表（例如 Verdaccio、Nexus 或自定义实现）。

---

使用原始 HTTP 请求测试注册表的步骤

1. 身份验证并获取令牌（如果需要）

大多数 NPM 注册表使用基于令牌的身份验证，要求你先登录获取令牌，然后才能进行后续请求。某些注册表也可能直接支持基本身份验证。以下是使用 curl 进行身份验证的方法：

使用 curl 登录

向注册表的身份验证端点发送 PUT 请求以获取令牌：

curl -X PUT \
  -H "Content-Type: application/json" \
  -d '{"name": "<用户名>", "password": "<密码>"}' \
  <注册表URL>/-/user/org.couchdb.user:<用户名>

• 替换：
  • <用户名>：你的注册表用户名。
  • <密码>：你的注册表密码。
  • <注册表URL>：你的注册表的完整 URL（例如 https://my-registry.example.com）。
• 预期响应：如果成功，你将收到一个包含令牌的 JSON 响应：

  {
    "token": "你的身份验证令牌"
  }
  

• 保存令牌：复制 你的身份验证令牌 值，用于后续请求。

注意：如果你的注册表使用不同的身份验证端点或方法（例如基本身份验证或自定义 API），请查阅其文档。如果它直接支持基本身份验证，你可以跳过此步骤，并在后续请求中改用 -u "<用户名>:<密码>"。

---

2. 对注册表执行 Ping 操作

通过向注册表的根 URL 或 ping 端点发送 GET 请求来测试基本连接性。

使用 curl 执行 Ping 操作

curl -H "Authorization: Bearer 你的身份验证令牌" <注册表URL>

• 替换：
  • 你的身份验证令牌：来自步骤 1 的令牌。
  • <注册表URL>：你的注册表 URL。
• 预期响应：成功的响应（HTTP 200）可能会返回注册表的主页或简单的状态消息（例如，对于基于 CouchDB 的注册表，返回 {"db_name":"registry"}）。
• 替代方案：某些注册表提供 /-/ping 端点：

  curl -H "Authorization: Bearer 你的身份验证令牌" <注册表URL>/-/ping
  

如果使用基本身份验证：如果你的注册表不使用令牌且支持基本身份验证：

curl -u "<用户名>:<密码>" <注册表URL>

---

3. 检索包元数据

通过请求特定包的详细信息，验证注册表是否能够提供包元数据。

使用 curl 获取元数据

curl -H "Authorization: Bearer 你的身份验证令牌" <注册表URL>/<包名>

• 替换：
  • <包名>：你知道存在于你的注册表上的一个包（例如，如果它代理公共注册表，则为 lodash，或者私有包如 my-org-utils）。
• 预期响应：一个包含包元数据的 JSON 对象，包括版本、依赖项和 tarball URL。例如：

  {
    "name": "lodash",
    "versions": {
      "4.17.21": {
        "dist": {
          "tarball": "<注册表URL>/lodash/-/lodash-4.17.21.tgz"
        }
      }
    }
  }
  

如果使用基本身份验证：

curl -u "<用户名>:<密码>" <注册表URL>/<包名>

• 成功：返回 200 OK 响应及元数据，确认注册表正确提供包数据。

---

4. 下载包 Tarball（可选）

要全面测试注册表，下载一个包 tarball 以确保它能够交付实际的包文件。

使用 curl 下载 Tarball

1. 从步骤 3 的元数据中，找到特定版本的 tarball URL（例如 <注册表URL>/lodash/-/lodash-4.17.21.tgz）。
2. 下载它：

   curl -H "Authorization: Bearer 你的身份验证令牌" -O <tarball-url>
   

• 替换：<tarball-url> 为元数据中的 URL。
• -O 标志：使用原始文件名保存文件（例如 lodash-4.17.21.tgz）。
• 如果使用基本身份验证：

  curl -u "<用户名>:<密码>" -O <tarball-url>
  

• 成功：文件成功下载，你可以解压它（例如使用 tar -xzf <文件名>）以验证其内容。

---

使用 Insomnia 进行测试

如果你更喜欢像 Insomnia 这样的 GUI 工具，请按照以下步骤操作：

1. 设置身份验证

• 在 Insomnia 中创建一个新请求。
• 转到 Auth 标签页：
  • Bearer Token：如果你在步骤 1 中获取了令牌，选择 “Bearer Token” 并粘贴 你的身份验证令牌。
  • Basic Auth：如果注册表使用基本身份验证，选择 “Basic Auth” 并输入你的 <用户名> 和 <密码>。

2. 对注册表执行 Ping 操作

• 方法：GET
• URL：<注册表URL> 或 <注册表URL>/-/ping
• 点击 Send。
• 预期响应：状态为 200 OK，响应体简单。

3. 检索包元数据

• 方法：GET
• URL：<注册表URL>/<包名>
• 确保在 Auth 标签页中设置了身份验证。
• 点击 Send。
• 预期响应：状态为 200 OK，包元数据为 JSON 格式。

4. 下载 Tarball

• 方法：GET
• URL：元数据中的 tarball URL（例如 <注册表URL>/<包名>/-/<包名>-<版本>.tgz）。
• 点击 Send and Download 将文件保存到本地。
• 成功：文件下载完成，确认注册表能够提供包。

---

故障排除

• 401 未授权：
  • 检查你的令牌或凭据。
  • 确保 Authorization 头或基本身份验证格式正确。
• 404 未找到：
  • 验证包是否存在于注册表上。
  • 如果测试公共包（例如 lodash），请确认注册表代理了公共 NPM 注册表。
• 连接错误：
  • 仔细检查 <注册表URL>（例如，如果需要，包含 https://）。
  • 对于 HTTPS 注册表，如果使用 curl 时出现 SSL 错误，添加 -k 以绕过证书检查（仅用于测试）。
• 自定义注册表行为：
  • 如果这些步骤失败，请查阅你的注册表文档，了解特定的端点或身份验证方法。

---

结论

通过使用 curl 或 Insomnia 按照这些步骤操作，你可以通过原始 HTTP 请求测试你的 NPM 注册表的连接性、身份验证和包提供能力。首先进行身份验证（如果需要），然后对注册表执行 ping 操作，检索已知包的元数据，并可选地下载一个 tarball。这种方法确保你的注册表在 HTTP 层面完全可操作。

---

Back Donate