jvanderneutstulen/gitea Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Gitea Docker镜像文档

镜像概述

本镜像基于Gitea构建，专为docker-compose部署优化，暴露了核心配置参数，简化私有Git服务的搭建流程。Gitea是一款轻量级自托管Git服务，兼容GitHub功能，适合个人开发者或小型团队使用。

核心功能与特性

• 轻量级设计：资源占用低，适合各种规模的部署环境
• docker-compose优化：通过环境变量暴露关键配置参数，无需手动修改配置文件
• 完整Git功能：支持代码仓库管理、分支控制、Pull Request、Issue追踪等核心功能
• 可扩展性：支持与多种数据库（MySQL、PostgreSQL、SQLite）集成
• 安全特性：内置用户认证、权限管理和HTTPS支持

使用场景

• 个人开发者搭建私有代码仓库
• 小型团队内部协作开发
• 企业内部Git服务私有化部署
• 教学或测试环境的Git服务快速搭建

使用方法

基本docker run部署

bash
docker run -d \
  --name gitea \
  -p 3000:3000 \
  -p 222:22 \
  -v /path/to/data:/data \
  -e GITEA__database__DB_TYPE=sqlite3 \
  -e GITEA__server__HTTP_PORT=3000 \
  -e GITEA__server__SSH_PORT=222 \
  gitea/gitea:latest

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:
      - ./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=gitea_password
      # 服务器配置
      - GITEA__server__DOMAIN=example.com
      - GITEA__server__HTTP_PORT=3000
      - GITEA__server__ROOT_URL=[***]
      # 管理员配置
      - GITEA__service__DEFAULT_ADMIN_USER=admin
      - GITEA__service__DEFAULT_ADMIN_PASSWORD=admin_password

  db:
    image: mysql:8.0
    container_name: gitea-db
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=root_password
      - MYSQL_DATABASE=gitea
      - MYSQL_USER=gitea
      - MYSQL_PASSWORD=gitea_password
    volumes:
      - ./mysql/data:/var/lib/mysql

启动服务：

bash
docker-compose up -d

配置参数说明

核心环境变量

数据持久化

建议挂载以下目录以确保数据持久化：

• /data：存储Gitea所有数据（仓库、配置、日志等）

访问方式

部署完成后，通过以下方式访问：

• Web界面：http://<服务器IP>:3000
• SSH访问：ssh -p 222 git@<服务器IP>

首次访问需完成初始配置（如未通过环境变量预设管理员账户）。