本文以在Ubuntu 16.04上对Anroid N的源代码配置OpenGrok为例，记录了适合像我这种懒人的最基本搭建过程。想用各种高级用法请自行参见官方文档。

- 安装所需包

$ sudo apt-get install exuberant-ctags tomcat8

 $ sudo /etc/init.d/tomcat8 restart

浏览器中打开http://localhost:8080/，出现下图说明tomcat8没问题。

- 下载OpenGrok

在https://github.com/OpenGrok/OpenGrok/releases下载OpenGrok。注意如果和我一样比较懒的话下载biinary包，不要下source code。我用的是opengrok-0.12.1.5.tar.gz。下载完后解压。(链接: https://pan.baidu.com/s/1H4wBW2-EUR8HFfLenruIiA 提取码: uc1g)

- 部署OpenGrok

OpenGrok提供了现成的脚本。首先到前面解压后的目录，运行以下命令。其中环境变量OPENGROK_TOMCAT_BASE为tomcat所在路径（tomcat7貌似脚本自己能找到，tomcat8自动找不到，所以人肉指定）。

$ sudo OPENGROK_TOMCAT_BASE=/var/lib/tomcat8 ./OpenGrok deploy

我是直接拷贝的, cp ./lib/source.war /var/lib/tomcat8/webapps

可能要修改/var/lib/tomcat8/webapps/source/WEB-INF 目录下的web.xml配置文件

            <param-value>/home/killer/tool/linux/opengrok-0.12.1.5/etc/configuration.xml</param-value>

这步之后浏览器打开http://localhost:8080/source/，应该能看到下面的页面，但现在是空的。

- 生成索引

用下面命令生成代码索引。假如代码在/home/jzj/source/Android/7.1下的话：

$ sudo ./OpenGrok index /home/jzj/source/android/7.1/

也可以根据需要修改OpenGrok脚本,

OPENGROK_INSTANCE_BASE="${OPENGROK_INSTANCE_BASE:-/home/killer/tool/linux/opengrok-0.12.1.5}"

等结束后打开http://localhost:8080/source/，就能浏览代码了。