想象一下你正站在客户现场，四周是高墙、铁门，网络信号像被抽走的气球——彻底失联。手里只有一台装满代码的笔记本，却找不到任何外部依赖。别慌，VerdifyKe以把外网的宝贵资源装进盒子，让它们在完全隔离的机器上继续发光发热。

普通项目依赖大多来自 registry.npmjs.org，而 Electron、electron‑builder 等工具在安装时会跑去 GitHub Releases 下载压缩包、NSIS 安装器甚至 Windows CodeSign 二进制。这些请求不受 registry 代理控制，所以即使把 npm 源改成本地 Verdaccio，也仍然会卡在外部下载环节。

关键痛点：

Verdaccio 只Neng缓存源码和元数据。

postinstall 脚本会直接向外部服务器索取二进制。

内网机器若没有这些文件，将导致编译失败或打包中断。

准备工作：在Neng够上网的机器上预先下载 Node、npm/yarn/pnpm、以及所有项目所需的二进制。

搭建 Verdaccio：全局安装并启动一个本地私服，让它缓存所有 npm 包。

迁移数据：将 Verdaccio 的 storage 与配置文件整体拷贝到内网机器。

恢复软链接 & 环境变量：让内网机器上的 node、npm Neng够找到对应可执行文件。

验证 & 使用：在离线环境下执行一次完整的依赖安装，确保没有网络请求。

a. 安装 Node 与版本管理工具

# 全局安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
# 下载 LTS 版 Node
nvm install 18
nvm alias default 18

b. 全局装好 Verdaccio 与 pnpm

npm install -g verdaccio pnpm
verdaccio --version   # 确认安装成功
pnpm --version

c. 把项目全部跑一遍，让 Verdaccio 把包dou拉下来

# 启动本地私服
verdaccio &
# 把注册表指向私服
npm set registry http://localhost:4873/
pnpm config set registry http://localhost:4873/
# 在每个项目目录执行一次完整依赖安装
cd /path/to/projectA && pnpm install
cd /path/to/projectB && pnpm install
# 对 Electron 系列进行一次完整构建，以确保二进制也被下载到缓存目录
cd /path/to/electron-demo && pnpm run build

💡 小提示：Ru果你使用的是 Yarn，请把对应的 registry 改为同样地址即可。

下面这一步是核心——把Yi经填满“粮仓”的 Verdaccio 整体搬走。我们把两个关键目录一起压缩：

$HOME/.config/verdaccio/config.yaml: 配置文件。

$HOME/.config/verdaccio/storage/: 所有 tarball 与元数据。

$HOME/.config/verdaccio/.verdaccio-db.json: 私有包列表与 token 信息。

mkdir -p ~/verdaccio-offline
cp -r ~/.config/verdaccio ~/verdaccio-offline/
tar -czf verdaccio-package.tar.gz -C ~/verdaccio-offline .
# 同时把全局 node_modules 中的 verdaccio 与 pnpm 打包，以防止
下载
PREFIX=$
tar -czf node-modules.tar.gz -C $PREFIX/lib/node_modules verdaccio pnpm
# 将软链接目标记录下来
readlink $PREFIX/bin/verdaccio> link-verdaccio.txt
readlink $PREFIX/bin/pnpm      > link-pnpm.txt
echo "打包完成，拷贝以下三个文件至内网机器：" 
ls -lh *.tar.gz *.txt

⚠️ 为了安全起见，请把上述压缩包放到 U 盘或其他可移动介质，并Zuo好校验哈希值后再传输。

a. 安装 Node 与 nvm

# 假设Yi经把 node-v18-linux-x64.tar.gz 放到 /tmp/
mkdir -p $HOME/.nvm/versions/node/v18
tar -xzf /tmp/node-v18-linux-x64.tar.gz -C $HOME/.nvm/versions/node/v18 --strip-components=1
# 写入环境变量，让 shell Neng识别 nvm 命令
cat>> ~/.bashrc <'EOF'
export NVM_DIR="$HOME/.nvm"
 && \. "$NVM_DIR/nvm.sh"
EOF
source ~/.bashrc
nvm use v18   # 切换到刚解压好的版本
node --version   # 确认可用
npm --version

b. 解压并还原 Verdaccio 与全局模块

# 假设Yi将 verdaccio-package.tar.gz 和 node-modules.tar.gz 拷贝至 ~/offline/
mkdir -p $HOME/.config/verdaccio
tar -xzf ~/offline/verdaccio-package.tar.gz -C $HOME/.config/verdaccia
# 恢复全局模块：
PREFIX=$
mkdir -p $PREFIX/lib/node_modules $PREFIX/bin
tar -xzf ~/offline/node-modules.tar.gz -C $PREFIX/lib/node_modules
# 重建软链接：
ln -sf $ $PREFIX/bin/verdacci o   # 注意空格不要误删 
ln -sf $      $PREFIX/bin/pnpm
# 检查软链接是否正确：
ls -l $PREFIX/bin | grep -E "verdccio|pnpm"

