创建您的第一个 Cloudflare 账户:
- 前往注册页面 ↗。
- 输入 Email(电子邮件) 和 Password(密码)。
- 选择 Create Account(创建账户)。
创建账户后,Cloudflare 会自动向您的地址发送电子邮件,以验证该电子邮件地址。
现有用户可以在仪表板中或通过 API 创建额外的 Free 账户。
创建 Free 账户需满足以下要求:
- 您的 Cloudflare 用户必须处于活跃状态,且注册至少满七天。
- 您必须在现有账户上拥有 Super Administrator 角色。
- 您最多可以创建五个额外的 Free 账户。
-
登录 Cloudflare 仪表板 ↗ 并前往 Accounts(账户)。
前往 Accounts(账户) ↗ -
选择 Create Account(创建账户)。
-
输入账户名称。
-
选择 Create Account(创建账户)。
使用用户拥有的 API token 或 OAuth access token。账户拥有的 API token 无法创建账户。
用户拥有的 API token 需要 User Details Read 权限。OAuth access token 需要 user-details.read 作用域。
将 standalone 字段设为 true,并省略 unit。每个 Free 账户创建请求都需要恰好一个有效的 Idempotency-Key 标头。重试同一请求时请复用相同的密钥。
将 CLOUDFLARE_API_TOKEN 设为用户拥有的 API token。将 IDEMPOTENCY_KEY 设为此账户创建请求的唯一值。
curl "https://api.cloudflare.com/client/v4/accounts" \
--request POST \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data '{"name":"Example account","type":"standard","standalone":true}'将 CLOUDFLARE_OAUTH_TOKEN 设为 OAuth access token。将 IDEMPOTENCY_KEY 设为此账户创建请求的唯一值。
curl "https://api.cloudflare.com/client/v4/accounts" \
--request POST \
--header "Authorization: Bearer $CLOUDFLARE_OAUTH_TOKEN" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data '{"name":"Example account","type":"standard","standalone":true}'完整请求架构请参阅 Create Account。
根据错误消息排查常见的账户创建失败:
| 错误 | 解决方法 |
|---|---|
| Your user is less than seven days old.(您的用户注册时间不足七天。) | 等待用户注册至少满七天。 |
| You are not a Super Administrator.(您不是 Super Administrator。) | 确认您在现有账户上拥有 Super Administrator 角色。 |
| You reached an account creation limit.(您已达到账户创建上限。) | 使用现有账户,或联系您的客户团队。 |
| Account creation is temporarily unavailable.(账户创建暂时不可用。) | 稍后使用相同的幂等密钥重试请求。 |
| The idempotency key was used for a different request.(该幂等密钥已用于其他请求。) | 为新请求使用新密钥。仅在完全相同的重试中复用原始密钥。 |
| Your user is suspended.(您的用户已被暂停。) | 联系 Cloudflare Support。 |
您的账户名称默认为 <<YOUR_EMAIL_ADDRESS>>'s Account。
您可能希望自定义此账户名称,以便说明其用途,或便于关联多个账户。
更改账户名称:
-
在 Cloudflare 仪表板中,前往 Configurations(配置) 页面。
前往 Configurations(配置) ↗ -
在 Account Name(账户名称) 下,选择 Change Name(更改名称)。
-
输入新的账户名称。
-
选择 Save(保存)。
如果您为团队或企业创建账户,我们建议为 Email(电子邮件) 选择电子邮件别名或邮件列表,例如 [email protected]。
该电子邮件地址是 Cloudflare 账单、用量通知和账户恢复的主要联系点。
有关保护账户和域名的详细建议,请参阅账户和域名管理最佳实践。
设置账户后,您有多种方式与 Cloudflare 交互。
如果您偏好无代码操作,可以通过 Cloudflare 仪表板 ↗管理账户和域名设置。
如果您偏好以编程方式与 Cloudflare 交互,可以使用以下方法:
| 资源 | 文档 | 说明 |
|---|---|---|
| Cloudflare API | API 文档 | 基于 HTTPS 请求和 JSON 响应的 RESTful API。 |
| Terraform ↗ | Terraform 文档 | 使用 HashiCorp 的基础设施即代码工具 Terraform 配置 Cloudflare。 |
| cloudflare-go ↗ | README ↗ | Cloudflare API 的官方 Go 库。 |
| cloudflare-typescript ↗ | README ↗ | Cloudflare API 的官方 TypeScript 库。 |
| cloudflare-python ↗ | README ↗ | Cloudflare API 的官方 Python 库。 |