讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

剧云
剧云

中文短剧剧本制作平台

AniShort
AniShort

AI短剧协同制作平台

Seko
Seko

AI短剧一键生成成片

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

胖磊酱_8793

胖磊酱_8793

发布时间:2026-11-22 16:44:04

|

252人浏览过

|

来源于php中文网

原创

如何在前端 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 运行器与任何编程语言或框架配合使用。

    下载

    立即学习“Java免费学习笔记(深入)”;

    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 或后端签发临时凭证,彻底避免前端持有长期密钥。

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

热门AI工具

更多
Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

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

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

3163

2023.08.11

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

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

6943

2023.10.09

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

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

7750

2024.03.19

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

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

7738

2024.03.22

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

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

1103

2024.05.22

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

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

6186

2023.06.20

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

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

1469

2023.07.04

js四舍五入
js四舍五入

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

6104

2023.07.04

CVE-2026-114938高危漏洞修复
CVE-2026-114938高危漏洞修复

Java4Shell是OpenJDK Base64解码路径中的远程代码执行漏洞,编号CVE-2026-114938,2026年11月17日披露,官方已发布17.0.21.1、21.0.13.1等修复版本,建议优先升级 。本专题围绕Java4Shell(CVE-2026-114938)持续更新,从漏洞原理、受影响版本、受影响产品到修复与自查一站式汇总,适合Java开发、运维与安全人员快速定位风险。ARM64环境不受影响,x86-64环境请

0

2026.11.22

热门下载

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

精品课程

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

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.6万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn