layout
landing

import { HomePage } from 'vocs/components' import { MetaBrowser } from '../components/MetaBrowser' import { Codebox } from '../components/Codebox'

<HomePage.Root> <HomePage.Tagline>bunpkg 是受到 unpkg 启发而开发的一个 NPM CDN 加速服务器,
自部署更加友好, 并提供了额外本地文件缓存等功能</HomePage.Tagline> <HomePage.Tagline>bunpkg is an alternative for unpkg.
but friendly for self-host deploy and file cache supported </HomePage.Tagline> </HomePage.Root>

• 💎 本地文件缓存: 压缩包(tgz) 和访问过的文件会使用 LRU 策略进行缓存, 并使用 sqlite 进行持久化

  Local File Cache: tarboll and visited file LRU cache, powered by sqlite

• 🌈 支持私有仓库: 通过自定义的 Authorization: Bearer ${TOKEN} 来支持私有 NPM 仓库认证

  Private Package Supported: Agent with npmAuthToken for private npm packages.

• 🚀 运行在 Bun 环境中, 超快乐!

  Powered by Bun! is fast!

演练场 LiveDemo

使用示例 Usages

/npm/package@version/file

https://bunpkg.com/npm/package@version/file https://bunpkg.com/npm/jquery@3.6.4/dist/jquery.min.js https://bunpkg.com/npm/jquery@3.6/dist/jquery.min.js https://bunpkg.com/npm/jquery@3/dist/jquery.min.js https://bunpkg.com/npm/jquery/dist/jquery.min.js https://bunpkg.com/npm/jquery

/meta/package@version

获取包的文件列表和对应版本的 package.json

https://bunpkg.com/meta/jquery@3.6.4 https://bunpkg.com/meta/jquery@3 https://bunpkg.com/meta/jquery

/esm/package@version/file

!IMOPRTANT 这是一个非常实验性的功能，避免在生产环境中使用

如果不是 js 代码， 将会回退到 npm 版本

https://bunpkg.com/esm/package@version/file https://bunpkg.com/esm/ofetch@1.3.3/dist/index.mjs https://bunpkg.com/esm/ofetch@1.3/dist/index.mjs https://bunpkg.com/esm/ofetch@1/dist/index.mjs https://bunpkg.com/esm/ofetch/dist/index.mjs https://bunpkg.com/esm/ofetch

请求参数 Query Parameters

?purge

删除当前 url 路径的缓存 https://bunpkg.com/esm/ofetch@1.3.3/dist/index.mjs?purge

与 UNPKG 的对比

feture	bunpkg	unpkg
302 supported, example npmmirror.com	✅	🚫
Local File Cache	✅ does nginx better, aha?	🚫
private Authorization header	✅	🚫
esm	✅ by Bun.Transpiler	✅ babel

HTTP 缓存表现 HTTP Cache Behavior

CDN 根据包含 npm 包版本的永久 URL 缓存文件。这是因为 npm 不允许包作者覆盖已经以相同版本号发布的不同包。

The CDN caches files based on their permanent URL, which includes the npm package version. This works because npm does not allow package authors to overwrite a package that has already been published with a different one at the same version number.

浏览器被指示（通过 Cache-Control 标头）无限期（1 年）缓存资产。

Browsers are instructed (via the Cache-Control header) to cache assets indefinitely (1 year).

未指定包版本号的 URL 会重定向到指定包版本号的 URL。如果未指定版本，这是最新版本，如果给出了 semver 版本，则是最大满意版本。重定向在 CDN 中缓存 10 分钟，在浏览器中缓存 1 分钟。

URLs that do not specify a package version number redirect to one that does. This is the latest version when no version is specified, or the maxSatisfying version when a semver version is given. Redirects are cached for 10 minutes at the CDN, 1 minute in browsers.

