Gitea Docker 安装与使用详解：轻量级自托管 Git 服务教程

文浩（楠搏万）

已于 2025-01-18 08:50:21 修改

阅读量1.9k

点赞数 21

文章标签： gitea docker git 私有仓库自托管轻量 git服务

于 2025-01-03 13:57:55 首次发布

本文链接：https://blog.csdn.net/m0_70878103/article/details/144908188

版权

言简意赅的讲解Gitea解决的痛点

Gitea 是一款轻量级的自托管 Git 服务，功能类似于 GitHub，适合团队协作或个人代码托管。以下是通过 Docker 安装 Gitea 的详细步骤及常用用法。在小伙伴们需要本地化部署Git服务的时候，Gitea其实是个好选择。

Gitea本地代码仓库

一、通过 Docker 安装 Gitea

步骤 1：准备工作

安装 Docker 和 Docker Compose
如果尚未安装 Docker，请先安装：
- Docker 是什么
- Docker 安装指南
创建 Gitea 的工作目录
在你的服务器上为 Gitea 创建一个独立的工作目录：
```
mkdir -p /data/gitea/{custom,data,logs}
```
设置文件夹权限
确保 Docker 容器对目录有读写权限：
```
chown -R 1000:1000 /data/gitea
```

步骤 2：编写 Docker Compose 文件

创建 Docker Compose 文件
在 Gitea 目录中创建 docker-compose.yml 文件：
```
nano /data/gitea/docker-compose.yml
```

添加以下内容到文件中

version: "3"

services:
  gitea:
    image: gitea/gitea:latest
    container_name: gitea
    environment:
      - USER_UID=1000
      - USER_GID=1000
    restart: always
    ports:
      - "3000:3000" # Web 界面端口
      - "2222:22"   # SSH 服务端口
    volumes:
      - /data/gitea/data:/data

保存并退出

步骤 3：启动 Gitea 服务

运行以下命令以启动 Gitea：

cd /data/gitea
docker-compose up -d

-d 表示后台运行
Gitea 服务启动后，可通过浏览器访问：http://<服务器IP>:3000

步骤 4：初始配置

打开浏览器访问 http://<服务器IP>:3000，进入配置页面。
配置关键项：
- 数据库类型：选择 SQLite（默认）或连接 MySQL。
- 站点设置：
  - SSH 端口：2222
  - Gitea 基本 URL：http://<服务器IP>:3000
- 点击 安装 Gitea。

二、Gitea 常用功能与用法

1. 创建和管理仓库

创建新仓库：
- 登录后点击右上角的“+”图标，选择“新建仓库”。
- 填写仓库名称、描述，并设置仓库为公有或私有。

克隆仓库到本地：

git clone http://<服务器IP>:3000/<用户名>/<仓库名>.git

推送代码到仓库：

cd <仓库目录>
git add .
git commit -m "初始化提交"
git push origin main

2. 用户和团队管理

添加用户：
- 作为管理员，可以创建或邀请用户注册账号。
创建团队：
- 在组织中创建团队，分配角色（管理员、写权限、读权限）。
分配权限：
- 为团队或用户设置仓库的访问权限。

3. 分支管理与代码审查

创建分支：
在本地创建新分支：

git checkout -b <新分支名>
git push origin <新分支名>

Pull Request（合并请求）：
- 在 Gitea Web 界面中发起合并请求，用于代码审查和合并。

4. 集成和自动化

Webhook 集成：
- 在仓库设置中配置 Webhook，将代码变动通知到 CI/CD 工具（如 Jenkins）。
Git Hooks：
- 在 /data/gitea/data/git/repositories/<仓库路径>/hooks 添加自定义脚本。

5. 数据备份

定期备份 Gitea 的数据目录和数据库：

tar -czvf gitea-backup-$(date +%Y%m%d).tar.gz /data/gitea

通过上述内容，你就已经基本理解了这个方法，基础用法我也都有展示。如果你能融会贯通，我相信你会很强

Best
Wenhao (楠博万)