讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

剧云
剧云

中文短剧剧本制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

updream

一键生成高质量推广成片

Node.js 实验性权限模型使用指南:安全控制文件访问

星强吖_2701

星强吖_2701

发布时间:2025-11-07 13:18:32

|

856人浏览过

|

来源于php中文网

原创

Node.js 实验性权限模型使用指南:安全控制文件访问

本文深入探讨 node.js 实验性权限模型,旨在解决在使用 `process.permission.has` 时常见的 `typeerror` 和 `err_access_denied` 错误。文章将详细介绍如何启用该模型,并通过 `--allow-fs-read` 和 `--allow-fs-write` 等命令行标志精细控制文件系统访问权限,提供示例代码和最佳实践,帮助开发者安全地管理 node.js 应用的资源访问。

理解 Node.js 实验性权限模型

Node.js v20 引入了一个实验性的权限模型,旨在增强应用程序的安全性,通过限制对特定资源的访问来减少潜在的安全风险。该模型允许开发者在运行时精细控制 Node.js 进程可以访问哪些文件系统路径、子进程、工作线程等。

然而,由于其实验性状态,以及默认的严格限制,初次使用时可能会遇到一些困惑和错误。

启用权限模型与 TypeError

在使用 Node.js 权限模型之前,必须通过命令行标志显式启用它。如果尝试在未启用权限模型的情况下访问 process.permission 对象,将会遇到 TypeError: Cannot read properties of undefined (reading 'has') 错误。这是因为 process.permission 对象仅在启用实验性权限模型时才存在。

错误示例代码:

// app.js
console.log(process.permission.has("fs.read"));

运行方式及错误输出:

node app.js
console.log(process.permission.has("fs.read"));
                               ^

TypeError: Cannot read properties of undefined (reading 'has')
    at file:///path/to/your/app.js:1:32
    # ... (其他堆栈信息)

要解决此 TypeError,您需要使用 --experimental-permission 标志运行 Node.js 应用程序。

默认限制与 ERR_ACCESS_DENIED

启用 --experimental-permission 标志后,Node.js 进程将默认处于高度受限的状态,这意味着它将无法执行任何未明确授权的操作。如果尝试执行文件读取或写入等操作而未授予相应权限,将会收到 Error: Access to this API has been restricted 错误,其 code 属性为 ERR_ACCESS_DENIED。

示例代码 (与上述相同,但运行方式不同):

// app.js
console.log(process.permission.has("fs.read"));

运行方式及错误输出:

node --experimental-permission app.js
node:internal/modules/cjs/loader:179
  const result = internalModuleStat(filename);
                 ^

Error: Access to this API has been restricted
    at stat (node:internal/modules/cjs/loader:179:18)
    at Module._findPath (node:internal/modules/cjs/loader:651:16)
    # ... (其他堆栈信息)
{
  code: 'ERR_ACCESS_DENIED',
  permission: 'FileSystemRead',
  resource: '/path/to/your/app/app.js'
}

这个错误表明,即使启用了权限模型,默认情况下所有文件系统操作(包括读取应用程序自身文件)也是被禁止的。您需要通过额外的命令行标志来授予特定权限。

授予文件系统权限

Node.js 权限模型通过一系列 allow 标志来授予对特定资源的访问权限。对于文件系统操作,最常用的是 --allow-fs-read 和 --allow-fs-write。

授予所有文件系统读写权限

您可以使用 * 通配符来授予所有文件系统读写权限。这在开发和测试阶段可能很有用,但在生产环境中应尽量避免,因为它削弱了权限模型的安全性优势。

JSON Toolkit
JSON Toolkit

JSON文件多功能工具。支持格式化、验证、压缩、键排序及点记法路径查询。零依赖。

下载

示例文件结构:

your-app/
├── index.js
└── a.json

a.json 内容:

{
  "name": "lin"
}

index.js 代码:

// index.js
const fs = require('fs');
const path = require('path');

const aJsonPath = path.resolve(__dirname, './a.json');
const bJsonPath = path.resolve(__dirname, './b.json'); // 假设会创建一个b.json

console.log('Has fs.read permission?', process.permission.has("fs.read"));
console.log('Has fs.write permission?', process.permission.has("fs.write"));

// 尝试读取文件
try {
  const content = fs.readFileSync(aJsonPath, 'utf-8');
  console.log(`JSON content of ${path.basename(aJsonPath)}:`, content);
} catch (error) {
  if (error.code === 'ERR_ACCESS_DENIED') {
    console.error(`Error reading ${path.basename(aJsonPath)}: Access denied.`);
  } else {
    console.error(`Error reading ${path.basename(aJsonPath)}:`, error.message);
  }
}

