# @bunny\.net/edgescript-sdk 中文文档

规范地址：https://npmcn.com/package/%40bunny.net/edgescript-sdk/

版本：0\.13\.0
npm 元数据更新时间：2026-09-23T15:08:17.883Z
中文译文更新时间：2026-11-08T19:56:14.967Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bunny.net/edgescript-sdk
原文对照：https://npmcn.com/package/%40bunny.net/edgescript-sdk/?lang=original
项目主页：https://github.com/BunnyWay/edge-script-sdk#readme
源码仓库：https://github.com/BunnyWay/edge-script-sdk

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：75.9 kB，14 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2024-08-14T00:47:30.008Z
- 最新版本发布：2026-09-23T15:08:17.578Z
- 近 30 天下载量：30440（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 3 个）

## 中文简介

* * *

## 安装

```sh
npm install @bunny.net/edgescript-sdk
```

也可以使用：`pnpm add @bunny.net/edgescript-sdk`、`yarn add @bunny.net/edgescript-sdk`、`bun add @bunny.net/edgescript-sdk`

## README

# 页面存档备份,存于互联网档案馆 @bunny.net/geder-script-sdk

* * *

[![Bunny](https://github.com/BunnyWay/edge-script-sdk/blob/main/asset/bunny.png?raw=true)](https://bunny.net/)

# 兔子边缘脚本SDK

此寄存器包含 `@bunny.net/edgescript-sdk`,一个旨在简化Bunny Edge脚本平台上应用程序的开发和测试的库. 通过这个 SDK 可以在当地构建、调试和运行脚本,然后将脚本无缝地部署到兔子的全球边缘网络进行生产.

在引擎盖下,Bunny Edge Scripting是建立在Deno上,它包括一个自定义的运行时间,在本地和Bunny边缘环境下可以互换支持运行的脚本. 这个 SDK 在本地复制环境, 让您在部署脚本之前 有信心地开发并测试您的脚本 .

> **说明:** 虽然Bunny运行时间与Deno和Node行为很吻合,但由于在基于服务器的CDN环境中运行应用程序的独特要求,一些API可能有所不同或受到限制.

## 使用量

与 `@bunny.net/edgescript-sdk`您可以在Deno、Node和bunny.net网络内 写出顺利运行的脚本。 下面是帮助您建立本地服务器的简单例子。 关于其他实例和使用案例,请参见: [示例文件夹](https://npmcn.com/package/%40bunny.net/edgescript-sdk/example/)。 。 。 .

### 哈罗世界实例

```typescript
import * as BunnySDK from "@bunny.net/edgescript-sdk";

function sleep(ms: number): Promise<void> {
  return new Promise((resolve) => setTimeout(resolve, ms));
}

console.log("Starting server...");

BunnySDK.net.http.serve({ port: 8080, hostname: '127.0.0.1' }, async (req) => {
  console.log(`[INFO]: ${req.method} - ${req.url}`);
  await sleep(1000); // Simulate some processing delay
  return new Response("Hello, Bunny Edge!");
});
```

这个例子使用Bunny Edge Scripting SDK设置了本地的HTTP服务器. 您可以在127.0.0.1:8080访问服务器并观察实时请求日志. 这个设置模仿了Bunny边缘网络处理请求的方式,提供了连贯的发展经验.

### 参数解释

-   **`port`**: 服务器会听到 HTTP 请求的端口 。 在这个例子中, `8080` 指定,因此您可以在 [http://127.0.0.1:8080 (中文(简体) )](http://127.0.0.1:8080/)。 。 。 .
    
-   **`hostname`**:服务器的主机名或IP地址. 这里, `'127.0.0.1'` 限制服务器只听本地机(localhost). 让它通过网络访问,你可以设置到 `'0.0.0.0'`,允许其他设备连接到服务器.
    

## 部署到兔子边缘

本地开发与测试后,部署到Bunny Edge脚本是直截了当的. 将您的代码推到你的 Bunny Edge 脚本项目 GitHub 存储器, 它会自动部署在 Bunny 的全球 CDN 上 .

Bunny的服务功能一旦部署,便会通过连接的Pull Zone处理收到的请求,使您的应用程序能够以最大速度和最小的延迟从边缘传送数据.

## QQ 错误处理和日志

Bunny Edge脚本包括内置记录,以支持错误跟踪和可观察性. 使用 Coper.log, Coper.warn, 以及 Coper.error 代码中的语句来监视应用程序流,调试问题, 并收集本地和部署中的深刻见解 .

## 常见问题

### 如何安装 @bunny\.net/edgescript-sdk？

在项目目录运行 npm install @bunny\.net/edgescript-sdk，或使用 pnpm add / yarn add / bun add。

### @bunny\.net/edgescript-sdk 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @bunny\.net/edgescript-sdk 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @bunny\.net/edgescript-sdk 可以商用吗？

@bunny\.net/edgescript-sdk 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @bunny\.net/edgescript-sdk 的下载量有多少？

根据 npm 官方下载统计，@bunny\.net/edgescript-sdk 在 2026/10/09 – 2026/11/07 这 30 天内被下载 30,440 次，日均约 1,015 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @bunny\.net/edgescript-sdk 还在维护吗？

最新版本 0\.13\.0 发布于 2026/09/23（1 个月前）；至今共发布 21 个版本，其中过去 12 个月发布了 3 个；首次发布于 2024/08/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。