docs: document repeatable LFS upload path

2026-08-02 15:17:31 +08:00
parent 98e6cadcb6
commit f2bf297e84
3 changed files with 145 additions and 1 deletions
@@ -23,6 +23,24 @@ GIT_LFS_SKIP_SMUDGE=1 git clone git@192.168.10.248:cogito/calculet-npu-research-

 随后可按需执行 `git lfs pull --include='archives/<路径>'`。

+### 从当前网络追加 LFS 大文件
+
+Gitea 当前对 SSH LFS 上传返回的内部地址是 `http://gitea/...`。匿名克隆和 LFS 下载通过上面的 IP 地址已经验收；如果贡献者电脑不能解析主机名 `gitea`，SSH 推送 LFS 时可在另一个终端启动仅监听本机回环地址的临时转发：
+
+```bash
+python3 scripts/lfs-host-proxy.py --port 18765
+```
+
+然后在仓库终端执行：
+
+```bash
+http_proxy=http://127.0.0.1:18765 \
+HTTP_PROXY=http://127.0.0.1:18765 \
+no_proxy= NO_PROXY= git push
+```
+
+推送完成后用 `Ctrl-C` 关闭转发器。长期方案是在 Gitea 服务端把 `ROOT_URL`/LFS 外部地址改成团队实际可解析的 IP 或 DNS 名称。
+
 ## 目录

 | 路径 | 内容 | 用途 |