rasheedamir/gitea

gitea-docker 镜像文档

镜像概述

基于Gitea官方Docker镜像派生，专门适配Fabric8环境，提供轻量级代码托管服务。支持多种数据库配置及Keycloak认证集成，满足团队协作开发中的代码管理需求。

核心功能与特性

• 基于Gitea构建，提供完整代码托管功能（仓库管理、分支控制、代码审查等）
• 支持多数据库配置：SQLite3（默认）、PostgreSQL
• 集成Keycloak认证，支持OpenID Connect登录
• 可通过自定义配置文件调整应用参数

使用场景

适用于需要与Fabric8集成的开发团队，作为内部代码托管平台，支持团队协作开发、版本控制及统一身份认证。

使用方法

快速启动

使用以下命令启动gitea容器：

bash
docker run -d --name=gitea -p 10022:22 -p 10080:3000 stakater/gitea:latest

参数说明：

• -d：后台运行容器
• --name=gitea：指定容器名称
• -p 10022:22：映射SSH端口（宿主机*** → 容器22）
• -p 10080:3000：映射Web访问端口（宿主机*** → 容器3000）

数据库配置

SQLite3（默认）

配置文件示例：

ini
[database]
DB_TYPE  = sqlite3
PATH     = /data/gitea/gitea.db  # 数据库文件路径
HOST     = 127.0.0.1:3306       # 数据库主机（SQLite3无需修改）
NAME     = gitea                # 数据库名称
USER     = gitea                # 数据库用户
PASSWD   =                      # 数据库密码（SQLite3无需设置）
SSL_MODE = disable              # SSL模式（禁用）

PostgreSQL

配置文件示例：

ini
[database]
DB_TYPE  = postgres             # 数据库类型
HOST     = gitea-db:5432        # PostgreSQL主机及端口
NAME     = gitea                # 数据库名称
USER     = gitea                # 数据库用户
PASSWD   =                      # 数据库密码（需根据实际环境设置）
SSL_MODE = disable              # SSL模式（禁用）
PATH     = /data/gitea/gitea.db # 数据库文件路径（PostgreSQL可忽略）

Keycloak认证配置

1. 登录Gitea管理界面，进入认证设置（Sign In → Authentication）
2. 点击添加新认证源（Add New Source）
3. 配置参数：
   • ID：认证源ID（自定义）
   • Secret：认证源密钥（从Keycloak获取）
   • OpenID Connect自动发现URL：

     https://kc.dd.theapp.com/auth/realms/fabric8/.well-known/openid-configuration
     

待办事项（ToDos）

• 如何在IDEA中刷新Go依赖？
• 更新Dockerfile以执行自定义启动脚本
• 将数据库切换为PostgreSQL
• 禁用用户注册功能
• 启动时自动创建默认系统管理员 - 可能无需额外配置，通过Keycloak注册的第一个用户将成为系统管理员（可使用gitea admin命令手动创建）
• 默认添加Keycloak OpenID Connect配置，使用户可选择OpenID Connect登录 - ***用户@strk建议需创建自定义模板实现：

  bash
  mkdir -p custom/templates/user/auth; 
  cp templates/user/auth/signin_inner.tmpl custom/templates/user/auth; 
  vi custom/templates/user/auth/signin_inner.tmpl
  

OpenID Connect参考

Gitea OpenID Connect实现代码参考：

https://github.com/go-gitea/gitea/blob/master/vendor/github.com/markbates/goth/providers/openidConnect/openidConnect.go

联系方式

@strk（***）

配置文件参考

Gitea默认配置文件参考：

https://github.com/go-gitea/gitea/blob/master/conf/app.ini