当前位置：首页 > news >正文

Sharry数据库设计与文件存储机制：深入理解数据持久化方案

news 2026/3/26 23:28:00

Sharry数据库设计与文件存储机制：深入理解数据持久化方案

【免费下载链接】sharrySharry is a self-hosted file sharing web application.项目地址: https://gitcode.com/gh_mirrors/sh/sharry

Sharry作为一款自托管文件共享Web应用，其高效的数据持久化方案是确保文件安全存储与共享的核心基础。本文将深入剖析Sharry的数据库设计理念与灵活的文件存储机制，帮助开发者和管理员全面理解其数据管理架构。

数据库设计：关系模型与核心实体

Sharry采用关系型数据库存储核心业务数据，通过精心设计的实体模型实现用户、共享和文件元数据的高效管理。

核心数据实体

用户账户模型（RAccount）存储系统用户的认证与权限信息，关键字段包括：

id: 用户唯一标识
login: 登录名（CIIdent类型确保大小写不敏感）
source: 账户来源（如内部创建或外部认证）
state: 账户状态（启用/禁用）
password: 加密存储的密码
admin: 管理员权限标识

完整实现代码

共享记录模型（RShare）管理文件共享的核心属性：

id: 共享唯一ID
accountId: 所属用户ID
validity: 有效期设置
maxViews: 最大查看次数限制
password: 可选访问密码
description: 共享描述信息

文件元数据模型（RFileMeta）记录文件的关键属性：

id: 文件唯一标识
mimetype: MIME类型
length: 文件大小（ByteSize类型）
checksum: 内容校验和（ByteVector类型）

实体关系与数据完整性

Sharry通过外键约束和关联查询维护实体间关系，例如：

共享记录（RShare）通过accountId关联到用户账户
文件元数据（RFileMeta）通过id与共享文件（RShareFile）建立关联

数据库迁移：Flyway自动化版本管理

Sharry使用Flyway实现数据库 schema 的版本控制与自动化迁移，确保系统升级时数据结构的兼容性。

迁移流程核心实现位于FlywayMigrate.scala，关键特性包括：

def run[F[_]: Sync](jdbc: JdbcConfig): F[MigrateResult] = Sync[F].delay { logger.info("Running db migrations...") val fw = makeFlyway(jdbc) fw.repair() fw.migrate() }

迁移脚本根据数据库类型自动选择适配的SQL脚本，支持PostgreSQL和H2等多种数据库：

def findLocations(jdbc: JdbcConfig) = jdbc.dbmsName match { case Some("h2") => List(s"classpath:db/migration/postgresql", "classpath:db/migration/h2") case Some(dbtype) => List(s"classpath:db/migration/$dbtype") }

文件存储机制：多策略灵活适配

Sharry设计了可扩展的文件存储架构，支持多种存储策略以适应不同部署环境需求。

存储类型与配置

文件存储类型定义在FileStoreType.scala，提供三种核心存储策略：

数据库存储（DefaultDatabase）：将文件内容存储在数据库中，适合小文件和简单部署场景
文件系统存储（FileSystem）：将文件保存到本地文件系统，适合中等规模部署
S3兼容存储（S3）：对接AWS S3或兼容对象存储服务，适合大规模和云环境部署

存储配置通过FileStoreConfig.scala实现，例如文件系统存储配置：

case class FileSystem( enabled: Boolean, path: String, tempDir: String, maxSize: ByteSize ) extends FileStoreConfig { val storeType = FileStoreType.FileSystem }