// 尝试写入文件
try {
  fs.writeFileSync(bJsonPath, JSON.stringify({ status: 'ok' }));
  console.log(`Successfully wrote to ${path.basename(bJsonPath)}`);
} catch (error) {
  if (error.code === 'ERR_ACCESS_DENIED') {
    console.error(`Error writing to ${path.basename(bJsonPath)}: Access denied.`);
  } else {
    console.error(`Error writing to ${path.basename(bJsonPath)}:`, error.message);
  }
}

运行命令 (授予所有读写权限):

node --experimental-permission --allow-fs-read=* --allow-fs-write=* index.js

预期输出:

Has fs.read permission? true
Has fs.write permission? true
JSON content of a.json: {
  "name": "lin"
}
Successfully wrote to b.json

授予特定文件或目录的读写权限

在生产环境中,最佳实践是遵循“最小权限原则”,即只授予应用程序所需的最少权限。您可以通过提供逗号分隔的绝对路径列表来指定允许访问的特定文件或目录。请注意,相对路径是不支持的,必须使用绝对路径。

假设您的 index.js 位于 /home/user/my-app/index.js,a.json 位于 /home/user/my-app/a.json,并且您希望将 b.json 写入 /home/user/my-app/b.json。

运行命令 (授予特定文件读写权限):

node --experimental-permission \
     --allow-fs-read=/home/user/my-app/a.json,/home/user/my-app/index.js \
     --allow-fs-write=/home/user/my-app/b.json \
     /home/user/my-app/index.js

注意: 在上述命令中,/home/user/my-app/index.js 是 Node.js 进程要执行的入口文件,它也需要被授予读取权限。

输出示例 (如果仅授予读取 a.json 和 index.js,但未授予写入 b.json):

node --experimental-permission \
     --allow-fs-read=/home/user/my-app/a.json,/home/user/my-app/index.js \
     /home/user/my-app/index.js
Has fs.read permission? true
Has fs.write permission? false
JSON content of a.json: {
  "name": "lin"
}
Error writing to b.json: Access denied.

此输出清晰地表明,fs.read 权限已授予,因此 a.json 被成功读取。但由于未授予 fs.write 权限给 b.json,写入操作被拒绝,并抛出了 ERR_ACCESS_DENIED 错误。

注意事项与最佳实践

  1. 实验性特性: Node.js 权限模型目前是实验性的。这意味着它的 API 和行为在未来的 Node.js 版本中可能会发生变化。在生产环境中使用时,请密切关注 Node.js 官方文档的更新。
  2. 绝对路径: --allow-fs-read 和 --allow-fs-write 等标志要求提供绝对路径。相对路径将不会生效,并可能导致权限拒绝错误。在构建命令行参数时,请确保正确解析和提供绝对路径。
  3. 最小权限原则: 始终遵循最小权限原则。只授予应用程序执行其任务所需的最低权限。避免使用 * 通配符来授予所有权限,除非是在严格控制的开发或测试环境中。
  4. 细粒度控制: 权限模型允许您指定文件或目录。如果应用程序只需要访问某个目录下的文件,可以指定该目录的绝对路径,例如 --allow-fs-read=/home/user/my-app/data/。
  5. 错误处理: 在代码中对文件系统操作进行适当的错误处理,特别是捕获 ERR_ACCESS_DENIED 错误,以便应用程序能够优雅地处理权限不足的情况。
  6. 其他权限: 除了文件系统权限,Node.js 权限模型还支持其他类型的权限,如网络访问 (--allow-net), 子进程 (--allow-child-process), 工作线程 (--allow-worker) 等。请查阅官方文档以获取完整列表和使用方法。

总结

Node.js 实验性权限模型为开发者提供了一个强大的工具,用于构建更安全的应用程序。通过正确启用 --experimental-permission 标志,并利用 --allow-fs-read 和 --allow-fs-write 等精细控制标志,您可以有效地管理应用程序对文件系统的访问。理解 TypeError 和 ERR_ACCESS_DENIED 错误的原因,并遵循最佳实践,将帮助您充分利用这一安全特性,提升 Node.js 应用的健壮性和安全性。随着该模型的不断发展,它有望成为 Node.js 生态系统中一个重要的安全基石。

热门AI工具

更多
讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

DeepSeek

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

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

WorkBuddy

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

UpDream
UpDream Hot

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

豆包大模型

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

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2395

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3962

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1316

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4599

2025.09.10

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1089

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3640

2023.10.25

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

4998

2023.08.10

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

5136

2023.06.20

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 21.4万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.9万人学习

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

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