Windows 10 上部署轻量级 Git 服务器：Bonobo Git Server 实战指南

1. 为什么选择Bonobo Git Server如果你在Windows环境下工作想要快速搭建一个轻量级的Git服务器Bonobo Git Server绝对是个不错的选择。我当初选择它就是因为简单——不需要折腾虚拟机或Docker直接跑在IIS上特别适合个人开发者或小团队使用。相比GitLab这种重型方案Bonobo的安装包只有几十MB对硬件要求极低。实测在我的老款Surface Pro上都能流畅运行。它的核心功能完全够用代码版本控制、用户权限管理、Web界面操作还能通过HTTP/HTTPS直接克隆仓库。2. 安装前的准备工作2.1 启用IIS和.NET功能首先确保你的Windows 10已经启用了IIS服务。按下WinR输入optionalfeatures勾选这些选项Internet Information Services全部子项.NET Framework 4.8 Advanced ServicesASP.NET 4.8注意如果漏装ASP.NET模块后面配置时会报HTTP 500.19错误。我就踩过这个坑又回头重装了两次。2.2 下载Bonobo安装包官网下载地址现在变更为https://github.com/jakubgarfield/Bonobo-Git-Server/releases建议下载最新的.zip包比如v6.5.0解压到C:\Bonobo这样的短路径。避免中文或空格路径否则可能遇到权限问题。3. IIS配置详细步骤3.1 创建网站打开IIS管理器右键「网站」→「添加网站」填写信息网站名称BonoboGit可自定义物理路径选择解压后的Bonobo-Git-Server文件夹端口建议用8080避免与默认80端口冲突3.2 配置应用程序池关键步骤来了右键新建的网站→「管理网站」→「高级设置」将应用程序池改为「无托管代码」启用32位应用程序True实测发现64位系统不开启32位支持会导致页面空白这是.NET兼容性问题。4. 初始化Bonobo服务4.1 首次访问配置浏览器打开http://localhost:8080你会看到初始化页面。默认管理员账号用户名admin密码admin强烈建议首次登录后立即修改密码在「Settings」→「Global Settings」可以切换中文界面。4.2 仓库路径设置在「Repository Directory」设置仓库存储位置例如D:\GitRepositories记得给IIS用户通常是IIS_IUSRS对这个目录的读写权限。我遇到过提交失败的问题就是因为权限没配置好。5. 日常使用技巧5.1 创建新项目点击「Create new repository」时注意这两个选项Allow Anonymous Push公开可写慎用Default Branch建议设为main而非master创建后会自动生成Git地址比如http://你的IP:8080/项目名.git5.2 用户权限管理在「Users」页面可以添加团队成员。权限分为三种管理员能管理所有仓库创建者能新建自己的仓库普通用户只能访问被授权的仓库小技巧通过「Teams」功能可以批量管理权限比单个设置高效得多。6. 常见问题解决方案6.1 无法克隆仓库如果遇到git clone失败检查防火墙是否放行了8080端口仓库路径是否包含特殊字符试试用IP地址替代localhost6.2 提交时提示权限不足典型错误信息error: insufficient permission for adding an object解决方法右键仓库文件夹→属性→安全添加用户IIS_IUSRS的完全控制权限重启IIS服务7. 进阶配置建议7.1 启用HTTPS在IIS中绑定SSL证书需要域名然后修改Web.configadd keyAuthenticationProvider valueCookies / add keyRequireSsl valuetrue /7.2 自动备份用这个PowerShell脚本定期备份仓库Compress-Archive -Path D:\GitRepositories\* -DestinationPath E:\Backups\git_$(Get-Date -Format yyyyMMdd).zip建议搭配Windows任务计划程序设置每周自动运行。8. 性能优化方案虽然Bonobo很轻量但当仓库数量超过50个时可以在IIS中启用「动态内容压缩」修改Web.config的缓存设置clientCache cacheControlModeUseMaxAge cacheControlMaxAge7.00:00:00 /对于超过1GB的大仓库建议用Git LFS扩展管理二进制文件。这套方案我已经在三个创业团队落地最久的稳定运行了2年多。相比GitLab动辄需要8GB内存Bonobo在1GB内存的机器上都能流畅运作特别适合预算有限的小型项目。