【GitBlit】Windows搭建Git服务器详细教程

前言

如果公司或个人想在 Windows 环境下搭建私有的 Git 服务器，那么这个开源的 GitBlit 是一个不错的选择。

Gitblit 是一个开源纯 Java 的用于管理、查看和服务 Git 存储库。它是一个小型的托管集中式存储库工具。
支持 SSH、HTTP 和 GIT 协议，开箱即用。
Gitblit 融合了 GitHub、BitBucket 和 Gerrit 的元素，以提供基于主存储库中分支的简化协作工作流。
管理员可以从 Web UI 创建和管理所有存储库、用户帐户和团队。

一、安装 Java JDK

GitBlit 是纯 Java 开发的，因此须确保电脑已安装了 Java 运行时环境 JRE 或者 JDK (要求版本 >= 1.7) 。

1.1 下载 Java

官网下载地址: Download Java for Windows

1.2 安装 Java

软件下载后直接双击运行：

*注：大家根据自己的习惯选择安装路径（我默认安装在C盘）！

1.3 配置 Java 环境变量

打开环境变量配置：

右键 "此电脑(计算机)" => "属性" => "高级系统设置" => "高级" => "环境变量" => "系统变量"。

新建：
变量名：JAVA_HOME
变量值：C:\Program Files\Java\jdk1.6.0_21【根据自己实际的安装路径填写】

新建：
变量名：CLASSPATH
变量值：.;%JAVA_HOME%/lib/dt.jar;%JAVA_HOME%/lib/tools.jar

添加：
编辑 PATH 变量，在最后一行添加: %JAVA_HOME%/bin;%JAVA_HOME%/jre/bin

1.4 验证 Java 是否安装成功

打开命令窗口（win + r）=> 输入 cmd
在命令窗口中，输入 java 命令并回车：java -version，有版本信息，说明安装成功。

二、安装 GitBlit

2.1 下载 GitBlit 安装包

官网下载地址：Download GitBlit

下载最新的安装包版本 gitblit-1.9.3.zip

2.2 创建 GitBlit 配置目录

2.2.1 在 D 盘创建一个 Git 配置目录【大家根据自己的习惯选择配置盘】

2.2.2 在刚才创建的 Git 目录下新建一个存储资料文件夹：GitRepository

2.2.3 将【2.1】下载的 GitBit 安装包，也解压到 D:\Git 目录下【如上图所示】

2.3 配置 GitBlit

以下所有操作均在 D:\Git\gitblit-1.9.3 安装包目录下完成。

2.3.1 配置 defaults.properties 文件

打开 data/defaults.properties 文件，按照如下操作流程配置。

2.3.1.1 找到 git.repositoriesFolder，赋值为【2.2】的存储资料库路径

*注意: 这里的 D:/Git/GitRepository 中的 "\" 一定要用 "/"

2.3.1.2 找到 server.httpPort，设定服务器的 http 协议端口号（不使用 https 可直接注释掉）

通过 netstat -ano 可以查看哪些端口已被占用，然后填写一个未被占用的端口作为  http 端口即可；
一般来说，端口号的范围是 [0,  65535]，其中 [0,  1023] 是被系统保留的一些知名端口，而 [1024,  65535] 是动态或私有端口；
HTTP 协议的标准端口是 80，而 [1024,  65535] 可作为 HTTP 的非标准端口。

2.3.1.3 找到 server.httpBindInterface，设定服务器的 IP 地址（Windows本地 IP 地址）

2.3.1.4 找到 server.httpsBindInterface，设定为 localhost

最后，记得保存修改的文件内容！！！

2.3.2 运行 gitblit.cmd 批处理文件

2.3.2.1 在 gitblit-1.9.3 目录下找到 gitblit.cmd 文件，双击运行

2.3.2.2 打开浏览器，输入服务器地址与端口登录，就可以开始使用 GitBlit 了

2.3.3 设置 Windows Service 启动 GitBlit

如果你不希望每次开机后都要手动双击运行 gitblit.cmd 文件才能访问服务器，那么设置以 Windows Service 方式启动 GitBlit 就非常有必要了。

2.3.3.1 在 gitblit-1.9.3 目录下，找到并打开 installService.cmd 文件，修改内容如下

1. 修改 ARCH：
32位系统：SET ARCH=x86
64位系统：SET ARCH=amd64

2. 添加 CD 为 GitBlit 安装包路径：
SET CD=SET CD=D:\Git\gitblit-1.9.3 (大家根据自己实际目录路径填写)

3. 修改 StartParams 里的启动参数，赋值为空即可：
--StartParams="" ^

2.3.4 以 Windows Service 方式启动 GitBlit

2.3.4.1 右键 => 以管理员身份运行，GitBlit 目录下的 installService.cmd 文件

