# 与 Gitea（192.168.1.201）同步

## 远程

- **gitea-local**：`http://192.168.1.201:3000/fnvtk/soul-yongping.git`（拉取 + 推送）

## 手动同步

```bash
./.cursor/scripts/gitea-sync.sh
```

## 每 10 分钟自动同步（macOS launchd）

- 已安装：`~/Library/LaunchAgents/com.soul.yongping.gitea-sync.plist`
- 每 10 分钟执行一次，登录后自动加载

**启用：**

```bash
launchctl load ~/Library/LaunchAgents/com.soul.yongping.gitea-sync.plist
```

**停用：**

```bash
launchctl unload ~/Library/LaunchAgents/com.soul.yongping.gitea-sync.plist
```

**查看是否在跑：**

```bash
launchctl list | grep com.soul.yongping.gitea-sync
```

## 认证（192.168.1.201 需登录时）

若 push/pull 需要账号密码，定时任务无法弹窗，请把凭证写进 remote URL（勿提交到仓库）：

```bash
git remote set-url gitea-local 'http://用户名:token或密码@192.168.1.201:3000/fnvtk/soul-yongping.git'
```

或用系统钥匙串：

```bash
git config --global credential.helper osxkeychain
# 然后手动执行一次 gitea-sync.sh，输入一次账号密码，之后由钥匙串记住
```

## 日志

- 脚本内部：`.cursor/scripts/gitea-sync.log`
- launchd 标准输出：`.cursor/scripts/gitea-sync-launchd.log`
- launchd 错误：`.cursor/scripts/gitea-sync-launchd.err.log`

## 跨网克隆失败（502 / `RPC failed` / `curl 18` / `early EOF`）

现象：`git clone http://open.quwanzhi.com:3000/...` 枚举对象到 100% 后断线，或一开始就 **502 Bad Gateway**。仓库约 2.5 万对象时较常见，**根因多在服务端反代或链路**，客户端可做降级与重试。

### 1. 优先：浅克隆 + 按需补历史（Windows `cmd` 示例）

先少传数据，成功率最高：

```bat
git config --global http.postBuffer 524288000
git clone --depth 1 --single-branch --branch devlop http://open.quwanzhi.com:3000/fnvtk/soul-yongping.git
cd soul-yongping
git fetch --unshallow
```

仍断线可再试 **partial clone**（Git 2.22+）：

```bat
git clone --filter=blob:none --depth 1 --single-branch --branch devlop http://open.quwanzhi.com:3000/fnvtk/soul-yongping.git
```

失败目录可删后重试；或进入半成品目录执行 `git fetch` 多次，Git 会续传。

### 2. 客户端其它设置（可选）

```bat
git config --global http.version HTTP/1.1
git config --global core.compression 0
```

压缩关掉会多占带宽，有时能避开中间设备对「大块压缩流」的处理问题。

### 3. 能走内网时改用局域网 Gitea

文档顶部 **gitea-local**（`192.168.1.201:3000`）通常比公网 `:3000` 稳定；在公司/VPN 内优先用内网地址克隆。

### 3.1 内网 `192.168.1.201:3000` 仍 502 / early EOF

说明：**内网和公网同一症状 = 问题在 Gitea 本机或前面的反代**，不是「你电脑网络」 alone。

**先确认服务是否活着（在能访问内网的机器上）：**

```bat
curl -sI http://192.168.1.201:3000/
```

- 若 **立刻 502**：多为 **Nginx（或宝塔反代）连不上 Gitea 进程**（Gitea 挂了、监听端口不对、防火墙）。
- 若 **Web 能开、只有 git clone 断**：多为 **反代超时 / 缓冲** 不适合大块 `git-upload-pack` 流。

**有服务器权限时（宝塔 / Nginx）**：在 **指向 Gitea 的那一段** 加大超时、关掉对 Git 流的缓冲（上游端口以你机器为准，常见 Gitea 在 `127.0.0.1:3000` 或其它端口，勿照抄错）：

```nginx
client_max_body_size 512M;
proxy_connect_timeout 300s;
proxy_send_timeout 3600s;
proxy_read_timeout 3600s;
proxy_buffering off;
proxy_request_buffering off;
```

改完后 **`nginx -t && nginx -s reload`**，并 **重启 Gitea**。仍 502 时看 **`error.log`** 里 `upstream timed out` / `connection refused` 对应哪一层。

**若短期无法改服务器**：用下面 **离线 bundle**，从已有完整仓库的机器拷一份到 Windows（不经过 HTTP 大包传输）。

### 4. 离线绕过：git bundle（推荐，不依赖 Gitea HTTP 稳定）

在 **Mac / 已能拉全仓库的机器**（本仓库根目录）执行：

```bash
chmod +x .cursor/scripts/create-offline-bundle.sh
.cursor/scripts/create-offline-bundle.sh devlop
```

会在仓库根生成 `soul-yongping-devlop.bundle`，拷到 Windows 后：

```bat
git clone E:\路径\soul-yongping-devlop.bundle soul-yongping
cd soul-yongping
git remote add origin http://192.168.1.201:3000/fnvtk/soul-yongping.git
git fetch origin
```

日常 `pull`/`push` 仍走 Gitea；若 push 仍断，再与运维修反代。

### 5. Windows 一键重试克隆（仍依赖服务端正常）

将本仓库拷到 Windows 或只拷脚本后，在 `cmd` 中进入脚本目录：

```bat
set REPO=http://192.168.1.201:3000/fnvtk/soul-yongping.git
set BRANCH=devlop
clone-soul-yongping-windows.bat
```

（需登录时第一次会提示账号密码，或事先 `git config --global credential.helper manager` 并手动 `git ls-remote` 存凭证。）

### 6. 服务端（有权限时）：反代与 Gitea（摘要）

502 / 传一半断线，除第 3.1 节参数外，还需保证 **Nginx `proxy_pass` 指向的 Gitea 进程在线**。官方反代说明：<https://docs.gitea.com/installation/reverse-proxies>。

### 7. 安全提醒

勿在截图/聊天记录里长期暴露「用户名:密码@」完整 URL；改用 **访问令牌** + 凭证管理器（Windows：`git config --global credential.helper manager`）。