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服务。按下Win+R输入optionalfeatures，勾选这些选项：

• Internet Information Services（全部子项）
• .NET Framework 4.8 Advanced Services
• ASP.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 创建网站

1. 打开IIS管理器，右键「网站」→「添加网站」
2. 填写信息：
   • 网站名称：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/项目名.git

5.2 用户权限管理

在「Users」页面可以添加团队成员。权限分为三种：

1. 管理员：能管理所有仓库
2. 创建者：能新建自己的仓库
3. 普通用户：只能访问被授权的仓库

小技巧：通过「Teams」功能可以批量管理权限，比单个设置高效得多。

6. 常见问题解决方案

6.1 无法克隆仓库

如果遇到git clone失败，检查：

1. 防火墙是否放行了8080端口
2. 仓库路径是否包含特殊字符
3. 试试用IP地址替代localhost

6.2 提交时提示权限不足

典型错误信息：

error: insufficient permission for adding an object

解决方法：

1. 右键仓库文件夹→属性→安全
2. 添加用户IIS_IUSRS的完全控制权限
3. 重启IIS服务

7. 进阶配置建议

7.1 启用HTTPS

在IIS中绑定SSL证书（需要域名），然后修改Web.config：

<add key="AuthenticationProvider" value="Cookies" /> <add key="RequireSsl" value="true" />

7.2 自动备份

用这个PowerShell脚本定期备份仓库：

Compress-Archive -Path D:\GitRepositories\* -DestinationPath E:\Backups\git_$(Get-Date -Format yyyyMMdd).zip

建议搭配Windows任务计划程序，设置每周自动运行。

8. 性能优化方案

虽然Bonobo很轻量，但当仓库数量超过50个时，可以：

1. 在IIS中启用「动态内容压缩」
2. 修改Web.config的缓存设置：

<clientCache cacheControlMode="UseMaxAge" cacheControlMaxAge="7.00:00:00" />

对于超过1GB的大仓库，建议用Git LFS扩展管理二进制文件。

这套方案我已经在三个创业团队落地，最久的稳定运行了2年多。相比GitLab动辄需要8GB内存，Bonobo在1GB内存的机器上都能流畅运作，特别适合预算有限的小型项目。