导航|地址|刷新
Cloudflare KV - Global Key-Value Databas…

Products Solutions Resources Pricing

Login Contact sales

Start building
Login

KV

Fast, globally distributed key-value database with infinite scale

Workers KV is an eventually consistent, high-performance key-value data database built for Workers. KV is ideal for read-heavy, low-latency edge decision making and configuration.

Start building for free View docs

Global Low-Latency Reads

Serve configuration or content to users worldwide with <5ms hot read latencies — thanks to Cloudflare's edge network.

Infinite Scale, Simple API

One API to store and retrieve key-value pairs — unlimited storage, high scalability, no infrastructure to manage.

More Than a Cache

Unlike a volatile cache, KV stores data persistently in central regions with exceptional availability and durability.

Fast, global, simple - here's how:

Workers KV persists data in Cloudflare edge colocations and distributed central regions. Reads from new edge locations pull requested key-value pairs, making them available for sub-5ms reads on subsequent requests ("hot reads"). This architecture is optimized for read-heavy workloads, letting you scale to 1 million RPS and beyond, with no infrastructure to manage.

Faster

Slower

KV

Perfect for Edge-First Applications

You can use KV to:
View docs

Build Distributed Configuration
Manage feature flags, A/B test variants, and redirect rules globally without managing deployments.

Serve Static Assets
Serve small but critical files like scripts, icons, images, or JSON payloads directly from the edge.

Personalize your app
Store user preferences or routing maps to customize experiences with near-zero latency.

Authorization
Quickly look up API keys or authentication tokens to validate requests before they reach your origin.

Manage Dynamic Data
Store and retrieve complex information as JSON documents, allowing your data structure to evolve easily without complex migrations.

Cloudflare Workers are fast, elastic, and serverless functions that scale automatically from zero to millions of requests

Instant access to the data your functions need. Workers KV stores and serves key-value pairs worldwide in milliseconds – ideal for personalization, configuration, and read-heavy workloads at global scale.

basic.ts ab-tests.ts api-keys.ts proxy.ts

01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16

export default { async fetch(request, env, ctx): Promise<Response> { await env.KV.put('KEY', 'VALUE'); const value = await env.KV.get('KEY'); const allKeys = await env.KV.list(); await env.KV.delete('KEY'); return new Response( JSON.stringify({ value: value, allKeys: allKeys, }), ); },};

01 02 03 04 05 06 07 08 09 10 11 12 13 14 15

