aatir0docking/getme

高性能键值存储的容器镜像

📑 目录

• 概述
• 可用Docker镜像
• 一体化容器（HTTP代理、CLI、服务器）
  • 快速启动
  • 使用内置CLI
  • Docker Compose示例
• MCP服务器容器
• 仅核心服务器容器
• 卷与持久化
• 安全与自定义
• 链接

📖 概述

getme是一款持久化、嵌入式、日志结构的键值存储，针对高写入吞吐量和低延迟读取进行了优化。本文档涵盖getme可用的多种容器化环境，助您在不同场景下无缝运行该数据库。

📦 可用Docker镜像

getme提供多种Docker镜像以适应不同使用场景：

1. ContainerFile（一体化）：将核心服务器、HTTP代理和CLI打包为单个轻量级镜像。
2. ContainerFile.server（核心引擎）：仅运行核心存储引擎，通过Unix域套接字（UDS）通信。
3. mcp-server/Dockerfile：基于Python的专用容器，将getme数据库作为大型语言模型（LLM）工具，使用模型上下文协议（MCP）暴露。

🚀 一体化容器（HTTP代理、CLI、服务器）

基于ContainerFile构建，是标准镜像。它内部运行存储引擎，并通过HTTP代理在8080端口暴露服务，同时预安装CLI工具。

快速启动

在后台运行容器，暴露HTTP代理端口并挂载卷以实现数据持久化：

bash
docker run -d \
  --name getme-store \
  -p 8080:8080 \
  -v getme_data:/var/lib/getMeStore \
  -v getme_tmp:/tmp/getMeStore \
  docker.xuanyuan.run/aatir0docking/getme:latest

使用内置CLI

镜像预安装了getme CLI工具。我们已配置镜像自动加载别名getme-cli，您可通过docker exec直接从主机与数据库交互：

bash
# 设置值
docker exec -it getme-store sh -ic "getme-cli set mykey 'hello world'"

# 获取值
docker exec -it getme-store sh -ic "getme-cli get mykey"

（注：-ic标志是必需的，用于调用加载别名配置的交互式shell）

Docker Compose示例

为简化部署，使用docker-compose.yml：

yaml
version: "3.8"

services:
  getme:
    image: docker.xuanyuan.run/aatir0docking/getme:latest
    container_name: getme-store
    ports:
      - "8080:8080"
    volumes:
      - getme_data:/var/lib/getMeStore
      - getme_tmp:/tmp/getMeStore
    restart: unless-stopped

volumes:
  getme_data:
  getme_tmp:

🤖 MCP服务器容器

若您将getme与LLM代理（如Claude Desktop或Cursor）配合使用，可部署mcp-server/Dockerfile定义的MCP服务器容器。

该容器需要访问运行中的getme服务器的Unix域套接字文件：

bash
cd mcp-server
docker compose run --rm -T getme-mcp-server

此命令通过标准I/O（JSON-RPC）通信，避免分配TTY（-T）。注意它会挂载主机的/tmp/getMeStore/sockDir。

⚡ 仅核心服务器容器

若您仅需要原始存储引擎并直接通过UDS（无HTTP）交互，可构建ContainerFile.server：

bash
docker build -t getme-core -f ContainerFile.server .
docker run -d \
  --name getme-engine \
  -v getme_data:/var/lib/getMeStore \
  -v /tmp/getMeStore/sockDir:/tmp/getMeStore/sockDir \
  docker.xuanyuan.run/getme-core

关键： 必须绑定挂载/tmp/getMeStore/sockDir，以便外部进程（SDK）能访问getMe.sock。

💾 卷与持久化

为确保数据在容器重启后保留，需将以下目录挂载到容器内：

• /var/lib/getMeStore/dataDir：存储日志结构段（数据库文件）的主目录。
• /tmp/getMeStore/sockDir：用于内部Unix域套接字通信。
• /tmp/getMeStore/dumpDir：用于内部应用日志记录。

🛡️ 安全与自定义

安全是设计内置的。容器不以root用户运行。

在多阶段构建过程中，会创建名为appuser的非特权用户（及appgroup组）。所有二进制文件均以该用户身份执行，所有关键数据目录的所有权会自动分配给appuser:appgroup。

若您的环境需要特定用户ID映射以避免本地权限问题，可在构建阶段通过build-args覆盖默认UID和GID：

bash
docker build --build-arg UID=2000 --build-arg GID=2000 -t getme -f ContainerFile .

🔗 链接

• GitHub仓库：https://github.com/AatirNadim/getMe
• 博客第一部分 - 构建getme：阅读此处
• 博客第二部分 - 构建getme：阅读此处
• 可用SDK：https://github.com/AatirNadim/getMe/releases?q=gosdk&expanded=true%E3%80%81Java%E3%80%81https://www.npmjs.com/package/getme-js-sdk%E3%80%81https://pypi.org/p/getme-python-sdk