如何在前端 JavaScript 中安全使用环境变量

胖磊酱_8793

胖磊酱_8793

2026-11-22

252人浏览

原创

如何在前端 JavaScript 中安全使用环境变量

本文详解在纯 HTML + JS 项目中,如何安全地将 .env 文件中的非敏感配置注入客户端脚本,重点规避直接暴露密钥的风险,并对比 Webpack、Vite、React 等主流方案的适用边界与最佳实践。

本文详解在纯 html + js 项目中,如何安全地将 `.env` 文件中的非敏感配置注入客户端脚本,重点规避直接暴露密钥的风险,并对比 webpack、vite、react 等主流方案的适用边界与最佳实践。

在前端 JavaScript 中直接使用 process.env.Token(如你代码中所示)无法生效——因为浏览器环境没有 Node.js 的 process 对象,process.env 是服务端或构建时概念,客户端运行时根本不存在该全局变量。更关键的是:任何硬编码或通过构建工具“注入”到前端代码中的密钥(如 X-App-Token),一旦进入浏览器,即等同于公开。这违反了基本安全原则:服务端密钥绝不应出现在客户端可读代码中。

因此,解决该问题必须区分两类场景:

✅ 场景一:变量为「非敏感配置」(推荐前端注入)

例如 API 基础路径、功能开关、应用版本号等可公开信息。此时可借助构建工具安全注入:

  • Webpack + dotenv-webpack 插件(你已配置)
    你当前的 webpack.config.js 已启用 Dotenv(),但需注意:

    • dotenv-webpack 默认仅注入 process.env.* 到模块作用域,不自动挂载到全局 window;
    • 你的 applicant.js 是直接通过 <script src></script> 引入的未打包裸文件,Webpack 配置对其完全无效(Webpack 只处理 entry 指定的入口文件并生成 bundle.js)。

    ✅ 正确做法:

    dotenvx 安全环境变量管理器和加密器
    dotenvx 安全环境变量管理器和加密器

    dotenvx 是由 dotenv 的创建者推出的_secure、跨平台环境变量管理器。它提供加密的 .env 文件、多环境支持,并通过其 CLI 运行器与任何编程语言或框架配合使用。

    下载
    1. 将 applicant.js 改为 Webpack 入口,构建后引入 dist/bundle.js;
    2. 在 JS 中直接使用 process.env.Token(Webpack 会将其替换为字符串字面量);
    3. 但前提是 .env 中的 Token 必须是非敏感值(如测试用公钥),否则仍危险。
    // .env(仅限非敏感值!)
    TOKEN=public-test-token-abc123
    
    // applicant.js(Webpack 构建后,process.env.TOKEN → "public-test-token-abc123")
    const token = process.env.TOKEN; // ✅ 安全(若值本身可公开)
  • Vite(更简洁)
    Vite 原生支持 .env,且仅暴露 VITE_ 开头变量:

    # .env
    VITE_API_BASE_URL=https://api.sumsub.com
    # TOKEN 不以 VITE_ 开头 → ❌ 不会被注入!
    // 直接在 JS 中使用(构建时替换,无 runtime 依赖)
    fetch(`${import.meta.env.VITE_API_BASE_URL}/resources/applicants`, {
      headers: { 'X-App-Token': import.meta.env.VITE_PUBLIC_TOKEN } // ✅ 仅当此 token 允许公开
    });

⚠️ 场景二:变量为「敏感密钥」(必须服务端代理)

你示例中的 X-App-Token 极大概率是 SumSub 的私有 API Token,绝不可暴露给前端。正确架构应为:

Browser → Your Backend (e.g., Django/Express) → SumSub API
  • 前端只调用你自己的 /api/applicant 接口;
  • 后端从 .env 读取 SUMSUB_TOKEN,拼装完整请求并转发;
  • 前端 JS 完全不接触任何密钥。
// applicant.js(安全版)
document.getElementById('getstarted').addEventListener('click', () => {
  // 调用你自己的后端接口,而非 SumSub 直连
  fetch('/api/applicant', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ externalUserId: '1234EERF', email: 'user@example.com' })
  })
  .then(r => r.json())
  .then(console.log)
  .catch(console.error);
});
# Django views.py(服务端代理)
from django.http import JsonResponse
from django.views.decorators.csrf import csrf_exempt
import requests
import os

@csrf_exempt
def create_applicant(request):
    if request.method == 'POST':
        data = json.loads(request.body)
        # ✅ 服务端安全读取密钥
        token = os.getenv('SUMSUB_TOKEN')
        response = requests.post(
            'https://api.sumsub.com/resources/applicants',
            json=data,
            headers={
                'Content-Type': 'application/json',
                'X-App-Token': token
            }
        )
        return JsonResponse(response.json(), status=response.status_code)

? 关键总结与注意事项

  • 永远不要在前端代码中存放真实 API 密钥:process.env.Token 在浏览器中是 undefined,即使 Webpack 注入也等于公开密钥;
  • .env 文件仅对构建工具/服务端有效:纯静态 HTML 引入的 JS 无法访问它,必须通过构建流程(Webpack/Vite)或服务端渲染(Django 模板)传递;
  • 若必须前端配置,请严格区分敏感性:
    • ✅ 允许:VITE_API_URL, REACT_APP_FEATURE_FLAG(Vite/React CRA);
    • ❌ 禁止:VITE_SUMSUB_TOKEN, REACT_APP_DB_PASSWORD;
  • 生产环境务必验证:构建后检查 bundle.js 源码,确认敏感值未被意外写入;
  • 替代方案:对高安全要求场景,使用 OAuth 令牌交换、短期 JWT 或后端签发临时凭证,彻底避免前端持有长期密钥。

安全不是功能,而是架构基石——让密钥留在服务器,让前端只做它该做的事。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3163

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

6943

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7750

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

7738

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

1103

5

js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

6186

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1469

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

6104

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

1100

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.6万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.9万人学习