package
cluster manager for egg
npm install egg-clusterGitHub-flavored package documentation.
Across all versions.
Download trend unavailable.
Runtime metadata.
Tagged topics.
Latest published Dec 13, 2025
latest
Cluster Manager for EggJS
npm i egg-cluster --saveconst startCluster = require('egg-cluster').startCluster;
startCluster({
baseDir: '/path/to/app',
framework: '/path/to/framework',
});You can specify a callback that will be invoked when application has started. However, master process will exit when catch an error.
startCluster(options, () => {
console.log('started');
});| Param | Type | Description |
|---|---|---|
| baseDir | String | directory of application |
| framework | String | specify framework that can be absolute path or npm package |
| plugins | Object | plugins for unittest |
| workers | Number | numbers of app workers |
| sticky | Boolean | sticky mode server |
| port | Number | port |
| reusePort | Boolean | (Required Node.js >= 22.12.0) allows multiple sockets on the same host to bind to the same port. Incoming connections are distributed by the operating system to listening sockets. This option is available only on some platforms, such as Linux 3.9+, DragonFlyBSD 3.6+, FreeBSD 12.0+, Solaris 11.4, and AIX 7.2.5+. |
EGG_APP_CLOSE_TIMEOUT: app worker boot timeout value
EGG_AGENT_CLOSE_TIMEOUT: agent worker boot timeout value
Made with contributors-img.
eggjs-admin
fengmk2+eggjs@gmail.com
false| debugPort | Number | the debug port only listen on http protocol |
| https | Object | start a https server, note: key / cert / ca should be full path to file |
| require | Array|String | will inject into worker/agent process |
| pidFile | String | will save master pid to this file |
| startMode | String | default is 'process', use 'worker_threads' to start the app & agent worker by worker_threads |
| ports | Array | startup port of each app worker, such as: [7001, 7002, 7003], only effects when the startMode is 'worker_threads' and reusePort is false |
| env | String | custom env, default is process.env.EGG_SERVER_ENV |
Estimated unpacked size across 40 packages.
1.5 MB
Includes dependencies.
^2.0.1
2.1.0
^1.1.0
3.0.2
^2.1.1
5.0.0
^1.0.2
2.0.0
^1.2.0
2.2.0