tiwinker/portal

Portal镜像文档

概述

Portal镜像为企业提供容器化的统一应用门户解决方案，旨在整合分散的业务系统，构建集中式访问入口。通过标准化部署流程与可扩展架构，帮助用户简化多系统访问复杂度，提升工作效率，适用于各类企业级门户场景的快速落地。

核心功能与特性

• 多系统集成能力：支持对接OA、CRM、ERP等主流业务系统，提供标准化接口适配方案
• 单点登录体系：集成SSO认证机制，实现一次登录多系统访问，支持OAuth2.0、SAML等协议
• 可视化配置平台：内置界面编辑器，支持拖拽式页面布局设计与品牌样式自定义
• 细粒度权限控制：基于RBAC模型的权限管理，支持用户组、角色及资源权限的精细化配置
• API扩展接口：提供完整的RESTful API，支持第三方功能扩展与业务流程定制
• 容器化优化：轻量级镜像设计，支持多实例集群部署，适配Kubernetes等容器编排平台

典型使用场景

• 企业内网门户：整合HR系统、财务系统、项目管理工具，构建员工一站式办公平台
• 客户服务门户：集中展示产品信息、订单查询、售后服务等客户相关功能模块
• 开发者门户：统一API文档、测试环境、资源申请等开发者服务入口
• 合作伙伴平台：为供应链伙伴提供订单协作、库存查询、结算管理等专属服务通道

部署与配置指南

快速启动命令

bash
docker run -d \
  --name enterprise-portal \
  -p 80:8080 \
  -e ADMIN_USER=admin \
  -e ADMIN_PASSWORD=Portal@2024 \
  -e DB_CONN=mysql://user:pass@db-host:3306/portal \
  -v /local/config:/app/config \
  -v /local/data:/app/data \
  portal:latest

核心配置参数

基础环境变量

数据持久化配置

• /app/config：门户配置文件目录（包含系统集成配置、页面布局等）
• /app/data：运行时数据目录（包含日志文件、临时缓存、用户上传文件等）
• /app/plugins：插件存放目录（用于扩展功能模块）

高级配置示例

docker-compose部署配置

yaml
version: '3.8'
services:
  portal:
    image: portal:latest
    container_name: portal-service
    ports:
      - "80:8080"
    environment:
      - ADMIN_USER=superadmin
      - ADMIN_PASSWORD=${PORTAL_PWD}
      - DB_CONN=postgresql://pguser:pgpass@postgres:5432/portal_db
      - LOG_LEVEL=INFO
    volumes:
      - ./config:/app/config
      - ./data:/app/data
    depends_on:
      - postgres
    restart: unless-stopped

  postgres:
    image: postgres:14
    container_name: portal-db
    environment:
      - POSTGRES_USER=pguser
      - POSTGRES_PASSWORD=pgpass
      - POSTGRES_DB=portal_db
    volumes:
      - pgdata:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  pgdata:

初始化与使用

1. 首次启动后，通过http://<主机IP>:<映射端口>访问管理后台
2. 使用配置的ADMIN_USER和ADMIN_PASSWORD登录系统
3. 在"系统管理-服务集成"页面添加需要对接的业务系统
4. 通过"界面配置"模块自定义门户首页布局与样式
5. 配置用户角色与权限，完成门户功能的个性化定制

注意事项

• 生产环境需修改默认管理员密码并启用HTTPS（建议通过Nginx反向代理实现SSL终结）
• 数据库建议使用外部独立部署实例，避免容器内数据丢失
• 高并发场景下可通过增加实例数量并配置负载均衡实现横向扩展
• 定期备份/app/config目录下的配置文件，确保系统配置可恢复性