piotrkowalczuk/mnemosyne

Mnemosyne

镜像概述

Mnemosyne是一款开源的自托管会话管理服务，采用Go语言编写，可编译为静态二进制文件，易于部署。它提供两种通信方式：简化版gRPC客户端（隐藏gRPC库复杂度）和全功能RPC客户端，支持会话的生命周期管理。

核心功能

• 会话操作：支持创建、获取、列表查询、存在性检查、废弃、设置数据、删除等操作
• 存储引擎：当前支持PostgreSQL，计划扩展至Redis、MongoDB等
• RPC API：基于Protocol Buffers实现结构化数据序列化，提供高效通信接口
• 自动初始化：启动时自动创建PostgreSQL所需的表和索引

使用场景

• 需要自托管会话管理的Web应用
• API服务的用户会话跟踪与状态管理
• 分布式系统中的会话共享与同步需求

配置说明

Mnemosyned服务支持通过命令行参数配置，主要选项如下：

Docker部署示例

基本运行（连接PostgreSQL）

bash
docker run -d \
  --name mnemosyne \
  -p 8080:8080 \
  docker.xuanyuan.run/piotrkowalczuk/mnemosyne \
  -storage.postgres.address="postgres://your_user:your_pass@postgres_host:5432/your_db?sslmode=disable" \
  -log.format=humane

Docker Compose示例（含PostgreSQL）

yaml
version: '3'
services:
  mnemosyne:
    image: piotrkowalczuk/mnemosyne
    ports:
      - "8080:8080"
    command: 
      - "-storage.postgres.address=postgres://postgres:postgres@db:5432/mnemosyne?sslmode=disable"
      - "-log.format=humane"
    depends_on:
      - db
  db:
    image: postgres:14
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
      POSTGRES_DB: mnemosyne
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data: