aspencloud/triplit-server

Triplit数据库同步服务器镜像

概述

本镜像为Triplit数据库提供同步服务，旨在实现多客户端之间的Triplit数据库数据同步，确保分布式环境下数据的一致性与实时性。适用于需要跨设备、跨客户端共享Triplit数据库数据的场景。

核心功能与特性

• 数据同步：支持多客户端间Triplit数据库数据的双向同步，确保数据一致性
• 实时更新：采用高效同步机制，实现数据变更的近实时同步
• 轻量部署：基于Docker容器化部署，配置简单，易于集成到现有系统
• 兼容性：兼容Triplit数据库的标准数据格式与访问协议

使用场景

• 多设备协同工作的应用（如跨设备笔记、协作编辑工具）
• 分布式应用中需要共享Triplit数据库的场景
• 需要确保客户端离线操作后数据自动同步的应用

使用方法

基本运行命令

通过以下命令启动Triplit数据库同步服务器：

bash
docker run -d \
  --name triplit-sync-server \
  -p 8080:8080 \
  -v /path/to/local/triplit/db:/data/db \
  triplit/sync-server

• -p 8080:8080：映射容器同步服务端口到主机（默认同步端口为8080）
• -v /path/to/local/triplit/db:/data/db：挂载本地Triplit数据库目录到容器内，确保数据持久化

环境变量配置

可通过环境变量自定义同步服务器行为，常用配置如下：

示例（自定义端口与同步间隔）：

bash
docker run -d \
  --name triplit-sync-server \
  -p 9000:9000 \
  -v /path/to/local/triplit/db:/data/db \
  -e SYNC_PORT=9000 \
  -e SYNC_INTERVAL=10 \
  triplit/sync-server

数据持久化

为避免容器重启导致数据丢失，需通过数据卷（Volume）挂载Triplit数据库目录：

bash
# 创建数据卷（推荐）
docker volume create triplit-db-data

# 使用数据卷启动容器
docker run -d \
  --name triplit-sync-server \
  -p 8080:8080 \
  -v triplit-db-data:/data/db \
  triplit/sync-server

客户端连接配置

客户端需配置同步服务器地址（如http://sync-server-ip:8080）以启用数据同步功能，具体配置方式参考Triplit客户端文档。

注意事项

• 确保所有客户端使用相同的同步服务器地址与端口
• 数据卷挂载路径需与客户端访问的Triplit数据库路径一致
• 高并发场景下可调整SYNC_INTERVAL参数优化同步性能