muidea/magiccas Docker 镜像 - 轩辕镜像

magicCas Docker镜像文档

镜像概述

magicCas是一款基于Docker容器化的中央认证服务(CAS)解决方案，旨在提供安全、高效的单点登录(SSO)能力。该镜像封装了CAS服务核心组件，简化了传统CAS服务的部署流程，支持快速集成到企业现有IT架构中，实现多应用系统的统一身份认证与授权管理。

核心功能与特性

• 单点登录(SSO)支持：用户一次认证即可访问所有集成的应用系统，提升用户体验与安全性
• 多协议兼容：支持CAS、OAuth2.0、SAML2.0等主流认证协议，适配不同应用场景
• 灵活认证策略：支持用户名密码、LDAP、数据库、OAuth第三方登录等多种认证方式
• 可扩展架构：模块化设计，支持自定义认证逻辑与权限控制策略
• 容器化部署：轻量级镜像，启动快速，资源占用低，支持水平扩展
• 配置持久化：支持外部配置文件挂载，便于个性化配置与版本管理

使用场景与适用范围

• 企业内部多系统统一身份认证
• 云服务平台用户访问控制
• 教育机构多应用单点登录系统
• ***/事业单位跨系统身份整合
• 需要高安全性与便捷用户体验的认证场景

使用方法与配置说明

基本部署

使用以下命令快速启动magicCas服务：

bash
docker run -d \
  --name magiccas \
  -p 8080:8080 \
  -e CAS_SERVER_NAME=[***] \
  -v /path/to/config:/cas/config \
  magiccas:latest

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  magiccas:
    image: magiccas:latest
    container_name: magiccas
    ports:
      - "8080:8080"
      - "8443:8443"  # 若启用HTTPS
    environment:
      - CAS_SERVER_NAME=[***]
      - CAS_ADMIN_USER=admin
      - CAS_ADMIN_PASSWORD=securepassword
    volumes:
      - ./config:/cas/config
      - ./data:/cas/data
    restart: always

启动服务：

bash
docker-compose up -d

核心环境变量配置

配置文件挂载

通过挂载外部配置目录(/cas/config)，可自定义CAS服务配置，主要配置文件包括：

• cas.properties：CAS核心配置
• services/：应用服务注册配置
• themes/：自定义主题与界面样式

访问与验证

服务启动后，通过以下地址访问CAS控制台：

• CAS登录页：http://<服务器IP>:8080/cas/login
• 管理员控制台：http://<服务器IP>:8080/cas/admin

使用配置的管理员账号密码登录，即可进行应用注册、认证策略配置等操作。

注意事项

• 生产环境中必须启用HTTPS，避免明文传输敏感信息
• 管理员密码应使用强密码策略，并定期更新
• 配置文件应做好版本控制与备份
• 高并发场景下建议配置负载均衡与集群部署