如何配置Bonobo Git Server以支持Git-LFS？解决大文件推送失败问题

开发者阿泽

2026-5-26

解决Bonobo Git Server大文件推送失败的问题

我之前帮朋友排查过Bonobo Git Server搭配Git LFS的问题，你的情况其实是两个小问题叠加导致的：一个是Git凭据助手的拼写错误，另一个是Bonobo默认没开启Git LFS支持。咱们一步步来搞定：

1. 修复Git凭据助手的拼写错误

从报错信息git: 'credential-wincerd' is not a git command能明显看出来，是你Git配置里的凭据助手名称拼写错了（正确的是wincred，或者更推荐的现代版manager-core）。

先检查当前Git的凭据配置：
打开Git Bash或者命令提示符，运行：
```
git config --list --show-origin
```
查找有没有类似credential.helper=wincerd的错误配置项。
修正配置：
如果是全局配置（影响所有本地仓库），运行：
```
git config --global credential.helper wincred
```
要是想适配新版本Windows的凭据管理，更推荐用：
```
git config --global credential.helper manager-core
```
如果只是当前仓库的配置有问题，去掉--global参数即可。
也可以手动修改配置文件：
打开全局Git配置文件（路径一般是C:\Users\<你的用户名>\.gitconfig），找到[credential]段落，把错误的wincerd改成wincred或者manager-core，保存后生效。

Bonobo Git Server默认不支持Git LFS，所以大文件推送会失败，需要开启相关支持：

确保本地已经安装并初始化Git LFS：
运行：
```
git lfs install
```
设置需要跟踪的大文件类型，比如要跟踪所有.zip和.iso文件：
```
git lfs track "*.zip"
git lfs track "*.iso"
```

把生成的.gitattributes文件提交到仓库：

git add .gitattributes
git commit -m "Add LFS track rules"

登录Bonobo的管理后台，找到目标仓库，进入仓库设置页面。
在设置里找到Git LFS支持选项（不同版本的Bonobo可能在「Advanced」或「Features」分类下），勾选开启。
检查Bonobo服务器的文件存储目录权限：确保服务器进程（一般是IIS的应用池账户）有读写存储目录的权限，避免大文件无法写入。
旧版本Bonobo可能需要手动配置web.config：如果开启LFS后还是有问题，打开Bonobo安装目录下的web.config，确认<handlers>节点里包含LFS相关的处理程序，比如：
```
<add name="LfsHandler" path="*" verb="*" type="Bonobo.Git.Server.Lfs.LfsHandler, Bonobo.Git.Server" preCondition="integratedMode" />
```

运行git lfs env查看本地LFS配置，确认Endpoint指向你的Bonobo仓库地址，比如：
```
Endpoint=http://IP/Git/GUI.git/info/lfs (auth=basic)
```

然后重新尝试推送：

git push -v --tags origin develop:develop

这样处理后，应该就能解决凭据错误和大文件推送失败的问题了。

内容的提问来源于stack exchange，提问作者Tony