# 0n-decoy 中文文档

规范地址：https://npmcn.com/package/0n-decoy/

版本：1\.4\.0
npm 元数据更新时间：2026-10-29T04:17:34.396Z
中文译文更新时间：2026-10-31T13:29:47.385Z
软件包许可：BUSL-1\.1

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

原始 npm 页面：https://www.npmjs.com/package/0n-decoy
原文对照：https://npmcn.com/package/0n-decoy/?lang=original
项目主页：https://0n3.app/
源码仓库：https://github.com/Crypto-Goatz/0n-decoy

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

- 包体积（解压后）：23.1 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-10-29T03:39:45.382Z
- 最新版本发布：2026-10-29T04:17:34.216Z
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

对AI代理和扫描仪攻击的api进行欺骗：蜂蜜路径、自我验证的金丝雀令牌、可信的假世界、tarpits和警报。从0 n3。

## 安装

```sh
npm install 0n-decoy
```

也可以使用：`pnpm add 0n-decoy`、`yarn add 0n-decoy`、`bun add 0n-decoy`

## README

# 0 n-decoy

对AI代理和扫描器攻击的api进行欺骗。零依赖关系。

真正的防御将攻击者拒之门外。 `0n-decoy` 添加图层 **浪费他们的时间，告诉你他们来了**：

|  | 它是做什么的 |
| --- | --- |
| **蜂蜜的路径** | `/secure-keys`， `/api/vault/export`， `/.env`， `/.git/config`， `/wp-login.php`， `/api/internal/…` (加上 `robotsLures()` 用于robots.txt，以及您自己的私人文件 `extraHoney`) -没有真正的客户要求这些。命中标记将地址标记为24小时。 |
| **金丝雀的令牌** | 看起来和你真正的代币一模一样。认可 **没有数据库**：令牌携带只有你的秘密才能产生的HMAC标签。把它们放在任何地方（文档、CRM笔记、回购）；任何使用都是一个关键的警报，它从哪里泄露。 |
| **假的世界** | 可信的JSON和配置文件，充满了金丝雀凭证和“内部笔记”，可以引导自动代理找到更多的蜂蜜路径。 |
| **限定** | 标记的地址得到缓慢的答复。蛮力-很多 _不同的_ 坏的代币-得到诱饵世界。永久重试的陈旧令牌则不会。 |

它永远不会将虚假数据提供给带有 **有效的** 凭据，永远不会改变真实用户收到的信息，也永远不会被黑客攻击。

```js
import { createDecoy, middleware } from '0n-decoy';

const decoy = createDecoy({
  secret: process.env.DECOY_SECRET,          // keep it OUT of your database
  host: 'api.example.com',
  onEvent: (e) => alertMe(e),                // { kind, severity, ip, path, ... }
});

app.use(middleware(decoy, { checkToken: async (t) => !!(await lookUp(t)) }));

const { token } = decoy.mint('planted in the Q3 board doc');   // a canary to plant
```

`guarded: (path) => boolean` 将标记地址的虚假世界限制在分发数据的路径上，因此对于共享地址的人来说，登录页面保持真实。

**个人链接和永久禁令（1.4）。** 通过 `beaconBase` (可选 `hopUrl`（一个离线页面，如b谷歌Apps Script web应用程序）。然后，每个诱饵都带有该访问者的独特链接。下面是 _任何_ 地址将该地址与访问者绑定，两者都被禁止。禁令也适用于金丝雀使用，私人陷阱命中，或高陷阱得分。 `neverBan(ip)` 保护您信任的地址，例如最近使用有效令牌的地址。

带上你自己的商店（添加） `banned/ban/remember/recall` 用于多实例部署(`get(ip)`， `bump(ip, { weight, flagMinutes, distinct })`); `memoryStore()` 包括在内。

为之构建并运行 [0 n3](https://0n3.app/).

## 常见问题

### 0n-decoy 是什么？

对AI代理和扫描仪攻击的api进行欺骗：蜂蜜路径、自我验证的金丝雀令牌、可信的假世界、tarpits和警报。从0 n3。

### 如何安装 0n-decoy？

在项目目录运行 npm install 0n-decoy，或使用 pnpm add / yarn add / bun add。

### 0n-decoy 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/0n-decoy 是否存在。

### 0n-decoy 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### 0n-decoy 需要什么版本的 Node\.js？

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

### 0n-decoy 可以商用吗？

0n-decoy 使用 BUSL-1\.1 许可。声明的许可为 BUSL-1\.1，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### 0n-decoy 还在维护吗？

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