# 下载最新版本（以 1.22 为例）
GITEA_VERSION="1.22.0"
wget -O /usr/local/bin/gitea \
  "https://dl.gitea.com/gitea/${GITEA_VERSION}/gitea-${GITEA_VERSION}-linux-amd64"

chmod +x /usr/local/bin/gitea

# 验证
gitea --version
# Gitea version 1.22.0 built with ...

# 创建系统用户
sudo adduser \
  --system \
  --shell /bin/bash \
  --group \
  --home /home/git \
  --disabled-password \
  git

# 创建必要的目录
sudo mkdir -p /var/lib/gitea/{custom,data,log}
sudo mkdir -p /etc/gitea

# 设置权限
sudo chown -R git:git /var/lib/gitea/
sudo chown root:git /etc/gitea
sudo chmod 750 /etc/gitea

sudo tee /etc/systemd/system/gitea.service << 'EOF'
[Unit]
Description=Gitea (Git with a cup of tea)
After=syslog.target
After=network.target
After=postgresql.service mysql.service mariadb.service

[Service]
Type=simple
User=git
Group=git
WorkingDirectory=/var/lib/gitea/
RuntimeDirectory=gitea
ExecStart=/usr/local/bin/gitea web --config /etc/gitea/app.ini
Environment=GITEA_WORK_DIR=/var/lib/gitea
Environment=USER=git
Restart=always
RestartSec=2s
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable gitea
sudo systemctl start gitea

# 安装 PostgreSQL
sudo apt install postgresql -y

# 创建数据库和用户
sudo -u postgres psql << SQL
CREATE USER gitea WITH PASSWORD 'gitea_password_change_me';
CREATE DATABASE giteadb OWNER gitea;
GRANT ALL PRIVILEGES ON DATABASE giteadb TO gitea;
SQL

# 验证连接
psql -h 127.0.0.1 -U gitea -d giteadb

sudo apt install mariadb-server -y
sudo mysql_secure_installation

sudo mysql << SQL
CREATE DATABASE giteadb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'gitea'@'localhost' IDENTIFIED BY 'gitea_password_change_me';
GRANT ALL PRIVILEGES ON giteadb.* TO 'gitea'@'localhost';
FLUSH PRIVILEGES;
SQL

sudo tee /etc/gitea/app.ini << 'INI'
[server]
DOMAIN           = git.example.com
HTTP_PORT        = 3000
ROOT_URL         = https://git.example.com/
SSH_DOMAIN       = git.example.com
SSH_PORT         = 22
START_SSH_SERVER = false
LFS_START_SERVER = true
LFS_CONTENT_PATH = /var/lib/gitea/data/lfs
OFFLINE_MODE     = false

[database]
DB_TYPE  = postgres
HOST     = 127.0.0.1:5432
NAME     = giteadb
USER     = gitea
PASSWD   = gitea_password_change_me
SSL_MODE = disable
CHARSET  = utf8

[repository]
ROOT                     = /var/lib/gitea/data/gitea-repositories
ENABLE_PUSH_CREATE_USER  = true
ENABLE_PUSH_CREATE_ORG   = true
DEFAULT_BRANCH           = main

[service]
DISABLE_REGISTRATION              = false
REQUIRE_SIGNIN_VIEW               = false
ENABLE_NOTIFY_MAIL                = false
ALLOW_ONLY_EXTERNAL_REGISTRATION  = false

[mailer]
ENABLED = false

[log]
MODE      = file
LEVEL     = Info
ROOT_PATH = /var/lib/gitea/log

[security]
INSTALL_LOCK   = true
SECRET_KEY     = auto_generated_change_me
INTERNAL_TOKEN = auto_generated_change_me
INI

sudo chown git:git /etc/gitea/app.ini
sudo systemctl restart gitea

# docker-compose.yml
version: "3"

services:
  gitea:
    image: gitea/gitea:1.22
    container_name: gitea
    restart: always
    environment:
      - USER_UID=1000
      - USER_GID=1000
      - GITEA__database__DB_TYPE=postgres
      - GITEA__database__HOST=db:5432
      - GITEA__database__NAME=gitea
      - GITEA__database__USER=gitea
      - GITEA__database__PASSWD=gitea_password
    volumes:
      - ./gitea/data:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "3000:3000"
      - "2222:22"
    networks:
      - gitea-network
    depends_on:
      - db

  db:
    image: postgres:16-alpine
    container_name: gitea-db
    restart: always
    environment:
      - POSTGRES_USER=gitea
      - POSTGRES_PASSWORD=gitea_password
      - POSTGRES_DB=gitea
    volumes:
      - ./postgres/data:/var/lib/postgresql/data
    networks:
      - gitea-network

networks:
  gitea-network:
    driver: bridge

# 启动
docker compose up -d

# 查看日志
docker compose logs -f gitea

# 访问 http://localhost:3000 进行安装配置

<!-- Issue 模板示例: .gitea/ISSUE_TEMPLATE/bug.md -->
---
name: Bug 报告
about: 报告一个 bug
labels: bug
---

## 描述
<!-- 简要描述 bug -->

## 复现步骤
1. 步骤一
2. 步骤二
3. 步骤三

