如何在Keycloak应用中传递Java opts？含Java agent及保留现有配置

优先推荐：修改standalone.conf（Linux/macOS） #

这是Keycloak官方推荐的配置方式，可避免直接修改启动脚本导致的配置覆盖问题：

1. 打开Keycloak安装目录下的bin/standalone.conf文件
2. 找到文件中定义JAVA_OPTS的代码块，不要替换原有配置，直接追加Java Agent参数：

   # 在原有JAVA_OPTS基础上新增agent配置
   JAVA_OPTS="$JAVA_OPTS -javaagent:/绝对路径/到/你的/agent.jar"
   

   示例：若原有JAVA_OPTS为JAVA_OPTS="-Xms64m -Xmx512m ..."，修改后保留所有原有参数，仅新增agent部分
3. 保存文件后重启Keycloak服务

Windows环境：修改standalone.conf.bat #

Windows下对应修改bin/standalone.conf.bat文件：

set "JAVA_OPTS=%JAVA_OPTS% -javaagent:C:\绝对路径\到\你的\agent.jar"

修改standalone.sh（不推荐） #

若之前修改standalone.sh未生效，大概率是因为配置被standalone.conf覆盖。若坚持修改启动脚本，需找到JVM启动的核心命令行直接追加参数：

1. 打开bin/standalone.sh，定位到以eval "\"$JAVA\"" $JAVA_OPTS开头的Java进程启动代码段
2. 在$JAVA_OPTS后直接添加agent参数：

   eval "\"$JAVA\"" $JAVA_OPTS -javaagent:/绝对路径/到/你的/agent.jar \
     -Dorg.jboss.boot.log.file="$JBOSS_LOG_DIR"/server.log \
     -Dlogging.configuration="$logging_config" \
     -jar "\"$JBOSS_HOME\""/jboss-modules.jar \
     $MODULE_OPTS \
     -mp "\"$JBOSS_MODULEPATH\"" \
     org.jboss.as.standalone \
     "$SERVER_OPTS" \
     "$@"
   

验证配置是否生效 #

启动Keycloak后，通过以下方式确认agent已加载：

• Linux/macOS执行ps aux | grep java，查看进程命令行是否包含-javaagent:/你的/agent路径.jar
• 查看Java Agent自身的日志文件，确认是否有初始化记录

注意事项 #

• 必须使用绝对路径指向agent.jar，避免相对路径导致的文件找不到问题
• 确保Keycloak运行用户拥有agent.jar文件的读取权限
• 若使用集群模式（domain模式），需对应修改domain.conf或domain.conf.bat文件
• 部分Agent需要额外配置参数，可直接追加在agent路径后，例如：-javaagent:/path/agent.jar=config=./agent.properties

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