安装Gitea：从源码到一键部署

# 1. 介绍Gitea
1.1 Gitea是什么
Gitea是一个轻量级的开源Git平台，类似于GitHub、GitLab等，它提供了Git仓库管理、问题跟踪、代码审核、Wiki等功能，可以帮助团队高效地进行代码管理和协作开发。

1.2 Gitea的优势
- **轻量级**: Gitea 是一个运行速度很快的应用，不会消耗太多的资源。
- **易用性**: 界面友好，易于上手，提供了丰富的功能和插件。
- **自托管**: 用户可以自行搭建和管理Gitea服务器，保护数据安全。
- **开源免费**: Gitea是一个开源项目，免费供个人和团体使用。

1.3 为什么选择Gitea
选择Gitea建立自己的Git平台有诸多优点：
- **安全性**: 用户数据受到保护，稳定性高。
- **灵活性**: 可根据需求自定义配置，满足团队特定需求。
- **自治性**: 不同于托管平台，用户可以掌控全部数据，不受第三方制约。

# 2. 准备工作

准备工作对于安装Gitea至关重要，包括环境准备、系统需求检查以及必要软件的安装。

### 2.1 准备环境

在开始安装Gitea之前，确保已经准备好适当的环境。这包括一台运行正常的服务器或虚拟机，并确保具有足够的磁盘空间和内存以运行Gitea。

### 2.2 检查系统需求

在安装Gitea之前，需要确保所选系统符合Gitea的系统需求。Gitea通常要求操作系统为Linux、Windows或macOS，并且有支持的数据库系统。

### 2.3 安装必要的软件

在安装Gitea之前，需要安装并配置一些必要的软件。这包括Git、Go编程语言、数据库等。确保这些软件都按照官方要求的版本进行安装，并且已经正确配置。

# 3. 从源码安装Gitea

在本章中，我们将介绍如何从源码安装Gitea，这样您可以根据自己的需求和偏好进行定制化配置。

### 3.1 下载Gitea源码

首先，您需要下载Gitea的源代码。您可以在 Gitea 的官方仓库（https://github.com/go-gitea/gitea）找到最新的源码版本。您可以使用 `git` 命令来克隆仓库：

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

### 3.2 设置数据库

接下来，您需要为 Gitea 设置一个数据库。Gitea 支持多种数据库，包括 MySQL、PostgreSQL、SQLite 等。您需要根据自己的实际情况来选择和配置数据库。以 MySQL 为例，您可以使用以下命令来创建一个数据库：

CREATE DATABASE gitea_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

### 3.3 编译和安装Gitea

一旦您下载了源代码并设置了数据库，接下来就是编译和安装 Gitea。在源代码目录中，您可以执行以下命令来编译 Gitea：

cd gitea
TAGS="bindata" make build

编译完成后，您可以使用以下命令安装 Gitea：

sudo make install

编译安装完成后，您就成功从源码安装了 Gitea。您可以继续配置和启动 Gitea 以便开始使用。

# 4. 配置Gitea

在安装Gitea之前，需要对其进行一些配置，包括数据库连接、域名和端口设置以及其他参数的配置。

### 4.1 配置数据库连接

首先，需要编辑Gitea的配置文件`custom/conf/app.ini`，修改数据库连接信息。根据你选择的数据库，可以配置以下信息：

[database]
DB_TYPE = mysql
HOST = localhost:3306
NAME = gitea
USER = root
PASSWD = your_password
SSL_MODE = disable
PATH = data/gitea.db

### 4.2 配置域名和端口

在配置文件`custom/conf/app.ini`中，可以设置Gitea的域名和端口号，例如：

[server]
DOMAIN = gitea.example.com
HTTP_PORT = 3000
ROOT_URL = https://gitea.example.com/

### 4.3 配置其他参数

除了数据库连接和域名端口，还可以配置其他参数，如仓库路径、日志设置等。详细的配置选项可以查看Gitea官方文档。

配置完成后，保存文件并准备启动Gitea服务。

# 5. 启动Gitea

