## 前言 基于前面的了解或者公司内部的刚需，可能搭建cnpm仓库已经变成了你必须会的知识点。跟着我一起去服务器部署一个私有的cnpm仓库吧。 ### 环境要求 * 系统要求：mac或者linux（服务器基本都是linux的） * nodejs:4.2.3 以上版本 ### 基本安装 * nodejs ~~~ curl -sL https://rpm.nodesource.com/setup_7.x | bash - （脚本） yum install -y nodejs yum install -y gcc-c++ make ~~~ * mysql ~~~ rpm -qa | grep mariadb rpm -e --nodeps mariadb/mysql sudo yum -y install mariadb-server systemctl start mariadb.service mysqladmin -u root password ‘passwd’ yum install git git clone git://github.com/fengmk2/cnpmjs.org.git $HOME/cnpmjs.org cd cnpmjs.org Mysql -u root -p create database cnpmjs; use cnpmjs; ~~~ source docs/db.sql【db.sql位于cnpmjs.org/docs/db.sql】 vim config/index.js ### 使用须知 * cnpm提供两个端口：7001和7002，其中7001用于NPM的注册服务，7002用于Web访问。 * bindingHost为安装cnpm的服务器ip地址，也就是在浏览器中只能通过访问http://192.168.0.234来访问cnpm以及获取npm的注册服务。 修改本地下载地址（registryHost：r.cnpmjs.org修改为192.168.0.129:7001） * 安装依赖 持久使用 npm config set registry https://registry.npm.taobao.org // 配置后可通过下面方式来验证是否成功 npm config get registry// 或 npm info express 进入./cnpmjs.org，执行npm install * 启动服务 node dispatch.js或者“nohup node dispatch.js &”来启动。 其中nohup为在后台启动。 npm run dev：调试模式启动； npm run test：跑测试； npm run start：启动 CNPM； npm run status：查看 CNPM 启动状态； npm run stop：停止 CNPM。 * 测试是否启动成功 在浏览器中输入：http://192.168.0.234:7002/，如果出现： 发布私有包 npm config set registry https://registry.npm.taobao.org 安装cnpm客户端 curl -sL https://rpm.nodesource.com/setup_7.x | bash - （脚本） yum install -y nodejs sudo npm install cnpm -g 更改默认的registry，指向私有的registry cnpm set registry http://192.168.0.234:7001 * 用npm账号登录你的私有registry 这里的账号中www.npmjs.com的账号，没有请注册（admin登录） ~~~ $ cnpm login Username: admin Password: npm0816@zjkj.com Email: (this IS public) admin@cnpmjs.org ~~~ ### 创建私有测试包 * 生成测试包 ~~~ $ cd /tmp $ mkdir helloworld && cd helloworld $ cnpm init name: @cjt/helloworld version: 1.0.0 ~~~ * 生成package.json（产出文件） : ~~~ { "name": "@cjt/helloworld", "version": "1.0.0", "description": "my first scoped package", "main": "index.js", "scripts": { "test": "echo \"Error: no test specified\" && exit 1" }, "author": "", "license": "ISC" } ~~~ * 注意事项 1. 注意，包名helloworld前必须要以公司名@cjt为前缀， @cjt在 config/index.js的scopes中配置 + // registry scopes, if don't set, means do not support scopes scopes: [ '@cjt','@cnpm', '@cnpmtest', '@cnpm-test' ], 2. 其余账号权限分配必须二次开发，修改 `middleware/publishable.js` 3. 发布与同步（见cnpm入门） 发布 cnpm publish 通过浏览器访问：http://192.168.0.129:7002/ 可查看和操作私有CNPM服务器 从默认源同步gulp cnpm sync gulp 下载 cnpm install gulp 4. 配置文件设置 enableCluster：是否启用 cluster-worker 模式启动服务，默认 false，生产环节推荐为 true; 利用多核 registryPort：API 专用的 registry 服务端口，默认 7001； webPort：Web 服务端口，默认 7002； bindingHost：监听绑定的 Host，默认为 127.0.0.1，如果外面架了一层本地的 Nginx 反向代理或者 Apache 反向代理的话推荐不用改； sessionSecret：session 用的盐； logdir：日志目录； uploadDir：临时上传文件目录； viewCache：视图模板缓存是否开启，默认为 false； enableCompress：是否开启 gzip 压缩，默认为 false； admins：管理员们，这是一个 JSON Object，对应各键名为各管理员的用户名，键值为其邮箱，默认为 { fengmk2: 'fengmk2@gmail.com', admin: 'admin@cnpmjs.org', dead_horse: 'dead_horse@qq.com' }； logoURL：Logo 地址，不过对于我这个已经把 CNPM 前端改得面目全非的人来说已经忽略了这个配置了； adBanner：广告 Banner 的地址； customReadmeFile：实际上我们看到的 cnpmjs.org 首页中间一大堆冗长的介绍是一个 Markdown 文件转化而成的，你可以设置该项来自行替换这个文件； customFooter：自定义页脚模板； npmClientName：默认为 cnpm，如果你有自己开发或者 fork 的 npm 客户端的话请改成自己的 CLI 命令，这个应该会在一些页面的说明处替换成你所写的； backupFilePrefix：备份目录； database：数据库相关配置，为一个对象，默认如果不配置将会是一个 ~/.cnpmjs.org/data.sqlite 的 SQLite； odb：数据的库名； ousername：数据库用户名； opassword：数据库密码； odialect：数据库适配器，可选 "mysql"、"sqlite"、"postgres"、"mariadb"，默认为 "sqlite"； ohost：数据库地址； oport：数据库端口； opool：数据库连接池相关配置，为一个对象； omaxConnections：最大连接数，默认为 10； ominConnections：最小连接数，默认为 0； omaxIdleTime：单条链接最大空闲时间，默认为 30000 毫秒； ostorege：仅对 SQLite 配置有效，数据库地址，默认为 ~/.cnpmjs/data.sqlite； nfs：包文件系统处理对象，为一个 Node.js 对象，默认是 fs-cnpm 这个包，并且配置在 ~/.cnpmjs/nfs 目录下，也就是说默认所有同步的包都会被放在这个目录下；开发者可以使用别的一些文件系统插件（如上传到又拍云等）,又或者自己去按接口开发一个逻辑层，这些都是后话了； registryHost：默认为 r.cnpmjs.org； enablePrivate：是否开启私有模式，默认为 false； o如果是私有模式则只有管理员能发布包，其它人只能从源站同步包； o如果是非私有模式则所有登录用户都能发布包； scopes：非管理员发布包的时候只能用以 scopes 里面列举的命名空间为前缀来发布，如果没设置则无法发布，也就是说这是一个必填项，默认为 [ '@cnpm', '@cnpmtest', '@cnpm-test' ]，据苏千大大解释是为了便于管理以及让公司的员工自觉按需发布；更多关于 NPM scope 的说明请参见 npm-scope； privatePackages：就如该配置项的注释所述，出于历史包袱的原因，有些已经存在的私有包（可能之前是用 Git 的方式安装的）并没有以命名空间的形式来命名，而这种包本来是无法上传到 CNPM 的，这个配置项数组就是用来加这些例外白名单的，默认为一个空数组； sourceNpmRegistry：更新源 NPM 的 registry 地址，默认为 https://registry.npm.taobao.org； sourceNpmRegistryIsCNpm：源 registry 是否为 CNPM，默认为 true，如果你使用的源是官方 NPM 源，请将其设为 false； syncByInstall：如果安装包的时候发现包不存在，则尝试从更新源同步，默认为 true； syncModel：更新模式（不过我觉得是个 typo），有下面几种模式可以选择，默认为 "none"; o"none"：永不同步，只管理私有用户上传的包，其它源包会直接从源站获取； o"exist"：定时同步已经存在于数据库的包； o"all"：定时同步所有源站的包； syncInterval：同步间隔，默认为 "10m" 即十分钟； syncDevDependencies：是否同步每个包里面的 devDependencies 包们，默认为 false； badgeSubject：包的 badge 显示的名字，默认为 cnpm； userService：用户验证接口，默认为 null，即无用户相关功能也就是无法有用户去上传包，该部分需要自己实现接口功能并配置，如与公司的 Gitlab 相对接，这也是后话了； alwaysAuth：是否始终需要用户验证，即便是 $ cnpm install 等命令； httpProxy：代理地址设置，用于你在墙内源站在墙外的情况。