如何在自定义npm注册表URL中保留端口以正常访问私有仓库？

看起来你碰到的这个问题我之前帮同事排查过好几次，核心是npm在解析带自定义端口的HTTPS注册表URL时，容易因为证书验证或配置细节的问题，出现端口被意外忽略的情况，我来一步步给你拆解解决：

首先明确一点：npm完全支持HTTPS的自定义端口，不是必须用443，所以问题肯定出在配置或证书的环节，而非端口本身不被支持。

先排查最容易踩的几个坑： #

• 检查.npmrc配置的准确性
  确保项目根目录或用户全局目录下的.npmrc里的registry配置没有拼写错误，尤其是端口和末尾的斜杠：

  registry=https://10.1.0.10:4434/repository/npm-group/
  

  写完后可以用npm config list命令查看当前生效的registry配置，确认显示的URL是完整带端口的，避免被其他层级的.npmrc（比如全局的）覆盖。

• 清除npm缓存，避免旧配置残留
  有时候缓存里的旧配置会干扰新请求，执行这个命令清掉缓存再试：

  npm cache clean --force
  

重点解决自签名证书的问题 #

这个是最容易被忽略的点！你能直接用浏览器下载.tgz，是因为浏览器可能已经信任了这个自签名证书，但npm默认会严格验证SSL证书，当证书不被信任时，它的请求流程可能会出现异常（比如直接忽略端口走默认443）。解决方法有两种：

1. 推荐：让npm信任你的自签名证书
   把你的自签名证书文件（比如.pem格式）放到本地某个路径，然后执行：

   npm config set cafile /绝对路径/到/你的证书文件.pem
   

   这样npm就会用这个证书来验证私有仓库的SSL连接。
2. 临时测试：关闭严格SSL验证（仅用于排查，生产环境别用）
   执行这条命令临时关闭严格SSL检查，再尝试安装：

   npm config set strict-ssl false
   

   如果这样能成功安装，就坐实了是证书验证导致的端口解析异常。

直接用命令行参数强制指定（排查用） #

如果还是有问题，可以在安装命令里同时指定registry和SSL参数，绕开配置文件的可能问题：

npm install my-lib@0.0.2-13 --registry=https://10.1.0.10:4434/repository/npm-group/ --strict-ssl=false

如果这个命令能成功，就说明你需要调整的是全局或项目的.npmrc配置，确保证书或SSL验证的设置正确。

最后再提一句：你用的npm 11.5.2版本相对较新，虽然理论上带端口的URL解析应该没问题，但如果以上方法都试过还是不行，可以尝试降级到npm 10.x（Node v22官方配套的npm版本是10.x），排除版本兼容性的小概率bug。

内容来源于stack exchange