Tomcat ROOT目录部署Gitblit后SSH链接不可见的解决求助

我之前也碰到过类似的情况，在Tomcat ROOT目录部署Gitblit确实会因为上下文路径的解析冲突，导致SSH链接无法正常生成或显示。不用移出ROOT目录也能解决，试试下面这几个可行方案：

方案1：修正Gitblit的基础URL与SSH外部链接配置 #

Gitblit在ROOT目录下时，默认可能无法正确识别自身的外部访问路径，导致SSH链接生成错误。你需要手动指定这些配置：

• 找到Gitblit的配置文件gitblit.properties（通常在ROOT/WEB-INF/data目录下，或者你指定的Gitblit数据目录）
• 找到并修改以下配置项：

  # 设置Gitblit的外部访问根地址，替换成你的服务器IP/域名+Tomcat端口
  gitblit.baseUrl = http://your-server-ip:8080/
  # 手动指定SSH的外部链接地址，端口默认是29418，根据你的实际配置修改
  gitblit.ssh.externalUrl = ssh://your-server-ip:29418/
  

• 保存配置后，重启Tomcat服务，再刷新Gitblit页面查看SSH链接是否正常显示。

方案2：显式配置Tomcat的ROOT上下文 #

有时Tomcat对ROOT目录的上下文解析会有模糊性，显式配置可以让Gitblit更准确地识别路径：

• 进入Tomcat的conf/Catalina/localhost目录（如果没有就手动创建）
• 创建一个名为ROOT.xml的文件，内容如下：

  <Context path="" docBase="ROOT" reloadable="true">
      <!-- 确保Gitblit的资源能被正确加载 -->
      <ResourceLink name="gitblit" global="gitblit" type="com.gitblit.GitBlit"/>
  </Context>
  

• 重启Tomcat，这个配置会强制Tomcat将ROOT目录识别为根上下文，避免路径解析混乱。

方案3：检查并确保SSH服务正常运行 #

SSH链接不显示也可能是Gitblit的SSH服务本身没有启动，或者端口配置有误：

• 登录Gitblit的后台管理页面（http://your-server-ip:8080/admin）
• 进入Settings -> SSH选项卡
• 确认ssh.enable选项已勾选（启用SSH服务），并且端口号和你在gitblit.properties中设置的一致
• 检查External SSH URL字段是否已正确填写，如果为空，手动输入你的SSH链接地址（比如ssh://your-server-ip:29418/），保存配置后重启服务。

方案4：确认防火墙与端口可用性 #

虽然你提到有防火墙限制，但至少要确保Gitblit的SSH端口（默认29418）在Windows Server上是开放的：

• 打开Windows防火墙高级设置，添加入站规则，允许TCP端口29418的访问
• 在服务器上用telnet localhost 29418命令测试端口是否能正常连通，确保端口没有被其他服务占用。

这些方案从路径解析、服务配置到网络层面覆盖了常见问题，按顺序尝试应该能解决SSH链接不显示的问题。

内容的提问来源于stack exchange，提问作者h.muja