# @flaregun-net/proxyflare-for-pages 中文文档

规范地址：https://npmcn.com/package/%40flaregun-net/proxyflare-for-pages/

版本：0\.1\.0
npm 元数据更新时间：2023-01-31T01:39:23.690Z
中文译文更新时间：2026-11-14T21:29:52.343Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40flaregun-net/proxyflare-for-pages
原文对照：https://npmcn.com/package/%40flaregun-net/proxyflare-for-pages/?lang=original
项目主页：https://github.com/flaregun-net/proxyflare-for-pages#readme
源码仓库：https://github.com/flaregun-net/proxyflare-for-pages

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

- 包体积（解压后）：459 kB，8 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@cloudflare/workers-types 3\.14\.0
- 首次发布：2022-12-21T17:00:56.710Z
- 最新版本发布：2023-01-31T01:39:23.560Z
- 近 30 天下载量：3207（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 0 个）

## 中文简介

在 Cloudflare 页面上的您网站的倒置代理

## 安装

```sh
npm install @flaregun-net/proxyflare-for-pages
```

也可以使用：`pnpm add @flaregun-net/proxyflare-for-pages`、`yarn add @flaregun-net/proxyflare-for-pages`、`bun add @flaregun-net/proxyflare-for-pages`

## README

# Cloudflare 的代理页

