Skip to content
Keycloak 图标

Keycloak ​

应用简介 ​

Keycloak 是开源的身份与访问管理平台,提供单点登录与权限管理。

主要能力 ​

  • OIDC / SAML 单点登录。
  • 用户联邦与角色权限。
  • 管理控制台与细粒度授权。

运行要求 ​

项目值
应用目录apps/fn-keycloak
目标平台x86
外部依赖外部 MariaDB / MySQL / PostgreSQL 数据库

安装与使用 ​

安装时设置 Web 访问端口,填写站点访问地址、初始管理员密码,以及数据库连接信息(地址、端口、库名、用户名、密码分开填写)。

站点访问地址很关键:该值用于生成 token 的 issuer 与前端跳转地址;填错会导致登录页反复跳转、token 校验失败。请填目标 NAS 的可访问地址(含协议与端口,如 http://192.168.1.10:8080);未配置反向代理时不要填域名。

初始管理员密码仅在首次启动、尚无管理员时生效。上游默认值是固定弱占位符,请自行设置。

数据库需用户自备:安装时填写数据库连接信息。连接失败时应用会启动但功能不可用(页面报数据库错误),请确认地址可达、端口已放行、库名与账号密码正确。

数据库类型沿用上游的三个选项(MariaDB / MySQL / PostgreSQL),未额外开放开发用与冷门数据库类型。

高级配置 ​

反向代理 ​

本应用开启了 KC_PROXY_HEADERS=xforwarded,以便在反向代理后正确识别客户端协议与地址。若你在前置反向代理上终结 TLS,请同时在应用内配置相应的 hostname 策略,避免 issuer 与实际访问地址不一致。

相关链接 ​

基于 VitePress 构建