Nexus搭建npm 私服

Nexus 搭建 npm 私服

服务端部署 Nexus

  • 下载解压

    官方下载链接](help.sonatype.com/repomanager…)，执行：

    1
    2
    3
    4
    5
    6
    #下载
    $ wget https://download.sonatype.com/nexus/3/latest-unix.tar.gz
    #移动到 /opt 目录
    $ sudo mv latest-unix.tar.gz /opt/nexus3.tar.gz
    #解压
    $ sudo tar -xzvf nexus3.tar.gz

    注意运行 Nexus 需要 Java 8 运行时环境(JRE)，请自行安装。

  • 创建运行用户

    单独创建一个 nexus 用户用来运行

    1
    2
    3
    4
    5
    # 创建用户、指定用户目录、授权
    $ sudo useradd -d /home/nexus -m nexus
    $ sudo chown -R nexus:nexus /home/nexus
    $ sudo chown -R nexus:nexus /opt/nexus-3.15.2-01
    $ sudo chown -R nexus:nexus /opt/sonatype-work/

    修改运行用户配置项：修改 /opt/nexus-3.15.2-01/bin 目录下的配置文件 nexus.rc 为 run_as_user="nexus"

  • 运行

    修改端口指 8073 并开放 iptables 防火墙，对/opt/sonatype-work/nexus3/etc/nexus.properties 文件进行修改:

    1
    2
    3
    4
    # Jetty section
    application-port=8073
    application-host=0.0.0.0                                                                 # nexus-args=${jetty.etc}/jetty.xml,${jetty.etc}/jetty-http.xml,${jetty.etc}/jetty-requestlog.xml
    # nexus-context-path=/                                                                   # Nexus section                                                                         # nexus-edition=nexus-pro-edition                                                       # nexus-features=\                                                                       #  nexus-pro-feature

    启动服务，以下为 nexus 服务命令:

    1
    2
    3
    4
    5
    6
    7
    8
    # 启动 nexus 服务
    $ sudo service nexus start
    # 重启 nexus 服务
    $ sudo service nexus restart
    # 停止 nexus 服务
    $ sudo service nexus stop
    # 查看 nexus 服务状态
    $ sudo service nexus status

    查看日志检查服务状态：

    1
    $ tail -f /opt/sonatype-work/nexus3/log/nexus.log

    至此，nexus 服务已搭建完毕！可使用默认账号 admin/admin123 登录 ip:post 后对 npm 仓库进行管理

![image-20200806002327294](Nexus 搭建 npm 私服.assets/image-20200806002327294.png)

  • 仓库管理

    创建仓库，npm 仓库有三种，这三种我们都需要创建

![image-20200806002450572](Nexus 搭建 npm 私服.assets/image-20200806002450572.png)

  1. npm(proxy) - 代理 npm 仓库

    将公共 npm 服务器的资源代理缓存，减少重复下载，加快开发人员和 CI 服务器的下载速度。

    创建时需填写 Name(npm-external)和 Remote Storage(公有库地址，填写官方或淘宝镜像，https://registry.npmjs.org/)。

    该仓库地址为：http://ip:post/repository/npm-external/

  2. npm(hosted) - 私有 npm 仓库

    用于 上传自己的 npm 包 以及第三方 npm 包。

    创建时只需填写 Name(npm-internal)。

    该仓库地址为：http://ip:post/repository/npm-internal/

    请注意：发布包时请将 registry 设为该地址。

  3. npm(group) - npm 仓库组

    用于将多个内部或外部 npm 仓库统一为一个 npm 仓库。可以新建一个 npm 仓库组将 上面两个刚刚创建的两个 npm 仓库都添加进去。这样可以通过这个 npm 仓库组，既可以访问 公有 npm 仓库 又可以访问自己的 私有 npm 仓库。

    创建时需填写 Name(npm-all)，然后选择需要添加到组里的 其他 npm 仓库(npm-external和npm-internal)。

    该仓库地址为：http://ip:post/repository/npm-all/

    请注意：安装包以及卸载包时请将 registry 设为该地址。

  • 用户管理

    将包发布到 nexus npm 仓库需要设置一下 Nexus Repository Manager 的权限。否则无法登陆到我们的私服。在 Security->Realms 栏目里，将npm Bearer Token Realm 选入 Active。

![image-20200806002525787](Nexus 搭建 npm 私服.assets/image-20200806002525787.png)

之后我们需要在 Security->Users 栏目里添加用户(需要admin权限否则无法发包)，只有这样添加的用户才可以发布包。经测试，在客户端使用 npm adduser 创建的用户没有发布权限。

​ npm adduser 添加的用户信息需要时刚刚创建的 user 信息, 非私服可以使用npm login使用 npm 账号进行发布。

客户端使用

使用 nrm 管理 registry

1
2
3
4
5
6
7
8
9
10
11
12
13
$npm install -g nrm

$ nrm ls
* npm ---- https://registry.npmjs.org/
  cnpm --- http://r.cnpmjs.org/
  taobao - https://registry.npm.taobao.org/
  nj ----- https://registry.nodejitsu.com/
  rednpm - http://registry.mirror.cqupt.edu.cn/
  npmMirror  https://skimdb.npmjs.com/registry/
  edunpm - http://registry.enpmjs.org/

$ nrm add ynpm http://XXXXXX:8888 # 添加私服的npm镜像地址
$ nrm use ynpm # 使用私服的镜像地址

安装包

1
2
3
4
5
6
7
8
9
10
npm install lodash # sinopia发现本地没有 lodash包,就会从 官方镜像下载
npm --loglevel info install lodash  # 设置loglevel 可查看下载包时的详细请求信息

[storage]$ ls
#下载过之后，私服的storage目录下回缓存安装包
[storage]$ ls
lodash

rm -rf node-modules # 删除目录
npm insatll lodash # 第二次安装就会从缓存下载了,速度很快

制作包

包的制作其实很简单，只需要npm init初始化一个项目，配置package.json文件自己所需的信息即可，主要注意下main字段所指定的入口文件，也是导出文件。

1
2
// index.js
module.exports = function () {};

发布包与撤销发布包

在项目根目录下运行$ npm publish发布新包。

运行$ npm unpublish 包名 --force撤销发布包。

1
$ npm publish

查看发布的包，已成功发布：

![image-20200806002957482](Nexus 搭建 npm 私服.assets/image-20200806002957482.png)

作用域 scope 管理发布包

经常有看到@xxx/yyy类型的开源 npm 包，原因是包名称难免会有重名，如果已经有人在 npm 上注册该包名，再次 npm publish 同名包时会告知发布失败，这时可以通过 scope 作用域来解决

  • 定义作用域包

    修改 package.json 中包名称：

    1
    2
    3
    4
    {
         "name": "@username/project-name"
    }
    复制代码

    需要注意的是，如果是发布到官方 registry，scope 一定要是自己注册的用户名，而如果是发布到自己的 npm 私服，scope 可以不是用户名

  • 发布作用域包

    作用域模块默认发布是私有的

    发布到官方 registry 时，直接npm publish会报错，原因是只有付费用户才能发布私有 scope 包，免费用户只能发布公用包，因此需要添加 access=public 参数；

    发布到自己的 npm 私服时，不加access=public参数也可以发布

    1
    npm publish --access=public

  • 使用作用域包

    1
    npm install @username/project-name