企业官网建设流程全解析

最近在搞龙虾，想着用龙虾写代码，但是版本管理这里有点问题。
正常是部署一个gitlab，或者是在github上搞，最简单的是本地弄个bare仓库。

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

支持git

1. 发现引用：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 数据

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

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

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

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

4. 透传本地的 stdin/stdout

5. nginx代理

proxy_buffering off; proxy_request_buffering off;

支持gitlfs

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

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

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

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

2. 对象上传

PUT /{repo}.git/info/lfs/objects/{oid}
用途：接收大文件二进制流（对应 batch 里的 upload.href）。

3. 对象下载
   GET /{repo}.git/info/lfs/objects/{oid}
   用途：返回大文件二进制流（对应 batch 里的 download.href）。

4. 验证接口
   HEAD /{repo}.git/info/lfs/objects/{oid}
   用途：客户端先查对象是否存在，避免重复上传。

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

Python 实现注意点

1. Content-Type

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

2. 大文件流式处理

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

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

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

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

4. 裸仓库配置

gitconfig--barehttp.lfstrue

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

玩～