sync: BOWEI_US 2026-09-02

tools-sync/references/skills_env_template.md

@@ -17,6 +17,27 @@ CODEX_SKILLS_DIR  = C:\Users\<user>\.codex\skills
 凭据说明：首次 clone 成功后运行 `git config --global credential.helper manager`，
 让 Windows 凭据管理器接管，此后 `SKILLS_REPO_PASS` 可以清空。
 
+### gitea 服务端（tools-sync 的 gitea_doctor 用；不自建 gitea 就整节留空）
+
+```
+GITEA_SSH_HOST     = <gitea 宿主机地址，同网段/VPN 内的直连地址优先>
+GITEA_SSH_PORT     = 22
+GITEA_SSH_HOST_ALT = <走公网跳板时的地址，没有就留空>
+GITEA_SSH_PORT_ALT = <跳板端口，没有就留空>
+GITEA_SSH_USER     = <登录用户>
+GITEA_HOST_KEY_FP  = <SHA256:... 主机公钥指纹，用于确认连对了机器>
+GITEA_CONTAINER    = gitea
+GITEA_DOCKER_BIN   = /usr/local/bin/docker
+GITEA_DATA_DIR     = <宿主机上 bind 到容器 /data 的目录>
+GITEA_COMPOSE_FILE = <docker-compose.yml 路径，没用 compose 就留空>
+GITEA_HTTP_LOCAL   = http://localhost:3000
+```
+
+填写要点：脚本要免密登录，先把本机公钥加进服务端的 `authorized_keys` 并实测一次。
+`GITEA_DOCKER_BIN` 写绝对路径——**ssh 非交互登录通常不加载登录 shell 的 PATH，
+`docker` 会找不到**。`GITEA_HOST_KEY_FP` 不是可选项：有跳板时它是你唯一能确认
+"连上的确实是那台机器"的凭据。
+
 ## Python / Conda
 
 ```