如何在Windows中部署Gitblit：从零到一的完整指南

一、环境准备与前置条件

在Windows中部署Gitblit前，需确保系统满足以下基础条件：

1. 操作系统版本：推荐使用Windows 10/11或Windows Server 2016及以上版本，避免因系统兼容性问题导致部署失败。
2. Java运行环境：Gitblit基于Java开发，需安装JDK 8或更高版本（建议使用LTS版本如JDK 11）。可通过命令java -version验证是否安装成功。
3. 管理员权限：部署过程中需修改系统配置或开放端口，需以管理员身份运行命令提示符或PowerShell。

关键步骤：

• 下载JDK：从Oracle官网或OpenJDK社区获取安装包，安装时勾选”添加到系统PATH”选项。
• 配置环境变量：新建系统变量JAVA_HOME指向JDK安装目录（如C:\Program Files\Java\jdk-11），并在Path变量中添加%JAVA_HOME%\bin。

二、Gitblit安装包获取与解压

1. 下载Gitblit：访问Gitblit官方仓库，选择最新稳定版（如1.9.1）的Windows版本（gitblit-1.9.1.zip）。
2. 解压与目录规划：
   • 创建专用目录（如C:\gitblit），将压缩包解压至此。
   • 目录结构说明：

     C:\gitblit\
       ├── data/       # 默认存储仓库与配置
       ├── ext/        # 扩展插件目录
       ├── logs/       # 运行日志
       └── gitblit.cmd # Windows启动脚本

注意事项：

• 避免解压到包含空格或特殊字符的路径（如Program Files），可能导致脚本执行异常。
• 若需自定义数据目录，可在后续配置中修改baseFolder参数。

三、核心配置文件修改

Gitblit的主配置文件为gitblit.properties，需重点调整以下参数：

1. 服务器监听配置：

   server.httpPort = 8080       # HTTP访问端口（默认8080）
   server.httpsPort = 8443      # HTTPS端口（需配置SSL时启用）
   server.bindInterface = 0.0.0.0 # 允许所有IP访问

2. 数据存储路径：

   git.repositoriesFolder = C:/gitblit/data/git # 仓库存储路径（需使用正斜杠）
   app.baseFolder = C:/gitblit/data           # 配置与日志存储路径

3. 管理员账户设置：

   realm.userService = com.gitblit.users.FileUserService
   realm.fileUserService.usersFile = C:/gitblit/data/users.conf

   首次启动后，需手动编辑users.conf文件添加管理员账户：

   admin = admin,admin,administrator,admin@example.com,true

   （格式：用户名=密码,显示名,角色,邮箱,是否激活）

进阶配置：

• 若需启用HTTPS，需生成SSL证书并配置server.httpSslCert与server.httpSslKey参数。
• 通过web.enableRpc与web.enableGitServlet控制API与Git协议访问权限。

四、服务启动与访问验证

1. 启动方式：

   • 命令行启动：以管理员身份运行cmd，执行：

     cd C:\gitblit
     gitblit.cmd --baseFolder data

   • 注册为Windows服务（推荐长期运行）：

     1. 下载Apache Commons Daemon的procrun工具。

     2. 创建服务脚本（如install-gitblit-service.bat）：

        @echo off
        set PR_INSTALL=C:\gitblit\prunsrv.exe
        set PR_LOGPATH=C:\gitblit\logs
        set PR_STARTUP=auto
        set PR_STARTMODE=jvm
        set PR_STARTCLASS=com.gitblit.GitBlitServer
        set PR_STOPMODE=jvm
        set PR_STOPCLASS=com.gitblit.GitBlitServer
        set PR_JVM=auto
        set PR_CLASSPATH=C:\gitblit\gitblit.jar
        set PR_LOGPREFIX=gitblit
        set PR_STDOUTFILE=C:\gitblit\logs\stdout.log
        set PR_STDERRFILE=C:\gitblit\logs\stderr.log
        %PR_INSTALL% //IS//GitBlitService --DisplayName="GitBlit Service"

     3. 执行脚本后，通过services.msc管理服务启动/停止。

2. 访问测试：

   • 浏览器访问http://localhost:8080，应显示Gitblit欢迎页。
   • 使用管理员账户登录，验证仓库创建与克隆功能：

     git clone http://admin:admin@localhost:8080/r/test.git

五、常见问题与排查

1. 端口冲突：
   • 若8080端口被占用，通过netstat -ano | findstr 8080查找进程ID，终止后修改server.httpPort。
2. 权限不足：
   • 确保运行账户对data目录有完全控制权限（右键属性→安全→编辑）。
3. Java版本不兼容：
   • 若启动报错UnsupportedClassVersionError，需升级JDK至指定版本。
4. 防火墙拦截：
   • 开放对应端口的入站规则（控制面板→Windows Defender防火墙→高级设置）。

六、运维建议

1. 定期备份：
   • 备份data目录下的git（仓库）、users.conf（用户）与gitblit.properties（配置）文件。
2. 性能优化：
   • 调整JVM参数（修改gitblit.cmd中的JAVA_OPTS）：

     set JAVA_OPTS=-Xms512m -Xmx2g -Dfile.encoding=UTF-8

3. 日志监控：
   • 通过logs/gitblit.log分析启动错误或访问异常。

通过以上步骤，开发者可在Windows环境中快速搭建稳定的Gitblit服务，实现代码托管与团队协作需求。实际部署时，建议结合企业安全策略进一步配置认证方式（如LDAP集成）与访问控制规则。