supertokens/supertokens-sqlite-pro

SuperTokens SQLite专业版镜像

镜像概述

SuperTokens SQLite专业版镜像是一款基于SQLite数据库的身份验证与会话管理工具，提供安全、灵活的用户认证解决方案，需有效许可证密钥方可运行。

核心功能

• 会话生命周期管理（访问令牌、刷新令牌生成与验证）
• 反CSRF保护机制
• 多方式配置（环境变量/自定义配置文件）
• 日志管理（Docker日志或文件日志）
• SQLite数据持久化
• 访问令牌黑名单与动态密钥更新

使用场景

• 中小型Web应用的身份验证系统
• 移动应用后端的会话管理服务
• 需轻量级SQLite存储的身份验证场景

配置说明

快速启动（内存数据库）

bash
docker run -p 3567:3567 -e LICENSE_KEY_ID=yourLicenseKeyID -d supertokens/supertokens-sqlite-pro

配置方式

支持环境变量或自定义config.yaml配置，若同时使用仅自定义文件生效。

环境变量配置

可用变量分类：

• 核心配置：API_KEY、COOKIE_DOMAIN等（详情见核心配置文档）
• SQLite配置：SQLITE_CONNECTION_POOL_SIZE等（详情见SQLite配置文档）
• 许可证：LICENSE_KEY_ID

示例：

bash
docker run \
    -p 3567:3567 \
    -e LICENSE_KEY_ID=yourLicenseKeyID \
    -v /path/to/sqlite_data:/sqlite_db \
    -d supertokens/supertokens-sqlite-pro

自定义配置文件

config.yaml需包含：

• core_config_version: 0
• host: "0.0.0.0"
• sqlite_config_version: 0
• sqlite_database_folder_location: "/sqlite_db"
• info_log_path: null（用Docker日志）
• error_log_path: null（用Docker日志）

容器内路径：/usr/lib/supertokens/config.yaml，示例：

bash
docker run \
    -p 3567:3567 \
    -v /path/to/config.yaml:/usr/lib/supertokens/config.yaml \
    -e LICENSE_KEY_ID=yourLicenseKeyID \
    -v /path/to/sqlite_data:/sqlite_db \
    -d supertokens/supertokens-sqlite-pro

许可证密钥

从SuperTokens控制台获取，支持两种方式：

• 环境变量（见上文示例）
• 文件方式：

bash
docker run \
    -p 3567:3567 \
    -v /path/to/licenseKey:/usr/lib/supertokens/licenseKey \
    -v /path/to/sqlite_data:/sqlite_db \
    -d supertokens/supertokens-sqlite-pro

详情见许可证文档。

日志管理

默认日志通过docker logs <容器名>查看，或配置到共享卷：

bash
docker run \
    -p 3567:3567 \
    -v /path/to/logsFolder:/home/logsFolder \
    -e INFO_LOG_PATH=/home/logsFolder/info.log \
    -e ERROR_LOG_PATH=/home/logsFolder/error.log \
    -e LICENSE_KEY_ID=yourLicenseKeyId \
    -v /path/to/sqlite_data:/sqlite_db \
    -d supertokens/supertokens-sqlite-pro

数据库存储

数据存于/sqlite_db，挂载共享卷可持久化（示例见上文）。

CLI参考

详情见CLI文档。