能否替换Gerrit登录页面？自定义登录页及背景图设置求助

步骤1：放置背景图到指定目录 #

• 将准备好的背景图（比如命名为bg-login.jpg）上传到Gerrit站点目录的static文件夹下，路径一般为$GERRIT_SITE/static。
• 设置正确的文件权限，避免Gerrit无法读取：

  chmod 644 $GERRIT_SITE/static/bg-login.jpg
  

步骤2：自定义登录模板文件 #

Gerrit登录页面的默认模板是LoginForm.soy，我们通过自定义模板覆盖的方式修改，不直接改动原文件：

1. 在Gerrit站点的etc目录下创建自定义模板目录：

   mkdir -p $GERRIT_SITE/etc/custom_templates
   

2. 从Gerrit安装目录的模板路径复制LoginForm.soy到上述目录：

   cp <gerrit_install_path>/war/WEB-INF/templates/LoginForm.soy $GERRIT_SITE/etc/custom_templates/
   

3. 编辑复制后的LoginForm.soy，找到登录表单的容器样式块（通常是.login-form），添加背景图相关CSS：

   .login-form {
     /* 保留原有样式，新增以下背景配置 */
     background-image: url('../static/bg-login.jpg');
     background-size: cover;
     background-position: center;
     background-repeat: no-repeat;
     /* 可选：调整表单背景透明度，避免遮挡背景图 */
     background-color: rgba(255,255,255,0.7);
   }
   

   如果要给整个页面加背景，就找到最外层容器（比如.page）添加上述样式。

步骤3：配置Gerrit加载自定义模板 #

编辑$GERRIT_SITE/etc/gerrit.config，在[web]段添加自定义模板路径：

[web]
  customTemplates = etc/custom_templates

步骤4：重启Gerrit生效 #

执行命令重启Gerrit服务，让配置和模板修改生效：

gerrit restart

你可以根据需求调整CSS细节，比如背景图的拉伸方式、表单的布局样式等，LDAP认证的登录逻辑不会受这些样式修改影响。

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