一个强大的 GitHub 复刻仓库同步工具，可以自动将你的复刻仓库与上游原始仓库保持同步，确保你不会错过任何更新。

• 🔄 自动同步 - 一键同步复刻仓库的所有提交记录
• 🔐 安全认证 - 使用 GitHub Token 进行安全认证
• 📱 多平台支持 - 支持 Linux、macOS、Windows 和 Android (Termux)
• 🎯 智能选择 - 自动列出所有复刻仓库供选择
• 🔄 重试机制 - 网络操作失败时自动重试
• 💾 配置保存 - Token 和配置信息安全保存
• 🛡️ 安全备份 - 自动备份本地更改

• Git
• curl
• jq

sudo apt update && sudo apt install git curl jq

Linux (CentOS/RHEL/Fedora)

# CentOS/RHEL
sudo yum install git curl jq

# Fedora
sudo dnf install git curl jq

macOS

# 使用 Homebrew
brew install git curl jq

Windows

· 安装 Git for Windows · 安装 jq for Windows

Android (Termux)

pkg update && pkg upgrade
pkg install git curl jq

🚀 快速开始

1. 获取脚本

# 克隆仓库
git clone https://github.com/2992253553/Github-fork-sync-tool.git
cd Github-fork-sync-tool

# 或者直接下载脚本
curl -O https://raw.githubusercontent.com/2992253553/Github-fork-sync-tool/main/github_fork_sync.sh
chmod +x github_fork_sync.sh

2. 运行脚本

./github_fork_sync.sh

3. 首次运行配置

首次运行时会要求进行 GitHub 认证：

1. 访问 GitHub Token 页面： · 打开 https://github.com/settings/tokens · 点击 "Generate new token" · 选择 "Generate new token (classic)"
2. 设置 Token 权限： · 备注：Fork Sync Tool · 勾选权限： · repo (全部仓库权限) · read:org (读取组织信息) · read:user (读取用户信息)
3. 生成并复制 Token： · 点击 "Generate token" · 复制生成的 Token 字符串
4. 在脚本中输入 Token： · 将复制的 Token 粘贴到脚本提示中 · Token 会自动保存到安全位置

📖 详细使用教程

基本使用流程

1. 启动脚本：

   ./github_fork_sync.sh

2. 选择仓库： · 脚本会自动列出你的所有复刻仓库 · 输入编号选择要同步的仓库 · 显示每个仓库的最后更新时间
3. ���动同步： · 脚本会自动： · 克隆仓库（如果本地不存在） · 添加上游远程仓库 · 获取所有最新提交 · 重置本地分支到上游状态 · 推送到你的复刻仓库
4. 查看结果： · 显示同步统计信息 · 显示过去一年的提交数量 · 显示最新提交信息

命令行选项

# 显示帮助信息
./github_fork_sync.sh --help

# 显示版本信息
./github_fork_sync.sh --version

# 清理配置和缓存
./github_fork_sync.sh --clean

Android (Termux) 专用教程

安装 Termux

1. 从 F-Droid 安装 Termux（推荐）
2. 或者从 GitHub Releases 下载最新版本

在 Termux 中设置

# 更新包管理器
pkg update && pkg upgrade

# 安装依赖
pkg install git curl jq

# 配置 Git（重要！）
git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub邮箱"

# 获取脚本
cd ~
git clone https://github.com/2992253553/Github-fork-sync-tool.git
cd Github-fork-sync-tool
chmod +x github_fork_sync.sh

# 运行脚本
./github_fork_sync.sh

设置别名（可选）

# 编辑 bash 配置
nano ~/.bashrc

# 添加别名
alias sync-fork='~/Github-fork-sync-tool/github_fork_sync.sh'

# 重新加载配置
source ~/.bashrc

# 现在可以直接使用
sync-fork

🔧 高级配置

设置定期同步

使用 cron (Linux/macOS)

# 编辑定时任务
crontab -e

# 添加每周同步（每周日晚上10点）
0 22 * * 0 /path/to/github_fork_sync.sh

# 或者每天同步（凌晨2点）
0 2 * * * /path/to/github_fork_sync.sh

🛠️ 故障排除

常见问题

1. 认证失败

症状：Authentication failed 或 Invalid username or token

解决方案：

· 检查 Token 是否有效 · 重新生成 Token：https://github.com/settings/tokens · 清理旧配置：./github_fork_sync.sh --clean

2. Git 安全目录错误

症状：detected dubious ownership in repository

解决方案：

# 修复 Git 安全目录
git config --global --add safe.directory /current/path

3. 网络连接失败

症状：fetch upstream failed 或网络超时

解决方案：

· 检查网络连接 · 设置代理（如果需要）：

export https_proxy="http://proxy-ip:port"

📁 文件结构

Github-fork-sync-tool/
├── github_fork_sync.sh          # 主脚本文件
├── README.md                    # 说明文档
└── LICENSE                      # 许可证文件

配置文件位置

· Token 文件: ~/.github_fork_sync/token · 配置缓存: ~/.github_fork_sync/repos_cache · Git 凭证: ~/.git-credentials

🔒 安全说明

· 🔐 Token 安全：Token 以 600 权限保存在用户目录 · 🗑️ 清理凭证：使用 --clean 选项清理所有敏感信息 · 🔄 定期更新：建议定期更新 GitHub Token · 📜 权限最小化：Token 只请求必要权限

🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支：git checkout -b feature/AmazingFeature
3. 提交更改：git commit -m 'Add some AmazingFeature'
4. 推送到分支：git push origin feature/AmazingFeature
5. 提交 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

🙏 致谢

感谢以下项目的启发：

· GitHub CLI · gh

📞 支持

如果你遇到问题：

1. 查看故障排除部分
2. 检查 Issues 是否有类似问题
3. 创建新的 Issue 并提供： · 操作系统和环境信息 · 详细的错误信息 · 复现步骤

Happy Syncing! 🚀

如果这个工具对你有帮助，请给个 ⭐ Star 支持一下！