timdoddcool/cookiedialog

CookieDialog镜像文档

镜像概述

CookieDialog镜像是基于同名开源库的自托管版本，提供轻量级、可定制的GDPR Cookie同意对话框解决方案。该镜像支持直接部署展示文档，或集成到网站中实现Cookie合规管理，零依赖且易于使用。

核心功能

• 轻量级：压缩后小于20KB，不影响页面加载速度
• 地理位置检测：自动识别用户是否位于GDPR适用区域（欧盟/欧洲经济区）
• 本地存储：持久化保存用户的Cookie同意状态
• 高度可定制：支持多种主题、自定义翻译及Cookie分类配置
• 响应式设计：适配移动端与桌面端
• 零依赖：纯JavaScript实现，无需额外库
• 简单集成：支持CDN或NPM安装方式

使用场景

• 面向欧洲用户的网站，需展示Cookie同意弹窗以符合GDPR合规要求
• 需要自定义Cookie分类（如必要Cookie、分析Cookie、营销Cookie）的网站
• 希望减少第三方依赖，选择自托管Cookie解决方案的场景

配置说明

CDN集成

在HTML中添加以下代码：

html
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/cookiedialog@1.0.3/dist/cookiedialog.min.css">
<script src="https://cdn.jsdelivr.net/npm/cookiedialog@1.0.3/dist/cookiedialog.min.js"></script>

<script>
  CookieDialog.init({
    enableLocation: true,
    privacyUrl: '/privacy',
    onAccept: (consent) => {
      console.log('用户同意Cookie:', consent);
    }
  });
</script>

NPM集成

bash
npm install cookiedialog

javascript
import CookieDialog from 'cookiedialog';
import 'cookiedialog/dist/cookiedialog.min.css';

const dialog = new CookieDialog({
  enableLocation: true,
  theme: 'dark',
  position: 'bottom'
});

dialog.init();

Docker部署示例

直接运行

bash
docker run -p 8080:80 docker.xuanyuan.run/timdoddcool/cookiedialog:latest

访问 http://localhost:8080 查看文档。

许可证

本镜像基于MIT许可证，详情见https://opensource.org/licenses/MIT%E3%80%82