Gitea 轻量级私有化部署指南
Gitea 是一个用 Go 语言编写的轻量级 DevOps 平台,从开发计划到产品成型的全生命周期管理都能高效支持。它集成了 Git 托管、代码审查、团队协作、软件包注册和 CI/CD 功能。下面分享如何在 Windows 环境下快速搭建及使用。
一、下载安装
访问官方发布页下载对应系统的安装包:Gitea Releases。
以 Windows 为例,下载 gitea-1.25.3-windows-amd64.exe 后,建议将其放置在一个固定路径(例如 D:\gitea),双击运行安装程序。
安装向导启动后,会进入初始化配置界面。默认选择 SQLite3 数据库即可,无需额外配置其他数据库服务。如果本地已部署 MySQL 或 PostgreSQL,也可在此处切换。
接下来创建管理员账户,用于后续仓库的初始化管理。填写完用户名、密码及邮箱后,点击"立即安装"。安装完成后,会在安装目录下生成必要的配置文件和数据目录。
二、配置开机自启
1. 快捷方式启动
按下 Win + R,输入 shell:startup 打开启动文件夹。新建一个快捷方式指向 Gitea 的可执行文件。这种方式简单,但每次开机都会弹出窗口,体验不佳。
2. 注册为后台服务
为了更稳定地运行,建议将 Gitea 注册为 Windows 服务。
首先以管理员身份运行 CMD。使用系统自带的 sc 命令进行注册,例如:
sc create gitea binPath= "D:\gitea\gitea.exe" start= auto
注册成功后,可以在服务管理器(services.msc)中查看到名为 gitea 的服务。这样每次开机服务会自动在后台默默运行,无需手动干预。
三、基础使用流程
1. 管理员创建仓库
登录管理后台,点击"创建仓库"。填写仓库名称,根据需求设置是否私有。创建完成后,管理员拥有该仓库的最高权限。
2. 用户协作模式
普通用户需先注册个人账户。通过"探索"页面找到目标仓库(如 admin/test),点击右上角的"派生"按钮,即可在自己的账号下创建一个副本。
从个人远端仓库 Clone 到本地后,修改代码并推送到自己的远程分支。当功能开发完成,发起 Pull Request 请求合并到主干(admin 仓库)。这种走读机制能有效保证代码质量,审核通过后再合并入主分支。
四、常用 Git 命令速查
日常开发中,以下命令组合能覆盖大部分场景。建议收藏备用。
1. 仓库克隆与提交
# 克隆远程仓库到本地
git clone [url]
# 指定分支克隆
git clone [url] -b branch_name
# 查看状态
git status
# 添加文件到暂存区
git add filename
# 添加所有修改
git add .
# 提交到版本库
# 类型说明:feat(新功能), fix(修复), docs(文档), style(风格), refactor(重构), perf(性能), test(测试)
git commit -m 'fix: 本次添加的注释信息'

