GitLab、Bitbucket 国内访问慢怎么办：克隆超时、CI 拉包失败与登录验证全解

GitHub 之外，GitLab 和 Bitbucket 是另外两个绕不开的代码托管平台：不少公司的私有仓库放在 GitLab.com 上，用 Jira 管项目的团队则大多把代码放在 Atlassian 自家的 Bitbucket。国内开发者接手这类项目时，第一天往往就卡住了——git clone 停在“Receiving objects 0%”十几分钟不动，然后报出连接超时；好不容易拉下来，推送几十 MB 的提交又在中途断开；打开网页想看合并请求，页面加载一半白屏；注册 Atlassian 账号时那个人机验证框始终转圈，点不了下一步。

这些现象的根子在两条不同的通道上。克隆与推送走的是 Git 传输通道，HTTPS 和 SSH 两种方式各有各的卡法；网页与注册验证走的是浏览器通道，其中人机验证依赖的是第三方脚本，那一路不通就永远转圈。CI 流水线拉不到依赖则又是另一回事——要看你的 Runner 跑在哪里。这篇把 Git 通道、浏览器通道与 CI 三条线分开讲，先让日常的拉取推送恢复正常，再解决登录验证与流水线的问题。

两家平台的差别：先看你用的是哪一家

两家平台在国内的访问表现相近：网页本身多数时候能打开但很慢，Git 传输在高峰期极不稳定，人机验证框几乎必卡。区别主要在账号体系——Bitbucket 用的是 Atlassian 统一账号，登录要收邮箱验证码，一旦邮箱本身也是海外服务，就多了一层依赖。两家的免费额度、CI 分钟数与功能边界都会调整，以官方最新条款为准。

让拉取推送恢复正常：分步操作步骤

• 第一步：先把线路准备好，连上刺猬VPN。安装客户端后自定义用户名和密码即可完成匿名注册，不需要邮箱、也不需要手机号，免费节点永久免费、不限流量，注册即用；全程 HTTPS+AES 加密传输；
• 第二步：连上后先用浏览器打开仓库页面，确认网页与文件列表能正常显示，这一步同时验证了线路与账号状态；
• 第三步：确认客户端的连接模式。智能分流下命令行工具的流量是否走线路取决于规则，克隆仍超时就临时切到全局模式再试；
• 第四步：HTTPS 方式克隆的，在终端里给 Git 配置代理：git config --global http.proxy 与 https.proxy 指向客户端的本地端口，端口号在客户端设置里能看到；
• 第五步：SSH 方式克隆的，把远端换成 altssh 域名并走 443 端口，在 ~/.ssh/config 里为 gitlab.com 或 bitbucket.org 写一条 Host 配置，指定 HostName 为 altssh 域名、Port 为 443；
• 第六步：大仓库先浅克隆：git clone --depth 1 拉最近一次提交，成功后再 git fetch --unshallow 补全历史，把一次大传输拆成两次；
• 第七步：推送前把大文件走 Git LFS，普通提交控制在几十 MB 以内，减少单次传输中断后全部重来的风险；
• 第八步：注册或登录时，人机验证框加载出来之前不要刷新页面，验证脚本要从第三方域名拉取，等它显示完整再操作；
• 第九步：一个账号支持多设备同时在线，工作机与笔记本共用同一套线路配置即可，Git 代理设置在每台机器上各配一次。

按现象逐条排查：克隆、推送、网页与验证

下面按终端与浏览器里实际看到的现象对应，先分清是 Git 通道、浏览器通道还是验证脚本的问题。

• clone 停在 Receiving objects 0%：Git 传输没走线路，检查 http.proxy 是否配置、或切到全局模式；
• 报 Connection timed out 或 port 22 无法连接：SSH 22 端口被干扰，换 altssh 域名走 443 端口；
• RPC failed、curl 56、early EOF：HTTPS 传输中断，增大 http.postBuffer 并改用浅克隆分批拉取；
• 推送到一半断开：单次传输过大，把大文件挪到 LFS，提交拆小后再推；
• 网页能开但合并请求页面白屏：页面依赖的前端资源没加载完，清缓存后重新加载；
• 注册页人机验证一直转圈：验证脚本来自第三方域名，确认线路已连并等待加载完成，不要反复刷新；
• Bitbucket 登录收不到验证码：邮箱服务本身访问受限，先确认邮箱网页版能打开；
• 登录后频繁被要求重新验证：会话在换出口后失效，固定一个节点使用，不要在操作中途切换；
• 网页上传附件或图片失败：附件走独立的对象存储域名，换负载低的节点后重传；
• 流水线拉依赖超时：看 Runner 在哪里，共享 Runner 在海外与你的本地网络无关，自建 Runner 才需要配镜像源。

CI 拉包失败：共享 Runner 与自建 Runner 完全是两回事

