easylinux/gitea

Gitea Docker镜像文档

概述

Gitea是一款轻量级的Git服务器Web管理界面，旨在提供类似GitHub的功能体验。它设计简洁、资源占用低，适合个人开发者、小型团队或组织搭建私有Git服务器，实现代码仓库的管理、版本控制及协作开发。

核心功能与特性

• Git仓库管理：支持创建、克隆、分支、合并等完整Git操作
• 用户与权限控制：提供用户、组织管理及细粒度的仓库访问权限设置
• Web界面交互：直观的Web界面，支持代码浏览、提交历史查看
• Issue跟踪：内置Issue管理系统，支持任务分配、标签分类
• 代码审查：支持Pull Request功能，便于团队代码审核与协作
• 轻量级设计：资源占用低，可在低配置服务器上稳定运行
• 扩展性：支持多种数据库（SQLite、MySQL、PostgreSQL）及第三方集成

使用场景与适用范围

• 个人开发者：搭建个人私有代码仓库，管理项目版本
• 小型团队：团队内部代码协作与版本控制
• 企业内部：部署私有Git服务器，保障代码安全与管理可控
• 教育场景：教学环境中Git版本控制实践与学习

使用方法与配置说明

基本部署（Docker Run）

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

Docker Compose配置示例

yaml
version: '3'

services:
  gitea:
    image: gitea/gitea:latest
    container_name: gitea
    restart: always
    ports:
      - "3000:3000"  # Web界面端口
      - "222:22"     # SSH访问端口
    volumes:
      - ./data:/data
      - ./config:/etc/gitea
    environment:
      - USER_UID=1000
      - USER_GID=1000
      - DB_TYPE=mysql  # 可选：sqlite3, postgres, mysql
      - DB_HOST=db:3306
      - DB_NAME=gitea
      - DB_USER=gitea
      - DB_PASSWD=gitea_password
    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:
      - ./mysql-data:/var/lib/mysql

关键环境变量说明

访问与初始化

1. 部署完成后，通过http://<服务器IP>:3000访问Web界面
2. 首次访问将进入初始化配置页面，设置管理员账号、数据库连接等信息
3. 配置完成后即可创建仓库、添加用户，开始使用Gitea进行代码管理