本文实例版本号:1.8
下载完毕后,解压至任意位置。
本文笔者系统环境说明:
- windows Server 2008 R2 数据中心版 64位
- Java 8 JRE 32位
1. gitblit 服务配置
默认配置文件
{gitblit安装目录}\data\defaults.properties
如果需要使用其他配置文件,需要修改同目录下的配置引导文件内的 include 值
{gitblit安装目录}\data\gitblit.properties
#值为你新建的配置文件
include = my.properties
基本服务配置
1. 设置仓库路径
该参数为必填内容
#自定义仓库目录
git.repositoriesFolder = C:/git/GitRepository
2. 服务端口设置
重要,必须修改,文档内的参数:_请填写实际搭建的服务器IP,域名,端口_
#服务的标准 http 端口。<= 0禁用此连接器。
# 默认为 0
server.httpPort = <端口号>;
#安全/ SSL https 端口服务。<= 0禁用此连接器。
# 默认 8443
server.httpsPort = <端口号>
#重定向功能 http => https,默认为 关闭状态
server.redirectToHttpsPort = false
# 绑定IP,默认为空,监听所有IP地址的 http 端口
server.httpBindInterface = <ip/或者不填>
# 绑定IP,默认为空,监听所有IP地址的 https 端口
server.httpsBindInterface = <ip/或者不填>
SSH端口
#默认监听 ssh 端口 29418
git.sshPort = <端口号>
#填写IP 默认为空
git.sshBindInterface = <ip/或者不填>
#填写域名 默认为空
git.sshAdvertisedHost = <域名>
#填写IP 默认为空
git.sshAdvertisedPort = <ip/或者不填>
3. 启动Gitblit服务
- 手动启动
# 双击执行,成功执行文件,并没有自动关闭,说明成功运行Gitblit服务
{gitblit安装目录}\gitblit.cmd
- 手动关闭
# 也可以点击关闭 启动的 cmd 窗口 服务即终止
# 或者双击执行,自动关闭启动的 cmd 窗口
{gitblit安装目录}\gitblit-stop.cmd
4. Giblit 服务随系统自动启动
- 注意事项
Gitblit(1.8版本),自动启动需要修改,自带的服务添加文件
#服务添加脚本
{gitblit安装目录}\installService.cmd
#服务删除脚本
{gitblit安装目录}\uninstallService.cmd
- 编辑修改文件
选择 服务添加脚本 -> 右键选择 编辑
#修改 默认 ARCH = amd64
#执行无效,修改为 x86
SET ARCH=x86
#新建变量,指定gitblit服务文件路径,下面是实例安装目录 如:C:\git\gitblit
SET CD = <gitblit安装目录>
#修改该参数为空
--StartParams="" ^
- 添加至服务
笔者配置过程发现,由于某个问题,双击 服务添加脚本 虽然添加进系统服务,也会无法启动, 所以推荐,保险做法,通过cmd
控制台,手动启动,添加服务脚本。
#打开文件所在目录 如:C:\git\gitblit
cmd >cd <gitblit安装目录>
#执行安装脚本 输入 installService.cmd
cmd C:\git\gitblit > installService.cmd
- 检查服务状态
- 打开任务管理器,查看 gitblit 服务是否正在运行
 - 运行
{gitblit安装目录}\gitblitw.exe
测试,手动 开启,关闭,是否正常。

