NSIS制作Windows安装包：Keycloak 15.1.1部署配置失败求助

一、修复Windows服务部署问题 #

Keycloak 15.1.1基于JBoss EAP，需通过官方提供的service.bat工具安装服务，避免手动修改service.conf导致的配置错误：

• 先清理之前的错误服务（如果有）：

  [KEYCLOAK_INSTALL_DIR]\bin\service.bat uninstall
  

• 执行以下命令静默安装服务（替换[KEYCLOAK_INSTALL_DIR]为实际安装路径）：

  [KEYCLOAK_INSTALL_DIR]\bin\service.bat install /name="KeycloakService" /displayname="Keycloak Authentication Service" /starttype=auto
  

二、静默创建初始管理员用户 #

无需启动Keycloak服务，直接用add-user.bat命令行静默创建管理员，避免弹出终端窗口：

[KEYCLOAK_INSTALL_DIR]\bin\add-user.bat -r master -u [ADMIN_USERNAME] -p [ADMIN_PASSWORD] -s

参数说明：

• -r master：指定在master领域创建用户
• -u/-p：管理员用户名和密码
• -s：静默执行，无交互输出

三、领域配置导入 #

推荐两种可靠的导入方式：

方式1：服务启动时自动导入 #

修改服务配置文件[KEYCLOAK_INSTALL_DIR]\bin\service.conf，在jvm_options行添加导入参数，确保服务启动时自动加载领域配置：

jvm_options=-Dkeycloak.migration.action=import -Dkeycloak.migration.provider=singleFile -Dkeycloak.migration.file=[PATH_TO_REALM_JSON] -Dkeycloak.migration.strategy=OVERWRITE_EXISTING

添加完成后重启Keycloak服务即可生效。

方式2：安装阶段一次性导入 #

先后台启动standalone模式完成导入，再切换为服务运行：

:: 后台启动standalone模式，无窗口弹出
start /b [KEYCLOAK_INSTALL_DIR]\bin\standalone.bat -Dkeycloak.migration.action=import -Dkeycloak.migration.provider=singleFile -Dkeycloak.migration.file=[PATH_TO_REALM_JSON] -Dkeycloak.migration.strategy=OVERWRITE_EXISTING

:: 等待服务启动完成（根据实际情况调整等待时长，比如30秒）
timeout /t 30 /nobreak >nul

:: 关闭standalone进程
taskkill /f /im java.exe

:: 启动Windows服务
net start KeycloakService

四、修正后的NSIS代码示例 #

!include "LogicLib.nsh"
!include "FileFunc.nsh"

Name "Keycloak 15.1.1 Installer"
OutFile "KeycloakSetup.exe"
InstallDir "$PROGRAMFILES\Keycloak-15.1.1"

Section "Install Keycloak"
    ; 解压Keycloak到安装目录
    SetOutPath "$INSTDIR"
    File /r "keycloak-15.1.1\*"

    ; 静默创建管理员用户
    ExecWait '"$INSTDIR\bin\add-user.bat" -r master -u admin -p Admin@123 -s'

    ; 安装Windows服务
    ExecWait '"$INSTDIR\bin\service.bat" install /name="KeycloakService" /displayname="Keycloak Authentication Service" /starttype=auto'

    ; 修改服务配置，添加领域导入参数（假设领域文件放在安装目录的config子文件夹）
    FileOpen $0 "$INSTDIR\bin\service.conf" a
    FileWrite $0 "`n`njvm_options=-Dkeycloak.migration.action=import -Dkeycloak.migration.provider=singleFile -Dkeycloak.migration.file=$INSTDIR\config\realm-export.json -Dkeycloak.migration.strategy=OVERWRITE_EXISTING"
    FileClose $0

    ; 启动服务
    ExecWait 'net start KeycloakService'
SectionEnd

Section "Uninstall"
    ; 停止服务
    ExecWait 'net stop KeycloakService'
    ; 卸载服务
    ExecWait '"$INSTDIR\bin\service.bat" uninstall'
    ; 删除安装目录
    RMDir /r "$INSTDIR"
SectionEnd

关键注意事项 #

• 确保安装包中包含realm-export.json文件，路径与代码中配置一致
• Java环境需提前安装并配置到系统PATH，或在service.conf中添加java_home=[JAVA_INSTALL_DIR]指定Java路径
• 若服务启动报错，查看[KEYCLOAK_INSTALL_DIR]\standalone\log下的日志文件，定位具体问题（如端口占用、JSON配置格式错误）

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