ozitag/tager-admin-auth

管理员认证页面Docker镜像文档

镜像概述和主要用途

本Docker镜像提供开箱即用的管理员认证页面解决方案，旨在为Web应用提供基础的管理员身份验证功能。镜像内置简洁的登录界面、身份验证逻辑及权限控制基础组件，帮助开发者快速为各类Web应用添加管理员访问控制机制，无需从零开发认证页面。

核心功能和特性

• 简洁登录界面：包含用户名、密码输入框及登录按钮的直观表单设计，适配主流浏览器
• 基础身份验证：支持基于用户名/密码的身份验证逻辑，验证通过后允许访问受保护资源
• 可配置参数：通过环境变量自定义管理员用户名、密码、页面标题等核心认证参数
• 轻量级设计：基于轻量级Web服务构建，资源占用低（启动内存<50MB），启动速度快（<10秒）
• 易于集成：支持端口映射、反向代理等方式与现有Web应用无缝集成，兼容主流Web服务器（Nginx、Apache等）

使用场景和适用范围

• 后台管理系统：为CMS、CRM等后台系统提供管理员登录入口
• 内容管理平台：控制对内容编辑、发布等管理功能的访问权限
• 企业内部系统：保护员工信息管理、数据统计等敏感功能的访问安全
• 快速原型开发：项目初期快速搭建基础认证功能，降低开发周期和成本

使用方法和配置说明

环境变量配置

Docker Run 部署示例

bash
docker run -d \
  --name admin-auth-page \
  -p 8080:80 \
  -e ADMIN_USER="admin" \
  -e ADMIN_PASSWORD="SecurePass123!" \
  -e LOGIN_TITLE="系统管理员登录" \
  -e SUCCESS_REDIRECT="/admin" \
  [镜像名称]:[版本标签]

Docker Compose 配置示例

yaml
version: '3.8'
services:
  admin-auth:
    image: [镜像名称]:[版本标签]
    container_name: admin-auth-page
    ports:
      - "8080:80"
    environment:
      - ADMIN_USER=admin
      - ADMIN_PASSWORD=SecurePass123!
      - LOGIN_TITLE=系统管理员登录
      - SUCCESS_REDIRECT=/admin
    restart: unless-stopped
    networks:
      - app-network

networks:
  app-network:
    driver: bridge

访问与验证

容器启动后，通过 http://<服务器IP>:8080 访问登录页面，输入配置的用户名（ADMIN_USER）和密码（ADMIN_PASSWORD）进行验证。验证通过后，系统将自动重定向至 SUCCESS_REDIRECT 配置的URL。

注意事项

• 生产环境中必须修改默认密码（ADMIN_PASSWORD），建议使用包含大小写字母、数字及特殊字符的强密码
• 建议通过HTTPS访问认证页面，可配合Nginx反向代理配置SSL证书
• 如需多角色或细粒度权限控制，需结合外部认证服务（如OAuth2、LDAP）扩展功能
• 容器日志可通过 docker logs admin-auth-page 查看，用于排查登录失败等问题