xiaowei-system/skills/devops/devops-umbrella/references/gitea-operations.md

Gitea Operations Reference

本地 Gitea 实例操作注意事项。

本地 Gitea 信息

• 地址：http://192.168.123.11:3000
• Token：见 ~/mc/小唯/记忆/MemoryFabric/技术细节.md（Token: 9380e8e6...）
• 用户：xiaoxue_admin（非 muchen）

上传已有 Git 项目到 Gitea

常见陷阱：Shallow Clone 问题

从 GitHub clone 的项目可能是 shallow clone（有 --depth 参数），导致：

remote: shallow update not allowed

或 force push 时失败。

解决步骤：

cd /path/to/repo
rm -rf .git                    # 删除原 Git 历史
git init -b main              # 重新初始化
git add -A
git commit -m "Initial commit"
git remote add origin http://TOKEN@192.168.123.11:3000/xiaoxue_admin/REPO.git
git push -u origin main

Token 认证

URL 中嵌入 Token 避免交互式输入：

http://TOKEN@192.168.123.11:3000/xiaoxue_admin/REPO.git

创建仓库

curl -s -X POST "http://192.168.123.11:3000/api/v1/user/repos" \
  -H "Authorization: token TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"REPO_NAME","description":"描述","private":false}'

返回 JSON 中 clone_url 字段含完整 URL（注意用户名前缀）。

关键教训

问题	教训
shallow clone 无法 push	从 GitHub 克隆后必须 rm -rf .git 重新初始化
交互式输入失败	URL 中嵌入 Token
仓库用户不对	API 创建时用 xiaoxue_admin，不是 muchen