2.3.4.2 (win+r => 输入services.msc)打开服务(本地)，会发现 gitblit 服务已经存在了

2.3.4.3 此时如果 gitblit.cmd 文件也已经关闭了（并且不重启电脑），在网页访问 GitBlit 服务器会发现被拒绝，原因是服务(本地)存在的 gitblit 服务还没正式启动，需要手动设置一下

*注：刷新网页，服务器访问成功！

三、使用 GitBlit 服务器管理用户与项目

1. 首次访问 GitBlit 服务器，默认管理员的用户名和密码都是 admin，出于安全考虑可更改登录密码。

2. 一般来说，管理员都是管理用户和项目的，基本不作为 Git 项目的实际操作者（如，拉取、推送代码等）。

3. (admin)管理员的作用：创建新用户或团队，创建新项目或项目分支，编辑项目用户或团队权限，删除项目版本库等。

3.1 创建新的版本库

以创建一个 test.git 版本库为例，操作流程如下。

先点击图中的 "1.版本库"，然后再点击 "2.创建版本库"

填写项目名称和描述（注意：名称最后要加 .git，如果不加服务器会默认添加）
选择限制查看、克隆和推送
勾选 "加入README" 和 "加入.gitignore文件"
然后选择构建版本库需要忽略的文件，如 VisualStudio
最后，点击 "创建"

创建成功后，进入对应的新版本库，显示如下

3.2 用户管理

3.2.1 以管理员身份登录服务器

在网址输入框输入 GitBlit 服务器的地址和端口号，然后以(admin)管理员身份登录

3.2.2 创建新用户

以创建一个 test 用户为例，操作流程如下：

点击图中红色框中的 "用户"

点击 "添加用户"

填写用户的信息，红色框中的选项视情况勾选（可使用默认配置）
点击保存

添加成功后，会在列表中显示对应的用户信息

(注销admin) 以新用户身份登录服务器，可以看到页面是没有任何版本库信息的，这是因为当前新用户还没有任何版本库的权限

3.2.3 授予用户版本库的读写权限

切换到管理员账号，并进入想要授权的版本库
点击 "编辑"

再点击"权限(permissions)"，选择你想要授权的用户与权限
比如，用户选择 test，权限选择 "RW(推送)"
最后点击 "添加" (添加成功后，点击 "保存")

此时，切换到相应已授权的用户 (例如 test 用户)，可以看到他的页面已有版本库的信息

四、安装配置本地 Git 客户端工具

4.1 下载 Git 客户端工具

官网下载地址：Download Git

4.2 安装 Git 客户端工具

一路默认安装即可（如果安装在非C盘，则需要自定义安装路径），如下

4.3 将 SSH 公钥配置到 GitBlit 服务器

查看 SSH 公钥的方法：在任意文件夹下点击右键，选择 Git GUI here。弹出的界面如下

点击主菜单的【Help】→【Show SSH Key】

*注：如果电脑还没有 SSH 密钥，此时显示的内容是空白的，需要生成一对 SSH 密钥（其中密码可以为空，根据自己实际需要是否填写）！

点击 "Copy To Clibboard"，把 SSH 的公钥粘贴 GitBlit 服务器对应用户的后台配置中

4.4 通过 Git 客户端拉取 GitBlit 服务器版本库代码

使用新创建的用户名和密码登录 GitBlit 服务器
复制红色框中的版本库URL

本地创建一个 Test 目录并进入，右键选择 "Git Bash here"
此时通过 Git 客户端拉取代码，提示错误（没有权限）

$ git clone ssh://test@172.168.3.126:29418/test.git 

20:23 Update failed
Unable to negotiate with 172.168.3.126 port 29418: no matching host key type found. Their offer: ssh-rsa
Could not read from remote repository.

解决方法：进入 C 盘用户(账户)下的 .ssh 目录创建一个 config 文件，内容如下

Host *
HostkeyAlgorithms +ssh-rsa
PubkeyAcceptedKeyTypes +ssh-rsa

重新通过 Git 客户端拉取 GitBlit 服务器版本库代码，成功！！！

git clone ssh://test@172.168.3.126:29418/test.git

五、TortoiseGit 安装使用教程

TortoiseGit 是基于 TortoiseSVN 的 Git 版本的 Windows Shell 界面。它是开源的，可以完全使用免费软件构建。
TortoiseGit 支持你执行常规任务，例如 commit、显示日志、区分两个版本、创建分支和标签、创建补丁等。
如果你希望使用带有 UI 操作界面的 Git 客户端工具，而不是 Shell 命令行的方式，那么 TortoiseGit (小乌龟) 就非常适合你。详细教程请查阅《TortoiseGit安装使用详细教程》