Gitea 是一款开源的轻量级代码托管平台，类似于 GitHub、GitLab的开源版
基于 Go 语言开发，支持 Git 版本控制功能，可用于管理代码仓库、跟踪代码变更、进行代码审查、管理项目 Issue 等。它设计轻量且易于部署，适合个人、团队或小型组织搭建私有代码托管服务，支持多种操作系统和数据库，同时提供了 Web 界面、API 以及与其他工具的集成能力，兼顾了易用性和扩展性。
使用场景：作为本地代码托管、文档备份和管理、问题单、CICD
应用特点：
完整 Pull Request 代码评审，支持行级评论、多人协作
内置 Gitea Actions CI/CD，兼容 GitHub Actions 工作流语法
内置 Issue 任务管理、指派、截止日期、关联 PR
支持项目看板（Kanban）可视化进度管理
内置软件包仓库，支持 Docker、Maven、npm、PyPI 等
组织与团队管理，精细化权限控制、分支保护
支持 2FA 双因素认证、SSH 密钥、GPG 签名、审计日志
内置 Wiki 文档、Pages 静态站点托管
支持 WebHook、API 对接，可与外部系统集成
界面简洁易用，中文友好，适合个人与中小团队私有部署
Docker 安装部署 Gitea
1、创建本地持久化存储路径
mkdir /opt/gitea #创建存储gitea应用数据库、gitea代码仓库的路径 mkdir /opt/gitea/data /opt/gitea/git_repos cd /opt/gitea
支持SQLite（内置，无需额外安装）、MySQL、PostgreSQL、MariaDB、MSSQL数据库
数据库版本要求：
MySQL最低版本：≥ 8.0（不支持 8.0 以下）
MariaDB版本≥ 10.4
PostgreSQL版本≥ 12
2、Docker Compose配置
推荐数据库postgres，连接已安装好的数据库
version: "3" services: server: image: docker.gitea.com/gitea:1.26.0 container_name: gitea-1.26.0 environment: - USER_UID=1000 - USER_GID=1000 - GITEA__database__DB_TYPE=postgres - GITEA__database__HOST=192.168.1.100:15433 - GITEA__database__NAME=gitea - GITEA__database__USER=root - GITEA__database__PASSWD=123456 #配置跨域解决 404/跨域） - GITEA__CORS__ENABLED=true - GITEA__CORS__SCHEME=http - GITEA__CORS__ALLOW_DOMAIN=* - GITEA__CORS__ALLOW_CREDENTIALS=true restart: always volumes: - ./data:/data/gitea - ./git_repos:/data/git/repositories - /etc/localtime:/etc/localtime:ro ports: - "23000:3000" - "20022:22"
参数说明：
1）数据库配置
修改数据库配置
- GITEA__database__DB_TYPE=postgres - GITEA__database__HOST=192.168.1.100:15433 - GITEA__database__NAME=gitea - GITEA__database__USER=root - GITEA__database__PASSWD=123456
2）解决Gitea
默认有限制跨域访问，其他第三方应用访问如果不设置，会报跨域错误
#配置跨域解决 404/跨域） - GITEA__CORS__ENABLED=true - GITEA__CORS__SCHEME=http - GITEA__CORS__ALLOW_DOMAIN=* - GITEA__CORS__ALLOW_CREDENTIALS=true
使用自带的SQLLite数据库：
services: gitea: image: gitea/gitea:1.25.3 # 官方最新稳定版 container_name: gitea restart: always environment: - USER_UID=1000 # 与宿主机用户保持一致 - USER_GID=1000 - SSH_DOMAIN=192.168.5.200 # 生成 clone 地址用，必填 - SSH_PORT=20022 # 宿主机映射端口 - DB_TYPE=sqlite3 # 单节点直接用 SQLite，免额外容器 ports: - "23000:3000" # Web 界面 - "20022:22" # SSH 克隆端口 volumes: - ./data:/data # 仓库、数据库、配置全持久化 - /etc/timezone:/etc/timezone:ro # 时区同步 - /etc/localtime:/etc/localtime:ro networks: - gitea-net networks: gitea-net: driver: bridge
3、简化版本
docker run -d \ --name gitea \ --restart always \ -p 23000:3000 \ -p 20022:22 \ -v /opt/gitea:/data \ -v /etc/timezone:/etc/timezone:ro \ -v /etc/localtime:/etc/localtime:ro \ gitea/gitea:latest
使用PGSQL
# 连接 PostgreSQL docker run -d --name gitea \ -p 23000:3000 -p 20022:22 \ -v /opt/gitea:/data \ -e DB_TYPE=postgres \ -e DB_HOST=pg-host:5432 \ -e DB_NAME=gitea \ -e DB_USER=gitea \ -e DB_PASSWD=your-password \ gitea/gitea:latest
Gitea使用教程
1、创建组织和项目工程
右上角+，创建组织
输入组织名称、权限
2）创建项目
创建普通项目
创建仓库镜像
镜像支持Gitea、Github同步，定时自动同步获取远端仓库，同步到本地
下载项目
支持http、https、ssh协议克隆项目
也可以下载压缩版
在线编辑和创建百科，创建项目知识库
2、配置SSH免密登录
右上角头像-设置-SSH/GPG密钥，配置公钥，copy本地公钥到Gitea服务器
3、工单管理
进入XX仓库，工单，创建问题单
管理日常问题单、Bug
