Gitea 是一个轻量级的 DevOps 平台,能够覆盖从开发计划到产品成型的整个软件生命周期。它支持 Git 托管、代码审查、团队协作、软件包注册和 CI/CD,非常适合团队或个人搭建私有代码仓库。
一、下载安装包
前往 Gitea 官方下载页面获取对应系统的安装包:Gitea | gitea。
二、安装步骤
- 准备环境
将下载好的安装包(例如
gitea-1.25.3-windows-4.0-amd64.exe)放置到指定目录,如D:\gitea。双击运行安装程序。
![安装向导界面]
- 初始化配置
安装完成后,在浏览器访问
http://localhost:3000。
![Web 初始化界面]
首次启动会进入配置向导。这里默认选择 SQLite3 即可,无需额外配置数据库。如果已有 MySQL 或 PostgreSQL,也可以在此处切换。
![数据库选择界面]
- 创建管理员账户 填写管理员账号信息,建议设置强密码。点击'立即安装',系统会在安装目录下生成必要的配置文件和数据文件。
![安装完成界面]
至此,基础服务已就绪。
三、配置开机自启动
直接通过启动文件夹运行会导致每次开机弹出窗口,体验不佳。推荐将其注册为 Windows 服务,实现后台静默运行。
- 以管理员身份打开 CMD 可以通过任务管理器或搜索'命令提示符'并右键选择'以管理员身份运行'。
![任务管理器界面]
- 注册服务
使用
sc命令将 Gitea 注册为系统服务。假设安装路径为D:\gitea\gitea.exe:
sc create gitea binPath= "D:\gitea\gitea.exe" start= auto DisplayName= "Gitea"
注意:binPath= 后面必须有空格。
![服务注册命令]
- 验证服务
按下
Win + R,输入services.msc,在服务列表中找到 Gitea,确保其状态为'正在运行'。
![服务列表界面]
四、基本使用流程
1. 创建仓库
登录管理员账户后,点击右上角的'新建'按钮创建仓库。初次创建时建议不勾选'私有',方便后续测试协作流程。
![创建仓库界面]
2. Fork 与合并工作流
普通用户可注册个人账户,通过 Fork 功能复制管理员的仓库进行开发。
![Fork 操作界面]
克隆到自己的远程仓库后,可以在本地修改代码。开发完成后,发起 Pull Request(合并请求),由管理员审核通过后合并至主干分支。这种机制能有效保障代码质量。
![合并请求界面]
五、常用 Git 命令实战
掌握以下命令能显著提升日常开发效率。
1. 仓库克隆与提交
# 克隆远程仓库到本地
git clone <url>
# 指定分支克隆
git clone <url> -b branch_name
git status
git add filename
git add .
git commit -m