export default { async fetch(request, env) { // Get the entire A/B test configuration object from KV const config = await env.CONFIG_STORE.get('homepage-test', 'json'); // Assign user to a group (e.g., based on a cookie or URL) const group = request.headers.get('X-User-Group') || 'control'; // Return the specific configuration for the user's group const variantData = config[group] || config.control; return new Response(JSON.stringify(variantData), { headers: { 'content-type': 'application/json' }, }); },} satisfies ExportedHandler<Env>;

01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22

export default { async fetch(request, env) { // Get Authorization key from request headers const apiKey = request.headers.get('Authorization')?.replace('Bearer ', ''); if (!apiKey) { return new Response('Authorization header missing', { status: 401 }); } // Check if the API key is valid and get associated metadata const keyData = await env.API_KEYS.get(apiKey, 'json'); if (keyData && keyData.enabled) { // Key is valid, add user info to the request and fetch the origin const newHeaders = new Headers(request.headers); newHeaders.set('X-User-ID', keyData.userId); return fetch(request, { headers: newHeaders }); } return new Response('Invalid API Key', { status: 403 }); },} satisfies ExportedHandler<Env>;

01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23

export default { async fetch(request, env) { const url = new URL(request.url); const path = url.pathname; // e.g., "/api/users" // Look up the path prefix (e.g., "/api") to find the correct origin hostname const pathPrefix = '/' + path.split('/')[1]; const originHostname = await env.ROUTING_RULES.get(pathPrefix); if (originHostname) { // Construct the new URL for the backend service const newUrl = new URL(url); newUrl.hostname = originHostname; // Act as a reverse proxy: fetch the content from the backend // and return it to the original client. return fetch(newUrl.toString(), request); } // If no route matches, return a 404 or forward to a default origin return new Response('Service not found for this path', { status: 404 }); },} satisfies ExportedHandler<Env>;

Store and retrieve data globally
Write, read, list, and delete key-value pairs from any Worker using a simple API. Ideal for configuration, personalization, and low-latency lookups.

Power A/B Tests from the Edge
Use Workers KV to store and serve configuration data, like A/B test variants. Fetch a JSON object containing your test parameters and dynamically alter your application's response with minimal latency.

Verify API Keys Instantly
Secure your endpoints by validating API keys or authentication tokens at the edge. Before a request hits your origin, a Worker can check the key against a KV store, blocking unauthorized traffic with zero latency.

Route Requests with a Dynamic Reverse Proxy
Use Workers KV to maintain a dynamic routing table at the edge. Map incoming paths to different backend services or origins without redeploying your Worker. This allows you to seamlessly shift traffic, canary release new versions, or build a multi-service architecture behind a single domain.

Leagued

"

Choosing Cloudflare as our serverless provider was a no-brainer. Workers KV took just 15 minutes to get up and running. The ability to quickly spin up a Worker, deploy it to production, and scale effortlessly has been invaluable. "

Sammi Sinno CEO

Workers KV Pricing

Lightning-fast key-value storage. View Storage & Data pricing details

Component

Free

Paid

Stored Data

Free

1 GB

Paid

$0.50 / GB-month

Read Requests

Free

100,000 / day

Paid

$0.50 / million requests

Write, Delete, List requests

Free

1,000 / day

Paid

$5.00 / million requests

Powerful primitives, seamlessly integrated

Built on systems powering 20% of the Internet, KV runs on the same infrastructure Cloudflare uses to build Cloudflare. Enterprise-grade reliability, security, and performance are standard.

*:first-child]:border-t-0 md:[&>*:nth-child(-n+2)]:border-t-0 lg:[&>*:nth-child(-n+3)]:border-t-0 lg:[&>*:nth-child(3n+1)]:border-l-0 md:[&>*:nth-child(even)]:border-l">

Compute

Browser Run Automated browsers

Containers Any language, anywhere

Durable Objects Stateful compute

Sandboxes Secure code execution

Workers Global serverless functions

Workers for Platforms Programmable Platform Solutions

Workflows Process orchestration

Storage

Artifacts Git-native versioned storage

D1 Serverless SQL

Data Platform Ingest, Catalog & Query

Hyperdrive Global databases

Queues Message processing

R2 Egress-free storage

KV Ultra-fast key-value storage

AI

Agents Build stateful AI agents

AI Gateway AI observability

AI Search Instant retrieval

Vectorize Vector database

Workers AI Edge AI models

SASE / Zero Trust

SASE Cloudflare SASE platform

Access Zero trust access to private resources

CASB SaaS and cloud posture

Data Loss Prevention Protect sensitive data

Gateway Web filtering

Browser Isolation Secure web browsing

WAN Cloud-delivered networking

Email Security Phishing protection

Security

DDoS Protection Mitigation Solutions

Rate Limiting Abuse prevention

SSL Secure Your Site with SSL

Turnstile A CAPTCHA Replacement Solution

WAF Web Application Firewall

Magic Transit DDoS Protection for Networks

Client-Side Security Prevent browser supply chain attacks

Bot Management Block bad bots

Network & Content Delivery

CDN Faster delivery & caching

DNS Fast DNS

Load Balancing Zero downtime

TURN / SFU Real-time infra

Analytics Web Performance & Security

Build without boundaries

Join thousands of developers who've eliminated infrastructure complexity and deployed globally with Cloudflare. Start building for free — no credit card required.

Start building for free View docs

No cold starts or region complexity SASE and Zero Trust without the complexity Deploy to 330+ cities instantly Defend against the Internet's biggest DDoS attacks Predictable pricing without surprises Identity-aware Zero Trust access that retires your VPN Battle-tested infrastructure powering millions CDN, WAF, and DNS faster than the public Internet No cold starts or region complexity SASE and Zero Trust without the complexity Deploy to 330+ cities instantly Defend against the Internet's biggest DDoS attacks Predictable pricing without surprises Identity-aware Zero Trust access that retires your VPN Battle-tested infrastructure powering millions CDN, WAF, and DNS faster than the public Internet

Getting started
Plans Contact sales Partners Find a partner Startups Under attack? Domain name search

Company
About Careers Investors Press Press kit Global network

Public interest
Project Galileo Athenian Project Cloudflare for Campaigns Project Fairshot Impact/ESG

Compliance
Compliance resources Trust Hub Data Protection Responsible AI Transparency report Report abuse

Resources
App innovation report Cloudflare Radar Case studies Status Support Events Blog

Developers
Documentation Learning center Community

Solutions
SSE and SASE platform Cloudflare AI Cloud AI Security Frontend Development Platform Multi-Tenant Platform Development Web Security Platform

Start Building Log In

© 2026 Cloudflare, Inc.

Privacy policy|Report security issues|Terms of use|Trademark
|Your privacy choices

------
导航页打开网址