turnkeylinux/gitea

TurnKey Gitea Docker镜像文档

镜像概述

TurnKey Gitea Docker镜像是基于TurnKey Linux构建的Gitea服务容器化解决方案。Gitea是一款开源、轻量级的自托管Git服务，旨在提供简单易用的代码仓库管理、版本控制和团队协作功能，适用于个人开发者、小型团队或企业内部使用，具有资源占用低、部署便捷的特点。

核心功能与特性

• 完整Git功能：支持仓库创建、分支管理、提交历史、合并请求等核心Git操作
• 用户权限管理：细粒度权限控制，支持组织、团队管理及角色分配
• 协作工具：集成Issue跟踪、里程碑管理和评论系统，便于团队协作
• Web界面：直观的Web管理界面，支持仓库浏览、在线编辑和文件对比
• 轻量级设计：低资源占用，可在低配置服务器稳定运行
• 数据持久化：支持数据卷挂载，确保仓库数据和配置信息持久存储
• 安全特性：支持HTTPS、两步验证(2FA)和IP限制等安全功能

使用场景

• 个人开发者：搭建个人代码仓库，管理项目版本
• 小型团队：团队内部代码协作、版本控制及项目管理
• 企业内部：部署私有Git服务，保护敏感代码资产
• 教育场景：教学环境中演示Git版本控制流程

使用方法与配置说明

基本部署（Docker Run）

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

bash
docker run -d \
  --name turnkey-gitea \
  -p 3000:3000 \  # Web界面端口
  -p 2222:22 \    # SSH访问端口（可选）
  -v /path/to/gitea/data:/data \  # 数据持久化目录
  turnkeylinux/gitea

Docker Compose配置

创建docker-compose.yml文件进行灵活部署：

yaml
version: '3'
services:
  gitea:
    image: turnkeylinux/gitea
    container_name: turnkey-gitea
    ports:
      - "3000:3000"  # Web界面端口
      - "2222:22"    # SSH端口
    volumes:
      - ./gitea/data:/data  # 数据卷挂载
    environment:
      - GITEA__database__TYPE=sqlite3  # 数据库类型（sqlite3/mysql/postgres）
      - GITEA__security__INSTALL_LOCK=true  # 锁定安装界面
      - GITEA__server__DOMAIN=example.com  # 服务器域名
      - GITEA__server__ROOT_URL=https://example.com:3000/  # 根URL
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

环境变量配置

常用环境变量说明：

初始化配置

1. 容器启动后，访问http://<服务器IP>:3000进入安装界面
2. 完成数据库配置、管理员账户设置和服务器URL等基础配置
3. 配置完成后建议设置GITEA__security__INSTALL_LOCK=true锁定安装界面

数据持久化

需将容器内/data目录挂载到宿主机目录（如示例中的/path/to/gitea/data），该目录包含仓库数据、配置文件和日志等关键信息，确保数据不丢失。

访问与使用

• Web界面：通过http://<服务器IP>:3000访问，使用管理员账户登录后可创建仓库、管理用户
• SSH访问：通过ssh -p 2222 git@<服务器IP>访问仓库（需确保端口映射正确）