# @ghostery/trackerdb 中文文档

规范地址：https://npmcn.com/package/%40ghostery/trackerdb/

版本：1\.0\.974
npm 元数据更新时间：2026-11-13T16:46:26.808Z
中文译文更新时间：2026-11-16T07:57:26.870Z
软件包许可：CC-BY-NC-SA-4\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40ghostery/trackerdb
原文对照：https://npmcn.com/package/%40ghostery/trackerdb/?lang=original
项目主页：https://github.com/ghostery/trackerdb#readme
源码仓库：https://github.com/ghostery/trackerdb

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

- 包体积（解压后）：8 MB，13 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0
- 运行依赖：4 个
- 首次发布：2023-02-24T09:30:47.896Z
- 最新版本发布：2026-11-13T16:46:26.442Z
- 近 30 天下载量：7802（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：963（近 12 个月 282 个）

## 中文简介

幽灵追踪器数据库

## 安装

```sh
npm install @ghostery/trackerdb
```

也可以使用：`pnpm add @ghostery/trackerdb`、`yarn add @ghostery/trackerdb`、`bun add @ghostery/trackerdb`

## README

# 幽灵追踪器数据库

透明度是 [幽灵](https://www.ghostery.com/) 经历。 这就是为什么幽灵不只 [区块广告、追踪器和其他烦恼](https://www.ghostery.com/ghostery-ad-blocker),但也显示了在线跟踪如何通过 [命名所有组织](https://whotracks.me/trackers.html) 他们通过互联网参与数据交换.

## 术语

数据交换可以很容易地通过私人识别器发现个人细节,通常被称为跟踪. 然而,并不是一个组织提出的每一项请求都涉及数据收集(即并不是一个组织提出的每一项请求都具有固有的侵犯性)。 组织经常表现出一系列的行为模式,其中一些可能侵犯用户隐私,而另一些则具有良性.

在幽灵里,我们承诺 描述的东西是准确的.

Ghostery Tracker Database的结构很简单,由三个主要要素组成:

-   **类别** - 说吧 [广告、网站分析、同意管理等.](https://npmcn.com/package/%40ghostery/trackerdb/docs/categories.md)
-   **组织** - 公司喜欢 [谷歌](https://npmcn.com/package/%40ghostery/trackerdb/db/organizations/google.eno) 或者说 [元数据](https://npmcn.com/package/%40ghostery/trackerdb/db/organizations/facebook.eno),但也有开源软件,例如 [马多莫](https://npmcn.com/package/%40ghostery/trackerdb/db/organizations/matomo.eno)
-   **模式** - 表达各组织的各种行为。 例如,一个图案: [谷歌分析](https://npmcn.com/package/%40ghostery/trackerdb/db/patterns/google_analytics.eno) 分类为 [站点分析](https://npmcn.com/package/%40ghostery/trackerdb/docs/categories.md#site-analytics)模式 [谷歌标签管理器](https://npmcn.com/package/%40ghostery/trackerdb/db/patterns/google_tag_manager.eno) 分类为 [水电费](https://npmcn.com/package/%40ghostery/trackerdb/docs/categories.md#utilities)。 。 。 .

## 在哪里使用过?

跟踪器数据库用于 [幽灵浏览器扩展](https://www.ghostery.com/ghostery-ad-blocker) 来分类浏览网页时看到的所有请求。 也用来出版 [谁跟踪我](https://whotracks.me/)世界最大的统计报告 追踪在线.

它也被想了解网络数据交换性质的大学,记者,公司所使用.

## SDK 软件

Ghostery Tracker Database 带有一款JavaScript SDK. 样本使用量 :

```js
import { readFileSync } from 'node:fs';
import loadTrackerDB from '@ghostery/trackerdb';

const engine = readFileSync('./node_modules/@ghostery/trackerdb/dist/trackerdb.engine');
const trackerDB = await loadTrackerDB(engine);

const domainMatches = await trackerDB.matchDomain('google.com');

const urlMatches = await trackerDB.matchUrl({
    url: 'https://google.com/gen_204',
    type: 'xhr',
    sourceUrl: 'https://google.com/'
}, {
    getDomainMetadata: true,
});
```

## 国 际

Ghostery Tracker Database也可以在命令行中使用,例如:

```sh
npx @ghostery/trackerdb "https://analytics.tiktok.com"
```

输出 :

```json
{
  "url": "https://analytics.tiktok.com",
  "matches": [
    {
      "pattern": {
        "key": "tiktok_analytics",
        "name": "TikTok Analytics",
        "category": "site_analytics",
        "organization": "bytedance_inc",
        "alias": null,
        "website_url": "https://analytics.tiktok.com",
        "ghostery_id": "4050",
        "domains": [
          "analytics.tiktok.com"
        ],
        "filters": [
          "||analytics.tiktok.com^$3p"
        ]
      },
      "category": {
        "key": "site_analytics",
        "name": "Site Analytics",
        "color": "#87d7ef",
        "description": "Data analytics, site usage, and performance trackers."
      },
      "organization": {
        "key": "bytedance_inc",
        "name": "ByteDance Inc",
        "description": "ByteDance, a Chinese multinational internet technology company headquartered in Beijing and legally domiciled in the Cayman Islands. Its main product is TikTok, known in China as Douyin, a video-focused social networking service.",
        "website_url": "https://www.bytedance.com/",
        "country": "KY",
        "privacy_policy_url": "https://sf16-sg.tiktokcdn.com/obj/eden-sg/upsnuhpevbn/bytedance_official/PrivacyPolicy_ByteDance.com.pdf",
        "privacy_contact": "privacy@bytedance.com",
        "ghostery_id": "5432"
      }
    }
  ]
}
```

## 我怎么能参与进来?

我们鼓励各级开发者作出贡献。 如果你遇到任何错误,比如打字,不准确,或者信息已经过时,请不要犹豫打开一个问题,或者,更好的话,给我们一个拉动请求. 你的反馈很受重视!

如果你是新来的 或者想要一个简单的起点, 看看我们 [良好的第一问题](https://github.com/ghostery/trackerdb/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)这些是方便初学者的任务 帮助你了解我们的项目 如果你对某个问题不肯定或有问题,请在问题评论中自由提问.

### 数据伙伴

非常感谢公司与我们密切合作,提高这个项目的质量。 它们不断作出的贡献对于改进和完善信息至关重要。 我们高度评价他们为实现最高质量而建立的伙伴关系和献身精神!

[![](https://npmcn.com/package/%40ghostery/trackerdb/assets/logo-verified-data.svg)](https://verified-data.com/)

## 许可证发放

Ghostery Tracker 数据库发布于 [CC-BY-NC-SA-4.0 (英语)](https://creativecommons.org/licenses/by-nc-sa/4.0/) 许可证,即可以自由用于非商业性目的。 如果你想用在你的生意上 请联系 [销售量@ghostery.com](mailto:sales@ghostery.com)。 。 。 .

## 常见问题

### @ghostery/trackerdb 是什么？

幽灵追踪器数据库

### 如何安装 @ghostery/trackerdb？

在项目目录运行 npm install @ghostery/trackerdb，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 trackerdb，可以用 npx trackerdb 直接运行。

### @ghostery/trackerdb 支持 TypeScript 吗？

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

### @ghostery/trackerdb 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @ghostery/trackerdb 需要什么版本的 Node\.js？

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

### @ghostery/trackerdb 可以商用吗？

@ghostery/trackerdb 使用 CC-BY-NC-SA-4\.0 许可。声明的许可为 CC-BY-NC-SA-4\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @ghostery/trackerdb 的下载量有多少？

根据 npm 官方下载统计，@ghostery/trackerdb 在 2026/10/17 – 2026/11/15 这 30 天内被下载 7,802 次，日均约 260 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @ghostery/trackerdb 还在维护吗？

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

