前言

如果公司或个人想在 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 ｕｐｄａｔｅ 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安装使用详细教程》