## 预期行为
<!-- 描述预期的行为 -->

## 实际行为
<!-- 描述实际的行为 -->

## 环境信息
- OS:
- 浏览器:
- 版本:

# 使用 Gitea API 迁移
curl -X POST "https://git.example.com/api/v1/repos/migrate" \
  -H "Authorization: token YOUR_GITEA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "clone_addr": "https://github.com/owner/repo.git",
    "repo_name": "repo",
    "repo_owner": "your-organization",
    "service": "github",
    "auth_token": "ghp_xxxxxxxxxxxx",
    "issues": true,
    "pull_requests": true,
    "labels": true,
    "milestones": true,
    "mirror": false,
    "private": true
  }'

#!/bin/bash
# batch-migrate.sh - 从 GitHub 批量迁移仓库

GITEA_URL="https://git.example.com"
GITEA_TOKEN="your_gitea_token"
GITHUB_TOKEN="ghp_xxxxxxxxxxxx"
GITHUB_ORG="github-org-name"
GITEA_ORG="gitea-org-name"

# 获取 GitHub 仓库列表
repos=$(curl -s -H "Authorization: token $GITHUB_TOKEN" \
  "https://api.github.com/orgs/${GITHUB_ORG}/repos?per_page=100" | \
  jq -r '.[].name')

for repo in $repos; do
    echo "Migrating: $repo"
    
    curl -s -X POST "${GITEA_URL}/api/v1/repos/migrate" \
      -H "Authorization: token ${GITEA_TOKEN}" \
      -H "Content-Type: application/json" \
      -d "{
        \"clone_addr\": \"https://github.com/${GITHUB_ORG}/${repo}.git\",
        \"repo_name\": \"${repo}\",
        \"repo_owner\": \"${GITEA_ORG}\",
        \"service\": \"github\",
        \"auth_token\": \"${GITHUB_TOKEN}\",
        \"issues\": true,
        \"pull_requests\": true,
        \"labels\": true,
        \"milestones\": true,
        \"private\": true
      }" | jq '.full_name'
    
    sleep 2  # 避免触发速率限制
done

# .gitea/workflows/build.yml
name: Build and Test

on:
  push:
    branches: [main, dev]
  pull_request:
    branches: [main]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
      
      - name: Install dependencies
        run: npm ci
      
      - name: Run tests
        run: npm test
      
      - name: Build
        run: npm run build
      
      - name: Upload artifact
        uses: actions/upload-artifact@v4
        with:
          name: build-output
          path: dist/

# 安装 act_runner
wget https://dl.gitea.com/act_runner/0.2.11/act_runner-0.2.11-linux-amd64
chmod +x act_runner-0.2.11-linux-amd64
sudo mv act_runner-0.2.11-linux-amd64 /usr/local/bin/act_runner

# 注册 Runner
act_runner register \
  --instance https://git.example.com \
  --token YOUR_REGISTRATION_TOKEN

# 启动 Runner
act_runner daemon --config config.yaml

sudo tee /etc/systemd/system/act_runner.service << 'EOF'
[Unit]
Description=Gitea Actions Runner
After=network.target

[Service]
Type=simple
User=git
ExecStart=/usr/local/bin/act_runner daemon --config /home/git/act_runner/config.yaml
Restart=always
RestartSec=5s

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable act_runner
sudo systemctl start act_runner

GITEA_URL="https://git.example.com"
TOKEN="your_api_token"

# 获取当前用户信息
curl -s -H "Authorization: token $TOKEN" \
  "$GITEA_URL/api/v1/user" | jq

# 列出仓库
curl -s -H "Authorization: token $TOKEN" \
  "$GITEA_URL/api/v1/repos/search?limit=50" | jq '.data[].full_name'

# 创建仓库
curl -s -X POST -H "Authorization: token $TOKEN" \
  -H "Content-Type: application/json" \
  "$GITEA_URL/api/v1/user/repos" \
  -d '{"name": "new-repo", "description": "New repository", "private": true}' | jq

# 创建 Issue
curl -s -X POST -H "Authorization: token $TOKEN" \
  -H "Content-Type: application/json" \
  "$GITEA_URL/api/v1/repos/owner/repo/issues" \
  -d '{"title": "Bug: login failed", "body": "Description...", "labels": [1]}' | jq

# Pull Mirror - 从远程仓库自动同步
# 在 Web 界面创建仓库时选择 "Migrate Repository"
# 或在已有仓库的 Settings → Mirror Settings 中配置

# /etc/gitea/app.ini

[git]
; 启用 Git GC
ENABLE_AUTO_GIT_WIRE_PROTOCOL = true

[repository]
; 限制仓库大小
MAX_CREATION_LIMIT = -1
; 启用 Large File Storage
ENABLE_PUSH_CREATE_USER = true

[server]
; 启用 Gzip 压缩
ENABLE_GZIP = true

[cache]
; 启用缓存
ADAPTER = redis
HOST = redis://127.0.0.1:6379/0

[queue]
; 任务队列配置
TYPE = redis
CONN_STR = redis://127.0.0.1:6379/1

# 启用 Prometheus 指标
[metrics]
ENABLED = true

# 访问指标端点
curl http://localhost:3000/metrics