andreychuk/postgres-pgjwt

postgres-pgjwt镜像说明

镜像概述

本镜像基于postgres:9.6.3-alpine构建，集成开源https://github.com/michelp/pgjwt%E6%89%A9%E5%B1%95%EF%BC%8C%E4%B8%BAPostgreSQL%E6%8F%90%E4%BE%9BJWT%E7%94%9F%E6%88%90%E4%B8%8E%E9%AA%8C%E8%AF%81%E8%83%BD%E5%8A%9B%EF%BC%8C%E7%AE%80%E5%8C%96%E6%95%B0%E6%8D%AE%E5%BA%93%E5%B1%82%E8%BA%AB%E4%BB%BD%E9%AA%8C%E8%AF%81%E9%80%BB%E8%BE%91%E5%AE%9E%E7%8E%B0%E3%80%82

核心功能

• 生成JWT令牌：通过sign(payload json, secret text, algorithm text default 'HS256')函数
• 验证JWT令牌：通过verify(token text, secret text, algorithm text default 'HS256')函数返回有效payload
• 支持HS256/HS384/HS512对称加密算法

使用场景

• API服务数据库层令牌验证
• 数据库内用户会话管理
• 跨服务JWT身份传递场景

配置说明

1. 环境变量：使用PostgreSQL标准变量配置
   • POSTGRES_USER：管理员用户名（默认postgres）
   • POSTGRES_PASSWORD：管理员密码（必填）
   • POSTGRES_DB：默认数据库名（与用户名一致）
2. 扩展启用：镜像预安装pgjwt，连接后直接使用函数

部署示例

Docker Run命令

bash
docker run -d \
  --name postgres-pgjwt \
  -e POSTGRES_PASSWORD=your_secure_pass \
  -p 5432:5432 \
  andreychuk/postgres-pgjwt

SQL使用示例

sql
-- 生成令牌
SELECT sign('{"user_id":1,"role":"editor"}'::json, 'your_secret_key', 'HS256');

-- 验证令牌
SELECT verify('your_generated_token', 'your_secret_key', 'HS256');