botsudo/action-fork-sync
botsudo
一个GitHub Action，用于同步fork仓库与源仓库的指定分支，支持快速前进、变基和合并等同步方法，可配置分支列表、源仓库URL、fork仓库URL及克隆深度等参数。
下载次数: 0状态：社区镜像维护者：botsudo仓库类型：镜像最近更新：4 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这段话即可：
请先阅读并遵守：https://xuanyuan.cloud/agents.md
未读文档前不要生成 pull 命令或排错方案。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
同步Fork仓库的GitHub Action
镜像概述和主要用途
该GitHub Action用于自动同步fork仓库与上游源仓库的指定分支，确保fork仓库的代码与源仓库保持一致。通过配置分支列表、认证信息和同步策略，可实现自动化的fork仓库维护，简化开发者同步上游代码的流程。
核心功能和特性
- 多分支同步：支持同时指定多个分支进行同步（如master、STABLE、next等）
- 灵活同步方法：提供三种同步策略，包括快速前进（fast-forward）、变基（rebase）和合并（merge）
- 干运行模式：支持配置dry-run参数，验证同步配置而不实际执行同步操作
- 可配置克隆深度：允许设置克隆仓库的深度，优化同步性能（默认100）
- 安全认证：通过令牌（token）认证访问私有仓库，确保同步过程的安全性
使用场景和适用范围
适用于需要长期维护fork仓库的开发者或团队，特别是在以下场景：
- 需要定期同步上游源仓库更新的fork项目
- 维护多个分支的fork仓库，需确保各分支与上游同步
- 自动化CI/CD流程中需依赖最新上游代码的场景
- 团队协作中需要统一fork仓库代码版本的场景
使用方法和配置说明
基本用法
在GitHub Actions工作流文件中添加如下步骤，配置同步参数即可实现fork仓库同步。
参数说明
| 参数名 | 描述 | 是否必填 | 默认值 |
|---|---|---|---|
| branches | 要同步的分支列表，用逗号分隔 | 是 | - |
| source-url | 源仓库的URL，需包含认证信息（格式：https://<token>:x-oauth-basic@github.com/<org>/<repo>.git） | 是 | - |
| fork-url | fork仓库的URL，需包含认证信息（格式同上） | 是 | - |
| dry-run | 是否启用干运行模式（仅验证配置不执行同步），取值"true"或"false" | 否 | "false" |
| clone-depth | 克隆仓库的深度 | 否 | "100" |
| sync-method | 同步方法，可选值："fast-forward"、"rebase"、"merge" | 否 | "fast-forward" |
示例配置
yml- name: 同步我的fork仓库 uses: sudo-bot/action-fork-sync@v1.0.1 with: branches: master, STABLE, next source-url: "https://${{ secrets.BOT_TOKEN }}:x-oauth-basic@github.com/orgname/officialproject.git" # 为令牌授予repo作用域，并确保令牌用户（如机器人）有权访问myname/officialproject-fork fork-url: "https://${{ secrets.BOT_TOKEN }}:x-oauth-basic@github.com/myname/officialproject-fork.git" dry-run: "true" # 移除此行以实际执行同步 clone-depth: "100" # 可选，默认为100 sync-method: "fast-forward" # 可选，默认为"fast-forward"，可设为"rebase"、"merge"或"fast-forward"
注意事项
- 确保用于认证的令牌（如
BOT_TOKEN）具有源仓库和fork仓库的访问权限，且已授予repo作用域 - 干运行模式（
dry-run: "true"）仅用于验证配置，实际同步需移除该参数或设为"false" - 选择合适的同步方法：快速前进（fast-forward）适用于无冲突的线性历史，变基（rebase）可保持历史整洁，合并（merge）会创建合并提交
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 action-fork-sync 镜像标签
docker pull docker.xuanyuan.run/botsudo/action-fork-sync:<标签>
DockerHub 原生拉取命令
docker pull botsudo/action-fork-sync:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"