流水线报“拉取依赖超时”时，先看这条流水线跑在哪台机器上。GitLab CI 与 Bitbucket Pipelines 默认用平台提供的共享 Runner，它们在海外机房，拉 npm、pip 或 Docker 镜像时走的是海外网络，和你本地开没开线路没有任何关系——这种情况下超时通常是包源本身的偶发故障，重跑一次往往就过了。真正与国内网络相关的是自建 Runner：公司把 Runner 部署在国内服务器上，它拉依赖时要穿越国际出口，这时该做的是给 Runner 所在机器配置镜像源或代理，而不是折腾你自己的电脑。搞清这一点能省掉很多无效排查。共享 Runner 的免费分钟数与并发数以官方最新条款为准。

自建 Runner 要做的事其实只有三件：给系统包管理器和语言包源换成国内镜像，给 Docker 守护进程配置镜像加速地址，再把 Runner 注册时的 clone 地址指向平台的 HTTPS 域名而不是 SSH。这三项配好之后，流水线里真正需要穿越国际出口的只剩下与托管平台本身的通信，量很小，稳定得多。还有一个常被忽略的点：流水线里的缓存目录要挂到持久化存储上，否则每次构建都从零拉依赖，任何一次网络抖动都会让整条流水线失败。把缓存做好之后，即便包源偶发超时，重跑一次的代价也只是几十秒。

线路怎么选：代码传输与网页操作的不同需求

代码托管的流量特征是“平时很小、偶尔很大”：日常提交几 KB 到几 MB，首次克隆一个带历史的大仓库可能几百 MB 到几个 GB。刺猬VPN 的免费节点永久免费、不限流量、注册即用，看代码、评审合并请求这类轻量操作完全够；每天多次拉取推送、还要拉 Docker 镜像的开发者，时长套餐期间不限流量、不限速，覆盖 20 多个国家、100 多台服务器，可以固定选一个负载低的节点长期用。实际可用性取决于当前网络环境。

和开发流程其他环节的分工

Git 代理配置在三家托管平台上是通用的，GitHub 用户遇到的克隆慢、推送失败与这里的解法基本一致，细节见 GitHub 访问速度优化。流水线里最常拉的外部资源是容器镜像，Docker Hub 拉取超时与登录失败的处理见 Docker Hub 访问指南；npm、pip 这类包源的镜像配置与命令行代理写法见 开发依赖源访问指南，自建 Runner 的机器按那篇配一遍即可。

代码推上去之后通常还要部署。GitLab 与 Bitbucket 都能直接对接 Vercel、Netlify 这类托管平台，每次推送自动触发构建，控制台打不开或构建拉依赖超时的处理见 Vercel 与 Netlify 部署指南。把托管、镜像、依赖源、部署四段各自的网络问题分开处理，整条开发链路就顺了。

常见报错速查表

高频问答

• 问：网页能打开，为什么 git clone 还是超时？答：浏览器和命令行是两条流量路径，智能分流下命令行工具可能没走线路，给 Git 配代理或切全局模式；
• 问：HTTPS 和 SSH 哪种方式更稳？答：SSH 走 22 端口容易被干扰，改 altssh 域名走 443 端口后两者差不多，按团队习惯选即可；
• 问：为什么共享 Runner 也会拉依赖超时？答：那是海外包源的偶发故障，和你本地网络无关，重跑一次通常就过；
• 问：Bitbucket 注册一直卡在人机验证怎么办？答：验证脚本来自第三方域名，连好线路后耐心等它加载完整，反复刷新会重新计时；
• 问：几个 GB 的仓库怎么克隆才不容易断？答：先 --depth 1 浅克隆，成功后再 unshallow 补历史，把一次大传输拆成两次；
• 问：一个账号能在公司电脑和家里笔记本同时用吗？答：可以，一个账号支持多设备同时在线，Git 代理配置在每台机器上各配一次。

让代码托管不再拖慢节奏：长期做法

GitLab 访问慢、Bitbucket 克隆超时、CI 拉包失败、登录验证转圈，这些问题分开看就三件事：Git 传输通道要走线路并选对端口，浏览器通道的第三方验证脚本要等它加载完，CI 则要先分清 Runner 在哪里。对应的长期做法是：Git 代理配一次就固定下来，SSH 直接写 altssh 配置省得每次改，大仓库习惯性浅克隆，大文件一律走 LFS；自建 Runner 的机器单独配镜像源，不要把本地线路的问题和它混在一起。

这套配置建好之后，日常的拉取推送基本不会再让你等。刺猬VPN 采用 HTTPS+AES 加密传输，支持自定义用户名和密码匿名注册，不需要邮箱和手机号；免费节点永久免费、不限流量、注册即用，看代码、提 issue 这类轻量需求足够；时长套餐按周月年计费、期间不限流量不限速，适合每天多次提交、还要拉镜像的开发者，一个账号支持多设备同时在线。两家平台的功能、免费额度与验证机制会不定期调整，以官方最新条款为准，实际可用性取决于当前网络环境。