linagora/linshare-database

LinShare数据库镜像文档

镜像概述

LinShare数据库镜像是LinShare文档协作平台的官方数据库组件，专门用于存储平台运行所需的所有结构化数据。作为LinShare生态的核心组成部分，该镜像提供了可靠的数据持久化存储能力，确保LinShare平台的用户信息、文档元数据、权限配置及业务逻辑数据的安全管理与高效访问。

核心功能与特性

• 结构化数据存储：存储LinShare平台的用户账户、组织架构、文档元数据、访问权限等关键结构化数据
• 数据持久化：支持数据卷挂载，确保服务重启或升级时数据不丢失
• 无缝集成：与LinShare应用服务深度适配，提供数据交互接口支持平台核心业务流程
• 兼容性保障：针对LinShare各版本进行优化，确保数据库 schema 与应用服务版本匹配

使用场景

• LinShare生产环境部署：作为企业级文档协作平台的数据库后端，支撑多用户并发访问与数据读写
• 开发测试环境：为LinShare二次开发或功能测试提供独立的数据库环境
• 数据迁移与备份：用于LinShare平台的数据迁移、备份与恢复操作

使用方法

基本部署（Docker Run）

bash
docker run -d \
  --name linshare-db \
  -p 5432:5432 \
  -v linshare-db-data:/var/lib/postgresql/data \
  -e POSTGRES_DB=linshare \
  -e POSTGRES_USER=linshareuser \
  -e POSTGRES_PASSWORD=strongpassword \
  docker.xuanyuan.run/linagora/linshare-database:latest

Docker Compose配置示例

yaml
version: '3'
services:
  linshare-db:
    image: docker.xuanyuan.run/linagora/linshare-database:latest
    container_name: linshare-db
    ports:
      - "5432:5432"
    volumes:
      - linshare-db-data:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=linshare
      - POSTGRES_USER=linshareuser
      - POSTGRES_PASSWORD=strongpassword
    restart: unless-stopped

volumes:
  linshare-db-data:

环境变量配置

数据持久化

通过挂载数据卷（如示例中的linshare-db-data）确保数据库文件持久化存储，避免容器重启或删除导致数据丢失。

注意事项

• 生产环境中需使用强密码并限制数据库端口访问范围
• 定期备份挂载的数据卷以防止数据丢失
• 确保数据库版本与LinShare应用服务版本兼容（参考LinShare官方版本矩阵）
• 首次启动时会自动初始化数据库schema，需等待初始化完成后再启动LinShare应用服务