Git LFS 推送失败问题分析与解决方案：HTTP 405 错误处理指南

问题现象

在使用 Docker 部署的 GitLab 环境中，用户报告了 Git LFS 推送失败的问题。常规 Git 操作（如 pull/push）正常执行，但涉及 LFS 大文件推送时出现 Client error from HTTP 405 错误。错误提示表明服务器拒绝了 LFS 传输请求，而 HTTP 405 状态码通常表示"方法不被允许"。

环境诊断

通过分析用户提供的 git lfs env 输出，可观察到以下关键信息：

1. LFS 终端点指向内网 IP 地址（192.168.100.155）
2. 认证方式显示为 auth=none
3. 客户端环境为 Windows 平台，使用 Git 2.39.2 和 Git LFS 3.3.0
4. 传输配置同时启用了 basic 和 ssh 协议

根本原因

该问题通常源于 GitLab 容器配置与 Docker 端口映射不匹配。具体表现为：

• GitLab 容器内部配置的 HTTP(S) 端口与 Docker 暴露的端口不一致
• LFS 服务无法通过预期端口访问
• Nginx 反向代理配置未正确处理 LFS 请求

解决方案

方案一：修正容器配置

1. 进入 GitLab 容器修改配置文件 /etc/gitlab/gitlab.rb：

external_url 'http://<服务器IP>:<实际映射端口>'

2. 重新配置 GitLab：

gitlab-ctl reconfigure

方案二：调整 Nginx 监听端口

若需保持原有 URL 结构，可单独修改 Nginx 配置：

nginx['listen_port'] = <Docker映射端口>

方案三：端口转发（临时方案）

通过路由器（如 OpenWrt）设置端口转发，将外部请求转发到容器内部正确端口。

配置验证步骤

1. 检查当前生效配置：

gitlab-rake gitlab:check

2. 确认端口监听状态：

netstat -tulnp | grep nginx

3. 测试 LFS 连接：

GIT_TRACE=1 GIT_TRANSPORT_TRACE=1 git lfs push origin main

最佳实践建议

1. 统一端口配置：确保 Docker compose 文件中的端口映射与 GitLab 配置完全一致
2. HTTPS 强化：生产环境建议配置 SSL 证书并启用 HTTPS
3. 防火墙检查：验证主机防火墙是否放行 LFS 服务端口（通常为 443 或自定义端口）
4. 客户端配置：对于复杂网络环境，可在客户端显式设置 LFS 终端点：

git config lfs.url "http://<实际访问地址>/info/lfs"

技术原理补充

Git LFS 使用 HTTP 协议传输大文件时，会向服务器发送 PUT 请求。当服务器端口配置错误时，请求可能被错误路由或拒绝，导致 405 错误。正确的端口配置确保：

• LFS 请求能到达 GitLab 内置的 LFS 处理器
• Nginx 能正确代理这些请求
• 身份认证信息能正常传递

通过本文的解决方案，用户可系统性地排查和修复 Git LFS 在容器化环境中的传输问题，确保大文件版本控制流程的稳定性。