karakayv/gitea

Gitea Docker镜像

镜像概述和主要用途

本Docker镜像基于https://github.com/go-gitea/gitea%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%9C%AA%E5%81%9A%E4%BB%BB%E4%BD%95%E4%BB%A3%E7%A0%81%E4%BF%AE%E6%94%B9%EF%BC%8C%E6%8F%90%E4%BE%9B%E8%BD%BB%E9%87%8F%E7%BA%A7Git%E6%9C%8D%E5%8A%A1%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E3%80%82%E6%94%AF%E6%8C%81%E5%A4%9A%E7%A7%8D%E7%A1%AC%E4%BB%B6%E6%9E%B6%E6%9E%84%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E4%B8%8D%E5%90%8C%E7%8E%AF%E5%A2%83%E4%B8%8B%E7%9A%84%E4%BB%A3%E7%A0%81%E6%89%98%E7%AE%A1%E9%9C%80%E6%B1%82%E3%80%82

核心功能和特性

• 零修改构建：完全基于官方Gitea源代码构建，保留所有官方功能和特性
• 多架构支持：适配arm64、arm/v7、arm/v6和amd64四种架构，满足不同硬件环境需求
• 项目渊源：源自https://github.com/zyxd/gitea%E9%A1%B9%E7%9B%AE%EF%BC%8C%E7%BB%A7%E6%89%BF%E5%85%B6%E6%88%90%E7%86%9F%E7%9A%84%E6%9E%84%E5%BB%BA%E9%85%8D%E7%BD%AE

使用场景和适用范围

• 个人开发者的私有代码仓库管理
• 小型团队的协作开发平台搭建
• 嵌入式设备（如树莓派）上的轻量级代码托管服务部署
• 多架构环境下的Git服务标准化部署

使用方法和配置说明

基本部署（docker run）

bash
docker run -d \
  --name gitea \
  -p 3000:3000 \
  -p 222:22 \
  -v /path/to/gitea/data:/data \
  -e USER_UID=1000 \
  -e USER_GID=1000 \
  gitea/gitea:latest

参数说明

• -p 3000:3000：映射Web界面访问端口
• -p 222:22：映射SSH访问端口（可根据主机端口占用情况调整）
• -v /path/to/gitea/data:/data：挂载数据卷，用于持久化存储仓库数据、配置文件等
• -e USER_UID=1000 和 -e USER_GID=1000：设置容器内运行用户的UID和GID，确保数据卷权限正确

Docker Compose配置示例

yaml
version: '3'

services:
  gitea:
    image: gitea/gitea:latest
    container_name: gitea
    ports:
      - "3000:3000"  # Web界面端口
      - "222:22"     # SSH端口
    volumes:
      - /path/to/gitea/data:/data  # 数据持久化目录
    environment:
      - USER_UID=1000
      - USER_GID=1000
    restart: always  # 容器异常退出后自动重启

访问说明

部署完成后，通过http://<主机IP>:3000访问Gitea Web界面，首次访问需完成初始化配置。SSH访问仓库时使用ssh -p 222 git@<主机IP>命令。