OpenGrok代码服务器搭建，解决代码检索慢的问题

一、背景

在前一家公司，公司提供了OpenGrok服务器供大家检索查阅代码。但在新公司，大家都使用vscode或Sourse Insight，这就存在一些问题：

不能跳转或者跳转比较慢。
搜索查询速度慢，且结果展示不易查看。

这严重影响了检索、阅读代码的效率，为了解决上面的问题，自己搭建了一个OpenGrok代码代码服务器，效果非常好，这篇文章记录下其中的过程，也给遇到同样问题的同学一个参考。

二、OpenGrok简介

OpenGrok是一个快速的代码搜索和交叉引用引擎。由Java语言编写而成，主要有以下功能。

可以搜索全文本、定义、符号、路径和修改记录。
可以将搜索限制在某个子树。
可以增量更新索引。
支持Google搜索类似搜索语法。
支持搜索某个时间段内被修改的文件。
支持使用通配符。
支持在搜索结果中显示匹配的行。
为版本控制工具提供了只读的web接口，包括文件修改提交记录和任意两个版本的文件差异。
支持在线交叉引用查询，包括语法高亮。
可扩展性强，可为新的编程语言和新的版本控制工具编写插件。

三、OpenGrok服务器搭建（Windows）

这里只介绍在Windows上安装搭建OpenGrok服务器的方法，Linux的安装方法可以自行百度。

3.1 下载OpenGrok

Releases · oracle/opengrok · GitHub

3.2 下载安装Tomcat

Tomcat 服务器是一个免费的开放源代码的Web 应用服务器，属于轻量级应用服务器，在中小型系统和并发访问用户不是很多的场合下被普遍使用，我们今天就用它来搭建我们的OpenGrok本地服务器。 Apache Tomcat® - Apache Tomcat 8 Software Downloads

添加环境变量：

TOMCAT_HOME=D:\software\tomcat\apache-tomcat-10.1.11-windows-x64\apache-tomcat-10.1.11

用GBK替换conf/logging.properties UTF-8，解决tomcat的乱码问题
运行bin/startup.bat
访问http://localhost:8080/ 出现tomcat官网文件，证明tomcat安装成功

3.3 下载安装JDK

Java Downloads | Oracle 中国

3.4 下载ctags

[https://github.com/universal-ctags/ctags-win32/releases](https://github.com/universal-ctags/ctags-win32/releases CTAGS_HOME=D:\software\ctag\ctags)

添加环境变量

CTAGS_HOME=D:\software\ctag\ctags

3.5 配置OpenGrok环境

3.5.1 配置Data Root目录

data root 用于放置生成的索引文件和配置信息，比如我在 OpenGrok 目录下创建了一个 data 目录用作 data root，即 D:\software\opengrok\opengrok-1.12.12\data。

3.5.2 配置source.war

将 OpenGrok 的 lib 目录里的 source.war 解压到 D:\software\tomcat\apache-tomcat-10.1.11-windows-x64\apache-tomcat-10.1.11\webapps 配置 WEB-INF\web.xml 文件的 CONFIGURATION 为上一步生成的 data 目录下的 configureation.xml，比如我的配置：

<display-name>OpenGrok</display-name>
    <description>A wicked fast source browser</description>
    <context-param>
        <description>Full path to the configuration file where OpenGrok can read its configuration</description>
        <param-name>CONFIGURATION</param-name>
        <param-value>D:/software/opengrok/opengrok-1.12.12/data/configuration.xml</param-value>
    </context-param>

3.5.3 配置source root

可以让 OpenGrok 认为 source root 下的每个子文件夹是一个项目，所以我们利用这个特性来配置和阅读多个项目源码就好了。我的做法是在 OpenGrok 直接使用我Hyper-H创建的虚拟机的映射地址：Z:\project

3.5.4 建立索引

使用 opengrok.jar 调用 ctags 来为源码建立索引。命令行使用：

java -jar "D:\software\opengrok\opengrok-1.12.12\lib\opengrok.jar" -W "D:\software\opengrok\opengrok-1.12.12\data\configuration.xml"  -P -S -v -s "Z:\project" -d "D:\software\opengrok\opengrok-1.12.12\data"

 -P 表示为 source root 目录下的每个一级子目录生成一个工程。
 -S 表示搜索并添加 “external” source repositories。
 -v 表示打印操作的进度信息。
 -s 表示指定 source root。
 -d 表示指定 data root。
 -W 表示指定将配置写到该文件。
 还有更多配置选项可以使用 java -jar /path/to/opengrok.jar 查看。

成功时的样子：