# @datadog/native-appsec 中文文档

规范地址：https://npmcn.com/package/%40datadog/native-appsec/

版本：12\.0\.0
npm 元数据更新时间：2026-11-10T14:55:25.979Z
中文译文更新时间：2026-11-11T13:22:44.649Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40datadog/native-appsec
原文对照：https://npmcn.com/package/%40datadog/native-appsec/?lang=original
项目主页：https://github.com/DataDog/dd-native-appsec-js#readme
源码仓库：https://github.com/DataDog/dd-native-appsec-js

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：20.1 MB，17 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：1 个
- 首次发布：2021-09-23T07:59:47.188Z
- 最新版本发布：2026-11-10T14:55:25.626Z
- 近 30 天下载量：50727775（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：53（近 12 个月 4 个）

## 中文简介

Libdwaf 的节点绑定

## 安装

```sh
npm install @datadog/native-appsec
```

也可以使用：`pnpm add @datadog/native-appsec`、`yarn add @datadog/native-appsec`、`bun add @datadog/native-appsec`

## README

# dd- native-appsec-js (英语)

节点.js 绑定 [自由妇女](https://github.com/datadog/libddwaf)。 。 。 .

# 支持的平台

此软件包支持以下平台:

-   **节点.js 版本 :** 18岁及以上
-   **操作系统:**
    -   macOS 14.2.1及以上(捆绑的libdwaf的最低目标)
        -   x64 (韩语)
        -   军火64
    -   窗口
        -   编号x86
        -   x64 (韩语)
    -   链接
        -   x64 有 glibc
        -   x64 有黏膜
        -   军火64

因此,不支持的平台包括:

-   Linux x86 函数
-   手臂32
-   第十六届
-   太平洋共同体理事会

请随意 [联系支持](https://docs.datadoghq.com/help) 如果您想请求支持一个新的平台.

# 向本地应用程序迁移 12

这个版本捆绑了libddwaf 2.2.0并更改了评价API. `context.run(data, timeout)` 现在直接收到地址映射。 前一个 `{ persistent, ephemeral }` 信封不再被支持 。 关于范围数据, 创建子连接符 `context.createSubcontext()`,称为 `run(data, timeout)` 方法,并处理 `finally`。子文本继承父数据并保存 它自己的数据和评价在当地产生影响。 它能活过父母.

`createContext()` 返回时 `null` 没有活动规则的,包括后面 删除所有配置。 被拒绝的同道替代也可以删除 上一个配置; 呼叫者必须检查诊断和配置 在决定是否恢复后退规则时,路径。 拒绝的映射配置 全部从建构器中移除,包括路径和任何部分装入 内容。 顶级解析失败报告于 `diagnostics.error`。 。 。 . 如果重建没有产生手柄, 新的环境也会返回 `null`; 绑定 不区分一个空规则组和其他构建失败,也不保留一个陈旧的手柄.

持续时间为纳秒;超时输入为微秒. 动作是按动作类型键取的映射.

## 责任

| 本地应用程序 | dd- trace-js (英语) |
| --- | --- |
| 原生手柄、分配器、最后敲定器和安全调配 | 请求和运行寿命,包括明确处置 |
| 背景和子背景评价原始 | 持续/范围大的投入路线、评价命令和共享的暂停预算 |
| 初步结果、诊断和截断测量 | 成果汇总、封锁、报告和遥测 |
| 配置绑定和参数验证 | 远程配置、倒置政策和已知地址过滤 |

Dd-trace-js 依赖性升级必须随同 API 迁移一起进行. 长期和范围评价的混合需要明确的成果汇总和 在跟踪器中共享时间预算。 本地约束并不推断这些政策.

## 转换和配置限制

评价数据限于每串4096字节,每个容器256个条目, 和20级的巢穴。 字符串截取保留了完整的UTF-8代码点. 截断量度计报告原尺寸. dd -trace -js拥有出口这些测量.

配置容器不受请求大小限制。 利布德瓦夫2.1级 大型容器 API 支持超过65535条目的配置阵列和地图.

调压器配置直接传递给libdwaf. 具有约束力的报告 构建器结果和诊断没有额外的正则克ex验证.

## 常见问题

### @datadog/native-appsec 是什么？

Libdwaf 的节点绑定

### 如何安装 @datadog/native-appsec？

在项目目录运行 npm install @datadog/native-appsec，或使用 pnpm add / yarn add / bun add。

### @datadog/native-appsec 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @datadog/native-appsec 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @datadog/native-appsec 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @datadog/native-appsec 可以商用吗？

@datadog/native-appsec 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @datadog/native-appsec 的下载量有多少？

根据 npm 官方下载统计，@datadog/native-appsec 在 2026/10/12 – 2026/11/10 这 30 天内被下载 50,727,775 次，日均约 1,690,926 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @datadog/native-appsec 还在维护吗？

最新版本 12\.0\.0 发布于 2026/11/10（今天）；至今共发布 53 个版本，其中过去 12 个月发布了 4 个；首次发布于 2021/09/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。