trame多用户应用基础镜像

镜像概述

本镜像为trame应用提供基础部署环境，专注于支持多用户访问场景，可灵活适配云平台（如AWS、Azure、GCP）或本地服务器部署需求。作为基础镜像，其设计目标是简化trame应用的多用户环境配置，降低跨环境部署复杂度。

核心功能与特性

• 多用户支持：内置用户会话管理机制，支持并发用户访问控制及会话隔离
• 跨环境兼容性：优化适配云环境容器编排（Kubernetes、Docker Swarm）及本地物理/虚拟机部署
• 基础依赖集成：预配置trame应用运行所需的核心依赖（Python环境、Web服务器、网络层组件）
• 可扩展架构：支持通过环境变量或配置文件自定义多用户策略（如认证方式、资源配额）

使用场景与适用范围

• 企业级trame应用部署：需支持多团队成员协同访问的内部系统
• 科学计算可视化平台：面向科研团队的多用户交互式数据可视化应用
• 教学实训环境：需要为多名学员提供独立trame应用实例的教学场景
• 混合部署需求：需在云环境测试与本地生产环境间无缝迁移的trame应用

使用方法与配置说明

基本部署命令

通过docker run快速启动基础环境：

bash
docker run -d -p 8080:8080 --name trame-multiuser-instance <镜像标签>

说明：默认映射容器8080端口至宿主机，可根据需求调整端口映射（如-p 9000:8080）

核心环境变量配置

带认证配置的部署示例

配置OAuth认证与用户配额：

bash
docker run -d \
  -p 8080:8080 \
  -e MULTI_USER_MODE=on \
  -e AUTH_PROVIDER=oauth \
  -e OAUTH_CLIENT_ID=<your-client-id> \
  -e OAUTH_CLIENT_SECRET=<your-client-secret> \
  -e MAX_CONCURRENT_USERS=20 \
  --name trame-oauth-instance <镜像标签>

Docker Compose配置示例

yaml
version: '3.8'
services:
  trame-app:
    image: <镜像标签>
    ports:
      - "8080:8080"
    environment:
      - MULTI_USER_MODE=on
      - AUTH_PROVIDER=ldap
      - LDAP_SERVER_URL=ldap://your-ldap-server:389
      - LDAP_BASE_DN=ou=users,dc=example,dc=com
      - MAX_CONCURRENT_USERS=15
    restart: unless-stopped
    volumes:
      - ./app-config:/etc/trame/config  # 挂载自定义配置文件

注意事项

• 生产环境部署时，建议通过volumes挂载持久化存储以保存用户会话数据
• 多用户高并发场景需根据实际负载调整宿主机资源（建议CPU≥4核，内存≥8GB）
• 非默认认证方式（如LDAP/OAuth）需提前准备对应服务的连接参数（如服务器地址、凭据）