gitlab-clone-script

批量克隆 GitLab Group 及其子组下所有项目的 Node.js 命令行工具。

安装

npm install
npm link        # 注册全局指令 gitlab-clone

或在任意目录直接执行：

node bin/gitlab-clone.js

配置（可选）

复制示例配置文件：

copy config.json.example config.json

编辑 config.json 设置默认值：

{
  "groupUrl": "https://gitlab.com/mycompany/team-a",
  "token": "your_personal_access_token",
  "outputDir": "repos"
}

运行时会以配置文件中的值作为提示输入的默认值，直接回车即可使用。

使用

gitlab-clone

按提示依次输入：

1. Group URL：包含 GitLab 地址和 group 路径，例如 https://gitlab.com/mycompany/team-a
2. Private Token：GitLab 个人访问令牌
3. 输出目录：本地存放仓库的根目录，默认 repos

示例

gitlab-clone
# Group URL (默认: https://gitlab.com/mycompany/team-a): https://gitlab.com/mycompany/team-a
# Private Token: glpat-xxxxxxxx
# 输出目录 (默认: repos): ./repos

无权限处理

当 API 返回 401/403 时，脚本会自动打开 GitLab 登录页，并提示重新输入 Token 后重试。

本地目录结构

所有项目直接平铺在输出目录下：

repos/
├── project-x/
├── project-y/
└── project-z/

依赖前提

• 已安装 Node.js
• 已安装 git，并且可以在命令行中直接调用 git