# @hakoniwajs/cloudflare 中文文档

规范地址：https://npmcn.com/package/%40hakoniwajs/cloudflare/

版本：0\.1\.6
npm 元数据更新时间：2026-11-01T06:51:41.306Z
中文译文更新时间：2026-11-01T07:15:18.721Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40hakoniwajs/cloudflare
原文对照：https://npmcn.com/package/%40hakoniwajs/cloudflare/?lang=original
源码仓库：https://github.com/hakoniwajs/hakoniwa

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

- 包体积（解压后）：107 kB，43 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：@cloudflare/workers-types \*
- 首次发布：2026-09-26T12:48:30.777Z
- 最新版本发布：2026-11-01T06:51:40.964Z
- 已发布版本数：7（近 12 个月 7 个）

## 中文简介

Cloudflare Workers （Cloudflare Workers）持久对象(SQLite)版の工人エントリと做クラスを提供する

## 安装

```sh
npm install @hakoniwajs/cloudflare
```

也可以使用：`pnpm add @hakoniwajs/cloudflare`、`yarn add @hakoniwajs/cloudflare`、`bun add @hakoniwajs/cloudflare`

## README

# @hakoniwajs / cloudflare

[（英文）](https://github.com/hakoniwajs/hakoniwa) Cloudflare worker适配器持久对象(SQLite)版の工人エントリと做クラスを提供します。

テンプレートリポジトリ [hakoniwajs / template-cloudflare](https://github.com/hakoniwajs/template-cloudflare) を使うのが一番簡単です （部署到Cloudflareボタン対応)。

## 中文：

```console
$ npm install @hakoniwajs/cloudflare
```

`src/worker.ts`：

```ts
import { createWorker } from "@hakoniwajs/cloudflare";

// wrangler.jsonc の durable_objects.class_name で HakoniwaGame を、exports で CachedPages を
// 解決するため、このファイルから再エクスポートする必要がある
export { CachedPages, HakoniwaGame } from "@hakoniwajs/cloudflare";

export default createWorker();
```

`wrangler.jsonc` の最小構成(完全な設定例はテンプレートを参照):

```jsonc
{
  "name": "hakoniwa",
  "main": "src/worker.ts",
  "compatibility_date": "2026-08-22",
  "compatibility_flags": ["nodejs_compat"],
  "assets": { "directory": "./node_modules/@hakoniwajs/core/public" },
  // Workers Cache。Gateway (default) は無効にし、CachedPages だけ有効にする (wrangler 4.107.0 以降)
  "cache": { "enabled": true },
  "exports": {
    "default": { "type": "worker", "cache": { "enabled": false } },
    "CachedPages": { "type": "worker", "cache": { "enabled": true } },
  },
  "durable_objects": {
    "bindings": [{ "name": "GAME", "class_name": "HakoniwaGame" }],
  },
  "migrations": [{ "tag": "v1", "new_sqlite_classes": ["HakoniwaGame"] }],
  "triggers": { "crons": ["*/15 * * * *"] },
  "vars": { "HAKONIWA_DEV_LOGIN": "false" },
}
```

工作缓存(`cache.enabled: true`)を有効にすると静的アセットへのリクエストも工人のリクエストとして課金対象になります。

秘密的，秘密的。`HAKONIWA_AUTH_SECRET` 耐用物品（耐用品）管理者は,デプロイ後にログインして `/admin/setup` を開き,工人のログに出力されるセットアップコードを入力すると登録できます(`HAKONIWA_ADMIN_EMAILS` )。X / Discord `wrangler secret put <NAME>` 。你怎么看 [環境変数一覧](https://hakoniwajs.github.io/hakoniwa/setup/environment-variables/) 。

## API

-   `createWorker(options?)` - - - - - - `fetch`/`scheduled` 工作人员（网关）。`options.doBinding` で做バインディング名を `GAME` 整整齐齐，整整齐齐。
-   `HakoniwaGame` -耐用对象（）。
-   `CachedPages` - - - - - - [工人缓存](https://developers.cloudflare.com/workers/cache/) （中文）：中文)。网关が `ctx.exports` 。★★★★★★★★★★`purgeEverything`)。。
-   `createCachedPages(options?)` - - - - - - `doBinding` （中文）。`createWorker` と同じオプションを渡し,`export const CachedPages = createCachedPages({ doBinding: "..." })` 出口，出口。

## 许可证

オリジナルの利用条件に従います([许可证](https://github.com/hakoniwajs/hakoniwa/blob/main/LICENSE))。你怎么看？你怎么看？

## 常见问题

### @hakoniwajs/cloudflare 是什么？

Cloudflare Workers （Cloudflare Workers）持久对象\(SQLite\)版の工人エントリと做クラスを提供する

### 如何安装 @hakoniwajs/cloudflare？

在项目目录运行 npm install @hakoniwajs/cloudflare，或使用 pnpm add / yarn add / bun add。

### @hakoniwajs/cloudflare 支持 TypeScript 吗？

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

### @hakoniwajs/cloudflare 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @hakoniwajs/cloudflare 可以商用吗？

@hakoniwajs/cloudflare 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @hakoniwajs/cloudflare 还在维护吗？

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