Windows下Gitea轻量级Git服务搭建与CI/CD实战-代码聚汇网

Windows下Gitea轻量级Git服务搭建与CI/CD实战

佚格麻瓜

1. 为什么选择Gitea搭建Windows版代码仓库

在Windows环境下搭建私有Git服务时，Gitea凭借其轻量级特性成为许多开发团队的首选。与GitLab相比，Gitea对系统资源的消耗更低（内存占用可控制在200MB以内），特别适合中小型团队或个人开发者使用。我曾在配置为4核8G的Windows Server 2016虚拟机上同时运行Gitea和Jenkins，系统负载长期保持在30%以下。

Gitea的Windows版本安装包仅约50MB，安装过程不需要依赖额外的数据库服务（默认使用SQLite），这对Windows用户尤其友好。实际测试显示，从下载安装包到完成基础配置，整个过程不超过15分钟。相比之下，GitLab的Windows安装需要准备PostgreSQL和Redis服务，初始内存占用就超过2GB。

提示：如果团队规模超过20人且需要复杂CI/CD功能，建议考虑GitLab。但对于大多数中小团队，Gitea的功能完全够用。

2. Windows环境下的Gitea安装实战

2.1 准备工作与环境配置

首先需要从Gitea官网下载Windows版本（当前稳定版为1.17.3）。我推荐选择带有SQLite支持的版本，这样可以省去单独安装数据库的步骤。系统要求如下：

Windows 7及以上版本（建议Windows 10/Server 2016+）
.NET Framework 4.6.1或更高版本
至少2GB空闲内存（建议4GB以上）
磁盘空间不小于10GB

安装前需要确保防火墙放通3000端口（Gitea默认端口）。以管理员身份运行CMD执行：

bash复制netsh advfirewall firewall add rule name="Gitea HTTP" dir=in action=allow protocol=TCP localport=3000

2.2 详细安装步骤解析

解压下载的gitea-x.x.x-windows-4.0-amd64.exe到目标目录（如C:\gitea）
首次运行会生成配置文件custom/conf/app.ini
通过浏览器访问http://localhost:3000进入安装向导
关键配置项说明：

ini复制[server]
HTTP_PORT = 3000  # 可修改为80端口避免URL带端口号
DOMAIN = your-domain.com
ROOT_URL = http://your-domain.com/

[database]
DB_TYPE = sqlite3  # Windows下推荐使用SQLite
PATH = data/gitea.db

安装完成后，可以将Gitea注册为Windows服务实现开机自启：

bash复制sc create gitea start= auto binPath= "\"C:\gitea\gitea.exe\" web --config \"C:\gitea\custom\conf\app.ini\""

3. 构建自动化CI/CD流水线

3.1 Gitea Actions配置指南

Gitea从1.14版本开始内置了Actions功能（类似GitHub Actions），这是实现CI/CD的关键。需要在app.ini中启用：

ini复制[actions]
ENABLED = true

然后在仓库根目录创建.gitea/workflows/build.yaml文件，示例配置：

yaml复制name: Java Build Pipeline
on: [push]

jobs:
  build:
    runs-on: windows
    steps:
    - uses: actions/checkout@v3
    - name: Set up JDK 17
      uses: actions/setup-java@v3
      with:
        java-version: '17'
        distribution: 'microsoft'
    - name: Build with Maven
      run: mvn -B package --file pom.xml
    - name: Deploy to Test
      run: |
        copy target/*.jar \\test-server\deploy\
        net stop TestService
        net start TestService

3.2 Windows环境下的Runner部署

Gitea Actions需要配合Runner才能执行任务，Windows版Runner安装步骤：

下载对应版本的act_runner_windows_amd64.zip
解压后执行注册命令：

bash复制act_runner register --instance http://your-gitea-server:3000 --token <your-token> --name windows-runner-01

启动Runner服务：

bash复制act_runner daemon

注意：Runner所在机器需要安装构建工具链（如JDK、Maven等），建议使用Chocolatey进行统一管理：

bash复制choco install jdk17 maven -y

4. 典型问题排查与优化建议

4.1 常见安装问题解决方案

端口冲突问题：如果3000端口被占用，修改app.ini中的HTTP_PORT后需重启服务。可通过以下命令查找占用进程：

bash复制netstat -ano | findstr :3000
taskkill /PID <pid> /F

服务启动失败：检查事件查看器中的应用程序日志，常见原因是权限不足。解决方法：

bash复制icacls "C:\gitea" /grant "NT AUTHORITY\SYSTEM:(OI)(CI)F"

4.2 性能优化配置

对于团队使用场景，建议调整以下参数：

ini复制[database]
MAX_OPEN_CONNS = 100  # SQLite默认值较低

[repository]
ROOT = D:/gitea-repos  # 将仓库存储到独立磁盘

[server]
PROTOCOL = http
DOMAIN = git.yourcompany.com
SSH_DOMAIN = git.yourcompany.com
SSH_PORT = 22

4.3 安全加固措施

定期备份gitea.db和repositories目录
启用HTTPS（可通过Caddy自动申请证书）：

ini复制[server]
PROTOCOL = https
CERT_FILE = C:/ssl/cert.pem
KEY_FILE = C:/ssl/key.pem

配置定期垃圾回收：

bash复制gitea dump --tempdir C:\backups --skip-log

5. 进阶集成方案

5.1 与Docker Desktop集成

虽然Gitea本身运行在Windows上，但可以通过Docker Desktop运行构建环境：

yaml复制jobs:
  docker-build:
    runs-on: windows
    steps:
    - uses: actions/checkout@v3
    - name: Build Docker image
      run: |
        docker build -t myapp .
        docker save myapp > myapp.tar
        copy myapp.tar \\prod-server\images\

5.2 多语言支持配置

Gitea支持界面本地化，修改app.ini启用多语言：

ini复制[i18n]
LANGS = en-US,zh-CN,ja-JP
NAMES = English,简体中文,日本語

用户可在个人设置中选择偏好语言。实测显示中文翻译完整度超过95%，适合国内团队使用。

5.3 备份与迁移方案

建议编写PowerShell脚本实现自动化备份：

powershell复制$date = Get-Date -Format "yyyyMMdd"
$backupDir = "D:\backups\$date"
New-Item -ItemType Directory -Path $backupDir
Copy-Item "C:\gitea\data\gitea.db" -Destination $backupDir
Compress-Archive -Path "C:\gitea\repositories" -DestinationPath "$backupDir\repos.zip"

迁移到新服务器时，只需复制gitea.db和repositories目录，保持相同路径结构即可恢复服务。