flyio/litefs

SQLite数据库复制文件系统镜像

镜像概述

本Docker镜像提供一个专用文件系统层，旨在为SQLite数据库实现高效、可靠的复制功能。SQLite作为嵌入式数据库，原生不支持内置复制机制，该镜像通过文件系统级别的同步策略，填补了这一空白，适用于需要SQLite数据高可用性的场景。

核心功能与特性

• 文件系统级复制：基于文件系统层实现SQLite数据库文件的实时同步，不依赖数据库本身的复制接口
• 主从复制模式：支持配置主节点（Master）与从节点（Slave）架构，主节点写入数据后自动同步至从节点
• 轻量级设计：镜像体积小，资源占用低，适合嵌入式系统、边缘设备等资源受限环境
• 可配置同步策略：支持自定义同步间隔、冲突解决机制（如覆盖/忽略/告警）
• 低延迟同步：优化文件变更检测机制，最小化主从节点间的数据同步延迟
• 数据一致性保障：内置文件锁与事务完整性校验，确保同步过程中数据不损坏

使用场景与适用范围

• 嵌入式系统：为物联网设备、工业控制设备中的SQLite数据库提供数据备份与冗余
• 边缘计算：在边缘节点实现本地SQLite数据的跨设备同步，保障断网重连后数据一致性
• 小型Web应用：为轻量级Web服务（如基于Flask/Django的小型应用）提供简单的主从备份方案
• 开发/测试环境：快速搭建SQLite多实例复制架构，验证数据同步逻辑
• 资源受限环境：替代高资源消耗的数据库集群方案，在低内存/低CPU设备上实现基础高可用

使用方法与配置说明

基本部署命令

bash
# 启动主节点（Master）
docker run -d \
  --name sqlite-replica-master \
  -v /host/path/to/sqlite-data:/data \  # 挂载主机目录作为数据库存储路径
  -e ROLE=master \                     # 指定节点角色为主节点
  -e SYNC_INTERVAL=3s \                # 设置同步检查间隔（默认3秒）
  -e CONFLICT_STRATEGY=overwrite \     # 冲突解决策略（overwrite/ignore/alert）
  [镜像名称]:[标签]

# 启动从节点（Slave），连接主节点
docker run -d \
  --name sqlite-replica-slave \
  -v /host/path/to/sqlite-slave-data:/data \
  -e ROLE=slave \
  -e MASTER_HOST=sqlite-replica-master \  # 主节点容器名称或IP
  -e MASTER_PORT=8080 \                   # 主节点同步端口（默认8080）
  -e SYNC_RETRY=5 \                       # 同步失败重试次数（默认5次）
  [镜像名称]:[标签]

核心配置参数

数据持久化

通过 -v 参数挂载主机目录至容器内 DATA_PATH（默认/data），确保容器重启后数据库文件与同步状态不丢失。建议使用命名卷（Named Volume）而非主机目录，提升数据管理可靠性：

bash
# 创建命名卷
docker volume create sqlite-replica-data

# 使用命名卷启动容器
docker run -d \
  -v sqlite-replica-data:/data \
  -e ROLE=master \
  [镜像名称]:[标签]

验证同步状态

容器启动后，可通过日志验证同步状态：

bash
# 查看主节点日志
docker logs sqlite-replica-master

# 查看从节点同步状态
docker exec sqlite-replica-slave cat /data/sync_status.log

正常同步时，从节点日志应显示类似 Sync completed successfully at [时间戳] 的记录。