linagora/linshare-ui-upload-request

LinShare UI-Upload-Request Docker镜像文档

1. 镜像概述和主要用途

LinShare UI-Upload-Request镜像是LinShare文件共享平台的前端组件，专注于提供上传请求管理功能。该镜像封装了用于创建、分享、跟踪文件上传请求的用户界面，支持用户通过直观的交互生成上传链接、设置上传规则、监控上传进度，实现安全、可控的文件收集与管理。

2. 核心功能和特性

2.1 核心功能

• 上传请求创建：支持用户生成自定义上传请求，配置请求名称、描述及相关参数。
• 分享链接生成：自动生成可分享的上传链接，支持通过邮件、即时通讯工具等渠道分发。
• 上传权限管理：可设置上传有效期、最大文件大小、允许上传的文件类型等限制条件。
• 上传状态跟踪：实时查看上传请求的接收状态、文件列表及上传进度。
• 历史记录查询：记录所有上传请求的创建、修改及文件接收历史，支持筛选与导出。

2.2 主要特性

• 与LinShare后端深度集成：无缝对接LinShare核心服务，支持用户认证、权限控制及数据持久化。
• 响应式设计：适配桌面端、平板及移动端，提供一致的操作体验。
• 多语言支持：内置多语言界面，满足国际化团队需求。
• 轻量化部署：基于Docker容器化设计，支持快速部署与横向扩展。

3. 使用场景和适用范围

3.1 典型使用场景

• 企业内部文件收集：如部门月报、项目材料、员工资料等结构化数据的集中上传。
• 外部协作文件接收：与合作伙伴、客户或供应商交换文件，通过上传请求实现安全可控的外部文件导入。
• 活动资料提交：会议、培训、竞赛等场景下，接收参与者提交的材料（如演讲稿、报名表）。
• 临时文件共享：生成短期有效的上传链接，用于临时文件接收（如临时项目素材）。

3.2 适用范围

• 中小企业及团队协作场景。
• 需要规范化文件收集流程的组织（如行政、HR、项目管理部门）。
• 对文件上传权限、有效期、大小有严格控制需求的环境。
• 基于LinShare平台构建文件管理系统的用户。

4. 使用方法和配置说明

4.1 前提条件

• 已部署LinShare后端服务（需提供API访问地址）。
• Docker环境（Docker 19.03+）或Docker Compose（2.0+）。
• 网络环境需允许前端服务与LinShare后端API通信。

5. 部署方案示例

5.1 Docker 运行命令

通过以下命令快速启动容器，需替换<参数>为实际配置：

bash
docker run -d \
  --name linshare-ui-upload-request \
  -p 80:80 \
  -e LINSHARE_API_URL="http://<linshare-backend-ip>:8080/linshare/webservices/rest" \
  -e PORT=80 \
  -e LOG_LEVEL="info" \
  docker.xuanyuan.run/linagora/linshare-ui-upload-request:latest

参数说明：

• -p 80:80：将容器内80端口映射到主机80端口（可根据需求修改主机端口）。
• LINSHARE_API_URL：LinShare后端API地址（必填，需指向实际部署的LinShare服务）。
• PORT：容器内服务监听端口（默认80）。
• LOG_LEVEL：日志级别（可选，支持debug/info/warn/error，默认info）。

5.2 Docker Compose 配置示例

创建docker-compose.yml文件，配置如下：

yaml
version: '3.8'

services:
  linshare-ui-upload-request:
    image: docker.xuanyuan.run/linagora/linshare-ui-upload-request:latest
    container_name: linshare-ui-upload-request
    restart: always
    ports:
      - "80:80"  # 主机端口:容器端口
    environment:
      - LINSHARE_API_URL=http://linshare-api:8080/linshare/webservices/rest  # 后端API地址（需与LinShare后端服务名/IP匹配）
      - PORT=80  # 服务监听端口
      - LOG_LEVEL=info  # 日志级别
      - TZ=Asia/Shanghai  # 时区配置
    networks:
      - linshare-network  # 需与LinShare后端服务在同一网络（若使用Docker网络隔离）

networks:
  linshare-network:
    driver: bridge

说明：

• 若LinShare后端服务通过Docker Compose部署，需确保linshare-ui-upload-request与后端服务在同一网络（如示例中的linshare-network），并通过服务名（如linshare-api）访问后端API。
• 通过TZ环境变量配置时区，避免日志时间与本地时间偏差。

6. 环境变量配置说明

7. 注意事项

• 后端依赖：需确保LINSHARE_API_URL指向的LinShare后端服务已启动并可访问，且版本兼容（建议使用与UI组件匹配的LinShare版本）。
• 端口冲突：若主机80端口被占用，需修改-p参数中的主机端口（如-p 8081:80映射到8081端口）。
• 安全配置：生产环境中建议通过HTTPS暴露服务（可配合Nginx反向代理实现SSL终结）。
• 数据持久化：UI组件本身无持久化数据，用户配置及上传记录存储于LinShare后端，无需额外挂载卷。

8. 参考链接

• https://github.com/linagora/linshare-ui-upload-request
• https://github.com/linagora/linshare-ui-upload-request-dockerfile
• LinShare官方文档