xmonline/xm-uaa

XM^online 2 Docker镜像文档

镜像概述

XM^online 2 是一款专注于用户账户管理与身份认证的服务器应用，旨在为各类系统提供安全、可靠的用户身份验证及权限控制解决方案。通过Docker镜像部署，可快速集成至现有架构，简化配置流程，提升系统安全性与可维护性。

核心功能与特性

用户账户管理

• 支持用户注册、登录、注销功能
• 提供用户信息查询、创建、更新及删除操作
• 支持用户资料管理（如密码重置、个人信息修改）

身份认证与授权

• 支持多种认证机制（如用户名密码认证、令牌认证）
• 提供基于角色的访问控制（RBAC）
• 支持权限粒度控制（资源级、操作级权限管理）

安全特性

• 密码加密存储，符合安全最佳实践
• 支持登录日志记录与审计
• 提供防暴力破解机制（如登录失败次数限制）

可扩展性

• 支持水平扩展，适应高并发场景
• 提供API接口，便于与第三方系统集成

使用场景

XM^online 2 适用于需要用户身份管理的各类应用场景，包括但不限于：

• 企业内部管理系统的用户认证与权限控制
• Web应用、移动应用的用户登录系统
• 多系统集成环境下的统一身份认证服务
• 对安全性要求较高的***、政务类应用

使用方法

基本部署（Docker Run）

通过以下命令快速启动XM^online 2容器：

bash
docker run -d \
  --name xm-online2-auth \
  -p 8080:8080 \
  -e SPRING_PROFILES_ACTIVE=prod \
  -e SERVER_PORT=8080 \
  docker.xuanyuan.run/xm-online2/auth-server:latest

Docker Compose部署

创建docker-compose.yml文件，配置如下：

yaml
version: '3.8'
services:
  auth-server:
    image: docker.xuanyuan.run/xm-online2/auth-server:latest
    container_name: xm-online2-auth
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=prod
      - SERVER_PORT=8080
      - SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/xm_auth?useSSL=false&serverTimezone=UTC
      - SPRING_DATASOURCE_USERNAME=root
      - SPRING_DATASOURCE_PASSWORD=password
    depends_on:
      - mysql
    restart: unless-stopped

  mysql:
    image: docker.xuanyuan.run/mysql:8.0
    container_name: xm-online2-mysql
    environment:
      - MYSQL_ROOT_PASSWORD=password
      - MYSQL_DATABASE=xm_auth
    volumes:
      - mysql-data:/var/lib/mysql
    ports:
      - "3306:3306"

volumes:
  mysql-data:

启动服务：

bash
docker-compose up -d

配置说明

环境变量参数

数据持久化

为确保用户数据不丢失，建议通过Docker卷挂载数据库目录或配置文件：

bash
docker run -d \
  --name xm-online2-auth \
  -p 8080:8080 \
  -v ./config:/app/config \  # 挂载配置文件目录
  -v ./data:/app/data \      # 挂载数据存储目录
  xm-online2/auth-server:latest

访问服务

服务启动后，可通过以下地址访问API接口（默认端口8080）：

• 基础路径：http://<容器IP或主机IP>:8080/api
• 登录接口：POST /api/auth/login
• 用户管理接口：GET /api/users（需管理员权限）

具体API文档可访问 http://<容器IP>:8080/swagger-ui.html 查看（若已集成Swagger）。