diff --git a/gitea-backup/.env.example b/gitea-backup/.env.example
new file mode 100644
index 00000000..21af905b
--- /dev/null
+++ b/gitea-backup/.env.example
@@ -0,0 +1,26 @@
+# =============================================================================
+#  Gitea 部署包环境变量模板
+#  用法：cp .env.example .env  然后按需修改
+#  ⚠️ 本文件是模板（占位符），真正的 .env 含密钥，已被 .gitignore 排除，勿提交
+# =============================================================================
+
+# ---- Gitea 域名与端口 ----
+# 备案域名（与你在 DNS 解析到本机 IP 的一致）
+GITEA_DOMAIN=gitea.usj.cc
+# 访问地址（http/https 按你的反代决定）
+GITEA_ROOT_URL=https://gitea.usj.cc/
+# SSH 克隆地址
+GITEA_SSH_DOMAIN=gitea.usj.cc
+# 宿主机对外暴露的端口
+GITEA_HTTP_PORT=3001
+GITEA_SSH_PORT=2222
+
+# ---- act_runner 注册 token ----
+# 首次启动后，到 Gitea 后台「站点管理 → Actions → Runners」生成，
+# 填到这里，然后重建 runner 容器完成注册。
+RUNNER_REGISTRATION_TOKEN=请到Gitea后台生成并填入
+
+# ---- 又拍云凭据（upyun-sync 用）----
+UPYUN_BUCKET=imzql
+UPYUN_OPERATOR=1770186415
+UPYUN_PASSWORD=请填入又拍云操作员密码
diff --git a/gitea-backup/.gitignore b/gitea-backup/.gitignore
index 46dfe271..69645770 100644
--- a/gitea-backup/.gitignore
+++ b/gitea-backup/.gitignore
@@ -1,7 +1,8 @@
 # Gitea 部署包 —— 忽略规则
 
-# 环境变量（含密钥）
+# 环境变量（含密钥）：忽略 .env，但保留模板 .env.example
 .env
+!.env.example
 
 # 数据卷（迁移时单独打包，不进 git）
 data/