@as-integrations/cloudflare-workers

中文文档
1.1.1发布于 2025/03/19MITTypeScriptCommonJS零依赖近 30 天下载 7067

将 Cloudflare Works 用作阿波罗服务器 v4 的托管服务的集成

中文使用文档
文档目录6 节
  1. 快速启动
  2. 安装
  3. 使用量
  4. 额外奖金
  5. 云花波来普来特
  6. 德诺支持

@as- institutions/cloudflare-works( 团结) 工作人

NPM version

将Cloudflare Workers作为阿波罗服务器的托管服务的集成.

快速启动

安装

npm add @apollo/server @as-integrations/cloudflare-workers graphql

使用量

您必须启用节点. js 兼容性特性, 在文件中添加以下旗帜 wrangler.toml数字 :

compatibility_flags = ["nodejs_compat"] # wrangler v4
# node_compat = true  # or wrangler v3
import { ApolloServer } from '@apollo/server';
import { startServerAndCreateCloudflareWorkersHandler } from '@as-integrations/cloudflare-workers';
import { ApolloServerPluginLandingPageLocalDefault } from '@apollo/server/plugin/landingPage/default';

const typeDefs = `#graphql
  type Query {
    example: String!
  }
`;

const resolvers = {
  Query: {
    example: () => {
      return 'Hello universe!';
    },
  }
}

interface Context {
  token: string
}

const server = new ApolloServer<Context>({
  typeDefs,
  resolvers,
  introspection: true,
  plugins: [
    ApolloServerPluginLandingPageLocalDefault({ footer: false }),
  ],
});

export interface Env {
  // ...
}

export default {
  fetch: startServerAndCreateCloudflareWorkersHandler<Env, Context>(server, {
    context: async ({ env, request, ctx }) => {
      return { token: 'secret' };
    },
  }),
};

额外奖金

云花波来普来特

Cloudflare提供官方执行 浩诺您可以在 云层/工人-绘图-服务器。 。 。 .

德诺支持

这个例子与 德诺 因为它遵循 Web API 标准并支持 获取随着德诺的内置 Deno.serve (英语),您可以用最小的改动运行它.

重要注释 :

  • 如果使用Node.js软件包,请向 deno.json 或使用 npm: 前缀.
# instead of:
import { ApolloServer } from '@apollo/server';

# we use:
import { ApolloServer } from 'npm:@apollo/server';
  • 对于更多的控制,请修改设置 :
type Env = {};
type Context = { token: string };

const handler = startServerAndCreateCloudflareWorkersHandler<Env, Context>(server, {
  context: async () => ({ token: 'secret' }),
});

Deno.serve({ port: 3000 }, (req) => handler(req, {} satisfies Env, { token: '' } satisfies Context));

版本与发布记录

@as-integrations/cloudflare-workers 共发布 9 个版本,首次发布于 2023/02/08;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.1.1latest2025/03/191.6 年前
1.1.02025/02/241.7 年前
1.0.22024/03/302 年前
1.0.12024/03/302 年前
1.0.02024/03/302 年前
1.0.0-alpha2024/03/302 年前

关于 @as-integrations/cloudflare-workers 的常见问题

@as-integrations/cloudflare-workers 是什么?

将 Cloudflare Works 用作阿波罗服务器 v4 的托管服务的集成

如何安装 @as-integrations/cloudflare-workers?

在项目目录运行 npm install @as-integrations/cloudflare-workers,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:graphql(^16.6.0)、@apollo/server(^4.3.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@as-integrations/cloudflare-workers 支持 TypeScript 吗?

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

@as-integrations/cloudflare-workers 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@as-integrations/cloudflare-workers 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@as-integrations/cloudflare-workers 可以商用吗?

@as-integrations/cloudflare-workers 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@as-integrations/cloudflare-workers 的下载量有多少?

根据 npm 官方下载统计,@as-integrations/cloudflare-workers 在 2026/10/07 – 2026/11/05 这 30 天内被下载 7,067 次,日均约 236 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@as-integrations/cloudflare-workers 还在维护吗?

最新版本 1.1.1 发布于 2025/03/19(1.6 年前);至今共发布 9 个版本,其中过去 12 个月发布了 0 个;首次发布于 2023/02/08。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。