5. 高级设置(常用)
- 全局属性
# 新存储库的默认访问限制。
# 有效值为NONE,PUSH,CLONE,VIEW
# NONE = 匿名视图,克隆和推
# PUSH = 匿名视图&克隆和验证推
# CLONE = 匿名视图,验证克隆和推
# VIEW = 验证视图,克隆,按
git.defaultAccessRestriction = PUSH
#新存储库的默认授权控制。
#有效值进行身份验证,并命名为
#AUTHENTICATED =任何身份验证的用户授予限制访问
#NAMED =只有指定的用户/团队被授予限制访问
git.defaultAuthorizationControl = NAMED
- 开启用户认证,非公开可浏览模式
#默认是 false
web.authenticateViewPages = true
- 使用windows基本认证,必须非公开模式下生效
#默认是 false
web.enforceHttpBasicAuthentication = true
- 站点名称
# 默认空白 官方说明:If blank Gitblit is displayed.
web.siteName = git
- 链接生成
#使用自定义端口时需要填写 如 非80 443 默认为 空
#此URL的主机名将被提取用于SSH和GIT协议存储库
# e.g. web.canonicalUrl = https://dev.gitblit.com
# web.canonicalUrl = https://dev.gitblit.com:8443
web.canonicalUrl = https://<域名>
#填写正确的域名
- 工单服务,【默认没有开启】
# 设置工单数据存储方式 三选一
# 一:.git目录下的文件系统中
# com.gitblit.tickets.FileTicketService
# 二:独立的分支上 这使您可以轻松地将整个故障单历史记录复制到客户端工作副本或镜像。
# com.gitblit.tickets.BranchTicketService
# 三:Redis数据库服务
# com.gitblit.tickets.RedisTicketService
tickets.service = com.gitblit.tickets.BranchTicketService
# Redis数据库服务 选择使用 redis 数据库
tickets.redis.url = redis://(:{password}@){hostname}:{port}(/{databaseId})
tickets.redis.url = redis://localhost:6379
tickets.redis.url = redis://:password@localhost:6379/2
- robots文件位置
#搜索引擎机器人的道德文件
#默认位置 {安装目录}\data\robots.txt
web.robots.txt = ${baseFolder}/robots.txt
- 联合注册
# 向非管理员用户显示联合注册(无令牌)和当前的状态
web.showFederationRegistrations = false
# 这是web.authenticateViewPages = true 时显示的消息
# 这可以指向一个包含Markdown内容的文件。
# 指定“gitblit”使用内部登录消息。
web.loginMessage = gitblit
- 时区
# 修改最后修改时间格式
web.datetimestampLongFormat = yyyy-MM-dd HH:mm:ss, EEEE
- 邮件设置
# IP或SMTP服务器主机名
# 默认为空 不启用
mail.server = <IP或SMTP服务器主机名>
# 端口设置 默认 25
mail.port = <端口>
#邮件认证模式 tls
#默认 false
mail.starttls = false
# 邮件服务器认证
mail.username = <账号>
mail.password = <密码>
#显示邮件发送地址 收件人显示的,发送人邮箱
mail.fromAddress = noreply@example.com
# 管理员邮件名称 管理员邮箱
mail.adminAddresses = noreply@example.com
- 群发邮件通知
#发送推送电子邮件通知的电子邮件地址列表。
#这个键目前需要使用sendemail.groovy钩子脚本。
#如果您在groovy.postReceiveScripts中设置了sendemail.groovy,
#那么将所有存储库的电子邮件通知(不管访问限制!)
#发送到这些地址。
mail.mailingLists =
6. 更多设置请查看配置文件与官方文档说明
2. Gitblit Https SSL 证书修改
1. 绑定证书
# 指定证书名称
# 默认名称 localhost
server.certificateAlias = localhost
# 证书库密码与证书密码必须一致 方便管理
# 默认密码 gitblit
#如果您使用的是来自Oracle的官方JRE或JDK,
#则您的JVM 可能没有 JCE Unlimited Strength Jurisdiction 策略文件。
#因为这个,你的存储/密钥密码不能超过7个字符。如果你需要的话
#您可能需要更长的密码才能
#从Oracle 安装 JCE Unlimited Strength Jurisdiction 策略文件。
server.storePassword = gitblit
JCE Unlimited Strength Jurisdiction 策略文件 从 Oracle 官网下载
#将政策文件,解压至 Java 安装目录内的下面路径文件夹即可
{java安装目录}\lib\security
2. Https域证书修改
关于ssl证书,gitblit 启动时,会根据配置文件去检测一些文件,如果没有所需文件,将会根据配置文件进行生成。其中就包括证书库文件,位置如下:
{gitblit安装目录}\data\serverKeyStore.jks
- 准备工作
- 确保当前已停止Gitblit服务;
- Portecle 点击打开网址 :用于编辑证书文件,需要Java环境运行;
- 有效的域名证书,证书必须包含证书与私钥,以 214351170410809.pfx 为例子;
- 删除旧文件
#在证书目录下
{gitblit安装目录}\data\certs
#删除以下文件
{gitblit安装目录}\data\certs\ca.cer
{gitblit安装目录}\data\certs\caKeyStore.p12
{gitblit安装目录}\data\certs\caRevocationList.crl
#新文件会在Gitblit服务启动的时候,重新生成
- 域名证书格式转换
- 使用 Portecle 工具,编辑 214351170410809.pfx 域名证书:
- 双击运行 Portecle.jar =>可以直接将证书拖入对话框内->输入证书密码->选择证书->右键选择导出->选择类型为:证书与私钥;格式为:PKCS#12->输入新的证书密码,或者旧密码保持密码不变->选择导出目录->导出完成
- 视频实例,(密码:yxwl001)
点击观看视频
- 编辑gitblit证书库
- 使用 Portecle 工具,编辑 serverKeyStore.jks :
- 双击运行 Portecle.jar => 直接将文件拖入对话框->输入证书库密码->选中默认证书->右键选择删除->点击导入->选择刚才导出的证书->输入证书密码->查看证书信息->填写证书名称->确认证书密码->导入完成提示->点击保存当前文件
- 视频实例,(密码:yxwl002)
点击观看视频
- 成功保存后,启动Gitblit服务,成功启动说明成功替换证书。