Docker 沙箱 npm 依赖安装排查

原名：sandbox-npm-install

针对 virtiofs 挂载目录中的原生依赖异常，整理隔离安装与验证流程。

中文 Skills 技能说明

适合特定 Docker 沙箱内 esbuild、Rollup 等二进制因文件系统兼容性出错的项目。将依赖装到容器本地文件系统，再以链接连接工作区，并验证原生工具和构建结果。需要 Linux 容器、Node.js、npm 和对应挂载环境，不适用于所有 npm 报错。脚本可能替换 node_modules、读取 npmrc 或安装浏览器，运行前检查目标、私有源凭据与权限，不修改宿主全局配置。

上游能力依据

上游原始适用说明：Install npm packages in a Docker sandbox environment. Use this skill whenever you need to install, reinstall, or update nodemodules inside a container where the workspace is mounted via virtiofs. Native binaries (esbuild, lightningcss, rollup) crash on virtiofs, so packages must be installed on the local ext4 filesystem and symlinked back.

上游 SKILL.md 主要章节（保留原文标题）：

• When to Use This Skill
• Prerequisites
• Background
• Step-by-Step Installation
• Common Options
• What the Script Does
• Post-Install Verification
• Important Notes
• Troubleshooting
• Vite Compatibility

使用边界

先核对运行环境、账号、区域、依赖和最小权限。创建资源、改配置、发布服务或产生费用前必须让使用者确认。

作者、翻译与许可证

原作者

GitHub, Inc. 与 awesome-copilot contributors

中文翻译

CEOFans翻译

许可证

MIT

上游来源

https://github.com/github/awesome-copilot/tree/a19b3101cc797a35de8b1c1698c13d1344703522/skills/sandbox-npm-install

适用范围

平台：linux；标签：开发运维、Docker 沙箱 npm 依赖安装排查、开源技能

安全提示

基础静态扫描不等于绝对安全。技能可能调用命令、浏览器、云服务或本地文件，请在最小权限环境中使用，高风险操作必须人工确认。

如发现侵权、许可证或安全问题，可在本页前台提交投诉，管理员复核后可立即下架。