当前位置：首页 > 系统教程 > 正文

Ubuntu环境下GitBlit安装部署与版本库迁移（从零开始搭建企业级Git服务器）

主机测评网
系统教程
2026-03-11
180

Ubuntu环境下GitBlit安装部署与版本库迁移（从零开始搭建企业级Git服务器）

在团队协作开发中，搭建一个私有的Git服务器对于代码管理和版本控制至关重要。本文将详细介绍如何在Ubuntu操作系统下进行GitBlit安装部署，并手把手教你完成Git版本库迁移的全过程。GitBlit是一款基于Java的轻量级Git仓库管理工具，无需数据库支持，配置简单，非常适合中小团队使用-1。

第一步：环境准备与Java安装

由于GitBlit是基于Java开发的，因此首先需要在Ubuntu系统中安装Java运行环境。GitBlit 1.9.1版本需要JDK 1.8才能正常运行-1。打开终端，执行以下命令安装OpenJDK 8-2：

                    sudo apt-get update            sudo apt-get install openjdk-8-jdk -y

安装完成后，通过以下命令验证Java是否安装成功：

                    java -version

如果输出显示Java版本为1.8.0_xxx，则说明环境配置成功-1。

第二步：下载与解压GitBlit

接下来，我们需要获取GitBlit安装包。建议前往GitHub官方release页面下载适配JDK 1.8的稳定版gitblit-1.9.1.tar.gz-1。在Ubuntu服务器上，可以使用wget命令直接下载：

                    # 创建安装目录            sudo mkdir -p /data/gitblit            cd /data/gitblit                        # 下载GitBlit（如果无法直接下载，请手动上传）            sudo wget https://github.com/gitblit/gitblit/releases/download/v1.9.1/gitblit-1.9.1.tar.gz                        # 解压安装包            sudo tar -zxvf gitblit-1.9.1.tar.gz

解压完成后，你会看到一个名为gitblit-1.9.1的目录，里面包含了GitBlit的所有运行文件-1。

Ubuntu环境下GitBlit安装部署与版本库迁移（从零开始搭建企业级Git服务器） Ubuntu GitBlit GitBlit安装部署 Git版本库迁移 Git服务器搭建第1张

第三步：核心配置修改

进入GitBlit目录，编辑核心配置文件defaults.properties：

                    cd /data/gitblit/gitblit-1.9.1            sudo vi defaults.properties

找到并修改以下几项关键配置-1：

                    # 设置HTTP端口，默认为8080            server.httpPort = 8080                        # 如果不需要HTTPS，将其禁用            server.httpsPort = 0                        # Git仓库存储路径（后续迁移会用到）            git.repositoriesFolder = ${gitblit.dataFolder}/git

保存文件后，别忘了检查Ubuntu防火墙状态，确保8080端口已放行-1：

                    sudo ufw allow 8080/tcp            sudo ufw reload

第四步：启动GitBlit服务

GitBlit支持前台启动和后台守护进程两种方式。为了生产环境稳定运行，建议使用后台启动模式-1：

                    cd /data/gitblit/gitblit-1.9.1            nohup sh gitblit.sh > gitblit.log 2>&1 &

启动后，需要通过几种方式验证服务是否正常运行-1：

1. 查看进程： ps -ef | grep gitblit，应该能看到sh和java两个进程。

2. 检查端口： sudo ss -tuln | grep 8080，确认端口处于LISTEN状态。

3. 本地访问： curl http://localhost:8080，如果返回HTML代码包含GitBlit关键词，则说明Git服务器搭建成功-1。

第五步：Git版本库迁移实战

对于已有历史版本库的团队来说，如何将旧仓库完整迁移到新搭建的GitBlit上是重中之重。Git版本库迁移的核心原理非常简单：只需将现有的裸仓库（通常以.git结尾）复制到GitBlit配置的仓库目录下即可-1。

5.1 定位仓库目录

首先，确认GitBlit的仓库存储位置。根据之前的配置，仓库默认路径为：

                    /data/gitblit/gitblit-1.9.1/data/git

5.2 复制历史仓库

假设你的备份仓库存放在/data/backup/repos/目录下，现在需要将它们复制到GitBlit的仓库目录-1：

                    # 示例：复制一个名为"my-project.git"的裸仓库            sudo cp -r /data/backup/repos/my-project.git /data/gitblit/gitblit-1.9.1/data/git/

5.3 设置权限

GitBlit运行需要读取这些仓库文件，因此必须设置正确的所有权和权限-1：

                    sudo chown -R root:root /data/gitblit/gitblit-1.9.1/data/git/            sudo chmod -R 755 /data/gitblit/gitblit-1.9.1/data/git/

5.4 重启GitBlit

完成仓库复制和权限设置后，需要重启GitBlit服务以使新仓库被识别-1：

                    # 停止原有进程            ps -ef | grep gitblit | grep -v grep | awk "{print $2}" | sudo xargs kill -9                        # 重新后台启动            cd /data/gitblit/gitblit-1.9.1            nohup sh gitblit.sh > gitblit.log 2>&1 &

重启后，访问GitBlit Web界面（http://你的服务器IP:8080），你应该能在仓库列表中看到刚刚迁移进来的my-project.git。至此，整个Git版本库迁移过程圆满结束。

总结与常见问题

通过以上五个步骤，我们成功在Ubuntu上完成了GitBlit安装部署并实现了历史Git版本库迁移。GitBlit作为一款优秀的Git服务器搭建工具，其简洁性和易用性非常适合中小团队-2。如果在迁移过程中遇到仓库无法显示的问题，请务必检查：1) 仓库目录权限是否正确；2) 仓库格式是否为裸仓库（包含branches, hooks, objects等目录）；3) 查看gitblit.log日志文件定位具体错误-1。

希望这篇教程能帮助你顺利搭建起属于自己的Git代码托管平台，让团队协作更加高效！