快速开始

环境要求

本项目使用以下工具：

• Node.js：建议 v20+
• npm
• Java 21：本实验环境已安装
• wrangler：Cloudflare 命令行工具

你可以用 npx wrangler 直接运行 wrangler，不需要全局安装。

克隆或打开项目

进入项目目录：

cd cloudflare-learning-lab

安装依赖：

npm install

如果网络较慢，可以配置国内镜像：

npm config set registry https://registry.npmmirror.com
npm install

准备 Cloudflare 凭证

不要在仓库中保存真实密钥。复制示例文件：

cp .env.example .env

在 .env 中填写：

CLOUDFLARE_ACCOUNT_ID=你的 Cloudflare Account ID
CLOUDFLARE_API_TOKEN=你的 Cloudflare API Token
CLOUDFLARE_R2_ACCESS_KEY_ID=你的 R2 Access Key ID
CLOUDFLARE_R2_SECRET_ACCESS_KEY=你的 R2 Secret Access Key
CLOUDFLARE_R2_ENDPOINT=https://你的AccountID.r2.cloudflarestorage.com

启动本地文档站

npm run dev

然后打开：

http://localhost:4173

启动 Workers 本地调试

npm run dev:wrangler

本地 Workers 地址通常类似：

http://localhost:8787/api/demo

首次创建 R2 Bucket

npx wrangler r2 bucket create cloudflare-learning-lab

Bucket 名称需要全局唯一。如果你已经创建过，可以直接使用现有 Bucket，并修改 wrangler.toml 中的 bucket_name。