文档、教程与可分享的演示
用明确的包版本和文件路径加载脚本、样式及示例依赖,让一个 HTML 文件即可展示交互效果。
包本身须包含合适的浏览器构建,并保留许可证要求。unpkg.com · 美国(运营主体注册地)
UNPKG 通过 URL 分发公开 npm 包中的文件,适合文档示例、交互演示及无需打包的小型网页应用。基础 CDN 免费、无需账户,另提供浏览器模块转换、内联 TypeScript/JSX 和 MCP;需要域名级供应链防护的团队可了解独立的 Shield Beta。
UNPKG 是一个面向 npm 公共软件包的开源内容分发项目,由 Michael Jackson 创建,起源于 2015 年将 npm 压缩包中的文件直接映射为网址的想法。开发者可以通过网址加载 JavaScript、CSS 及其他包内资源,适合前端演示、文档站点和无需构建步骤的应用。UNPKG 独立于 npm 运营,软件包内容仍由各自的维护者发布并按其许可证使用。
UNPKG Foundation Inc. 是项目关联的美国亚利桑那州非营利法人,也是 UNPKG Shield 的运营方。当前基础 CDN 免费开放,无需注册账户;开源代码可在 GitHub 查阅。服务通过 Cloudflare 边缘网络分发内容,源站部署在多个地区。需要合同服务保障的项目应先评估其免费、按现状提供且没有合同 SLA 的服务条件。
UNPKG 的基本地址由包名、版本和文件路径组成。它读取 npm 已发布的公开包,JavaScript、CSS、字体和其他包内资源都可以按文件访问。开发者不必为这些资源另建存储桶;需要发布自己的文件时,应先把它们发布到 npm,并遵守包内容的许可。
完整版本和文件路径适合需要可重复结果的页面。版本范围或 latest 会先解析并重定向,后续发布可能改变解析结果;固定地址则需要开发者主动更新才能获得补丁。省略文件路径时,服务按 package.json 的 exports、main 及包作者指定的 unpkg 入口解析,不能把任意 Node.js 包直接当作可运行的浏览器脚本。
文件通过 Cloudflare 边缘网络交付,源站分布在美洲、欧洲和亚太的 11 个区域,包括 Dallas、São Paulo、Amsterdam、London、Singapore、Tokyo 和 Sydney。固定版本文件可缓存一年;进入缓存前检查长度与摘要,发现损坏条目时清除并重新获取。
这套服务采用单一边缘供应商,没有多 CDN 自动故障切换。基础文件分发按现状提供,不附合同 SLA。对依赖可用性、版本更新或私有资源有严格要求的项目,需要自行安排依赖管理、回退路径或独立部署。
UNPKG 的公共文件 CDN 免费开放,无需账户;浏览 npm 包、读取文件与元数据,以及使用浏览器模块和无构建工具时,都应遵守各 npm 包自己的许可。它提供的是公开 npm 包的分发服务,不能用来上传任意网站文件、托管私有包或购买专属带宽。
公共 npm 文件分发无需付费或绑定付款方式。Shield 的免费 Beta 通过候补名单申请;组织级部署、服务承诺和未来收费安排需与团队确认。
公共 CDN 免费开放,无需注册试用。Shield 目前为免费私测:加入候补名单并获批准后可使用,包含最多 3 个域名、10 个 npm 包和不限次数的包安全扫描。申请人需年满 18 岁或达到所在地成年年龄;Beta 没有固定试用天数,功能与开放安排可能调整或结束。
用明确的包版本和文件路径加载脚本、样式及示例依赖,让一个 HTML 文件即可展示交互效果。
包本身须包含合适的浏览器构建,并保留许可证要求。通过 import map 管理浏览器依赖;需要转换包格式时可使用 esm.unpkg.com,内联 TS/JSX 则由 /run 辅助处理。
框架既有构建流程、复杂依赖图和兼容性仍需项目自行管理。以元数据和 MCP 核对包版本、文件与依赖;可选 Shield 对已验证域名进行监控,按需要启用防护。
Beta 接入、域名验证和防护策略与免费文件读取分别办理。从少量明确的浏览器依赖开始,先决定固定版本、更新节奏与回退路径。UNPKG 的公开包分发适合快速接入;需要私有仓库、任意自有源站回源或合同可用性保障时,应另行规划服务与部署。
按业务用途了解产品:做什么、如何使用,以及是否需要单独计费。
按包名、版本和文件路径读取公开 npm 包内资源,支持作用域包、版本范围、dist-tag、导出子路径及条件解析。基础 CDN 保留发布者的文件内容与包许可。
目录地址末尾加斜线可浏览包文件;追加 ?meta 可获得文件路径、字节数、MIME 类型和 SHA-256 integrity,适合工具发现资源与生成 SRI。摘要校验确认字节一致,不能代替恶意代码审查。
把未直接提供浏览器模块的 npm 包解析和转换为 ES 模块,重写依赖地址,支持目标语法、依赖版本覆盖、开发模式及 CSS 模块等参数。默认目标为 ES2022;接入后仍需验证包与浏览器环境的兼容性。
扫描页面中的 text/ts、text/jsx 和 text/tsx 脚本,经模块服务转换后插入可执行模块,可设置目标语法和 JSX 来源。适合演示和小页面,无需单独生成脚本文件。
为 AI 开发工具提供包解析、文件发现、依赖审查、导入映射生成与校验,以及指定版本的恶意软件和漏洞检查。通用功能可匿名使用;读取自身域名和策略需连接已获批准的 Shield 账户。工具输入及结果会写入日志,不应提交密钥或私有源码。
监控 npm 新发布版本,为已接入的域名提供依赖可见性。域名先进入监控状态;主动启用防护后,可在边缘把受影响版本替换为已知安全版本或阻断请求。防护策略可能改变返回的版本,应与应用测试及完整性策略一起规划。
官方仓库提供 CDN Worker、包浏览器、模块转换 Worker 和 Bun 文件源站,使用 pnpm/Bun 运行。源站部署示例采用 Fly.io,边缘 Worker 使用 Cloudflare;独立部署需要自己的账户、域名、配置和运维。
加载公开 JavaScript、CSS 和其他 npm 包文件的开发者
直接使用文件 URL,无需注册、订阅或付款。
希望观察网站 npm 依赖并评估边缘防御的站点团队
需候补名单批准;Beta 期间免费,无固定试用天数。
需要统一身份、策略、审计与支持安排的组织
先确认可用配置、合同范围和费用;Shield 目前仍处于 Beta 阶段。
| 产品 | 免费额度 / 起付 | 主要用量价格 |
|---|---|---|
| 公共文件分发 | 公开 npm 包文件免费访问;服务不提供专属容量或合同可用率承诺。 | 免费 |
| Shield Beta 额度 | 获批账户包含最多 3 个域名、10 个包与不限次数的包安全扫描;仅适用于 Beta。 | 免费 |
| 自托管部署 | MIT 许可代码可自行部署;需配置文件源站与 Worker,并承担所选基础设施及运维成本。 | 成本自理 |
公共 CDN 按现状提供,没有合同 SLA。 Shield 的免费 Beta 同样不保证可用率或响应时限;自动检测可能误报或漏报,应先观察,再按域名选择是否启用自动防御。 组织级功能和服务承诺需事先确认,不能将免费 Beta 理解为已订购企业 SLA。 自托管代码采用 MIT 许可,云资源、带宽、存储、域名及运维成本由部署方承担。
URL 分发、元数据与模块工具让接入直接,固定版本也便于管理依赖。
基础服务不附合同 SLA,也没有多 CDN 故障切换。固定版本需要主动更新,浮动版本可能引入新发布风险;npm 包许可、浏览器兼容性和依赖回退都需项目自行管理。Shield 处于 Beta,防护资格和策略应单独确认。
了解 UNPKG 的产品、使用场景与选型建议