Gitea Docker镜像文档

镜像概述和主要用途

本镜像为Gitea的容器化部署包。Gitea是一款开源轻量级自托管Git服务，功能类似GitHub、GitLab，专注于简洁性和资源效率。该Docker镜像通过容器化技术简化Gitea的部署流程，支持跨平台快速启动，适用于个人开发者、小团队或企业内部搭建私有代码管理系统，实现代码仓库的集中管理与版本控制。

核心功能和特性

核心功能

• Git仓库管理：创建、克隆、分支、合并等完整Git操作支持
• 用户与权限控制：细粒度用户/组织管理，基于角色的访问控制（RBAC）
• 协作工具：Issue跟踪、代码审查、Pull Request功能
• 集成能力：支持WebHook、第三方认证（OAuth2、LDAP等）、CI/CD基础集成
• 数据可视化：提交历史、分支图谱、贡献统计等代码活动分析

主要特性

• 轻量级：低资源占用（内存<100MB，CPU消耗低），适合低配服务器
• 易配置：支持环境变量动态配置，兼容多种数据库（SQLite、MySQL、PostgreSQL等）
• 跨平台：支持Linux/Windows/macOS等主流操作系统，多架构镜像（amd64、arm64等）
• 持久化存储：数据卷挂载支持，确保仓库数据、配置文件持久化保存
• 高可用性：支持数据备份与恢复，可结合外部数据库实现高可用部署

使用场景和适用范围

使用场景

• 个人开发者搭建私有代码托管平台
• 小团队内部协作开发的代码版本管理
• 企业内部轻量化代码仓库（替代复杂Git服务）
• 教育机构/开源社区的小型代码协作系统

适用范围

• 资源受限环境（如个人服务器、边缘设备）
• 需快速部署自托管Git服务的场景
• 对数据隐私有要求，需本地化存储代码的场景
• 希望避免第三方Git服务依赖的组织或个人

详细使用方法和配置说明

快速部署（docker run）

基础部署命令

docker run -d \
  --name gitea \
  -p 3000:3000 \
  -p 222:22 \
  -v /path/to/gitea/data:/data \
  noenv/gitea

说明：

• -p 3000:3000：映射Web访问端口
• -p 222:22：映射SSH访问端口（Git SSH协议）
• -v /path/to/gitea/data:/data：挂载数据卷，持久化存储仓库数据、配置及日志

带数据库配置的部署（使用外部MySQL）

docker run -d \
  --name gitea \
  -p 3000:3000 \
  -p 222:22 \
  -v /path/to/gitea/data:/data \
  -e DB_TYPE=mysql \
  -e DB_HOST=mysql:3306 \
  -e DB_NAME=gitea \
  -e DB_USER=gitea \
  -e DB_PASS=your_db_password \
  -e GITEA__server__DOMAIN=git.example.com \
  -e GITEA__server__HTTP_PORT=3000 \
  --link mysql:mysql \
  noenv/gitea

Docker Compose配置示例

version: '3'
services:
  gitea:
    image: noenv/gitea
    container_name: gitea
    restart: always
    ports:
      - "3000:3000"  # Web访问端口
      - "222:22"     # SSH访问端口
    volumes:
      - ./data:/data  # 数据持久化目录
    environment:
      - DB_TYPE=sqlite3  # 使用SQLite数据库（默认，轻量级无需额外数据库）
      - GITEA__server__DOMAIN=localhost
      - GITEA__server__HTTP_PORT=3000
      - GITEA__service__DISABLE_REGISTRATION=false  # 允许用户注册
    depends_on:
      - mysql  # 如需MySQL，取消注释并配置mysql服务

  # 可选：MySQL数据库配置
  # mysql:
  #   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:
  #     - ./mysql-data:/var/lib/mysql

核心配置参数（环境变量）

注：更多配置可通过GITEA__SECTION__KEY格式的环境变量传递，对应Gitea的app.ini配置文件（如GITEA__repository__DEFAULT_BRANCH=main设置默认分支为main）。

数据持久化与备份

Gitea的所有数据（仓库、配置、日志、用户数据等）均存储在/data目录下，部署时需通过-v参数挂载本地目录实现持久化。备份时只需复制该目录即可，恢复时将备份目录挂载至新容器的/data路径。

访问与使用

部署完成后，通过http://<服务器IP>:3000访问Gitea Web界面，首次访问需完成初始配置（如管理员账户设置）。通过git clone ssh://git@<服务器IP>:222/<用户名>/<仓库名>.git克隆仓库（注意SSH端口为容器映射的222端口，非默认22）。