必须统一Java版本、路径格式与权限配置：Windows需手动设JAVA_HOME并用正斜杠路径，Linux用包管理器装JDK21且禁用tar.gz手动安装；索引目录须跨平台映射并标准化路径；Web服务在Windows用Service Wrapper注册，在Linux用systemd托管。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Linux服务器上稳定运行代码搜索服务，同时在Windows工作站上保持相同功能体验，必须处理OpenGrok在两大平台间的关键部署差异——Java版本兼容性、路径分隔符敏感性、索引存储权限控制这三点不一致，就会导致索引失败或Web界面无法加载源码。
Java环境配置差异
OpenGrok依赖Java运行时，但Windows与Linux对JAVA_HOME的解析逻辑不同，直接复用同一套配置会触发“找不到tools.jar”或“Unsupported Java version”错误。
方法一：Windows平台手动校准
下载JDK 21（非JRE），安装时勾选“设置JAVA_HOME”，安装完成后打开PowerShell执行：【$env:JAVA_HOME = "C:\Program Files\Java\jdk-21"；再运行[System.Environment]::SetEnvironmentVariable("JAVA_HOME", $env:JAVA_HOME, "Machine")永久写入系统变量。
方法二：Linux平台用包管理器统一管控
Ubuntu/Debian系执行sudo apt install openjdk-21-jdk，CentOS Stream 9执行sudo dnf install java-21-openjdk-devel；安装后验证java -version输出含“21.0.x”且无警告，【不要手动解压tar.gz并软链接，否则systemd服务启动时无法继承PATH】。
索引路径与存储权限适配
OpenGrok的source root目录在Linux下默认归root所有，在Windows下却由当前用户创建，跨平台同步索引时若权限不匹配，Linux容器内进程将无法读取Windows生成的index文件。
第一步：统一索引根目录结构
在Windows工作站上，将代码仓库置于D:\opengrok\src；在Linux服务器上，建立对应挂载点/mnt/opengrok/src，并确保该目录属组为opengrok（非root）。
第二步：强制索引输出路径标准化
启动索引命令时，Windows用opengrok.jar -s D:/opengrok/src -d D:/opengrok/data，Linux用java -jar opengrok.jar -s /mnt/opengrok/src -d /mnt/opengrok/data；【两个路径中的斜杠必须全为正斜杠，Windows下禁止使用反斜杠，否则ctags解析失败】。
第三步：Linux端解除SELinux干扰（仅RHEL/CentOS）
执行sudo setsebool -P container_manage_cgroup on，再运行sudo semanage fcontext -a -t container_file_t "/mnt/opengrok(/.*)?"，最后sudo restorecon -Rv /mnt/opengrok。
Web容器部署模式切换
Tomcat是OpenGrok官方推荐的Web容器，但Windows与Linux对其服务注册方式完全不同：Windows习惯以Windows服务后台运行，Linux则依赖systemd托管，混用会导致重启后服务静默退出。
Windows方案：使用Service Wrapper注册为系统服务
下载Apache Commons Daemon的prunsrv.exe，执行prunsrv //IS//OpenGrok --DisplayName="OpenGrok Search" --Install="D:\opengrok\tomcat\bin\prunsrv.exe" --Jvm="%JAVA_HOME%\jre\bin\server\jvm.dll"，随后在服务管理器中启动。
Linux方案：编写systemd单元文件
创建/etc/systemd/system/opengrok.service，内容包含Type=forking、ExecStart=/opt/tomcat/bin/startup.sh、Restart=on-failure；启用前执行sudo systemctl daemon-reload，再sudo systemctl enable opengrok。
