@c15t/backend

中文文档
3.2.2发布于 2026/11/02Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 42.8万

C15t自备后端. 在Postgres、MySQL或SQLite上存储同意记录和审计日志并解决政策和地理定位问题.

中文使用文档
文档目录10 节
  1. 关键特性
  2. 先决条件
  3. 安装
  4. 使用量
  5. 文档
  6. 主办或自有
  7. 支助
  8. 捐款
  9. 警卫
  10. 许可证

c15t: the open standard for cookie banners

@c15t/后端:自行托管的同意管理后端

Latest NPM Version Stars License Discord Skills Made by Inth

在您的服务器和数据库中运行 c15t cookie 同意后端 。 它解决了GDPR和其他隐私法的同意政策,存储同意记录和审计历史,并通过一个网络为每个c15t前端服务 Request 处理者.

c15t用于 2 100个以上地点包括expo.dev, sed.dev, unkey.dev, mintlify.com, 和 sazabi.com.

关键特性

  • 您拥有数据: 同意记录保留在您的 PostgreSQL 、 MySQL 或 SQLite 数据库中
  • 按区域划分的政策规则,包括: policyRulePresets.europeOptIn()
  • 一个网络标准 Request 改为 Response 在 Next.js 、 Nuxt 、 SvelteKit 、 TanStack Start 或任何服务器上挂载的处理器
  • 从主机头、服务器侧翻译和审计日志中定位
  • IAB TCF配置与全球供应商名单和定制供应商
  • 与 Inth 相同的 API, 因此前端只更改后端 URL

先决条件

  • 节点.js 20.19或以后
  • PostgreSQL, MySQL, 或 SQLite 数据库, 加上其驱动程序 : @effect/sql-pg, (中文(简体) ), @effect/sql-mysql2,或 @effect/sql-sqlite-node
  • 一个运行 Node.js 的服务器. 静态导出无法运行后端

安装

pnpm add @c15t/backend @effect/sql-sqlite-node

安装后端列为对等依赖的驱动程序版本 。 不想运行数据库吗 ? 输入 为您运行此后端.

使用量

  1. 创建 c15t-backend.config.ts 与您的数据库、 信任的来源和政策规则
// c15t-backend.config.ts
import { defineConfig, policyRulePresets } from '@c15t/backend'

export default defineConfig({
  database: { dialect: 'sqlite', filename: './consent.db' },
  trustedOrigins: ['localhost'],
  manifest: { policyRules: [policyRulePresets.europeOptIn()] },
})
  1. 创建计划 : npx @c15t/cli self-host migrate --config ./c15t-backend.config.ts --plan,然后运行它再次 --apply
  2. 将操作员挂载在全程路线上 GET, (中文(简体) ), POST, (中文(简体) ), PUT, (中文(简体) ), PATCH,以及 OPTIONS
// app/api/c15t/[[...path]]/route.ts (Next.js)
import { c15tInstance } from '@c15t/backend'

import config from '../../../../c15t-backend.config'

export const runtime = 'nodejs'
const backend = c15tInstance({ ...config, basePath: '/api/c15t' })

export const GET = (request: Request) => backend.handler(request)
export const POST = GET
export const PUT = GET
export const PATCH = GET
export const OPTIONS = GET
  1. 将您的前端指向后端 URL, 例如 https://app.example.com/api/c15t,其中快速启动请求获取 Inth URL
  2. 其他服务器,PostgreSQL和部署检查,见 自主办指南

文档

见 文档 用于指南、API参考和示例.

主办或自有

当您需要自己运行服务及其数据库时, 自动托管 。 然后,您拥有供给、迁移、备份、政策配置、签名秘密、可用性和升级.

输入 为您运行相同的后端, 并有一个仪表板, 审计历史, 和管理的IAB CMP ID。 你前端的密码是相同的.

支助

捐款

警卫

不为安全弱点打开一个公共问题。 私下通过报告 GitHub 的脆弱性报告我们审查所有的报告.

  • 不在公共论坛、议题或请求中分担脆弱性
  • 给它复制的步骤 和它影响的版本
  • 在你透露之前给我们点时间

许可证

Apache 许可证 2.0


由 输入

版本与发布记录

@c15t/backend 共发布 108 个版本,首次发布于 2025/03/12;过去 12 个月发布了 48 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
3.2.2latest2026/11/027 天前
3.2.12026/10/319 天前
3.2.02026/10/3010 天前
3.2.0-canary.0canary2026/10/2316 天前
3.1.02026/10/1723 天前
3.1.0-canary.02026/10/1525 天前

其他发布通道:rc → 2.0.0-rc.10,alpha → 3.0.0-alpha.12,canary → 3.2.0-canary.0。

关于 @c15t/backend 的常见问题

@c15t/backend 是什么?

C15t自备后端. 在Postgres、MySQL或SQLite上存储同意记录和审计日志并解决政策和地理定位问题.

如何安装 @c15t/backend?

在项目目录运行 npm install @c15t/backend,或使用 pnpm add / yarn add / bun add。

@c15t/backend 支持 TypeScript 吗?

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

@c15t/backend 支持 ESM 还是 CommonJS?

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

@c15t/backend 可以商用吗?

@c15t/backend 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@c15t/backend 的下载量有多少?

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

@c15t/backend 还在维护吗?

最新版本 3.2.2 发布于 2026/11/02(7 天前);至今共发布 108 个版本,其中过去 12 个月发布了 48 个;首次发布于 2025/03/12。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。