家用小GIT - 技术栈

最近在搞龙虾，想着用龙虾写代码，但是版本管理这里有点问题。

正常是部署一个gitlab，或者是在github上搞，最简单的是本地弄个bare仓库。

最后我是在最简单的基础上，用python写了一点代码，支持了Git HTTP后端。差不多是这个思路：

支持git

发现引用：GET //info/refs?service=git-upload-pack

作用：clone/fetch 前获取 refs
Content-Type：application/x-git-upload-pack-advertisement
返回：001e# service=git-upload-pack\n0000 + refs 数据

拉取数据：POST //git-upload-pack

作用：fetch/clone 实际传输
Content-Type：application/x-git-upload-pack-request
调用：git upload-pack --stateless-rpc repo

推送数据：POST //git-receive-pack

作用：push 写入
Content-Type：application/x-git-receive-pack-request
调用：git receive-pack --stateless-rpc repo

透传本地的 stdin/stdout
nginx代理

nginx 复制代码

proxy_buffering off;
proxy_request_buffering off;

支持gitlfs

批量接口
POST /{repo}.git/info/lfs/objects/batch
用途：上传/下载前，先获取 LFS 对象的上传/下载地址与 Token。
请求体：

json 复制代码

{
  "operation": "upload|download",
  "objects": [{"oid": "sha256...", "size": 12345}]
}

响应体（返回临时直链 + 鉴权头）：

json 复制代码

{
  "objects": [
    {
      "oid": "...", "size": 12345,
      "actions": {
        "upload": {"href": "...", "header": {"Authorization": "..."}},
        "download": {"href": "...", "header": {"Authorization": "..."}}
      }
    }
  ]
}

对象上传

PUT /{repo}.git/info/lfs/objects/{oid}

用途：接收大文件二进制流（对应 batch 里的 upload.href）。

对象下载
GET /{repo}.git/info/lfs/objects/{oid}

用途：返回大文件二进制流（对应 batch 里的 download.href）。
验证接口
HEAD /{repo}.git/info/lfs/objects/{oid}

用途：客户端先查对象是否存在，避免重复上传。
认证可复用

LFS 接口和 Git 接口用同一套 Basic Access Token 即可（用户名任意，密码=token）。

Python 实现注意点

Content-Type

Git 接口：application/x-git-*-*
LFS 接口：application/vnd.git-lfs+json（batch）、application/octet-stream（对象流）

大文件流式处理

LFS 文件可能几 GB，不能全读进内存
Python 用 await request.stream() 分片写磁盘；返回时用 StreamingResponse 流式输出

存储结构建议（纯文件系统）

/srv/git-lfs
/{repo}
/objects
/ab
/cd
/abcd1234...（oid 文件，直接存二进制）

按 oid 前 2 字符分目录，避免单目录文件过多。

裸仓库配置

bash 复制代码

git config --bare http.lfs true

这样搞了一波之后，就有一个自用小git仓库了。

玩～