owncloudops/gitea

gitea

![构建状态]([] ![Quay.io]([]

Gitea的自定义容器镜像。

镜像概述

gitea镜像是基于Gitea的自定义容器化实现。Gitea是一个用Go语言开发的轻量级自托管Git服务，提供代码仓库管理、问题跟踪、拉取请求、用户权限控制、Wiki等功能，适合个人开发者或团队搭建私有代码托管平台。

核心功能与特性

• 多端口支持：暴露2222（SSH）和3000（Web界面）端口，满足不同访问需求
• 数据持久化：通过/opt/app/data卷实现配置文件、代码仓库、用户数据等持久化存储
• 灵活配置：支持通过环境变量自定义Gitea的各项功能，覆盖仓库设置、UI展示、数据库连接、安全策略等
• 版本可控：支持通过构建参数指定Gitea版本，确保部署一致性

使用场景

• 个人开发者搭建私有Git仓库
• 小型团队内部代码协作与版本控制
• 企业内部私有代码托管平台部署
• 需要自定义配置的Gitea实例快速部署

使用方法

基本运行

通过以下命令快速启动Gitea容器：

bash
docker run -d -p 3000:3000 -p 2222:2222 -v /path/to/local/data:/opt/app/data --name gitea owncloudops/gitea:latest

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  gitea:
    image: owncloudops/gitea:latest
    ports:
      - "3000:3000"  # Web界面访问端口
      - "2222:2222"  # SSH协议访问端口
    volumes:
      - ./gitea-data:/opt/app/data  # 持久化存储数据
    environment:
      - GITEA_APP_NAME="企业代码托管平台"
      - GITEA_RUN_MODE="prod"
      - GITEA_SERVER_DOMAIN="git.example.com"
      - GITEA_SERVER_ROOT_URL="https://git.example.com"
      - GITEA_DATABASE_TYPE="mysql"
      - GITEA_DATABASE_HOST="db:3306"
      - GITEA_DATABASE_NAME="gitea"
      - GITEA_DATABASE_USERNAME="gitea"
      - GITEA_DATABASE_PASSWORD="secure_password"
    restart: always

启动服务：

bash
docker-compose up -d

配置说明

端口说明

卷说明

环境变量

Gitea的所有配置项均可通过环境变量设置，以下是主要分类及常用配置：

基本设置

仓库设置

服务器设置

数据库设置

安全设置

UI设置

完整环境变量列表包含仓库、CORS、Markdown、邮件、缓存、任务队列等更多配置项，可根据实际需求进行设置。

构建镜像

可通过BUILD_VERSION参数指定目标Gitea版本构建镜像：

bash
docker build --build-arg BUILD_VERSION=1.13.0 -f Dockerfile -t gitea:latest .

许可证

本项目采用Apache 2.0许可证 - 详见https://github.com/owncloud-ops/gitea/blob/main/LICENSE%E6%96%87%E4%BB%B6%E3%80%82