chapvic/gitea

Gitea Docker镜像文档

概述

Gitea是一个开源的轻量级自托管Git仓库服务，旨在提供简单、高效的代码托管解决方案。它兼容Git协议，支持多种版本控制功能，并提供直观的Web界面，适合个人开发者、小型团队或企业内部搭建私有代码仓库，实现代码的安全管理和团队协作。

核心功能与特性

• Git仓库管理：支持创建、克隆、分支、合并等标准Git操作
• 用户与权限管理：细粒度的访问控制，支持组织、团队和个人权限设置
• Web界面：直观的Web控制台，支持代码浏览、提交历史查看、差异比较等
• Issue跟踪：内置问题管理系统，支持任务分配、标签分类和状态跟踪
• 代码审查：支持Pull Request功能，便于团队协作和代码质量控制
• 轻量级设计：资源占用低，部署简单，适合各种规模的环境
• 扩展性：支持插件系统，可集成CI/CD工具、第三方服务等

使用场景与适用范围

• 个人开发者：搭建个人代码仓库，管理个人项目
• 小型团队：团队内部代码协作，版本控制和项目管理
• 企业内部：私有代码托管，保障代码安全和知识产权
• 教育机构：教学环境中的版本控制实践，学生项目管理

使用方法与配置说明

基本部署（Docker Run）

使用以下命令快速启动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：设置容器内运行用户的UID和GID，避免权限问题

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'

services:
  gitea:
    image: gitea/gitea:latest
    container_name: gitea
    restart: always
    ports:
      - "3000:3000"
      - "222:22"
    volumes:
      - /var/lib/gitea:/data
    environment:
      - USER_UID=1000
      - USER_GID=1000
      - DB_TYPE=sqlite3  # 可选：sqlite3, mysql, postgres
      - DB_HOST=db:3306  # 若使用外部数据库，需配置数据库地址
      - DB_NAME=gitea
      - DB_USER=gitea
      - DB_PASSWD=your_db_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=your_db_password
    volumes:
      - /var/lib/mysql:/var/lib/mysql

启动服务：

bash
docker-compose up -d

环境变量配置

常用环境变量说明：

访问与配置

部署完成后，通过http://<服务器IP>:3000访问Gitea Web界面，首次访问需完成初始配置，包括数据库设置、管理员账号创建等。

注意事项

• 数据卷挂载：建议使用持久化卷存储数据，避免容器删除导致数据丢失
• 安全配置：生产环境中应配置HTTPS，设置强密码，并限制访问权限
• 备份策略：定期备份数据卷内容，防止数据损坏或丢失