Gitea——私有git服务器搭建详细教程

本文将从源代码和docker安装两种方式带大家从0～1通过Gitea搭建一个私有git服务器

---

什么是Gitea

Gitea 是一个开源社区驱动的轻量级代码托管解决方案，后端采用 Go 编写，采用 MIT 许可证.
官网：https://gitea.io/zh-cn/

一、源代码安装方式

实验环境为MacOS系统，Windows系统以下操作大同小异

官方文档：https://docs.gitea.io/zh-cn/install-from-source/

1. 前置环境要求

• Go环境安装（版本要求大于1.16，一定要设置$GOPATH 环境变量，并将其bin目录添加到$PATH中）
  • Go语言环境搭建(Windows+Linux)_欢迎来到 Baret~H 的博客-CSDN博客
• Node.JS环境安装（版本要求大于等于12.17，用于构建js和css文件，建议安装最新版本）
  • Node.JS安装教程_欢迎来到 Baret~H 的博客-CSDN博客
• 数据库环境安装，建议MySQL
  • MySQL最新版8.0.21安装配置教程_欢迎来到 Baret~H 的博客-CSDN博客

# 我的环境
zhongsiru@zhongsirudeMacBook-Air ~ % go version
go version go1.17.1 darwin/arm64
zhongsiru@zhongsirudeMacBook-Air ~ % node -v   
v14.17.6
zhongsiru@zhongsirudeMacBook-Air ~ % npm -v    
8.1.3
zhongsiru@zhongsirudeMacBook-Air ~ % mysql -V
mysql  Ver 8.0.27 for macos11 on x86_64 (MySQL Community Server - GPL)
1
2
3
4
5
6
7
8
9

2. 下载gitea

• Github：https://github.com/go-gitea/gitea
• Gitee镜像：https://gitee.com/mirrors/gitea

通过git将项目下载到$GOPATH/src目录下

git clone https://github.com/go-gitea/gitea
1

3. 构建运行

下载完成后用Goland打开，在项目根目录下使用以下命令安装各种前端依赖，下载好的依赖在项目根目录下生的node_modules目录中

npm install
1

然后通过以下目录构建后端代码

TAGS="bindata" make backend
1

构建完成后，会在项目根目录下生成gitea可执行文件，我们使用以下命令来启动项目

./gitea web
1

启动成功后我们访问本机的3000端口，可以看到如下界面：

这里我们配置我们所安装的mysql数据库和密码即可，这里的数据库名称需要我们提前创建一个数据库，这里创建的名称为gitea，此外还可以更改站点名称为自己想要的名称。

设置更新完后，点击安装即可，然后就进入到gitea的控制台，到此即安装配置成功。

---

二、Docker安装方式

实验环境为CentOS7.6服务器，可以使用任意云厂商或者centos虚拟机

官方文档：https://docs.gitea.io/zh-cn/install-with-docker/

1. Docker安装

官方文档：Install Docker Engine on CentOS | Docker Documentation

# 1.移除以前docker相关包
sudo yum remove docker \
                  docker-client \
                  docker-client-latest \
                  docker-common \
                  docker-latest \
                  docker-latest-logrotate \
                  docker-logrotate \
                  docker-engine

# 2. 配置yum源
sudo yum install -y yum-utils
sudo yum-config-manager \
--add-repo \
http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

# 3. 安装docker
sudo yum install -y docker-ce docker-ce-cli containerd.io

# 4. 启动docker
systemctl enable docker --now

# 5. 配置阿里云加速
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": ["https://82m9ar63.mirror.aliyuncs.com"],
  "exec-opts": ["native.cgroupdriver=systemd"],
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m"
  },
  "storage-driver": "overlay2"
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

以上操作完成后，我们可以使用 systemctl status docker来查看 Docker 服务是否启动

2. Dokcer Compose安装

官方文档：Install Docker Compose | Docker Documentation

# 1.安装docker compose
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# 2.赋予下载的docker-compose执行权限
sudo chmod +x /usr/local/bin/docker-compose
1
2
3
4
5

注意：Docker Compose 存放在GitHub不太稳定，可以通过镜像网址高速安装。

• 镜像网站：http://get.daocloud.io/

curl -L https://get.daocloud.io/docker/compose/releases/download/v2.2.2/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
1
2

下载完成后可以输入docker-compose --version来查看是否安装成功

3. 安装启动gitea

我们通过docker compose的yaml配置文件来安装gitea，其中选用数据库mysql来存储gitea的数据文件。

创建docker-compose.yml文件，内容如下：

version: "3"

networks:
  gitea:
    external: false

