对 HTTP 内容收费

x402-proxy 模板是位于任意 HTTP 后端前方的 Cloudflare Worker。当请求命中受保护路由时，proxy 返回带支付说明的 402 响应。客户端支付后，proxy 验证支付并将请求转发到 origin。

将 x402-proxy 模板部署到你的 Cloudflare 账户：

前置条件

Cloudflare 账户 ↗
需要设门禁的 HTTP 后端
用于收款的 wallet 地址

配置

在 wrangler.jsonc 中定义受保护路由：

{
	"vars": {
		"PAY_TO": "0xYourWalletAddress",
		"NETWORK": "base-sepolia",
		"PROTECTED_PATTERNS": [
			{
				"pattern": "/api/premium/*",
				"price": "$0.10",
				"description": "Premium API access"
			}
		]
	}
}

使用 Bot Management 选择性设门禁

配合 Bot Management，proxy 可对 crawler 收费，同时让人类用户免费访问：

{
	"pattern": "/content/*",
	"price": "$0.10",
	"description": "Content access",
	"bot_score_threshold": 30,
	"except_detection_ids": [117479730]
}

bot score 低于或等于 bot_score_threshold 的请求会被导向 paywall。使用 except_detection_ids 按 detection ID 将特定 crawler 加入 allowlist。

部署

克隆模板，编辑 wrangler.jsonc 并部署：

git clone https://github.com/cloudflare/templates
cd templates/x402-proxy-template
npm install
npx wrangler deploy

完整配置选项与 Bot Management 示例请参阅 template README ↗。

自定义 Worker 端点

如需更多控制，使用 Hono 将 x402 中间件直接加入 Worker：

import { Hono } from "hono";
import { paymentMiddleware } from "x402-hono";

const app = new Hono<{ Bindings: Env }>();

app.use(
	paymentMiddleware(
		"0xYourWalletAddress" as `0x${string}`,
		{
			"/premium": {
				price: "$0.10",
				network: "base-sepolia",
				config: { description: "Premium content" },
			},
		},
		{ url: "https://x402.org/facilitator" },
	),
);

app.get("/premium", (c) => c.json({ message: "Thanks for paying!" }));

export default app;

完整实现请参阅 x402 Workers 示例 ↗。

对 HTTP 内容收费

前置条件

配置

使用 Bot Management 选择性设门禁

部署

自定义 Worker 端点

相关