linagora/linshare-ui-user

LinShare UI-User 镜像文档

镜像概述

LinShare UI-User 是 LinShare 开源文件共享与协作平台的前端用户界面组件，基于 Web 技术构建，提供直观、易用的操作界面。该镜像封装了 LinShare 用户界面的完整运行环境，用户可通过浏览器访问，实现文件上传、下载、共享、权限管理等日常操作，需与 LinShare 后端服务（如 linshare-core）配合使用。

核心功能与特性

主要功能

• 文件管理：支持文件上传、下载、删除、重命名及文件夹创建与管理
• 共享功能：创建文件/文件夹共享链接，设置访问权限（查看/编辑）、有效期及密码保护
• 协作操作：支持多用户文件夹共享、实时通知及文件版本控制
• 搜索与筛选：快速搜索文件/文件夹，按名称、日期、类型等条件筛选
• 用户友好界面：响应式设计，适配桌面及移动设备，简化操作流程

技术特性

• 基于现代 Web 技术栈（React/Vue 等前端框架）构建
• 支持与 LinShare 后端 API 无缝集成
• 可通过环境变量灵活配置，适应不同部署环境
• 轻量级容器化部署，简化安装与升级流程

使用场景与适用范围

典型使用场景

• 企业内部文件共享：企业员工间安全共享工作文件，替代传统邮件附件
• 团队协作：项目团队共享文件夹，实时协作编辑，追踪文件版本变更
• 外部文件交换：与客户/合作伙伴安全交换文件，通过加密链接控制访问
• 远程办公支持：提供随时随地的文件访问与管理能力，支持分布式团队协作

适用范围

• 中小企业文件管理系统
• 团队协作平台文件模块
• 教育机构资源共享系统
• 需安全文件交换的组织或个人

使用方法与配置说明

前置条件

• 已部署 LinShare 后端服务（如 linshare-core），并获取后端 API 地址
• 安装 Docker 及 Docker Compose（可选）

环境变量配置

Docker 快速启动

基本运行命令

bash
docker run -d \
  --name linshare-ui-user \
  -p 80:80 \
  -e LINSHARE_API_URL="http://linshare-core:8080/linshare/webservice/rest" \
  linagora/linshare-ui-user:latest

Docker Compose 示例

创建 docker-compose.yml 文件：

yaml
version: '3.8'
services:
  linshare-ui-user:
    image: linagora/linshare-ui-user:latest
    container_name: linshare-ui-user
    ports:
      - "80:80"
    environment:
      - LINSHARE_API_URL=http://linshare-core:8080/linshare/webservice/rest
      - PORT=80
    depends_on:
      - linshare-core
    restart: unless-stopped

  linshare-core:
    image: linagora/linshare-core:latest
    container_name: linshare-core
    # 参考 linshare-core 镜像文档配置后端服务
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=prod
      # 其他后端必要环境变量...
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

访问界面

服务启动后，通过浏览器访问 http://<服务器IP>:<映射端口>（默认 http://localhost），即可打开 LinShare 用户界面，使用 LinShare 账号登录后进行文件操作。

注意事项

• 确保 LinShare 后端服务与 UI-User 版本兼容，建议使用官方推荐的版本组合
• 生产环境中建议配置 HTTPS，可通过反向代理（如 Nginx）实现 SSL 终止
• 调整 LINSHARE_API_URL 以匹配实际后端服务地址，确保网络连通性
• 如需自定义界面样式，可通过挂载配置文件或构建自定义镜像实现

相关链接

• 官方代码仓库：https://github.com/linagora/linshare-ui-user
• Dockerfile 仓库：https://github.com/linagora/linshare-ui-user-dockerfile
• LinShare 官方文档：LinShare Documentation