Merge remote-tracking branch 'origin/pr/544'

.env.example

@@ -57,6 +57,29 @@ ADMIN_USERNAME=admin123456
 # docker compose 下 app 启动前自动执行 pending migration/backfill（默认 true）
 # AETHER_GATEWAY_AUTO_PREPARE_DATABASE=true
 
+# 管理后台一键更新（正式发布版默认可用）
+# 正式发布版会下载 GitHub Release 包，校验 SHA256 后切换 /opt/aether/current 并重启。
+# 源码/本地构建不支持后台在线更新。
+# AETHER_BASE_DIR=/opt/aether
+# Docker Compose 默认把应用日志输出到 stdout/stderr。
+# 如需文件日志，可改成 file 或 both，并把可写目录挂载到 /opt/aether/logs。
+# AETHER_LOG_DESTINATION=stdout
+# AETHER_LOG_FORMAT=pretty
+# AETHER_LOG_DIR=/opt/aether/logs
+# 服务器访问 GitHub 需要代理时可配置；也兼容 UPDATE_PROXY_URL / HTTPS_PROXY / ALL_PROXY / HTTP_PROXY。
+# 如果 Aether 跑在 Docker 容器里，想走宿主机代理时请写 host.docker.internal，不要写 127.0.0.1。
+# AETHER_UPDATE_PROXY_URL=http://host.docker.internal:7890
+# 共享出口触发 GitHub API 限流时可配置只读 token；也兼容 GITHUB_TOKEN / GH_TOKEN。
+# AETHER_UPDATE_GITHUB_TOKEN=
+# 下载超时控制：总超时默认 600 秒；连续无响应/无数据默认 30 秒。
+# AETHER_UPDATE_DOWNLOAD_TIMEOUT_SECS=600
+# AETHER_UPDATE_DOWNLOAD_IDLE_TIMEOUT_SECS=30
+# 本地联调后台在线更新（配合 docker-compose.release-local.yml）：
+# 会用当前源码构建 release-layout 测试镜像，并伪装成较旧版本以触发升级入口。
+# AETHER_RELEASE_LOCAL_VERSION=v0.7.0
+# AETHER_RELEASE_LOCAL_PORT=18085
+# LOCAL_RELEASE_APP_IMAGE=aether-app:release-local
+
 # PostgreSQL 连接池配置（默认适合单实例/小型部署；高并发可按需调大）
 # 推荐计算方式（单实例）：
 #   MAX = CPU 核数 × 10（AI 网关偏 IO 等待，可激进些；纯 OLTP 用 × 4）