harshavardhanj/gitea

Gitea 多架构镜像文档

镜像概述

Gitea 是一款轻量级自托管 Git 服务，提供与 GitHub、GitLab 类似的代码管理功能。本镜像为多架构构建版本，支持在 amd64、arm64、arm/v7 等多种 CPU 架构的设备上部署，满足不同硬件环境下的代码管理需求。

核心功能和特性

• 完整 Git 服务：支持代码仓库创建、分支管理、提交历史、代码对比等核心 Git 功能
• 多架构支持：适配 amd64（x86_64）、arm64（aarch64）、arm/v7 等主流架构，可在服务器、开发板等设备运行
• 轻量级设计：资源占用低，适合低配设备或资源受限环境部署
• 团队协作工具：集成 Issue 跟踪、Pull Request、代码审查、用户权限管理等协作功能
• 易于部署维护：简化配置流程，支持多种数据库（SQLite、MySQL、PostgreSQL）

使用场景和适用范围

• 个人开发者搭建私有代码仓库，管理个人项目
• 小型团队内部协作，实现代码共享与版本控制
• 在 ARM 架构设备（如树莓派）或混合架构环境中部署 Git 服务
• 对服务器资源有严格要求，需要轻量级代码管理解决方案的场景

使用方法和配置说明

基本部署（Docker Run）

通过以下命令快速启动单节点 Gitea 服务（使用 SQLite 数据库，适合个人或小型团队）：

bash
docker run -d \
  --name gitea \
  -p 3000:3000 \  # Web 访问端口
  -p 222:22 \      # SSH 访问端口（Git 协议）
  -v /path/to/gitea/data:/data \  # 数据持久化目录
  -e GITEA__server__DOMAIN=git.example.com \  # 服务域名/IP
  -e GITEA__server__HTTP_PORT=3000 \
  -e GITEA__server__SSH_PORT=222 \
  gitea/gitea:latest

Docker Compose 部署（推荐）

使用 Docker Compose 实现 Gitea 与数据库分离部署（以 MySQL 为例）：

yaml
version: '3'

services:
  gitea:
    image: gitea/gitea:latest
    container_name: gitea
    restart: always
    ports:
      - "3000:3000"
      - "222:22"
    volumes:
      - /path/to/gitea/data:/data
      - /etc/timezone:/etc/timezone:ro  # 同步时区
      - /etc/localtime:/etc/localtime:ro
    environment:
      - GITEA__database__DB_TYPE=mysql
      - GITEA__database__HOST=db:3306
      - GITEA__database__NAME=gitea
      - GITEA__database__USER=gitea
      - GITEA__database__PASSWD=your_db_password
      - GITEA__server__DOMAIN=git.example.com
      - GITEA__server__ROOT_URL=https://git.example.com/
    depends_on:
      - db

  db:
    image: mysql:8.0
    container_name: gitea-db
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=your_root_password
      - MYSQL_DATABASE=gitea
      - MYSQL_USER=gitea
      - MYSQL_PASSWORD=your_db_password
    volumes:
      - /path/to/mysql/data:/var/lib/mysql

关键配置参数

常用环境变量配置（完整配置参见 Gitea 官方文档）：

访问与初始化

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

数据持久化

所有配置、仓库数据、数据库文件均存储在 /data 目录，通过 -v 参数挂载本地目录实现持久化，确保容器重启或升级后数据不丢失。