将Github/Gitlab仓库镜像到自建Gitea服务器时遇推送失败求助

可能的原因及对应解决方法 #

1. Gitea仓库未开启镜像推送权限 #

Gitea默认仓库不允许直接推送包含所有分支、标签、refs的完整镜像，需手动开启对应权限：

• 登录Gitea后台进入目标仓库的「设置」页面
• 找到「仓库功能」或「镜像设置」区域，勾选「允许推送镜像」或「接收所有引用推送」选项（不同版本Gitea位置略有差异）
• 保存设置后重新执行git push --mirror

2. 自定义pre-receive hook拦截推送 #

若Gitea管理员配置了自定义pre-receive hook脚本，可能会阻止镜像推送：

• 联系服务器管理员检查该仓库或全局的pre-receive hook脚本，确认是否存在拦截镜像推送的规则
• 若脚本限制了分支命名、提交信息等，而镜像包含不符合规则的refs，优先调整hook脚本以适配镜像需求（不建议过滤refs，会破坏完整镜像）

3. SSH用户权限不足 #

即便配置了SSH密钥，对应的用户可能没有推送所有引用的权限：

• 检查Gitea中该用户对目标仓库的权限，确保分配了「管理员」或具备完整写入权限的角色（部分版本Gitea的普通写入权限可能限制全量refs推送）
• 可先尝试用该用户手动推送一个普通分支，验证基础权限是否正常

4. 版本兼容问题 #

旧版本Git或Gitea对--mirror推送的处理可能存在bug：

• 升级本地Git到最新稳定版，重新执行镜像推送命令
• 若Gitea服务器版本较旧，建议升级到最新稳定版后重试

每日cron同步脚本优化 #

问题解决后，可使用以下脚本实现自动同步：

#!/bin/bash
# 开源项目镜像同步脚本
REPO_NAME="project"
LOCAL_REPO_PATH="/data/mirrors/$REPO_NAME.git"
UPSTREAM_URL="https://github.com/pathto/project.git"
LOCAL_URL="git@git.localserver.net:pathto/project"

# 本地镜像仓库不存在则初始化
if [ ! -d "$LOCAL_REPO_PATH" ]; then
    git clone --mirror "$UPSTREAM_URL" "$LOCAL_REPO_PATH"
    cd "$LOCAL_REPO_PATH"
    git remote set-url --push origin "$LOCAL_URL"
fi

# 拉取上游更新并推送到本地服务器
cd "$LOCAL_REPO_PATH"
git fetch --prune "$UPSTREAM_URL"
git push --mirror

将脚本保存为sync_repo.sh，添加可执行权限chmod +x sync_repo.sh，再通过cron设置每日任务：

# 每天凌晨2点执行同步，日志输出到指定文件
0 2 * * * /data/scripts/sync_repo.sh >> /var/log/repo_sync.log 2>&1

内容的提问来源于stack exchange，提问作者thisiszeev