Keycloak 20.0.1：非Docker环境下从JSON导入Realm的路径疑问

不同安装场景的默认路径 #

• 二进制包手动解压部署
  如果你是从Keycloak官网下载压缩包（tar.gz/zip格式）解压后直接运行，data/import目录就在你解压后的Keycloak根目录下。
  例：Linux/macOS下解压到/opt/keycloak，路径就是/opt/keycloak/data/import；Windows下解压到C:\keycloak，路径就是C:\keycloak\data\import。如果这个目录不存在，手动创建即可，Keycloak启动时会自动识别。

• 系统包管理器安装（apt/yum/dnf等）
  通过系统包安装的Keycloak，默认数据目录通常在系统标准数据路径下：

  • Debian/Ubuntu系列：/var/lib/keycloak/data/import
  • RHEL/CentOS/Rocky系列：/var/lib/keycloak/data/import

• 自定义Home目录部署
  如果你启动Keycloak时通过--home参数指定了自定义Home目录，或者设置了KEYCLOAK_HOME环境变量，那data/import就位于这个指定的Home目录下。

更灵活的替代方案 #

不想纠结默认路径的话，直接在启动命令里用--import-dir参数指定自定义导入目录，比如：

# Linux/macOS
bin/kc.sh start --import-realm --import-dir=/your/custom/path/import

# Windows
bin/kc.bat start --import-realm --import-dir=C:\your\custom\path\import

验证方式 #

启动Keycloak时可以调整日志级别为DEBUG，查看启动日志，里面会明确打印出它尝试读取的导入目录路径，以此确认位置是否正确。

内容的提问来源于stack exchange，提问作者flywell