GeekFaka 极客发卡系统

GeekFaka 是一款专为独立开发者、创作者及数字商品卖家打造的 Headless 自动发卡系统。

系统基于 Next.js + React 18 + Prisma 技术栈开发，以简洁优雅的设计，帮你省去数字商品售卖的繁琐流程。

核心特性

• 双模式架构：开发环境适配 SQLite，生产环境支持 MySQL/PostgreSQL，大文本内容自动优化处理
• Docker 一键部署：内置 Node.js 20 版本 Dockerfile 与 Docker-compose 配置，5 分钟内即可完成全环境搭建
• 极客风格 UI：主打极致深色模式，搭配毛玻璃质感设计；商品卡片支持悬停详情预览，全平台响应式适配
• 深度数据仪表盘：集成 ECharts 趋势图，实时展示今日收入、订单统计数据（支持时区优化），并提供缺货预警功能
• 多渠道安全支付网关：内置易支付（EPay）适配器，兼容 MD5、RSA 高安全签名方式，轻松对接主流支付渠道
• 灵活优惠码系统：支持固定金额、百分比两种折扣类型，可绑定特定商品或分类；内置外部批量创建 API
• 自动邮件发货：集成 Resend 服务，用户支付成功后，系统自动将格式化卡密发送至客户邮箱
• 内置 CMS 内容管理：自带文章管理功能，可快速发布购买教程、常见问题、服务协议等配套页面
• 多样化发货格式：支持普通卡密、账号 —- 密码、虚拟卡 (|)、代理 IP (:) 等多种格式，智能分割与展示
• 多重安全加固：后台采用 JWT（JSON Web Token）身份认证，支持 API Key 权限保护，Session 稳定可靠

完整售卖闭环

覆盖商品展示→下单购买→支付对接→自动发货→邮件通知→优惠折扣全流程，让数字商品售卖更简单高效。

小白部署教程，只需4步

如果使用宝塔安装的话可以按以下步骤，这里使用宝塔docker环境部署

1.第一步先下载获取最新的配置文件，这份文件是 Docker Compose 配置文件，用于一键启动 GeekFaka 应用和依赖的 MySQL 数据库

2.下载之后上传到宝塔的网站目录

3.然后就是修改配置文件，按照上面的进行配置

#这里我用以下修改的配置进行演示version: '3'services:  geekfaka:    container_name: geekfaka    image: huangzijian888/geekfaka:latest    restart: always    ports:      - "3007:3000"    environment:      - DATABASE_URL=mysql://yanshi123:yanshi123@mysql:3306/yanshi123      - NEXT_PUBLIC_URL=http://127.0.0.1:3007      - ADMIN_PASSWORD=admin      - COOKIE_NAME=geekfaka_session      - JWT_SECRET=change_me_to_a_random_string # JWT 签名密钥      - COUPON_API_KEY=geekfaka_default_secret_key # 批量创建优惠码的 API KEY    depends_on:      - mysql  mysql:    image: mysql:8.0    container_name: geekfaka-mysql    restart: always    environment:      - MYSQL_ROOT_PASSWORD=aa123456      - MYSQL_DATABASE=yanshi123      - MYSQL_USER=yanshi123      - MYSQL_PASSWORD=yanshi123    ports:      - "3497:3306"    volumes:      - ./mysql_data:/var/lib/mysql    command: --default-authentication-plugin=mysql_native_password

4.修改好后打开目录终端，输入命令启动

docker-compose up -d# 停止并重建容器docker-compose downdocker-compose up -d

最后显示数据库和服务都启动成功，就可以给容器进行反代访问了！！

这里可以用 docker-compose logs -f 容器名字 进行查看运行情况

方式 B：本地源码运行 (适合开发)

安装依赖：

yarn install

环境配置： 复制 .env.example 为 .env：

DATABASE_URL="file:./dev.db"
ADMIN_PASSWORD="admin"
NEXT_PUBLIC_URL="http://localhost:3000"
JWT_SECRET="随机字符串"

初始化与运行：

npx prisma db push
yarn dev