怎么在Linux下使用Gitblit工具创建Git仓库服务

# 怎么在Linux下使用Gitblit工具创建Git仓库服务

## 前言

在软件开发过程中，版本控制系统是必不可少的工具。Git作为目前最流行的分布式版本控制系统，被广泛应用于各类项目中。虽然GitHub、GitLab等托管服务提供了便捷的在线仓库管理，但有时我们需要在本地或内网搭建自己的Git服务。本文将详细介绍如何在Linux系统下使用Gitblit工具搭建私有Git仓库服务。

## 一、Gitblit简介

### 1.1 什么是Gitblit

Gitblit是一个开源的、纯Java编写的Git仓库管理工具，它提供了：
- Git仓库管理界面
- 用户权限控制
- 仓库浏览功能
- 支持HTTP/HTTPS和SSH协议
- 集成文档/wiki系统

### 1.2 Gitblit特点

- 轻量级：不需要数据库支持，使用文件系统存储配置
- 跨平台：基于Java开发，可在任何支持Java的平台上运行
- 简单易用：配置简单，适合小型团队或个人使用
- 功能完整：提供类似GitHub的基本功能

## 二、准备工作

### 2.1 系统要求

- Linux操作系统（本文以Ubuntu 20.04为例）
- Java运行环境（JRE 1.8或更高版本）
- 至少1GB可用内存
- 2GB以上磁盘空间（取决于仓库数量）

### 2.2 安装Java

```bash
sudo apt update
sudo apt install openjdk-11-jre

验证安装：

java -version

三、安装Gitblit

3.1 下载Gitblit

访问Gitblit官网(http://www.gitblit.com/)下载最新版本，或直接使用wget：

wget https://github.com/gitblit/gitblit/releases/download/1.9.3/gitblit-1.9.3.tar.gz

3.2 解压安装包

tar -zxvf gitblit-1.9.3.tar.gz
sudo mv gitblit-1.9.3 /opt/gitblit

3.3 创建专用用户（可选但推荐）

sudo adduser --system --shell /bin/bash --group gitblit
sudo chown -R gitblit:gitblit /opt/gitblit

四、配置Gitblit

4.1 修改配置文件

主要配置文件位于/opt/gitblit/data/gitblit.properties：

cd /opt/gitblit/data
cp gitblit.properties.example gitblit.properties
nano gitblit.properties

关键配置项：

# 服务器设置
server.httpPort = 8080
server.httpsPort = 8443
server.httpBindInterface = 0.0.0.0

# 仓库存储路径
git.repositoriesFolder = /opt/gitblit/data/git

# 管理员账户
realm.adminUser = admin
realm.adminPassword = admin123

4.2 配置HTTPS（可选）

如果需要HTTPS支持，需要生成或导入SSL证书：

keytool -genkey -alias gitblit -keyalg RSA -keystore /opt/gitblit/data/server.jks

然后在配置文件中启用HTTPS：

server.httpsPort = 8443
server.httpsBindInterface = 0.0.0.0
server.httpsCertificate = server.jks
server.httpsCertificatePassword = yourpassword

五、运行Gitblit

5.1 直接运行（测试用）

cd /opt/gitblit
./gitblit.sh

5.2 作为服务运行

创建systemd服务文件：

sudo nano /etc/systemd/system/gitblit.service

内容如下：

[Unit]
Description=Gitblit Git Server
After=network.target

[Service]
User=gitblit
Group=gitblit
WorkingDirectory=/opt/gitblit
ExecStart=/opt/gitblit/gitblit.sh
Restart=always

[Install]
WantedBy=multi-user.target

启用并启动服务：

sudo systemctl daemon-reload
sudo systemctl enable gitblit
sudo systemctl start gitblit

检查状态：

sudo systemctl status gitblit

六、使用Gitblit

6.1 访问Web界面

浏览器访问：http://your-server-ip:8080

使用管理员账户登录（默认admin/admin123）

6.2 创建新仓库

1. 登录后点击”Repositories” > “New repository”
2. 输入仓库名称（如myproject.git）
3. 设置访问权限
4. 点击”Create”按钮

6.3 用户管理

1. 点击”Users” > “Create user”
2. 填写用户名、密码等信息
3. 设置用户权限
4. 点击”Create”按钮

6.4 团队管理

1. 点击”Teams” > “Create team”
2. 输入团队名称
3. 添加团队成员
4. 设置团队权限
5. 点击”Create”按钮

七、客户端使用

7.1 克隆仓库

git clone http://your-server-ip:8080/git/myproject.git

7.2 推送代码

cd myproject
touch README.md
git add .
git commit -m "Initial commit"
git push origin master

7.3 配置SSH访问（可选）

1. 在Gitblit中配置用户的SSH公钥
2. 客户端使用SSH协议克隆：

git clone ssh://git@your-server-ip:29418/myproject.git

八、维护与备份

8.1 日常维护

• 定期检查日志：/opt/gitblit/logs/gitblit.log
• 监控磁盘空间
• 定期更新Gitblit版本

8.2 数据备份

关键数据包括： - 仓库数据：/opt/gitblit/data/git - 配置文件：/opt/gitblit/data/gitblit.properties - 用户数据：/opt/gitblit/data/users.conf

备份示例脚本：

#!/bin/bash
BACKUP_DIR=/backup/gitblit
DATE=$(date +%Y%m%d)

mkdir -p $BACKUP_DIR/$DATE
cp -r /opt/gitblit/data $BACKUP_DIR/$DATE

8.3 恢复数据

只需将备份的数据复制回原位置即可：

cp -r /backup/gitblit/20230101/data/* /opt/gitblit/data/

九、常见问题解决

9.1 无法访问Web界面

• 检查防火墙设置：sudo ufw allow 8080/tcp
• 确认服务是否运行：sudo systemctl status gitblit
• 检查日志：tail -f /opt/gitblit/logs/gitblit.log

9.2 推送被拒绝

• 检查用户权限
• 确认仓库是否存在
• 检查仓库是否设置为只读

9.3 性能问题

• 增加JVM内存：修改gitblit.sh中的-Xmx参数
• 考虑使用SSH协议替代HTTP
• 定期清理不活跃的仓库

十、进阶配置

10.1 集成LDAP认证

修改gitblit.properties：

realm.ldap.server = ldap://your-ldap-server
realm.ldap.username = cn=admin,dc=example,dc=com
realm.ldap.password = password
realm.ldap.accountBase = ou=users,dc=example,dc=com

10.2 配置反向代理

使用Nginx作为反向代理：

server {
    listen 80;
    server_name git.yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

10.3 邮件通知配置

mail.server = smtp.example.com
mail.port = 587
mail.username = user@example.com
mail.password = password
mail.fromAddress = gitblit@example.com

结语

通过本文的详细指导，您应该已经成功在Linux系统上搭建了Gitblit Git仓库服务。Gitblit轻量级的Git服务器解决方案，非常适合小型团队或个人开发者使用。它不仅提供了基本的Git仓库管理功能，还支持用户权限控制、团队协作等高级特性。

随着使用的深入，您可以根据团队需求进一步调整配置，如集成持续集成系统、配置更复杂的权限模型等。希望Gitblit能为您的开发工作带来便利和效率提升！ “`