linagora/linshare-backend

LinShare Backend 镜像文档

镜像概述和主要用途

LinShare Backend 是 LinShare 文件共享平台的核心组件，负责处理平台的核心业务逻辑，包括文件存储管理、用户认证授权、共享权限控制及数据处理。作为后端服务，它为前端应用及第三方系统提供稳定的 RESTful API 接口，是构建企业级文件共享解决方案的关键部分。

核心功能和特性

• 文件存储与管理：支持本地存储、S3兼容对象存储等多种存储后端，提供文件上传、下载、版本控制及删除管理
• 用户认证与授权：集成 LDAP、Active Directory、OAuth 2.0 等认证方式，基于角色的访问控制（RBAC）确保数据安全
• 文件共享功能：支持内部用户间共享、外部链接共享，可设置细粒度权限（查看/编辑/管理）、访问有效期及密码保护
• RESTful API 支持：提供完整的 API 接口，支持前端应用、移动客户端及第三方系统集成
• 高可用性与扩展性：模块化架构设计，支持水平扩展，可通过负载均衡实现高可用部署
• 数据安全：文件传输加密（HTTPS）、存储加密，审计日志记录所有操作，满足合规需求

使用场景和适用范围

• 企业内部文件共享：适用于企业或组织内部员工间的安全文件交换与协作
• 团队协作平台：支持项目文件集中管理，成员间实时共享与版本控制
• 客户/合作伙伴文件交换：通过外部共享链接实现与外部人员的安全文件传输
• 合规性文件管理：满足***、***等行业对文件存储、共享及审计的合规要求

使用方法和配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name linshare-backend \
  -p 8080:8080 \
  -e SPRING_DATASOURCE_URL=jdbc:postgresql://db-host:5432/linshare \
  -e SPRING_DATASOURCE_USERNAME=linshare \
  -e SPRING_DATASOURCE_PASSWORD=password \
  -e LINSHARE_STORAGE_TYPE=local \
  -e LINSHARE_STORAGE_PATH=/data/linshare \
  linagora/linshare-backend:latest

Docker Compose 配置示例

yaml
version: '3'
services:
  linshare-backend:
    image: linagora/linshare-backend:latest
    ports:
      - "8080:8080"
    environment:
      - SPRING_DATASOURCE_URL=jdbc:postgresql://db:5432/linshare
      - SPRING_DATASOURCE_USERNAME=linshare
      - SPRING_DATASOURCE_PASSWORD=linsharepassword
      - LINSHARE_STORAGE_TYPE=s3
      - LINSHARE_S3_ENDPOINT=https://s3.example.com
      - LINSHARE_S3_BUCKET=linshare-files
      - LINSHARE_S3_ACCESS_KEY=AKIAEXAMPLE
      - LINSHARE_S3_SECRET_KEY=secret
      - LINSHARE_AUTH_TYPE=ldap
      - LINSHARE_LDAP_URL=ldap://ldap.example.com:389
      - LINSHARE_LDAP_BASE_DN=dc=example,dc=com
    volumes:
      - linshare-data:/data/linshare
    depends_on:
      - db

  db:
    image: postgres:13
    environment:
      - POSTGRES_DB=linshare
      - POSTGRES_USER=linshare
      - POSTGRES_PASSWORD=linsharepassword
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  linshare-data:
  postgres-data:

配置参数说明

核心环境变量配置

扩展配置

• 详细配置可通过挂载配置文件实现：-v /host/path/config:/app/config
• 完整配置文档参见：https://github.com/linagora/linshare-core#configuration 和 https://github.com/linagora/linshare-backend-dockerfile#configuration