careappgroup/kratos-test-runner

Ory Kratos 内存数据库镜像文档

镜像概述

该镜像提供预配置的Ory Kratos身份管理系统运行环境，集成默认身份模式与内存数据库，旨在简化Ory Kratos的快速部署与测试流程。无需复杂的外部数据库配置，即可启动完整的身份认证服务，适合开发、测试及原型验证场景。

核心功能与特性

核心功能

• 运行Ory Kratos身份管理系统，支持用户认证、会话管理及身份验证流程
• 内置默认身份模式，包含标准用户属性（如***、密码、用户ID等基础字段）
• 集成内存数据库作为数据存储层，无需外部数据库依赖

关键特性

• 零配置启动：预配置核心参数，无需手动编写身份模式文件或数据库配置
• 内存数据存储：数据存储于容器内存中，启动速度快，适合临时测试环境
• 默认身份模型：包含用户注册、登录所需的基础字段定义，满足通用身份管理需求
• 轻量级部署：镜像体积优化，资源占用低，可快速启动和销毁

使用场景与适用范围

适用场景

• 开发环境测试：开发人员快速验证Ory Kratos API功能，无需搭建持久化数据库
• 原型演示：在产品演示或技术验证阶段，快速部署身份管理功能
• 学习与评估：学习Ory Kratos核心功能时，通过该镜像快速上手实践

限制说明

• 非持久化存储：内存数据库数据在容器停止后自动清除，不适合生产环境
• 默认配置限制：默认身份模式可能无法满足定制化身份需求，需手动扩展时需额外配置

使用方法与配置说明

基础启动命令

通过以下命令启动容器，映射Ory Kratos的公共API端口（4433）和管理API端口（4434）：

bash
docker run -p 4433:4433 -p 4434:4434 <image-name>

• -p 4433:4433：映射公共API端口，用于客户端交互（如用户登录、注册接口）
• -p 4434:4434：映射管理API端口，用于系统管理操作（如用户数据查询、配置更新）
• <image-name>：替换为实际镜像名称（如官方分发的oryd/kratos或自定义镜像名）

服务验证

容器启动后，可通过健康检查接口验证服务状态：

bash
curl http://localhost:4433/health/alive

返回{"status":"ok"}表示服务正常运行。

环境变量配置

可通过环境变量调整服务参数，常用配置项如下：

配置示例：修改日志级别为debug并调整公共端口

bash
docker run -p 8080:8080 -p 4434:4434 \
  -e KRATOS_LOG_LEVEL=debug \
  -e KRATOS_PUBLIC_PORT=8080 \
  <image-name>

注意事项

1. 数据持久性：内存数据库数据仅在容器运行期间保留，容器停止、重启或销毁后数据将丢失
2. 生产环境限制：该配置不适合生产环境，生产部署需使用持久化数据库（如PostgreSQL）并启用TLS加密
3. 端口冲突：启动前确保主机映射端口未被占用，端口冲突会导致容器启动失败
4. 身份模式扩展：如需自定义身份字段，需通过挂载外部身份模式文件覆盖默认配置