giteacharts/gitea

Gitea Docker镜像文档

镜像概述和主要用途

Gitea是一款开源轻量级自托管一体化软件开发服务，旨在提供简单易用的Git服务及全流程开发工具集成。通过Docker镜像，用户可快速部署运行Gitea，无需复杂环境配置，适用于个人开发者、中小型团队或企业内部，满足从代码托管到持续集成的完整开发需求。

核心功能和特性

• Git托管：完整支持Git版本控制功能，包括仓库创建、分支管理、提交历史查看、代码对比等
• 代码审查：提供Pull Request工作流，支持代码评审、评论讨论、变更确认，提升代码质量
• 团队协作：支持组织与团队管理，细粒度权限控制，成员角色分配，协作开发流程管理
• 包注册表：集成多类型包管理功能，支持Maven、npm、Docker、Helm等包的存储与分发
• CI/CD：内置持续集成/持续部署功能，可自动化构建、测试、部署流程，支持自定义工作流
• 轻量级设计：资源占用低，运行高效，支持在低配硬件环境稳定运行
• 易扩展性：提供丰富的API和Web钩子，支持与第三方工具集成，满足个性化需求

使用场景和适用范围

• 个人开发者：搭建个人Git服务器，管理个人项目代码，实现版本控制与备份
• 中小型开发团队：作为团队内部代码托管与协作平台，统一管理项目，简化开发流程
• 企业内部开发：部署于企业内网，保障代码数据安全，实现开发流程闭环管理
• 教育机构：用于教学环境，演示版本控制与团队协作开发，培养规范开发习惯
• 开源项目：作为开源项目托管平台，支持社区贡献者协作，管理Issue与Pull Request

使用方法和配置说明

基本部署（Docker Run）

使用以下命令快速启动Gitea容器：

bash
docker run -d \
  --name=gitea \
  -p 3000:3000 \  # Web界面端口
  -p 222:22 \      # SSH访问端口（用于Git SSH协议）
  -v /path/to/gitea/data:/data \  # 数据持久化目录
  -e USER_UID=1000 \  # 运行用户UID（需与宿主机目录权限匹配）
  -e USER_GID=1000 \  # 运行用户GID（需与宿主机目录权限匹配）
  gitea/gitea:latest

Docker Compose配置

创建docker-compose.yml文件实现更灵活配置：

yaml
version: '3'

services:
  gitea:
    image: gitea/gitea:latest
    container_name: gitea
    restart: always
    ports:
      - "3000:3000"  # Web访问端口
      - "222:22"     # SSH访问端口
    volumes:
      - ./data:/data  # 数据持久化目录
      - /etc/timezone:/etc/timezone:ro  # 时区同步
      - /etc/localtime:/etc/localtime:ro  # 时间同步
    environment:
      - USER_UID=1000
      - USER_GID=1000
      - DB_TYPE=sqlite3  # 数据库类型（可选：mysql、postgres）
      - RUN_MODE=prod    # 运行模式（prod：生产环境，dev：开发环境）

启动服务：

bash
docker-compose up -d

环境变量配置

常用环境变量说明：

数据持久化

Gitea所有数据（仓库、数据库、配置、日志等）存储在/data目录，需通过卷挂载实现持久化：

bash
# 宿主机目录挂载示例
mkdir -p /my/gitea/data
docker run -d \
  --name=gitea \
  -p 3000:3000 \
  -p 222:22 \
  -v /my/gitea/data:/data \
  gitea/gitea:latest

高级配置

如需详细配置，可通过修改容器内/data/gitea/conf/app.ini文件实现，配置完成后重启容器：

bash
# 进入容器修改配置
docker exec -it gitea /bin/bash
vi /data/gitea/conf/app.ini

# 重启容器使配置生效
docker restart gitea

更多配置选项可参考Gitea官方文档的配置章节。