nemoinho/gitea

Gitea - 一杯茶的功夫，搭建你的Git服务

镜像概述和主要用途

Gitea项目的目标是提供最简单、快速且无痛苦的自托管Git服务搭建方式。该项目使用Go语言开发，可通过独立二进制包在Go支持的所有平台上分发，包括Linux、macOS、Windows以及x86、amd64、ARM和PowerPC等架构。Gitea源自2016年11月对Gogs的分支项目，经过多年发展已形成独立且功能丰富的代码管理平台。

核心功能和特性

• 轻量级部署：独立二进制分发，无需复杂依赖，部署简单
• 跨平台支持：兼容Linux、macOS、Windows等操作系统，支持x86、amd64、ARM、PowerPC等架构
• 完整Git功能：支持代码仓库管理、分支管理、提交历史、代码对比等核心Git功能
• Web界面：提供直观的Web管理界面，包含仪表盘、仓库视图、问题跟踪、拉取请求等功能
• API支持：提供实验性API接口，便于集成和自动化操作
• 多数据库支持：可与SQLite3、MySQL、PostgreSQL等数据库兼容

使用场景和适用范围

• 个人开发者：搭建个人代码仓库，管理个人项目
• 小型团队：团队内部协作开发，进行代码版本控制
• 企业内部：部署私有Git服务，保护敏感代码资产
• 教育机构：用于教学环境中的版本控制实践

使用方法和配置说明

快速启动

通过Docker快速启动Gitea服务：

bash
docker run -d --name=gitea -p 3000:3000 -p 222:22 -v /var/lib/gitea:/data gitea/gitea:latest

• -p 3000:3000：映射Web界面端口
• -p 222:22：映射SSH访问端口
• -v /var/lib/gitea:/data：挂载数据卷，持久化存储配置和仓库数据

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:
      - /var/lib/gitea:/data  # 数据持久化目录
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    environment:
      - GITEA__database__DB_TYPE=sqlite3  # 数据库类型，可选sqlite3、mysql、postgres
      - GITEA__database__PATH=/data/gitea.db  # SQLite数据库路径
      - GITEA__server__DOMAIN=localhost  # 服务器域名
      - GITEA__server__HTTP_PORT=3000  # HTTP端口
      - GITEA__server__SSH_PORT=22  # 容器内SSH端口

启动服务：

bash
docker-compose up -d

访问和配置

服务启动后，通过http://localhost:3000访问Web界面，首次访问需完成初始配置，包括管理员账号设置、数据库配置等。

贡献指南

贡献流程：Fork -> 提交修改 -> 推送 -> 提交Pull Request

注意：

1. 在提交Pull Request前，必须阅读https://github.com/go-gitea/gitea/blob/master/CONTRIBUTING.md
2. 如发现安全漏洞，请通过邮件*******私下报告

常见问题

如何发音"Gitea"？

Gitea的发音为/ɡɪ’ti:/，类似"gi-tea"，其中"g"发浊辅音。

为什么项目代码不在Gitea实例上托管？

开发团队正在解决此问题，相关进展可查看https://github.com/go-gitea/gitea/issues/1029%E3%80%82

许可证

本项目采用MIT许可证，详见https://github.com/go-gitea/gitea/blob/master/LICENSE%E6%96%87%E4%BB%B6%E3%80%82

更多信息

• 官方文档：[***]
• 社区：[]
• 论坛：[***]
• 在线演示：[***]