terminus7/gitea

Gitea - Git with a cup of tea

镜像概述和主要用途

Gitea是一个轻量级自托管Git服务，使用Go语言开发，目标是提供最简单、快速且无痛苦的方式搭建私有Git仓库。该项目自2016年11月从Gogs分叉而来，经过持续改进，支持跨平台部署，可在Linux、macOS、Windows等操作系统及x86、amd64、ARM、PowerPC等架构上运行。通过独立二进制分发，用户可轻松部署，满足个人、团队或组织对代码版本控制和协作的需求。

核心功能和特性

• 跨平台兼容性：支持Go语言兼容的所有平台，包括Linux、macOS、Windows及多种硬件架构
• 轻量级设计：单一二进制文件，资源占用低，部署简单，无需复杂依赖
• 完整Git功能：支持仓库管理、分支操作、提交历史、合并请求(Pull Request)等核心Git功能
• 用户与权限管理：提供用户注册、组织管理、细粒度权限控制，确保代码安全
• 多数据库支持：兼容SQLite、MySQL、PostgreSQL等多种数据库后端
• Web界面：直观的Web管理界面，包含仪表盘、用户资料、问题跟踪、代码编辑器等功能
• API支持：提供实验性API接口，可通过Swagger文档了解详细使用方法

使用场景和适用范围

• 个人开发者：搭建个人私有代码仓库，管理个人项目版本
• 小型团队：团队内部协作开发，实现代码共享与版本控制
• 企业组织：部署内部Git服务，保障代码数据隐私与安全，避免依赖第三方平台
• 教育机构：用于教学环境，教授版本控制和协作开发实践

详细使用方法和配置说明

基本Docker运行命令

使用官方Docker镜像快速启动Gitea服务：

bash
docker run -d \
  --name=gitea \
  -p 3000:3000 \
  -p 222:22 \
  -v /var/lib/gitea:/data \
  -e USER_UID=1000 \
  -e USER_GID=1000 \
  gitea/gitea:latest

参数说明：

• -p 3000:3000：映射Web界面访问端口
• -p 222:22：映射SSH服务端口（用于Git SSH协议访问）
• -v /var/lib/gitea:/data：挂载数据卷，持久化存储仓库数据、配置和数据库
• -e USER_UID=1000 和 -e USER_GID=1000：指定运行Gitea的用户ID和组ID，需与宿主机数据目录权限匹配

Docker Compose配置示例

使用Docker Compose配置包含MySQL数据库的完整环境：

yaml
version: '3'

services:
  gitea:
    image: gitea/gitea:latest
    container_name: gitea
    restart: always
    ports:
      - "3000:3000"  # Web界面端口
      - "222:22"     # SSH端口
    environment:
      - USER_UID=1000
      - USER_GID=1000
      - DB_TYPE=mysql
      - DB_HOST=db:3306
      - DB_NAME=gitea
      - DB_USER=gitea
      - DB_PASSWD=gitea_password
    volumes:
      - /var/lib/gitea:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    depends_on:
      - db

  db:
    image: mysql:8.0
    container_name: gitea-mysql
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=root_password
      - MYSQL_DATABASE=gitea
      - MYSQL_USER=gitea
      - MYSQL_PASSWORD=gitea_password
    volumes:
      - /var/lib/gitea/mysql:/var/lib/mysql

启动服务：

bash
docker-compose up -d

关键配置参数

Gitea主要通过环境变量或配置文件(app.ini)进行配置，常用环境变量包括：

更多配置详情请参考Gitea官方配置文档。

访问与初始化

1. 启动容器后，通过浏览器访问 http://<服务器IP>:3000
2. 首次访问将进入安装向导，完成数据库配置、管理员账户设置等步骤
3. 配置完成后，即可创建仓库、添加用户、进行代码管理等操作

许可证

本项目采用MIT许可证，详情参见https://github.com/go-gitea/gitea/blob/master/LICENSE%E6%96%87%E4%BB%B6%E3%80%82