[访问我们的网站](https://flaregun.net/docs/latest/proxyflare/plugin/getting-started) 用于完整文件.

## 概览

Poxyflare是一个倒置的代理,它使得HTTP流量很容易围绕你的域名移动并跨过互联网.

此软件包提供代理文件 [云旗页](https://developers.cloudflare.com/pages) 插件 。 在Cloudflare Pages上部署的任何网站都可能使用Proxyflare.

代理软件层是将收到的请求匹配到 `Routes` 在你身边 `Configuration`。 。 。 .

更多信息请查阅Cloudflare文档 [页中软件](https://developers.cloudflare.com/pages/platform/functions/middleware/), (中文(简体) ), [页面函数](https://developers.cloudflare.com/pages/platform/functions) 和其他优秀的社区 [插件](https://developers.cloudflare.com/pages/platform/functions/plugins/) 可以增强您的网站.

## 使用大小写

### 代理流量到另一个服务

代理流量从域名的一部分到同一域名或互联网上其他地方的另一服务

#### 实例

1.  移动流量从 `https://yoursite.com/api/*` 改为 `https://your-hosted-api.com`
2.  托管服务于 `https://torrents.yoursite.com/*` 说明 `http://yoursite.com:41321`

#### 页:1

-   代理服务器工作结束 `http(s):` 财务报告和审定财务报表 `ws(s):` (websockets) (英语)
-   公共互联网必须提供代理服务
-   标准端口和自定义端口都得到支持(例如. `80`, (中文(简体) ), `443`, (中文(简体) ), `8787`页:1

[学多点](https://flaregun.net/docs/latest/proxyflare/plugin/tutorials/proxying-services)

### 在您的域上挂载主机网站

#### 实例

1.  挂载您托管的反作用力文档 `https://hosted-docs.com` 打开 `https://yoursite.com/docs/*`
2.  挂载主机 WordPress 站点 `https://some-wordpress-blog.com` 打开 `https://yoursite.com/blog/*`

#### 页:1

-   挂载的网站应配置基站 URL 以匹配其挂载的路径名
-   样式表等静态资源必须小心添加到 `Route["to.website.resources"]`

[学多点](https://flaregun.net/docs/latest/proxyflare/plugin/tutorials/proxying-websites)

### 从一个地方到另一个地方

1.  API版本( 如重定向) `/v2/api`(中文(简体) )
2.  重定向 stale 内容 URL

#### 页:1

-   重定向为通配符
-   支持任何300级状态代码

[学多点](https://flaregun.net/docs/latest/proxyflare/plugin/tutorials/redirecting-traffic)

### 通过代理服务器服务静态内容

1.  出版独有 `robots.txt` 和围绕您领域的其他网站元数据文件

#### 页:1

-   支持设置自定义响应头 `Content-Type` jSON,或其他文本
-   文本文件不应大于 16KB

[学多点](https://flaregun.net/docs/latest/proxyflare/plugin/tutorials/serving-static-responses)

## 安装

安装 `@flaregun-net/proxyflare-for-pages` 财务报告和审定财务报表 `@cloudflare/workers-types` 使用您首选的 Node.js 软件包管理器

```bash
npm install @flaregun-net/proxyflare-for-pages
npm install -D @cloudflare/workers-types
```

## 插进

### 脚手架

在您的 Cloudflare Pages 项目中创建 `functions/_middleware.ts` 文档。 此文件的名称必须完全如所书写, 因为 Cloudflare Pages 内部使用文件名进行路由 。 如果你的项目已经有一个 `functions/_middleware.ts` 单向输出 `onRequest` 对象,为方便将其转换为中间软件列表。 Middleware是按所列顺序呼叫的.

这个 `onRequest` 中间软件应包括以下配置。 注意,我们把代理文件包入 `PagesFunction` 以便使用带有Proxyflare的环境变量. [学多点](https://flaregun.net/docs/latest/proxyflare/plugin/tutorials/using-environment-variables/) 关于环境变量和秘密.

```ts
import proxyflare from "@flaregun-net/proxyflare-for-pages"

const routes: Route[] = []

// `PagesFunction` is from @cloudflare/workers-types
export const onRequest: PagesFunction[] = [
  (context) =>
    proxyflare({
      config: {
        global: { debug: true },
        routes,
      },
    })(context),
  // other Pages plugins and middleware
]
```

这是赤骨代管配置 `debug` 启用后将有助于设置和配置。 学习更多关于 [正在调试代理服务器](https://flaregun.net/docs/latest/proxyflare/plugin/tutorials/debugging-proxyflare/)。 。 。 .

### 配置

接下来,你需要写第一个 `Route`检查 [使用大小写](https://npmcn.com/package/%40flaregun-net/proxyflare-for-pages/#readme-use-cases) 区域查找 `Route` 点子。 如果你还没有,试试这个例子:

```ts
const routes: Route[] = [
  {
    from: {
      pattern: "yourdomain.com/proxyflare-example",
      alsoMatchWWWSubdomain: true,
    },
    to: { url: "https://example.com" },
  },
]
```

替换 `yoursite.com` 与您的域名.

### 部署

一旦你有一个 `Route` 设置,部署您 Cloudflare Pages 网站的新版本,并监视部署。 一旦部署成功, 导航到你的域.

举个例子 `Route` 上面,你应该看看 `https://example.com` 执行时间 `yourdomain.com/proxyflare-example`。如果你没有看到它,请参考 [正在调试代理服务器](https://flaregun.net/docs/latest/proxyflare/plugin/tutorials/debugging-proxyflare/) 在Discord中, 区域或寻求帮助.

## 今后的步骤

现在,你起来跑,看看 [教学](https://flaregun.net/docs/latest/proxyflare/plugin/tutorials/proxying-services/) 来了解你对Proxyflare能做什么.

## 常见问题

### @flaregun-net/proxyflare-for-pages 是什么？

在 Cloudflare 页面上的您网站的倒置代理

### 如何安装 @flaregun-net/proxyflare-for-pages？

在项目目录运行 npm install @flaregun-net/proxyflare-for-pages，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@cloudflare/workers-types（3\.14\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @flaregun-net/proxyflare-for-pages 支持 TypeScript 吗？

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

### @flaregun-net/proxyflare-for-pages 支持 ESM 还是 CommonJS？

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

### @flaregun-net/proxyflare-for-pages 可以商用吗？

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

### @flaregun-net/proxyflare-for-pages 的下载量有多少？

根据 npm 官方下载统计，@flaregun-net/proxyflare-for-pages 在 2026/10/15 – 2026/11/13 这 30 天内被下载 3,207 次，日均约 107 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @flaregun-net/proxyflare-for-pages 还在维护吗？

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