mertdogan/auth-server

authServer

镜像概述

authServer是一个基于JWT（JSON Web Token）的认证REST API服务，用于处理用户认证请求，生成和验证JWT令牌，实现安全的用户身份验证与授权机制。

核心功能

• 提供JWT令牌的生成与验证
• 支持RESTful API接口
• 与MongoDB数据库集成，用于存储用户认证相关数据

使用场景

• 需要用户身份验证的Web应用后端
• 移动应用的API访问授权
• 微服务架构中的服务间认证
• 需要保护API端点的各类应用系统

文档资源

• https://documenter.getpostman.com/view/***/TzeZERnx
• https://github.com/mertdogan12/authServer

环境变量配置

数据库相关

• ASPORT: 数据库端口
• ASDATABASE: 数据库名称
• ASUSER: 数据库用户名
• ASPW: 数据库密码
• ASHOST: 数据库主机地址
• ASURL: MongoDB连接URL，包含以下占位符：
  • <user>: 数据库用户名（替换为ASUSER的值）
  • <password>: 数据库密码（替换为ASPW的值）
  • <port>: 数据库端口（替换为ASPORT的值）
  • <database>: 数据库名称（替换为ASDATABASE的值）
  • <host>: 数据库主机地址（替换为ASHOST的值）

JWT相关

• ASSECRET: JWT签名密钥，用于令牌的生成与验证

使用方法

Docker Run部署

bash
docker run -d \
  -e ASPORT=27017 \
  -e ASDATABASE=authdb \
  -e ASUSER=admin \
  -e ASPW=password123 \
  -e ASHOST=mongodb-host \
  -e ASURL="mongodb://<user>:<password>@<host>:<port>/<database>" \
  -e ASSECRET=your_jwt_secret_key \
  --name auth-server \
  docker.xuanyuan.run/authserver:latest

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  auth-server:
    image: docker.xuanyuan.run/authserver:latest
    environment:
      - ASPORT=27017
      - ASDATABASE=authdb
      - ASUSER=admin
      - ASPW=password123
      - ASHOST=mongodb
      - ASURL=mongodb://<user>:<password>@<host>:<port>/<database>
      - ASSECRET=your_jwt_secret_key
    ports:
      - "3000:3000"
    depends_on:
      - mongodb

  mongodb:
    image: docker.xuanyuan.run/mongo:latest
    ports:
      - "27017:27017"
    volumes:
      - mongodb-data:/data/db

volumes:
  mongodb-data:

注意：部署时需将环境变量中的占位符替换为实际配置值，并确保JWT密钥（ASSECRET）使用高强度随机字符串以保证安全性。