如何在Cloudflare Workers无服务器函数中读取环境密钥

DevOps 小满

2026-7-14

在Cloudflare Workers中读取密钥的正确方法

在Cloudflare Workers里读取密钥其实有标准且安全的方式，下面是两种常用方法，以及需要避开的误区：

方法1：使用Cloudflare Secrets（敏感数据首选）

这是官方推荐的存储敏感密钥的方式，密钥会被加密存储，不会以明文形式出现在控制台或代码仓库中。

配置步骤：
1. 登录Cloudflare控制台，进入你的Worker服务页面
2. 切换到「Settings」→「Variables」标签页
3. 找到「Secrets」区域，点击「Add secret」
4. 输入密钥名称（比如MY_PRIVATE_KEY）和对应的密钥值，确认保存
5. 在Worker代码中直接通过env对象读取：

export default {
  async fetch(request, env, ctx) {
    // 直接读取机密密钥
    const privateKey = env.MY_PRIVATE_KEY;
    // 这里编写使用密钥的业务逻辑，比如调用第三方API
    return new Response("密钥读取完成（示例，实际不会返回密钥内容）");
  },
};

方法2：使用普通环境变量绑定（非敏感配置用）

如果是不需要加密的普通配置项（比如API地址、调试开关），可以用普通环境变量：

配置步骤：
1. 同样在Worker服务的「Settings」→「Variables」标签页
2. 找到「Environment Variables」区域，点击「Add variable」
3. 输入变量名和对应值，选择是否同步部署到所有环境（生产/预览）
4. 代码中通过env对象读取：

export default {
  async fetch(request, env, ctx) {
    const apiBaseUrl = env.API_BASE_URL;
    return new Response(`当前API地址：${apiBaseUrl}`);
  },
};