Keycloak 20.0.1：如何添加自定义Supported locales语言选项

步骤1：准备语言资源文件 #

Keycloak的界面文本依赖主题目录下的属性文件，你需要为波斯语创建对应的翻译文件：

• 找到Keycloak安装目录下的主题文件夹，默认路径为{keycloak-home}/themes/base/admin/messages/
• 复制默认的英文资源文件messages_en.properties，重命名为messages_fa.properties（fa是波斯语的ISO语言代码）
• 打开新文件，将里面的英文文本逐一翻译成波斯语

提示：如果需要区分区域（比如伊朗波斯语），可以命名为messages_fa_IR.properties，后续添加语言选项时用fa-IR作为代码

步骤2：添加语言到Supported locales下拉框 #

• 登录Keycloak管理控制台，进入目标Realm的「设置」->「本地化」标签页
• 在Supported locales输入框中，手动添加fa（或fa-IR），多个语言用逗号分隔
• 点击「保存」按钮，刷新页面后就能在下拉框中看到波斯语选项

步骤3：验证效果 #

• 在本地化标签页的Default locale下拉框中选择刚添加的波斯语，保存后查看管理控制台界面是否切换为波斯语显示
• 也可以在用户登录时切换语言，验证前端界面的翻译是否生效

内容的提问来源于stack exchange，提问作者reza ramezani matin