🐳 Docker Compose 部署 Gitea 服务（Ubuntu 24.04）

📋 前置条件

已完成 Docker 和 docker-compose 安装并正常运行。

📁 项目目录规划

指定 Gitea 数据持久化目录为 /usr/local/soft/gitea/，包含配置、数据、Git 仓库等核心文件，避免容器删除后数据丢失。

# 手动创建目录（必须执行，权限更规范）
sudo mkdir -p /usr/local/soft/gitea/
# 赋予目录权限（Docker 容器可正常读写）
sudo chmod 777 /usr/local/soft/gitea/

🚀 编写 Docker Compose 配置文件

1. 进入项目目录

cd /usr/local/soft/gitea/

2. 创建 docker-compose.yml 文件

sudo vim docker-compose.yml

3. 粘贴以下配置内容（直接可用）

# 服务配置
services:
  zhu-gitea:
    # 官方稳定版镜像
    image: gitea/gitea:latest
    # 容器名称
    container_name: zhu-gitea
    # 开机自启
    restart: always
    # 端口映射（主机端口:容器端口）
    ports:
      - "3000:3000"   # Gitea Web 访问端口
      - "222:22"      # Git SSH 访问端口
    # 数据持久化（关键：主机目录挂载到容器）
    volumes:
      - /usr/local/soft/gitea/:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    # 环境变量
    environment:
      - TZ=Asia/Shanghai

🔧 启动 Gitea 服务

在 /usr/local/soft/gitea/ 目录下执行：

# 后台启动容器（-d 表示守护进程模式）
docker-compose up -d

✅ 验证服务状态

# 查看容器运行状态
docker ps
# 查看 Gitea 日志（排查问题用）
docker-compose logs -f gitea

🌐 访问 Gitea 控制台

1. 浏览器打开地址：http://你的服务器IP:3000
2. 首次进入会自动跳转到初始化配置页面，直接默认配置点击「立即安装」即可
3. 注册第一个账号，自动成为管理员账号

🛠️ 常用管理命令

# 停止 Gitea 服务
docker-compose stop

# 重启 Gitea 服务
docker-compose restart

# 删除 Gitea 容器（数据不会丢失，因为挂载到主机目录）
docker-compose down

总结

1. 所有数据持久化到 /usr/local/soft/gitea/，安全不丢失
2. 端口：Web 3000、SSH 222，直接映射无需额外配置
3. 一条命令启动/停止，管理简单便捷
4. 配置文件轻量化，无冗余参数，新手直接上手