🔧 Ru果发现路径不匹配，只需要手动修改上述两行中的目标路径即可。

# 启动前先编辑 config.yaml，把 proxy 部分关掉，避免误连外网：
sed -i '/uplinks:/,/^$/ s/url:.*/url: false/' ~/.config/verdaccia/config.yaml
# 启动服务
nohup verdaccio> ~/verdacio.log 2>&1 &
# 检查日志确认Yi监听 localhost:4873：
tail -f ~/verdacio.log | grep "http address"

⚠️ 若是 Windows 环境，只要打开 CMD 或 PowerShell 执行同样的启动命令即可，只是路径稍有不同，需要自行替换为实际用户目录下的路径。

项目根目录新建或修改 .npmrc：

registry=http://127.0.0.1:4873/
always-auth=true   # 私有仓库默认开启鉴权，可省略 token 步骤 

对于 Electron/Electron‑builder 的二进制，同样Ke以通过环境变量指向本地缓存目录：

export ELECTRONMIRROR=file:///home/user/.cache/electron/
export ELECTRONBUILDERBINARIESMIRROR=file:///home/user/.cache/electron-builder/
export PLAYWRIGHTDOWNLOADHOST=file:///home/user/.cache/playwright/



三、进阶技巧：让 electron‑builder 完全脱机运行 🚀 

预先抓取 electron‑builder 所需工具链： 在联网机器上运行一次完整构建后将以下目录复制过去：

~/.cache/electron-builder  
~/.cache/electron  
~/.cache/playwright  

修改配置让它们只读本地： 在 .env 或者构建脚本里加入前面提到的三个 export 指令；或者直接在 package.json 的 scripts 中写入：
{ 
   "scripts":{ 
      "build": "ELECTRON_MIRROR=file:///home/me/.cache/electron \\
                ELECTRON_BUILDER_BINARIES_MIRROR=file:///home/me/.cache/electron-builder \\
                pnpm run electron-builder"
   } 
} 
验证无网络请求： 用 tcpdump / wireshark kankan是否还有出站请求；若出现 “GET https://github.com/... ” 那就说明还有遗漏，需要继续抓取对应 binary。
四、常见故障排查指南 🔎 
无法访问 http://localhost:4873/ 

检查防火墙是否阻止了 4873 端口；Windows 下Ke以打开 “高级安全 Windows 防火墙” → 入站规则 → 新增允许 TCP 4873 。 
确认 config.yaml 中 listen 字段写的是 “0.0.0.0:4873” 而非 “127.0.0.1”。 

依赖仍然尝试访问外部 CDN 

某些包会在 postinstall 时自行去 Github Release 拉取二进制，这类情况需要手动下载后放入相应缓存目录，再通过 environment variable 指向。 
检查 .npmrc 是否还有额外的 registry 配置覆盖了全局设置。 

pnpm install 报错 “ENOENT: no such file or directory … tarball” 

确认 storage 下对应 tarball 文件大小非零；Ru果为零说明之前没有成功缓存，需要重新在外网机跑一遍完整安装。 
Ru果你使用了 `--offline` 参数，请先删除该参数再尝试，因为它会强行只读 cache 而不去 fallback。 

五、收官感言 🌟 
从「没有网络」到「自给自足」只差几步准备和一次搬运。Verdacci o 本身轻量又易于
，加上我们手动同步 Electron 二进制等关键资产，就算是Zui挑剔的桌面端项目，也Neng在铁墙之内顺畅编译发布。未来Ru果业务需要geng细粒度的权限控制或镜像多语言镜像，可考虑接入 Nexus Repository Manager 或者 JFrog Artifactory，但对于大多数前端团队而言，这套「离线 + 本地」方案Yi经足够实战。


©2026 AI 文案
专家·原创发布，仅供学习交流使用。
温馨提醒
- 备份每次修改 config.yaml 前请备份原始文件，以免误删重要配置。
- 安全.vertacci-db.json 中保存着 token 密钥，不要随意泄露；生产环境建议使用独立账号登录。
- geng新当公司内部新增 NPM 包时只需在外网上执行 npm publish 到你的 Verdacc i o 实例，然后同步 storage 即可，无需
搬运整个节点。
祝你们玩转离线开发，一路顺风 🚀!