hboahen/k8s-demo-api

Acquisitions API Docker镜像

一个生产就绪、安全的RESTful API镜像，用于管理用户获取，具备JWT认证、角色访问控制及Arcjet提供的高级安全特性。

快速开始

bash
docker pull hboahen/k8s-demo-api:latest

Linux环境运行：

bash
docker run -p 3000:3000 \
  -e DATABASE_URL="你的PostgreSQL连接地址" \
  -e JWT_SECRET="你的JWT密钥" \
  -e ARCJET_KEY="你的Arcjet密钥" \
  hboahen/k8s-demo-api:latest

Windows环境运行：

bash
docker run -p 3000:3000 `
  -e DATABASE_URL="你的PostgreSQL连接地址" `
  -e JWT_SECRET="你的JWT密钥" `
  -e ARCJET_KEY="你的Arcjet密钥" `
  hboahen/k8s-demo-api:latest

核心功能

• 认证与授权：基于JWT的身份验证，支持角色访问控制（管理员、用户、访客）
• 高级安全：Arcjet防护（限流、机器人检测、***防护）、Helmet.js安全头、bcrypt密码哈希
• 数据库支持：PostgreSQL数据库，使用Drizzle ORM及Neon数据库兼容
• 生产就绪：全面日志（Winston/Morgan）、错误处理、数据验证（Zod）
• RESTful API：用户CRUD操作及受保护端点
• 健康监控：内置健康检查端点

环境变量

API端点

健康与状态

• GET /health - 健康检查
• GET /api - API状态

认证

• POST /api/auth/sign-up - 注册新用户
• POST /api/auth/sign-in - 登录并获取JWT令牌
• POST /api/auth/sign-out - 登出

用户（受保护）

• GET /api/users - 列出所有用户（仅管理员）
• GET /api/users/:id - 根据ID获取用户（需认证）
• PUT /api/users/:id - 更新用户（需认证）
• DELETE /api/users/:id - 删除用户（仅管理员）

Docker Compose示例

yaml
services:
  api:
    image: hboahen/k8s-demo-api:latest
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
      - PORT=3000
      - DATABASE_URL=${DATABASE_URL}
      - JWT_SECRET=${JWT_SECRET}
      - JWT_EXPIRES_IN=24h
      - ARCJET_KEY=${ARCJET_KEY}
    restart: unless-stopped

安全特性

• 限流：基于角色的限流策略（管理员：20次/分钟，用户：10次/分钟，访客：5次/分钟）
• 机器人防护：自动检测并阻止机器人访问
• 防护：防御常见Web
• 安全头：Helmet.js配置
• 密码安全：bcrypt哈希加盐处理
• CORS与Cookie安全：可配置的CORS及安全Cookie解析

技术栈

• Node.js（ES Modules）+ Express.js v5
• PostgreSQL + Drizzle ORM
• Arcjet安全平台
• JWT认证
• Winston/Morgan日志
• Zod数据验证

健康检查

容器内置健康检查端点/health，返回结果示例：

json
{
  "status": "ok",
  "timestamp": "2025-12-30T...",
  "uptime": 123.456
}

支持标签

• latest - 最新稳定版本
• v1.0.0 - 特定版本标签
• development - 开发构建版本

文档

完整文档：https://github.com/Hboahen42/acquistions

许可

ISC

支持

• 问题反馈：https://github.com/Hboahen42/acquistions/issues
• 代码仓库：https://github.com/Hboahen42/acquistions

---