跳转到内容
搜索文档

对 HTTP 内容收费

最后更新 查看 MarkdownAgent 设置

mpp-proxy 模板是位于任意 HTTP 后端前方的 Cloudflare Worker。当请求命中受保护路由时,proxy 返回带 MPP 支付挑战的 402 响应。客户端支付后,proxy 验证支付、将请求转发到 origin,并签发 1 小时 session cookie。

将 mpp-proxy 模板部署到你的 Cloudflare 账户:

部署到 Cloudflare

前置条件

配置

wrangler.jsonc 中定义受保护路由:

{
	"vars": {
		"PAY_TO": "0xYourWalletAddress",
		"TEMPO_TESTNET": false,
		"PAYMENT_CURRENCY": "0x20c000000000000000000000b9537d11c60e8b50",
		"PROTECTED_PATTERNS": [
			{
				"pattern": "/premium/*",
				"amount": "0.01",
				"description": "Access to premium content for 1 hour"
			}
		]
	}
}

使用 Bot Management 选择性设门禁

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

{
	"pattern": "/content/*",
	"amount": "0.25",
	"description": "Content access for 1 hour",
	"bot_score_threshold": 30,
	"except_detection_ids": [120623194, 117479730]
}

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

部署

克隆模板,编辑 wrangler.jsonc 并部署:

git clone https://github.com/cloudflare/mpp-proxy
cd mpp-proxy
npm install
npx wrangler secret put JWT_SECRET
npx wrangler secret put MPP_SECRET_KEY
npx wrangler deploy

完整配置选项、proxy 模式与 Bot Management 示例请参阅 mpp-proxy README

自定义 Worker 端点

如需更多控制,使用 Hono 将 MPP 中间件直接加入 Worker:

import { Hono } from "hono";
import { Mppx, tempo } from "mppx/hono";

const app = new Hono();

const mppx = Mppx.create({
	methods: [
		tempo({
			currency: "0x20c0000000000000000000000000000000000000",
			recipient: "0xYourWalletAddress",
		}),
	],
});

app.get("/premium", mppx.charge({ amount: "0.10" }), (c) =>
	c.json({ data: "Thanks for paying!" }),
);

export default app;

完整 API(含 session 支付与 payer 识别)请参阅 Hono 中间件参考

相关

这篇文档对您有帮助吗?