在完成了Gitea的安装和配置之后，我们需要启动Gitea服务，并进行一些测试以确保一切正常。

#### 5.1 启动Gitea服务

首先，我们需要进入Gitea的安装目录，通常情况下是 `/home/git/gitea/`。然后使用如下命令启动Gitea 服务：

cd /home/git/gitea/
./gitea web

这条命令会启动Gitea 的 Web 服务，并且会在终端输出一些相关的日志信息，包括 Gitea 服务的启动情况以及访问地址等信息。

#### 5.2 测试Gitea是否正常工作

在启动了 Gitea 服务之后，我们可以打开浏览器，输入 Gitea 的访问地址，通常情况下是 `http://your_domain_or_IP:3000`（具体端口号根据配置文件中的 `DOMAIN` 和 `HTTP_PORT` 决定），然后按下 Enter 键访问。如果一切正常，你将会看到 Gitea 的网页界面，这代表 Gitea 服务已经正常运行。

#### 5.3 设置Gitea为系统服务

为了让 Gitea 在服务器重启后能够自动启动，我们需要将 Gitea 设置为系统服务。具体的操作可以参考操作系统的相关文档，或者在启动脚本中进行相应的配置。

总结：在本章节中，我们介绍了如何启动 Gitea 服务，并进行了简单的测试以确认 Gitea 是否正常工作。同时，我们也提到了将 Gitea 设置为系统服务的必要性。

# 6. 一键部署Gitea

在本章中，我们将介绍如何利用现成的工具，以一键部署的方式快速搭建起Gitea服务。一键部署可以大大简化安装的流程，让用户能够更加便捷地使用Gitea。

### 6.1 使用Docker一键部署Gitea

Docker是一种轻量级的容器技术，能够将应用和其依赖项打包到一个容器中。借助Docker，我们可以很容易地部署Gitea，而无需担心系统兼容性和依赖项安装等问题。以下是使用Docker一键部署Gitea的步骤：

#### 步骤一：安装Docker

# 在系统上安装Docker引擎
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io

#### 步骤二：拉取Gitea镜像

# 从Docker Hub上拉取Gitea镜像
docker pull gitea/gitea:latest

#### 步骤三：创建并运行Gitea容器

# 创建Gitea容器
docker run -d --name=gitea -p 3000:3000 -p 22:22 gitea/gitea:latest

在上述命令中，我们使用`docker run`命令创建了一个名为`gitea`的容器，并将宿主机的3000端口映射到容器的3000端口，同时将宿主机的22端口映射到容器的22端口。这样，我们就可以通过浏览器访问宿主机的3000端口来使用Gitea了。

### 6.2 使用脚本自动部署Gitea

除了Docker外，还可以利用脚本来实现Gitea的一键部署。以下是一个简单的Shell脚本示例，用于自动化安装和配置Gitea：

#!/bin/bash

# 下载并解压Gitea安装包
wget https://dl.gitea.io/gitea/1.15.4/gitea-1.15.4-linux-amd64 -O gitea
chmod +x gitea

# 创建Gitea所需的数据目录
mkdir -p /var/lib/gitea
chmod 750 /var/lib/gitea

# 设置数据库连接等相关配置
echo "DB_TYPE=mysql" > custom/conf/app.ini
echo "DB_HOST=127.0.0.1:3306" >> custom/conf/app.ini
echo "DB_NAME=gitea" >> custom/conf/app.ini
echo "DB_USER=gitea" >> custom/conf/app.ini
echo "DB_PASSWD=gitea" >> custom/conf/app.ini

# 启动Gitea服务
./gitea web

### 6.3 一键部署的注意事项

当使用一键部署方式安装Gitea时，需要注意以下几点：

- 确保系统符合Gitea的最低硬件和软件要求；
- 在Docker部署中，注意端口映射和镜像拉取的问题；
- 在使用脚本自动部署时，应确保环境变量的正确设置和脚本的执行权限。

通过本章的学习，读者可以了解到如何利用Docker和Shell脚本来实现Gitea的一键部署，从而快速搭建自己的代码托管平台。