user-portal-view 镜像文档

镜像概述和主要用途

user-portal-view 是一个面向用户门户的前端视图Docker镜像，基于现代Web技术栈构建，包含预编译的静态资源（HTML、CSS、JavaScript等）。该镜像旨在提供开箱即用的用户交互界面，作为各类应用系统的统一入口，支持用户认证、功能导航、信息展示等核心门户功能，简化前端视图的容器化部署流程。

核心功能和特性

• 完整门户视图：内置登录页、首页、功能菜单、用户中心等核心页面组件，满足基础门户需求
• 响应式设计：适配桌面端、平板及移动端设备，提供一致的跨设备访问体验
• 静态资源服务：集成轻量级Web服务器（如Nginx），高效分发前端静态资源
• 灵活配置：支持通过环境变量或配置文件自定义后端接口地址、主题样式等参数
• 容器化优化：镜像体积精简，启动速度快，支持多平台部署（amd64/arm64）

使用场景和适用范围

• 企业内部系统门户：作为员工访问OA、CRM、ERP等内部系统的统一入口
• 客户自助服务平台：供外部客户查询订单、提交工单、查看账户信息的交互界面
• Web应用登录入口：提供标准化的用户认证界面及权限控制后的功能导航
• 多系统集成门户：整合分散的业务系统视图，实现单点登录后的统一操作体验

使用方法和配置说明

基本部署（Docker Run）

bash
docker run -d -p 80:80 --name user-portal-view \
  -e API_URL=[***] \  # 后端API服务地址
  -e THEME=default \                    # 界面主题（default/dark/light）
  user-portal-view:latest

Docker Compose 配置示例

yaml
version: '3.8'
services:
  user-portal:
    image: user-portal-view:latest
    container_name: user-portal-view
    ports:
      - "80:80"  # 宿主机端口:容器内端口（需与PORT环境变量一致）
    environment:
      - PORT=80                           # 容器内Web服务监听端口
      - API_URL=[***]       # 后端API基础地址
      - THEME=dark                        # 主题样式
      - LOG_LEVEL=info                    # 日志级别（info/warn/error）
      - SESSION_TIMEOUT=3600              # 用户会话超时时间（秒）
    volumes:
      - ./custom-config:/usr/share/nginx/html/config  # 挂载自定义配置文件
      - ./logs:/var/log/nginx                         # 挂载日志目录（如使用Nginx）
    restart: unless-stopped

环境变量配置说明

自定义配置文件

如需更复杂的个性化配置（如自定义菜单、接口路径、主题色等），可通过挂载配置文件实现。创建config.json文件并挂载至容器内静态资源目录（通常为/usr/share/nginx/html/config）：

json
{
  "apiEndpoints": {
    "auth": "/api/v1/auth/login",       // 登录接口路径（相对于API_URL）
    "userInfo": "/api/v1/user/info",    // 用户信息接口路径
    "logout": "/api/v1/auth/logout"     // 登出接口路径
  },
  "theme": {
    "primaryColor": "#165DFF",         // 主题主色调
    "layout": "top-menu",              // 布局样式（sidebar/top-menu）
    "logoUrl": "/assets/logo-custom.png" // 自定义Logo路径
  },
  "menu": [                             // 自定义导航菜单
    { "name": "首页", "path": "/", "icon": "home" },
    { "name": "我的订单", "path": "/orders", "icon": "order" },
    { "name": "账户设置", "path": "/settings", "icon": "settings" }
  ]
}

注意事项

1. 后端依赖：确保API_URL指向的后端服务已部署且可被容器访问，否则前端功能可能无法正常使用
2. 端口冲突：若宿主机80端口已被占用，需修改端口映射（如-p 8080:80）并确保与PORT环境变量一致
3. 持久化配置：生产环境建议通过卷挂载（volumes）保存自定义配置，避免容器重建后配置丢失
4. 安全加固：生产环境应启用HTTPS（可配合反向代理如Nginx/Traefik实现），并限制容器网络访问权限