services:
  server:
    image: gitea/gitea:1.15.9
    container_name: gitea
    environment:
      - USER_UID=1000
      - USER_GID=1000
      - DB_TYPE=mysql
      - DB_HOST=db:3306
      - DB_NAME=gitea
      - DB_USER=gitea
      - DB_PASSWD=gitea
    restart: always
    networks:
      - gitea
    volumes:
      - ./gitea:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
       - "3000:3000"
       - "222:22"
    depends_on:
       - db
 
  db:
     image: mysql:8
     restart: always
     environment:
       - MYSQL_ROOT_PASSWORD=gitea
       - MYSQL_USER=gitea
       - MYSQL_PASSWORD=gitea
       - MYSQL_DATABASE=gitea
     networks:
       - gitea
     volumes:
       - ./mysql:/var/lib/mysql
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

编写完成后，我们通过以下命令再启动 Gitea

# 后台启动gitea
docker-compose up -d server
1
2

待启动成功，可以看到它启动在3000端口，然后我们通过服务器公网IP:3000即可访问到其web界面，注意服务器安全组规则要放行3000端口

其中数据库设置我们不需要更改，因为是根据上述docker-compose.yml文件中的数据库配置来读取的，我们需要更改ssh服务的域名为服务器的公网ip，通知基础url的前缀也更改为服务器的公网ip

然后创建一个管理员用户(zsr/123456)即可，然后点击安装

设置完成后，点击立即安装，然后即可进入如下界面

到此gitea的已经安装部署完成

4. 基本操作实例

我们来新建一个仓库：

然后我们将仓库克隆下来新增一个文件然后再推送回去：

# 克隆仓库
zhongsiru@zhongsirudeMacBook-Air Desktop % git clone http://139.198.40.248:3000/zsr/hello.git
Cloning into 'hello'...
warning: You appear to have cloned an empty repository.

# 进入本地仓库目录
zhongsiru@zhongsirudeMacBook-Air Desktop % cd hello 

# 新增hello.txt文件
zhongsiru@zhongsirudeMacBook-Air hello % vim hello.txt
zhongsiru@zhongsirudeMacBook-Air hello % ls
hello.txt

# 将变更添加到暂存区
zhongsiru@zhongsirudeMacBook-Air hello % git add .

# 将暂存区的内容添加到本地仓库
zhongsiru@zhongsirudeMacBook-Air hello % git commit -m "添加hello.txt"
[master (root-commit) 1f46f0e] 添加hello.txt
 1 file changed, 1 insertion(+)
 create mode 100644 hello.txt

# 推送到远程仓库(要输入用户名和密码)
zhongsiru@zhongsirudeMacBook-Air hello % git push origin master
Username for 'http://139.198.40.248:3000': zsr
Password for 'http://zsr@139.198.40.248:3000': 
Enumerating objects: 3, done.
Counting objects: 100% (3/3), done.
Writing objects: 100% (3/3), 230 bytes | 230.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
remote: . Processing 1 references
remote: Processed 1 references in total
To http://139.198.40.248:3000/zsr/hello.git
 * [new branch]      master -> master
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

上述命令操作完成后，我们回到gitea web页面，即可看到变更

5. ssh配置

上述我们推送到远程仓库要输入用户名和密码进行校验，这是十分麻烦的，我们可以配置ssh实现免密登陆：

1️⃣ 首先在本机生成公钥：

# 进入到.ssh目录
cd ~/.ssh

# 生成密钥对
ssh-keygen -t rsa -C "邮箱"

# 查看公钥内容
cat id_rsa.pub
1
2
3
4
5
6
7
8

2️⃣ gitea中添加公钥

在gitea web界面的ssh配置页面新增一个ssh密钥，复制上面生成的公钥粘贴进去即可

添加完成后如下所示

此时如果我们修改hello.txt的内容再重新推送到gitea仓库，就不需要输入密码了

如果我们采用ssh的方式克隆下来呢？

我们复制这个ssh地址来看看：

发现还让我们输密码，我们不是刚刚配置的ssh吗？我们仔细看这个ssh地址：

git@139.198.40.248:zsr/hello.git
1

在服务器公网ip后面直接接了zsr用户名，没有接任何端口，也就是想当于走了默认端口22，等价于服务器公网ip:22也就是要登陆服务器的操作，这当然是需要密码的，我们应该是登陆服务器内部gitea容器的操作，因此我们需要修改gitea的一些配置：

在docker-compose.yml文件中，由于我们将gitea的data目录挂在到本季的gitea目录中，因此我们需要进入该目录中来修改相关配置，需要修改/gitea/gitea/conf/app.ini文件

由于我们将主机的222端口映射到gitea容器中的22端口，因此我们将app.ini中的ssh_port和ssh_listen_port修改为222端口

修改完成后我们通过docker-compose restart命令重启一下gitea容器

然后再次访问web界面，可以看到ssh地址已经变更，在服务器的公网ip后接了222端口（注意服务器安全组要放行222端口），也就相当于访问服务器内部gitea容器的22端口

此时我们再通过ssh进行克隆，然后修改文件再推送回去

这次期间任何流程无需再需要输入密码进行验证，到此ssh配置已经完毕。