Keycloak

约 523 字大约 2 分钟

IdP

2026-01-12

🚀 部署指南

Keycloak 是一个开源的身份和访问管理解决方案。

准备工作

创建用于存储数据库数据的持久化目录

mkdir -p /share/Container/keycloak/db

启动服务

Docker Compose (推荐)

使用 Docker Compose 部署 Keycloak 和 PostgreSQL 数据库，确保数据持久化。

services:

  keycloak:
    image: quay.io/keycloak/keycloak:26.5.0
    restart: unless-stopped
    command: start
    ports:
      - 8080:8080
    environment:
      KC_DB: postgres
      KC_DB_URL: jdbc:postgresql://postgres:5432/keycloak
      KC_DB_USERNAME: keycloak
      KC_DB_PASSWORD: password
      KC_BOOTSTRAP_ADMIN_USERNAME: admin
      KC_BOOTSTRAP_ADMIN_PASSWORD: admin
    depends_on:
      - postgres

  postgres:
    image: postgres
    restart: unless-stopped
    environment:
      POSTGRES_DB: keycloak
      POSTGRES_USER: keycloak
      POSTGRES_PASSWORD: password
    volumes:
      - /share/Container/keycloak/db:/var/lib/postgresql

Docker CLI (开发模式)

快速启动开发模式，即使重启数据也会丢失（因为使用内存 H2 数据库），仅供测试使用。

docker run -d \
  -p 8080:8080 \
  -e KC_BOOTSTRAP_ADMIN_USERNAME=admin \
  -e KC_BOOTSTRAP_ADMIN_PASSWORD=admin \
  --restart unless-stopped \
  --name keycloak \
  quay.io/keycloak/keycloak:26.5.0 \
  start-dev

📝 初始配置

1. 登录管理控制台

浏览器访问 http://localhost:8080/admin。
使用环境变量中配置的管理员账号登录（Docker Compose 示例中为 admin / admin）。

2. 创建 Realm (领域)

Keycloak 中的 Realm 相当于一个租户空间。master realm 仅用于管理 Keycloak 本身，不建议用于业务应用。

登录后，点击左上角的 Master 下拉菜单。
选择 Create Realm。
在 Realm name 输入框中填写名称，例如 myrealm。
点击 Create 按钮。

3. 创建用户

确保左上角显示的当前 Realm 是你刚创建的 myrealm。
点击左侧菜单的 Users。
点击 Create new user。
填写 Username（如 myuser），其他信息可选，点击 Create。
设置密码：
- 点击用户详情页顶部的 Credentials 标签。
- 点击 Set password。
- 输入密码并确认。
- 将 Temporary 选项关闭（off），否则用户首次登录时会被强制要求修改密码。
- 点击 Save。

4. 验证配置

访问用户账户控制台：http://localhost:8080/realms/myrealm/account。
使用刚才创建的普通用户（myuser）登录。
如果能成功进入账户管理页面，说明 Keycloak 基础配置已完成。