必须将gitblit注册为原生windows服务,才能实现后台常驻、无人值守、随系统自启;需确保jdk≥11、正确配置installservice.cmd中arch与cd路径、以管理员身份运行安装脚本、放行防火墙端口,并在services.msc中设启动类型为“自动(延迟启动)”。

要在Windows 10上让GitBlit作为系统级服务长期稳定运行,避免每次开机手动双击启动、关机前忘记关闭、或用户登出后服务中断等问题,必须将其注册为原生Windows服务——这一步直接决定GitBlit能否真正“后台常驻、无人值守、随系统自启”。
确认Java环境与GitBlit目录结构
打开命令提示符(CMD),执行 java -version,确保输出显示 JDK 或 JRE 版本 ≥ 11(如 11.0.22)。版本低于11会导致 installService.cmd 启动失败且无明确报错。
解压后的GitBlit根目录下必须存在 installService.cmd、gitblit.cmd 和 data/ 子目录;若缺失 installService.cmd,说明下载的是极简版ZIP(如 gitblit-j7.zip),需改用完整版(如 gitblit-3.2.0.zip)。
修改 installService.cmd 配置参数
用记事本打开 GitBlit 根目录下的 installService.cmd。
找到 SET ARCH= 行:32位系统改为 SET ARCH=x86,64位系统必须设为 SET ARCH=amd64 ——写错会导致服务安装后无法启动,且事件查看器中只报“错误1053”,不提示根本原因。
在 SET CD= 行填入 GitBlit 实际安装的**绝对路径**,末尾不加反斜杠,例如:SET CD=E:\git\gitblit-3.2.0。
找到 StartParams= 行,将其清空为 StartParams="",否则服务会尝试传入非法参数而静默失败。
以管理员身份运行安装脚本
右键点击 installService.cmd → “以管理员身份运行”。
窗口快速闪退属正常现象——只要没有弹出红色报错(如“Access is denied”或“Failed to install service”),即表示注册成功。
【关键验证动作】 按 Win + R 输入 services.msc 回车,在服务列表中查找名为 Gitblit 的条目。若状态为“已停止”且“启动类型”为“自动(延迟启动)”,说明服务已注册成功;若完全找不到,说明上一步执行未生效,需检查是否漏掉管理员权限。
配置防火墙放行HTTP端口
方法一(图形界面):
打开“控制面板 → Windows Defender 防火墙 → 高级设置 → 入站规则 → 新建规则”,选择“端口” → TCP → 特定本地端口(填你在 gitblit.properties 中设置的 server.httpPort,如 8080)→ 允许连接 → 勾选“域、专用、公用” → 规则名称填 Gitblit HTTP。
方法二(命令行,更可靠):
以管理员身份运行 PowerShell,执行:New-NetFirewallRule -DisplayName "Gitblit HTTP" -Direction Inbound -Protocol TCP -LocalPort 8080 -Action Allow。
这一步不做,局域网内其他电脑将无法通过浏览器访问 http://你的IP:8080,但本机仍可访问。
启动并设为开机自启
第一步:在 services.msc 中右键 Gitblit → “启动”。
第二步:再次右键 → “属性” → “启动类型”下拉菜单中选择“自动(延迟启动)”。
第三步:点击“应用” → “确定”。
现在重启一次Windows 10,待桌面加载完成后,立即打开浏览器访问 http://127.0.0.1:8080。如果看到 GitBlit 登录页,且地址栏显示 http://(非 https:// 或报错页面),说明服务已真正实现后台自启、无需人工干预。











