上一篇
如何在Windows系统上轻松搭建Git服务器环境?
- 行业动态
- 2025-04-25
- 1
在Windows系统搭建Git服务器可通过Git for Windows配置SSH服务或使用Gitea等工具,前者需安装OpenSSH、创建裸仓库并配置权限;后者提供Web界面,安装后配置数据库及存储路径,支持HTTP/SSH协议访问,适合团队协作,需注意防火墙设置和用户认证管理。
在Windows系统上搭建Git服务器,能为团队提供私有化代码托管、版本控制及协作开发环境,无论是企业还是个人开发者,私有Git服务器能提升代码管理安全性,降低对第三方平台的依赖,本文将详解两种主流方案:Gitea轻量级服务与Bonobo Git Server(基于IIS),并提供完整的搭建步骤、验证方法及常见问题解决方案。
准备工作
系统要求
- Windows 10/11 或 Windows Server 2016及以上版本。
- 管理员权限账户。
- 2GB以上内存,20GB可用存储空间(根据项目规模调整)。
安装必备组件
- Git for Windows:下载地址 https://git-scm.com/download/win,安装时勾选“将Git添加到系统PATH”。
- IIS(Internet Information Services)(可选,Bonobo方案需要):
控制面板 → 程序 → 启用或关闭Windows功能 → 勾选“IIS管理控制台”及相关模块(ASP.NET、CGI等)。
方案一:Gitea轻量级Git服务
Gitea是一款开源、跨平台的Git服务,支持Windows部署,占用资源少且配置简单。
步骤1:下载与安装
- 访问Gitea官网 https://gitea.io,下载Windows版本(
gitea-x.x.x-windows-4.0-amd64.exe
)。 - 将文件重命名为
gitea.exe
,保存至自定义目录(如C:gitea
)。
步骤2:初始化配置
- 以管理员身份打开CMD,执行:
cd C:gitea gitea.exe web
- 浏览器访问
http://localhost:3000
,按提示完成数据库(推荐SQLite)、管理员账户等配置。
步骤3:配置为Windows服务(开机自启)
- 下载NSSM工具 https://nssm.cc/download,解压后以管理员身份运行:
nssm install Gitea
- 在弹窗中设置:
- Path:
C:giteagitea.exe
- Arguments:
web --config C:giteacustomconfapp.ini
- 点击“Install service”完成。
- Path:
方案二:Bonobo Git Server(基于IIS)
Bonobo是专为IIS设计的Git服务器,适合习惯Windows图形化操作的用户。
步骤1:安装与配置IIS
- 确保IIS已启用“ASP.NET 4.8”及“Windows身份验证”。
- 安装URL Rewrite模块:下载链接。
步骤2:部署Bonobo
- 下载Bonobo最新版 https://bonobogitserver.com,解压至IIS网站目录(如
C:inetpubbonobo
)。 - 在IIS管理器中新建网站:
- 物理路径:选择解压后的文件夹
- 绑定端口:80(或自定义端口)
步骤3:配置权限与仓库
- 修改
App_Data
文件夹权限,赋予IIS用户(如IIS_IUSRS
)读写权限。 - 访问
http://localhost
,使用默认账户(admin/admin)登录,创建首个仓库。
验证与使用
测试仓库克隆与推送
git clone http://localhost:3000/用户名/仓库名.git # Gitea git clone http://localhost/仓库名.git # Bonobo
配置SSH访问(可选)
- 生成SSH密钥:
ssh-keygen -t ed25519
- 将公钥(
id_ed25519.pub
)添加到Gitea/Bonobo的用户设置中。
常见问题与解决方案
问题 | 解决方法 |
---|---|
无法访问服务端口(3000/80) | 检查防火墙规则,放行对应端口。 |
仓库推送提示权限不足 | IIS/Bonobo中检查目录权限,确保IUSR账户可写。 |
Gitea服务启动失败 | 通过事件查看器排查日志,或重新安装服务。 |
方案对比与选择建议
特性 | Gitea | Bonobo Git Server |
---|---|---|
性能 | 高(Go语言编写) | 中(依赖IIS和.NET) |
配置复杂度 | 低(命令行+Web界面) | 中(需配置IIS) |
扩展性 | 支持插件、Webhook | 功能较为基础 |
适用场景 | 中小团队、跨平台需求 | 习惯IIS管理的Windows环境用户 |
维护与优化建议
- 定期备份:备份Gitea的
giteadata
目录或Bonobo的App_Data
文件夹。 - HTTPS加密:通过Let’s Encrypt申请免费SSL证书,提升传输安全性。
- 更新版本:关注Gitea/Bonobo官网,及时升级修复破绽。
引用说明
- Gitea官方文档:https://docs.gitea.io
- Bonobo Git Server GitHub:https://github.com/jakubgarfield/Bonobo-Git-Server
- IIS官方配置指南:https://docs.microsoft.com/iis