user-portal-login 镜像文档

镜像概述

user-portal-login 是一个专注于提供用户门户登录功能的Docker镜像，旨在简化Web应用或系统中用户登录模块的构建流程。该镜像封装了登录界面展示、用户身份验证及会话管理等核心能力，可快速集成至各类需要用户登录功能的场景，提供安全、标准化的登录体验。

核心功能与特性

• 用户认证支持：集成基础用户身份验证机制，支持用户名密码校验
• 登录界面展示：内置简洁的登录界面模板，支持自定义样式配置
• 会话管理：提供基础会话创建与维护功能，保障登录状态有效性
• 轻量部署：容器化设计，支持快速启动与横向扩展，降低部署复杂度

使用场景与适用范围

• 企业内部管理系统的用户登录入口
• Web应用的统一登录门户
• 需快速集成基础登录功能的中小规模项目
• 作为认证服务前置模块，与后端用户管理系统配合使用

使用方法

基础运行命令

通过以下命令可快速启动容器：

bash
docker run -d -p 8080:80 --name user-login-portal user-portal-login

启动后，可通过 http://localhost:8080 访问登录界面。

环境变量配置

示例（自定义端口与会话超时）：

bash
docker run -d -p 3000:3000 \
  -e PORT=3000 \
  -e SESSION_TIMEOUT=60 \
  --name user-login-portal user-portal-login

数据持久化（可选）

若需持久化存储登录日志或配置，可挂载数据卷：

bash
docker run -d -p 8080:80 \
  -v ./login-config:/app/config \
  -v ./login-logs:/app/logs \
  --name user-login-portal user-portal-login

注意事项

• 生产环境中建议结合HTTPS使用，确保数据传输安全
• 当AUTH_MODE为ldap时，需额外配置LDAP服务连接参数（如LDAP_URL、LDAP_BASE_DN等）
• 建议通过环境变量或配置文件自定义登录界面样式，以匹配应用整体风格