如果您希望用户在您剪切新版本时能够使用最新版本，最好的策略是将版本号直接放在您的安装说明中的 URL 中。这也将更快地加载，因为我们不必解析最新版本并重定向它们。

If you want users to be able to use the latest version when you cut a new release, the best policy is to put the version number in the URL directly in your installation instructions. This will also load more quickly because we won't have to resolve the latest version and redirect them.

磁盘缓存表现 Disk Cache Behavior

使用 CACHE_DIR=./cache 或重新映射 docker volumns /cache 来观察 tarboll 和文件缓存；sqlite 的文件缓存管理器，使用 LRU 算法；

Use CACHE_DIR=./cache or remap docker volumns /cache to watch how tarboll and file cache; File Cache Manager by sqlite, with LRU algorithm;

tarboll 和文件对半共享的默认限制为 4Gib 。您可以通过配置更改它

Default limit is 4Gib for tarboll and files shared. Your Can change it by Config

配置项 Config

• .env

默认值

PORT=4567
# HOST=0.0.0.0
# CORS_ORIGIN=*
CACHE_DIR=./.cache
# CACHE_MAX_SIZE=4
NPM_REGISTRY=https://registry.npmmirror.com/
ESM_ORIGIN=https://bunpkg.com
# NPM_MAX_TGZ_SIZE=100
# NPM_AUTH_TOKEN=
# JWT_SECRET=

• bun.config.ts

import path from "node:path";
import { cors } from "@elysiajs/cors";

export const BunPkgConfig = {
  /** 服务器相关 */
  server: {
    /**
     * 端口号
     * @default process.env.PORT || 4567
     */
    port: 4567,
    /**
     * 主机名
     * @default process.env.HOST || '0.0.0.0'
     */
    // host: "0.0.0.0",
    /**
     * 跨域配置
     * @default {origin:  process.env.CORS_ORIGIN } || Paramaters<typeof cors[0]>
     * @docuemnt see more https://elysiajs.com/plugins/cors.html#config
     */
    cors: {
      origin: "*",
    },
  },
  /** 缓存配置  */
  cache: {
    /**
     * 缓存硬盘占用空间最大值 (Gib)
     * @default process.env.CACHE_MAX_SIZE || 4
     */
    maxSize: 4,
    /**
     * 磁盘缓存目录位置
     * @default process.env.CACHE_DIR || '/cache'
     */
    dir: "/cache",
  },
  /** NPM 配置 */
  npm: {
    /**
     * 上游 NPM 源地址
     * @default process.env.NPM_REGISTRY || 'https://registry.npmjs.org/'
     */
    registry: "https://registry.npmjs.org/",
    /**
     * 私有 npm 认证头
     * Authorization: Bearer ${authToken}
     */
    // authToken: "",
    /**
     * 支持最大 npm tgz 压缩包尺寸 (mib)
     * @default 100 (Mib)
     * @default process.env.NPM_MAX_TGZ_SIZE || 100
     **/
    maxTgzSize: 100,
  },
  esm: {
    /**
     * ESM 前缀配置
     * @default process.env.ESM_ORIGIN
     */
    origin: "",
  },
  /**
   * 是否开启 JWT 认证, 只有有当前配置项并添加了 secret 的情况下才会开启
   *  seemore https://elysiajs.com/plugins/jwt.html
   */
  jwt: {
    //   /**
    //    * 认证密钥
    //    * @default process.env.JWT_SECRET
    //    **/
    //   secret: "",
  },
};

docker

docker run -i -t -p 4567:4567 chaogpt/bunpkg
docker run --env-file .env \
  -i -t -p 4567:4567 \
  -v /cache:./cache \
  -v bunpkg.config.ts:/app/bunpkg.config.ts chaogpt/bunpkg

Roadmap

• Persistence Cache (by sqlite)
• Browser UI
• [] Live Config Manager
• [] Data Statistics

Dev

bun dev
# then
# open http://localhost:4567

Powered by

• Elysia
• bun.sh