# pm > Process Manager for Node.js, branched from node-cluster. Latest version **2.2.6** (published 2015-12-09) · 0 weekly downloads ## Install ```sh npm install pm pnpm add pm yarn add pm bun add pm ``` ## Health **Score 15/100 (F)** — status: abandoned. Positive: no vulnerabilities. Warnings: low downloads; no types; no esm support. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 2.2.6 | | Published | 2015-12-09 | | First published | 2012-07-21 | | Weekly downloads | 0 | | TypeScript types | none | | Module format | CommonJS | | Node | >=0.9 | | Dependencies | 0 | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 270 | | Author | Aleafs Zhang | | Maintainers | aleafs, fengmk2 | | Keywords | process manager, cluster, child-process, master-worker | ## Links - npm: https://www.npmjs.com/package/pm - Repository: https://github.com/aleafs/pm - Issues: https://github.com/aleafs/pm/issues - npm.io page: https://npm.io/package/pm ## Alternatives - [cron](https://npm.io/package/cron.md) — 4.9M weekly downloads - [@vercel/queue](https://npm.io/package/@vercel/queue.md) — 731.6K weekly downloads - [create-sonicjs](https://npm.io/package/create-sonicjs.md) — 1.6K weekly downloads - [@exellix/jobs-api](https://npm.io/package/@exellix/jobs-api.md) — 941 weekly downloads - [@forwardimpact/libskill](https://npm.io/package/@forwardimpact/libskill.md) — 575 weekly downloads ## Recent versions - 2.2.6 (latest) — 2015-12-09 - 10.0.0-alpha.5 (next) — 2026-01-19 - 10.0.0-alpha.4 — 2026-01-18 - 2.2.5 — 2014-10-18 - 2.2.4 — 2014-10-12 - 2.2.3 — 2014-01-23 - 2.2.2 — 2013-10-25 - 2.2.1 — 2013-04-17 - 2.2.0-beta — 2013-03-08 - 2.2.0-alpha — 2013-03-06 - 2.1.1 — 2012-12-01 - 2.1.0 — 2012-11-29 - 2.0.2 — 2012-11-28 - 2.0.1 — 2012-11-22 - 2.0.0 — 2012-11-19 - … 12 more at https://npm.io/package/pm/versions ## README [![npm version](http://img.shields.io/npm/v/pm.svg)](https://github.com/aleafs/pm) [![Build Status](https://secure.travis-ci.org/aleafs/pm.png?branch=master)](http://travis-ci.org/aleafs/pm) [![Coverage Status](https://coveralls.io/repos/aleafs/pm/badge.png?branch=master)](https://coveralls.io/r/aleafs/pm?branch=master) [![npm download](https://img.shields.io/npm/dm/pm.svg)](https://npmjs.org/package/pm) ## About `pm` 是一个轻量级的Node.js多进程管理器，基于之前的`node-cluster`重构而来，在淘宝内部的生产系统中得到了广泛的应用. * 基于 master + worker 模式，master负责进程管理，worker 处理业务逻辑，有效利用现代服务器的多CPU; * 同一 master 可管理多种类型的worker, 并且支持在不同类型的 worker 之间进行轻量的消息传递; * 同一类型的 worker ，对于TCP请求，采用抢占式的方式进行负载均衡； * 平滑退出和 不退出前提下的 worker 进程重载 (reload). ## Api * Visit the [wiki page](https://github.com/aleafs/pm/wiki) to get more infomation about `pm`. * Also, we supply demo scripts in the code directory [demo](demo). ## Install ```bash $ npm install pm ``` ## Benchmark ```bash $ siege -b -c100 -t 60S http://172.0.0.2:33749/ ``` * QPS (only one child, http server, response req.url) (node0.6.17):
CASEClosedKeepAlive
pm2.0560010553
pm1.0523110388
node548110126
## Usage * in `master.js`, run as master: ```javascript var app = require('pm').createMaster({ 'pidfile' : '/tmp/demo.pid', }); app.register('group1', __dirname + '/http.js', { 'listen' : [8080, 8081], 'addr': '127.0.0.1' // it uses '0.0.0.0' by default }); app.on('giveup', function (name, num, pause) { // YOU SHOULD ALERT HERE! }); app.dispatch(); ``` * in `http.js`, run as worker: ```javascript var http = require('http').createServer(function (req, res) { res.end('hello world'); }); require('pm').createWorker().ready(function (socket, port) { http.emit('connection', socket); }); ``` ## Contributors Thanks goes to the people who have contributed code to this module, see the [GitHub Contributors page](https://github.com/aleafs/pm/graphs/contributors). Below is the output from `git-summary` ``` project: pm commits: 91 files : 27 authors: 86 aleafs 94.5% 4 wanglang 4.4% 1 fengmk2 1.1% ``` ## License `pm` is published under MIT license. See license text in [LICENSE](https://github.com/aleafs/pm/blob/master/LICENSE) file. --- _Source: https://npm.io/package/pm · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._