Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

cnpm

github.com

  • Free plan
  • Windows
  • macOS
  • Linux
  • Self-hosted
7.4 Club score Visit github.com

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.