小蓝中转站使用文档

Linux 平台安装 Node.js ​

Linux 推荐直接装 Node.js LTS。下面给常见发行版的做法。

安装 Node.js 的目标是让系统拥有 node 和 npm 两个命令。node 用来运行 JavaScript CLI，npm 用来下载和更新 Claude Code、Codex、Gemini CLI 等工具。

开始前先安装基础工具：

bash
sudo apt-get update
sudo apt-get install -y curl ca-certificates git

CentOS / RHEL / Fedora 用户把 apt-get 换成对应的 dnf 或 yum。

Ubuntu / Debian ​

使用 NodeSource（推荐） ​

NodeSource 通常提供更新的 Node.js LTS 版本，适合需要安装最新 CLI 工具的服务器或开发机。

bash
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

验证安装：

bash
node -v
npm -v
git --version

如果 NodeSource 下载慢，可以先用发行版自带仓库跑通：

bash
sudo apt-get update
sudo apt-get install -y nodejs npm git

如果版本太旧，再回到 NodeSource 或 nvm。

CentOS / RHEL ​

bash
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs

安装 Git：

bash
sudo yum install -y git

Fedora ​

bash
sudo dnf install -y nodejs npm

安装 Git：

bash
sudo dnf install -y git

使用 nvm（适合多版本管理） ​

nvm 适合一台机器同时维护多个 Node.js 版本，或者不想把 npm 全局包安装到系统目录的场景。

bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install --lts
nvm use --lts

如果 GitHub 访问不稳定，先使用系统包管理器安装 Node.js；等网络稳定后再切 nvm。

配置 npm 镜像 ​

npm 默认从官方 registry 下载依赖，国内网络下可能很慢。切到 npmmirror 后，安装 CLI 工具通常更快、更稳定。

这个设置只影响 npm 下载依赖，不会改变 小蓝中转站 的接口地址，也不会影响模型请求。

bash
npm config set registry https://registry.npmmirror.com
npm config get registry

输出 https://registry.npmmirror.com/ 即可。

最小验证 ​

这一步用于确认命令已经写入 PATH。四条命令都正常，再继续安装 CLI 工具。

bash
node -v
npm -v
git --version
npm config get registry

这四条都正常，再继续安装 Claude Code、Codex 或 Gemini CLI。

常见问题 ​

权限问题 ​

不要直接依赖 sudo npm install -g 解决权限问题。多版本环境优先用 nvm。

如果必须全局安装 npm 包，先确认当前 Node.js 不是系统残留旧版本：

bash
which node
which npm
node -v

版本过旧 ​

发行版自带仓库版本太老时，直接换 NodeSource 或 nvm。

命令装完还是找不到 ​

关闭当前终端，重新登录 SSH 或重新打开终端。还不行就检查 PATH：

bash
echo $PATH
which node
which npm

服务器没有图形界面 ​

CLI 工具不需要图形界面。只要 node、npm、git 正常，终端里就能继续配置。

下一步 ​

小蓝中转站使用文档

© 2026 小蓝中转站