cnpm
github.com
- Free plan
- Windows
- macOS
- Linux
- Self-hosted
What cnpm is
cnpm is an npm client for the China npm mirror, available on Linux, macOS, Windows, and self-hosted systems. It supports npm commands for installing and synchronizing packages, including `cnpm sync [moduleName]`, and can open package documentation with `cnpm doc` or a Git web URL with `cnpm doc -g`. The project documents global installation through `npm install cnpm -g` and requires Node.js 20 at minimum, with LTS recommended. By default, cnpm uses npminstall, while users can select the original npm installer. npminstall accepts folders, tarballs, URLs, registry packages, and Git URLs, with options to ignore lifecycle scripts, omit optional dependencies, enforce registry-only installs, or forbid specified licenses. Custom registry settings can create a private-registry npm CLI. The associated mirror is read-only and aims to synchronize with npm in real time, so write operations are excluded. npminstall cannot install from shrinkwrap files. The project recommends migrating to utoo, a modern npm package manager.
Who it suits
cnpm suits developers and administrators working with npm packages through the China mirror, private registries, or self-hosted environments. It requires Node.js 20 or later.
Good to know, and what to watch
- Supports Linux, macOS, Windows, and self-hosting
- Provides package synchronization and documentation commands
- Accepts registry, Git, URL, folder, and tarball inputs
- Offers private registry configuration
- Includes workspace, lockfile, and peer dependency support
- Requires Node.js 20 minimum
- Mirror excludes write-related operations
- Cannot install from shrinkwrap files
- Project recommends migrating to utoo
The verdict
cnpm provides npm-compatible workflows around a read-only China mirror, with private-registry configuration and broad package input support. Its Node.js requirement and shrinkwrap limitation matter when planning adoption.
What the maker publishes
- Commands
- cnpm supports npm commands, including package synchronization and opening package documentation or a Git web URL. source
- Compatibility
- cnpm supports npm commands, and npmmirror says it supports commands such as install, info, and view, except write-related operations. source
- Install
- The project instructs users to install cnpm globally with `npm install cnpm -g`. source
- Installation
- The project documents global installation with `npm install cnpm -g`. source
- Installer
- cnpm uses npminstall by default; users can select the original npm installer, with a stated loss of the fastest install speed. source
- Installer
- cnpm uses npminstall by default; the README says users can choose the original npm installer, with slower install speed. source
- Install options
- npminstall documents options to ignore lifecycle scripts, omit optional dependencies, enforce registry-only installs, and forbid specified licenses. source
- License
- The cnpm repository identifies its license as MIT. source
- License
- The cnpm repository is licensed under MIT. source
- Limitations
- npminstall says it cannot install from shrinkwrap files and warns that failed installs are best retried after cleaning node_modules. source
- Maintainer
- The package metadata lists fengmk2 as its author. source
- Mirror
- npmmirror describes itself as a read-only npm mirror that aims to synchronize with the official service in real time. source
- Mirror behavior
- npmmirror describes itself as a read-only npm mirror that aims to synchronize with the official service in real time. source
- Mirror commands
- npmmirror says its cnpm CLI supports commands such as install, info, and view, while write-related operations are excluded. source
- Node.js requirement
- The minimum Node.js version is 20, with LTS recommended. source
- Node.js requirement
- The README lists Node.js 20 as the minimum requirement and LTS as recommended. source
- Package documentation
- The `cnpm doc` command opens package documentation, and `cnpm doc -g` opens a Git web URL. source
- Package sync
- Users can sync packages from npm with `cnpm sync [moduleName]`. source
- Package types
- npminstall supports package inputs including folders, tarballs, URLs, registry packages, and Git URLs. source
- Private registries
- The README shows how to alias cnpm with a custom registry, registry web URL, and user configuration file to build a private registry npm CLI. source
- Private registry
- The README shows how to alias cnpm with custom registry, registry web, and user configuration URLs to build a private registry npm CLI. source
- Project status
- The project recommends migrating to utoo, described as a modern npm package manager. source
- Project status
- The project recommends migrating to utoo, described as a modern npm package manager. source
- Purpose
- cnpm is an npm client for the China mirror of npm. source
Checked against the maker's pages on 29 Sept 2026.