将本地 Git 仓库一键迁移到 GitHub，支持批量操作。
适用于从 Gitee、GitLab、Bitbucket 或其他平台迁移到 GitHub 的场景。
- 单项目 / 批量迁移 — 一条命令搞定一个或多个仓库
- 敏感文件扫描 — 推送前自动检测
.env、密钥等文件并告警 - 保留旧远程 — 可将原
origin重命名为upstream，同时维护两个远程 - dry-run 预览 — 先看会做什么，再决定是否执行
- 自动创建仓库 — 调用
ghCLI 创建 GitHub 仓库，无需手动操作
- Git
- GitHub CLI (
gh) — 已登录 (gh auth login)
git clone https://github.com/ZengLiangYi/git-migrate-github.git
cd git-migrate-github
chmod +x migrate.sh或者直接下载脚本：
curl -fsSL https://raw.githubusercontent.com/ZengLiangYi/git-migrate-github/main/migrate.sh -o migrate.sh
chmod +x migrate.sh# 迁移单个项目 (默认 private)
./migrate.sh ~/project/my-app
# 迁移为公开仓库，自定义名称
./migrate.sh ~/project/my-app --public --name my-cool-app
# 保留 Gitee 远程为 upstream
./migrate.sh ~/project/my-app --keep-remote
# 先预览，不执行
./migrate.sh ~/project/my-app --dry-run./migrate.sh --batch ~/project/app1 ~/project/app2 ~/project/app3创建 repos.txt：
~/project/app1
~/project/app2
~/project/app3
# 以 # 开头的行会被跳过
执行：
./migrate.sh --file repos.txt --yes| 选项 | 说明 | 默认值 |
|---|---|---|
--public |
公开仓库 | private |
--private |
私有仓库 | ✓ |
--name <name> |
自定义仓库名（单项目模式） | 目录名 |
--desc <text> |
仓库描述 | - |
--keep-remote |
保留原 origin 为 upstream | 替换 origin |
--dry-run |
仅预览，不执行 | - |
--yes, -y |
跳过确认提示 | - |
--batch |
批量模式 | - |
--file <file> |
从文件读取路径 | - |
--version |
显示版本号 | - |
-h, --help |
显示帮助 | - |
脚本执行以下操作：
1. 验证环境 (git / gh CLI / 登录状态)
2. 扫描敏感文件并告警
3. 在 GitHub 创建同名仓库
4. 设置 origin 指向 GitHub
- 默认: 替换原 origin
- --keep-remote: 原 origin → upstream, 新 origin → GitHub
5. 推送所有分支和标签
如果历史提交中包含密钥（如云服务 SecretKey），GitHub 会拒绝推送。解决方案：
- 推荐：用 git-filter-repo 清除历史中的敏感信息
- 改用
--private私有仓库（Push Protection 对私有仓库更宽松）
# 安装 git-filter-repo
pip install git-filter-repo
# 从所有历史中删除 .env 文件
git filter-repo --path .env --invert-paths- 记得更新本地其他 clone 的远程地址
- 如果原平台有 CI/CD，需要在 GitHub 重新配置
- 建议迁移后轮换（更新）所有暴露过的密钥