cnpm搭建
最后更新于：2022-04-02 05:29:20
## 前言
基于前面的了解或者公司内部的刚需，可能搭建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
1. 检测并卸载已有的
~~~
rpm -qa | grep mariadb
rpm -e --nodeps mariadb/mysql
~~~
2. 安装mysql-server
2.1 在/etc/yum.repos.d/目录创建MariaDB.repo文件，内容如下：
~~~
# MariaDB 5.5 CentOS repository list - created 2014-03-04 11:20 UTC
# http://mariadb.org/mariadb/repositories/
[mariadb]
name = MariaDB
baseurl = http://yum.mariadb.org/5.5/centos6-amd64
gpgkey=https://yum.mariadb.org/RPM-GPG-KEY-MariaDB
gpgcheck=1
~~~
2.2 安装对应包
~~~
sudo yum -y install mariadb-server MariaDB-client
~~~
2.3 启动服务
~~~
//如果你是centos 系统
systemctl start mariadb.service
//如果你是GUN/linux ,只有service服务
service mysql start
//修改数据库密码，默认是空的
mysqladmin -u root password "passwd"
~~~
2.4 相关命令的拓展
~~~
//centos 系统
systemctl start mariadb #启动服务
systemctl enable mariadb #设置开机启动
systemctl restart mariadb #重新启动
systemctl stop mariadb.service #停止MariaDB
// gun
service xxxx start/stop/enable/restart
~~~
* 安装git并检出cnpmjs项目
~~~
//安装git 下载cnpmjs的git项目
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】
//允许外部链接数据库（如果 你想查看数据库的情况有必要设置）
grant all privileges on *.* to root@'%' identified by 'password';
//根据自己的需要修改index的配置文件
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
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。
~~~
* 如果启动时报错：`/lib64/libc.so.6: version `GLIBC_2.14' not found`，这个是因为glibc版本过低引起的，你可以通过命令查看目前支持的版本：`strings /lib64/libc.so.6 |grep GLIBC ` ，解决办法从官网下载相关的压缩包然后编译安装，再配置到相关的目录下。
1. 找到官网：http://www.gnu.org/software/libc/，下载2.14版本后缀为gz的压缩包，我们下载后放到root/software 下
2. 剩下的都是命令行操作
~~~cmd
//解压
[root@jrgc130 ~]#tar zxf glibc-2.14.tar.gz
[root@jrgc130 ~]# cd /opt/software
[root@jrgc130 software]# tar xf glibc-2.14.tar.gz
[root@jrgc130 software]# cd glibc-2.14
[root@jrgc130 glibc-2.14]# mkdir build
[root@jrgc130 glibc-2.14]# cd build
//修改配置文件
[root@jrgc130 build]# ../configure --prefix=/usr/local/glibc-2.14
//安装
[root@jrgc130 build]# make -j4
[root@jrgc130 build]# make install
//拷贝链接库
[root@jrgc130 build]# cd /usr/local/glibc-2.14/lib
[root@jrgc130 lib]# cp libc-2.16.so /lib64/
//创建链接
[root@jrgc130 lib]# cd /lib64
[root@jrgc130 lib64]# rm -rf libc.so.6
//复制相关文件到so
[root@example lib64]# /sbin/sln libc-2.14.so /lib64/libc.so.6
//运行strings /lib64/libc.so.6 |grep GLIBC 可以查看最新支持版本为2.14，问题解决。
~~~
* 测试是否启动成功
~~~
在浏览器中输入：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
~~~
* 如果过程中遇到不能同步或者下载自己的模块 ，可以修改/config/index.js 文件
> enableAbbreviatedMetadata: true
### 创建私有测试包
* 生成测试包
~~~
$ 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，你可以设置为kkl
scopes: [ '@cjt','@cnpm', '@cnpmtest', '@cnpm-test' ],
~~~
2. 其余管理员账号权限分配必须二次开发，修改 `middleware/publishable.js` ，也可以直接修改index.js中的文件，默认的管理员是admin ;
3. 注册并登陆用户：
3. 发布与同步（见cnpm入门）
~~~
发布
cnpm publish
通过浏览器访问：http://192.168.0.129:7002/ 可查看和操作私有CNPM服务器
从默认源同步gulp
cnpm sync gulp
下载
cnpm install gulp
~~~
## 配置文件（config/index.js）
~~~
'use strict';
var mkdirp = require('mkdirp');
var copy = require('copy-to');
var path = require('path');
var fs = require('fs');
var os = require('os');
var version = require('../package.json').version;
var root = path.dirname(__dirname);
var dataDir = path.join(process.env.HOME || root, '.cnpmjs.org');
var config = {
version: version,
dataDir: dataDir,
/**
* Cluster mode 是否启用 cluster-worker 模式启动服务，默认 false，生产环节推荐为 true; 利用多核
*/
enableCluster: true,
numCPUs: os.cpus().length,
/*
* server configure 服务器的基本设置，ip以及请求以及访问端口（必须设置）
*/
registryPort: 7001,
webPort: 7002,
bindingHost: '10.0.0.141', // only binding on 127.0.0.1 for local access
// debug mode
// if in debug mode, some middleware like limit wont load
// logger module will print to stdout
debug: process.env.NODE_ENV === 'development',
// page mode, enable on development env
pagemock: process.env.NODE_ENV === 'development',
// session secret
sessionSecret: 'cnpmjs.org test session secret',
// max request json body size
jsonLimit: '10mb',
// log dir name
logdir: path.join(dataDir, 'logs'),
// update file template dir
uploadDir: path.join(dataDir, 'downloads'),
// web page viewCache
viewCache: false,
// config for koa-limit middleware
// for limit download rates
limit: {
enable: false,
token: 'koa-limit:download',
limit: 1000,
interval: 1000 * 60 * 60 * 24,
whiteList: [],
blackList: [],
message: 'request frequency limited, any question, please contact fengmk2@gmail.com',
},
enableCompress: false, // enable gzip response or not
// default system admins，（管理员必须设置为自己清楚的，只有管理员可以删除模块，配置需要重启）
admins: {
// name: email
fengmk2: 'fengmk2@gmail.com',
admin: 'admin@cnpmjs.org',
dead_horse: 'dead_horse@qq.com',
},
// email notification for errors
// check https://github.com/andris9/Nodemailer for more informations
mail: {
enable: false,
appname: 'cnpmjs.org',
from: 'cnpmjs.org mail sender ',
service: 'gmail',
auth: {
user: 'address@gmail.com',
pass: 'your password'
}
},
logoURL: 'https://os.alipayobjects.com/rmsportal/oygxuIUkkrRccUz.jpg', // cnpm logo image url
adBanner: '',
customReadmeFile: '', // you can use your custom readme file instead the cnpm one
customFooter: '', // you can add copyright and site total script html here
npmClientName: 'cnpm', // use `${name} install package`，（默认的安装命令符号）
packagePageContributorSearch: true, // package page contributor link to search, default is true
// max handle number of package.json `dependencies` property
maxDependencies: 200,
// backup filepath prefix
backupFilePrefix: '/cnpm/backup/',
/**
* database config（数据库配置文件，必须设置的）
*/
database: {
db: 'cnpmjs',
username: 'root',
password: 'kkl123456',
// the sql dialect of the database
// - currently supported: 'mysql', 'sqlite', 'postgres', 'mariadb'
dialect: 'mariadb',
// custom host; default: 127.0.0.1
host: '127.0.0.1',
// custom port; default: 3306
port: 3306,
// use pooling in order to reduce db connection overload and to increase speed
// currently only for mysql and postgresql (since v1.5.0)
pool: {
maxConnections: 10,
minConnections: 0,
maxIdleTime: 30000
},
// the storage engine for 'sqlite'
// default store into ~/.cnpmjs.org/data.sqlite
storage: path.join(dataDir, 'data.sqlite'),
logging: !!process.env.SQL_DEBUG,
},
// package tarball store in local filesystem by default（文件系统，可以默认，可以用其他云服务器）
nfs: require('fs-cnpm')({
dir: path.join(dataDir, 'nfs')
}),
// if set true, will 302 redirect to `nfs.url(dist.key)`
downloadRedirectToNFS: false,
// registry url name（模块下载请求地址，必须设置）
registryHost: '10.0.0.141:7001',
/**
* registry mode config
*/
// enable private mode or not（必须设置，false允许其他人发布，否则只有管理员）
// private mode: only admins can publish, other users just can sync package from source npm
// public mode: all users can publish
enablePrivate: false,
// registry scopes, if don't set, means do not support scopes（私有模块前缀，必须设置）
scopes: [ '@kkl'],
// some registry already have some private packages in global scope
// but we want to treat them as scoped private packages,
// so you can use this white list.
privatePackages: [],
/**
* sync configs
*/
// the official npm registry（官方请求地址，一般不用修改）
// cnpm wont directly sync from this one
// but sometimes will request it for some package infomations
// please don't change it if not necessary
officialNpmRegistry: 'http://registry.npm.taobao.org',
officialNpmReplicate: 'https://replicate.npmjs.com',
// sync source, upstream registry（同步模块的地址，设置为阿里镜像建议）
// If you want to directly sync from official npm's registry
// please drop them an email first
sourceNpmRegistry: 'http://registry.npm.taobao.org',
// upstream registry is base on cnpm/cnpmjs.org or not
// if your upstream is official npm registry, please turn it off
sourceNpmRegistryIsCNpm: true,
// if install return 404, try to sync from source registry（模块没有，从远程更新下载，必须设置）
syncByInstall: true,
// sync mode select（同步模式，同步已有模块即可）
// none: do not sync any module, proxy all public modules from sourceNpmRegistry
// exist: only sync exist modules
// all: sync all modules
syncModel: 'exist', // 'none', 'all', 'exist'
syncConcurrency: 1,
// sync interval, default is 10 minutes（10ms同步一次）
syncInterval: '10m',
// sync polular modules, default to false（不同步热门模块）
// because cnpm can't auto sync tag change for now
// so we want to sync popular modules to ensure their tags
syncPopular: false,
syncPopularInterval: '1h',
// top 100
topPopular: 100,
// sync devDependencies or not, default is false
syncDevDependencies: false,
// changes streaming sync
syncChangesStream: false,
handleSyncRegistry: 'http://127.0.0.1:7001',
// badge subject on http://shields.io/
badgePrefixURL: 'https://img.shields.io/badge',
badgeSubject: 'cnpm',
// custom user service, @see https://github.com/cnpm/cnpmjs.org/wiki/Use-Your-Own-User-Authorization
// when you not intend to ingegrate with your company's user system, then use null, it would
// use the default cnpm user system
userService: null,
// always-auth https://docs.npmjs.com/misc/config#always-auth
// Force npm to always require authentication when accessing the registry, even for GET requests.
alwaysAuth: false,
// if you're behind firewall, need to request through http proxy, please set this
// e.g.: `httpProxy: 'http://proxy.mycompany.com:8080'`
httpProxy: null,
// snyk.io root url
snykUrl: 'https://snyk.io',
// https://github.com/cnpm/cnpmjs.org/issues/1149（针对某个补丁文件的修复，必须设置）
// if enable this option, must create module_abbreviated and package_readme table in database
enableAbbreviatedMetadata: true,
// global hook function: function* (envelope) {}
// envelope format please see https://github.com/npm/registry/blob/master/docs/hooks/hooks-payload.md#payload
globalHook: null,
};
if (process.env.NODE_ENV === 'test') {
config.enableAbbreviatedMetadata = true;
}
if (process.env.NODE_ENV !== 'test') {
var customConfig;
if (process.env.NODE_ENV === 'development') {
customConfig = path.join(root, 'config', 'config.js');
} else {
// 1. try to load `$dataDir/config.json` first, not exists then goto 2.
// 2. load config/config.js, everything in config.js will cover the same key in index.js
customConfig = path.join(dataDir, 'config.json');
if (!fs.existsSync(customConfig)) {
customConfig = path.join(root, 'config', 'config.js');
}
}
if (fs.existsSync(customConfig)) {
copy(require(customConfig)).override(config);
}
}
mkdirp.sync(config.logdir);
mkdirp.sync(config.uploadDir);
module.exports = config;
config.loadConfig = function (customConfig) {
if (!customConfig) {
return;
}
copy(customConfig).override(config);
};
~~~
### 参考测试文档
* [cnpm配置](http://blog.csdn.net/xs20691718/article/details/51898164)
* [cnpm官网文档介绍](https://github.com/cnpm/cnpmjs.org/wiki)
';