Gitea轻量级Git服务部署

uname -m
# x86_64   → Intel/AMD 64位
# aarch64  → ARM 64位（Apple Silicon、ARM服务器）

gitea/gitea:版本号-架构-rootless

# docker-compose.yml - Gitea rootless 部署
version: "3"

networks:
  gitea:
    external: false

services:
  server:
    image: gitea/gitea:1.20.1-rootless
    container_name: gitea-server
    environment:
      - GITEA__database__DB_TYPE=sqlite3
      # 如需 MySQL/PostgreSQL：
      # - GITEA__database__DB_TYPE=mysql
      # - GITEA__database__HOST=db:3306
      # - GITEA__database__NAME=gitea
      # - GITEA__database__USER=gitea
      # - GITEA__database__PASSWD=gitea
    restart: always
    networks:
      - gitea
    volumes:
      - ./data:/var/lib/gitea
      - ./config:/etc/gitea
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "11080:3000"   # HTTP 端口
      - "11081:22"     # SSH 端口

# 1. 创建项目目录
mkdir -p ~/gitea && cd ~/gitea

# 2. 创建 docker-compose.yml（粘贴上方配置）

# 3. 创建必要目录
mkdir -p data config

# 4. 设置目录权限（rootless 模式必需！）
# Gitea 容器内使用 UID 1000
sudo chown -R 1000:1000 data config

# 5. 启动服务
docker compose up -d

# 6. 验证运行状态
docker ps | grep gitea

# 7. 查看启动日志
docker logs -f gitea-server
# 看到 "starting new web server" 表示启动成功

~/gitea/config/app.ini

[server]
; SSH 对外暴露端口（用户克隆时看到的端口）
SSH_PORT = 11081

; SSH 容器内部监听端口（通常不变）
SSH_LISTEN_PORT = 22

; HTTP 配置
HTTP_PORT = 3000
ROOT_URL = http://192.168.1.100:11080

# 编辑配置
vi ~/gitea/config/app.ini
# 修改 SSH_PORT = 11081

# 重启容器生效
docker restart gitea-server

# 1. 本地生成密钥
ssh-keygen -t ed25519 -C "your@email.com"

# 2. 查看公钥
cat ~/.ssh/id_ed25519.pub

# 3. 添加到 Gitea
# 浏览器 → 右上角头像 → 设置 → SSH/GPG 密钥 → 添加密钥

# 4. 测试连接
ssh -T git@服务器IP -p 11081

# 5. 克隆仓库
git clone ssh://git@服务器IP:11081/用户名/仓库.git

右上角头像 → 管理后台 → 用户账户管理 → 添加用户

#!/bin/bash
# gitea-backup.sh - Gitea 自动备份脚本

BACKUP_DIR="./backup"
GITEA_DIR="$HOME/gitea"
RETENTION_DAYS=7

mkdir -p $BACKUP_DIR
BACKUP_FILE="gitea-backup-$(date +%Y%m%d-%H%M%S).tar.gz"

echo "开始备份 Gitea..."

# 停止容器确保数据一致性
cd $GITEA_DIR
docker compose down

# 创建备份
tar -czf $BACKUP_DIR/$BACKUP_FILE data/ config/ docker-compose.yml

# 重启服务
docker compose up -d

echo "备份完成：$BACKUP_DIR/$BACKUP_FILE"

# 清理旧备份
find $BACKUP_DIR -name "gitea-backup-*.tar.gz" -mtime +$RETENTION_DAYS -delete
echo "已清理 $RETENTION_DAYS 天前的旧备份"

crontab -e

# 每天凌晨2点执行备份
0 2 * * * /home/user/gitea/gitea-backup.sh >> /home/user/gitea/backup.log 2>&1

# 1. 停止服务
cd ~/gitea && docker compose down

# 2. 解压备份
tar -xzf backup/gitea-backup-YYYYMMDD-HHMMSS.tar.gz

# 3. 确认文件恢复
ls -la data/ config/

# 4. 启动服务
docker compose up -d

# 5. 浏览器验证数据完整

[server]
HTTP_PORT = 3000
ROOT_URL = http://192.168.1.100:11080
SSH_PORT = 11081
SSH_LISTEN_PORT = 22
DISABLE_SSH = false

[database]
DB_TYPE = sqlite3
PATH = data/gitea/gitea.db

[repository]
ROOT = /var/lib/gitea/data/gitea-repositories

[security]
INSTALL_LOCK = true

[service]
DISABLE_REGISTRATION = false    ; 是否禁止注册
REQUIRE_SIGNIN_VIEW = false     ; 是否需要登录才能查看

[mailer]
ENABLED = false