587_Gitea代码托管¶

# docker-compose.yml
services:
  gitea:
    image: gitea/gitea:latest           # 最新版（v1.23，2026）
    container_name: gitea
    restart: always
    ports:
      - "3000:3000"                     # Web 界面
      - "2222:22"                       # SSH（Git over SSH）
    volumes:
      - ./gitea-data:/data              # 数据持久化
      - /etc/timezone:/etc/timezone:ro  # 时区
    environment:
      - USER_UID=1000                   # 运行用户 UID
      - USER_GID=1000                   # 运行用户 GID
      - GITEA__database__DB_TYPE=sqlite3  # 使用 SQLite（最简单）

docker compose up -d                   # 启动
# 浏览器打开 http://localhost:3000
# 首次访问进入安装向导

# 下载最新版
wget https://dl.gitea.com/gitea/1.23/gitea-1.23-linux-amd64
chmod +x gitea-1.23-linux-amd64       # 添加执行权限
sudo mv gitea-1.23-linux-amd64 /usr/local/bin/gitea  # 移到系统路径

# 创建用户和目录
sudo adduser --system --shell /bin/bash --group git
sudo mkdir -p /var/lib/gitea /etc/gitea
sudo chown git:git /var/lib/gitea /etc/gitea

# 启动
sudo -u git gitea web                 # 前台运行
# 或创建 systemd 服务后台运行

# 首次访问 http://localhost:3000 时的关键配置：
# 1. 数据库类型：SQLite3（小团队）/ MySQL / PostgreSQL
# 2. 站点标题：你的 Git 服务名称
# 3. 仓库根目录：/data/gitea-repositories
# 4. SSH 端口：22 或 2222
# 5. 管理员账号：立即创建！
# 6. 邮件服务：配置 SMTP（可选，用于通知和密码重置）

# 在 Web 界面创建仓库后，用 Git 推送代码：

# SSH 方式（推荐）
git remote add origin ssh://git@your-server:2222/username/repo.git
git push -u origin main               # 推送代码

# HTTPS 方式
git remote add origin https://your-server:3000/username/repo.git
git push -u origin main

# 在仓库中创建 .gitea/workflows/ci.yml
name: CI                               # 工作流名称
on: [push, pull_request]               # 触发条件

jobs:
  test:
    runs-on: ubuntu-latest             # 运行环境
    steps:
      - uses: actions/checkout@v4      # 拉取代码
      - name: Run tests               # 步骤名
        run: |
          npm install                  # 安装依赖
          npm test                     # 运行测试

# 启用 Gitea Actions 需要在 app.ini 中配置：
# [actions]
# ENABLED = true
#
# 还需要部署 act_runner（Actions 执行器）
docker run -d --name runner \
  -v /var/run/docker.sock:/var/run/docker.sock \
  gitea/act_runner:latest

# 从 GitHub 镜像仓库到 Gitea：
# 1. 新建仓库 → 选择 "迁移/从远程仓库导入"
# 2. 填入 GitHub 仓库 URL
# 3. 勾选 "镜像仓库"
# 4. 设置同步间隔
# Gitea 会自动定期同步 GitHub 仓库的变更

; /data/gitea/conf/app.ini
[server]
ROOT_URL = https://git.example.com/    ; 外部访问 URL
SSH_PORT = 2222                        ; SSH 端口
DOMAIN = git.example.com              ; 域名

[service]
DISABLE_REGISTRATION = true           ; 关闭注册（安全！）
REQUIRE_SIGNIN_VIEW = true            ; 必须登录才能查看

[mailer]
ENABLED = true                        ; 启用邮件
SMTP_ADDR = smtp.gmail.com            ; SMTP 服务器
SMTP_PORT = 587                       ; SMTP 端口
FROM = gitea@example.com              ; 发件人

[actions]
ENABLED = true                        ; 启用 Gitea Actions

# 管理面板 → 认证源 → 添加认证源
# 支持：LDAP / OAuth2 / SMTP / PAM
#
# OAuth2 配置示例（GitHub 登录）：
# - 类型：OAuth2
# - 提供者：GitHub
# - Client ID：从 GitHub 获取
# - Client Secret：从 GitHub 获取
# - 重定向 URL：https://git.example.com/user/oauth2/github/callback

# === Docker 安装 ===
docker run -d -p 3000:3000 -p 2222:22 \
  -v gitea-data:/data --name gitea gitea/gitea:latest

# === 默认端口 ===
# 3000 → Web 界面
# 22/2222 → SSH

# === 资源需求 ===
# 最低：2 CPU + 512MB RAM（SQLite）
# 推荐：2 CPU + 1GB RAM

# === 数据库支持 ===
# SQLite（最简单）| MySQL | PostgreSQL | TiDB | MSSQL

# === 关键配置路径 ===
# app.ini：/data/gitea/conf/app.ini
# 仓库：/data/gitea-repositories/
# 日志：/data/gitea/log/

# === Gitea CLI ===
gitea admin user create --username admin --password pass --email a@b.com
gitea admin user list                 # 列出用户
gitea dump                            # 备份所有数据