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: 本次添加的注释信息'
2. 推送与分支管理
# 推送到远程
# 首次推送建立关联
push origin branch-name -u
# 强制推送（慎用）
git push -f origin branch-name
# 创建分支
# 基于当前分支
branch new_branch_name
# 基于指定分支
branch new_branch_name reference_branch_name
# 删除分支
# 远程删除
push origin -d branch_name
# 本地删除
branch -D branch_name
分支命名规范建议：
- 功能开发：
feature/功能名 - Bug 修复：
fix/问题描述 - 发布版本：
release/版本号 - 个人开发：
dev/姓名/功能
3. 合并与回滚
# 切换到主分支
checkout main
# 合并功能分支（保留历史）
merge --no-ff feature/功能名 -m '本次添加的注释信息'
# 删除本地功能分支
branch -d feature/功能名
# 撤销 Commit（保留已 add 的文件）
reset --soft HEAD^
# 撤销 Commit 且丢弃已 add 的文件
reset --hard HEAD^
# 撤销单个文件的 add
reset filename
# 回滚到特定版本
reset --hard commit_id
# 注意：回滚后需强制推送更新远程
push origin branch_name --force
4. 日常同步策略
# 每日工作前拉取最新代码（推荐变基）
checkout main
pull --rebase
# 开发中途同步远程更新
fetch origin
rebase origin master
5. 标签与冲突处理
# 打标签发布
tag -a v1.2.1 -m "本次添加的注释信息"
push --tags
# 解决换行符问题 (Windows/Mac 混用)
git config --global core.whitespace cr-at-eol
掌握这些核心命令，基本能应对绝大多数 Git 协作场景。实际使用中遇到冲突时，耐心比对差异，确保逻辑无误后再提交。
