cl.3hh.win/index.php,windows 系统下 安装 gitblit 教程

Gitblit官方网站

本文实例版本号：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地址的 https 端口

server.httpsBindInterface =

SSH端口

#默认监听 ssh 端口 29418

git.sshPort =

#填写IP 默认为空

git.sshBindInterface =

#填写域名 默认为空

git.sshAdvertisedHost =

#填写IP 默认为空

git.sshAdvertisedPort =

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 =

#修改该参数为空

--StartParams="" ^

添加至服务

笔者配置过程发现，由于某个问题，双击 服务添加脚本 虽然添加进系统服务，也会无法启动， 所以推荐，保险做法，通过 cmd 控制台，手动启动，添加服务脚本。 #打开文件所在目录 如：C:\git\gitblit

cmd >cd

#执行安装脚本 输入 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 =

# 端口设置 默认 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

#将政策文件，解压至 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服务，成功启动说明成功替换证书。