Blog/.env.example at custom · Marvel-L/Blog · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
# 站点公开访问地址，用于生成 sitemap、RSS 与预渲染 SEO URL。
# 留空时使用 config/site.config.json 中的 url。
VITE_SITE_URL=https://Marvel-L.github.io/Blog

# 部署在子路径时填写，例如 GitHub Pages 的 /Blog/；根路径部署请留空。
VITE_BASE_PATH=/Blog/

# ---------- 以下为可选的构建/自动化调优变量（GitHub Actions 或本地） ----------
# 数值型变量支持显式 0（如 =0 表示禁用超时/跳过冷却/不重试），
# 不会静默回退默认值（parseEnvNumber 语义，见 scripts/lib/env.mjs）。

# build.mjs：单阶段超时（毫秒），默认 1200000（20 分钟）；0 立即触发超时（测试超时路径）。
# BUILD_STAGE_TIMEOUT_MS=1200000

# build.mjs：整条流水线总预算（毫秒），默认 3300000（55 分钟）。
# BUILD_TOTAL_TIMEOUT_MS=3300000

# ssg.mjs：SSG 全站渲染总预算（毫秒），默认 600000（10 分钟）。
# SSG_TOTAL_BUDGET_MS=600000

# ssg.mjs：SSG 产物/SSR 产物目录覆盖（默认 ../dist 与 ../dist-ssr；本地调试独立产物时使用）。
# SSG_DIST_DIR=dist
# SSG_SSR_DIR=dist-ssr

# build.mjs：verbose 日志开关（等效于 build:verbose 脚本 / --verbose 参数）。
# BUILD_VERBOSE=1

# lib/http.mjs（SSRF 防护）：本地开发机开启 Clash/Surge 等 TUN 代理时，所有域名会被
# 解析到 198.18.0.0/15 / fc00::/7 伪 DNS 段，SSRF 防护默认拦截这些保留段（攻击者可
# 把域名 DNS 指向保留段绕过校验，故 fail-closed）。仅在这种本地场景下设 1 放行
# （请求经代理转发到真实公网目标）；CI/生产务必保持关闭。
# 本地使用：先 export ALLOW_PROXY_ARTIFACT_DNS=1 再运行 npm run check:links（或在
# PowerShell 设 $env:ALLOW_PROXY_ARTIFACT_DNS='1'）；本仓库脚本不自动加载 .env。
# ALLOW_PROXY_ARTIFACT_DNS=1

# akismet-comment-check.mjs：Akismet API Key（仓库 Secret，CI 自动注入；未配置时跳过反垃圾判定）。
# AKISMET_API_KEY=

# gh-actions-logger.mjs：debug 级别日志开关（Actions 中亦可设 ACTIONS_STEP_DEBUG=true）。
# DEBUG=1
# telegram-notify.mjs：GitHub 事件 → Telegram 推送（见 .github/workflows/telegram-notify.yml）。
# 推送内容：新评论/新讨论/新 Issue、push 提交、Action 运行结果；
# 未配置 token / chat id 时脚本优雅跳过（::warning:: 正常退出），不红叉。
# Actions 环境读取仓库 Secrets（Settings → Secrets and variables → Actions），不读取本地 .env；
# 以下变量仅用于本地 --print 调试或自建环境：
#   GITHUB_EVENT_NAME=push GITHUB_EVENT_PATH=event.json node scripts/telegram-notify.mjs --print
# TELEGRAM_BOT_TOKEN=123456:ABC-DEF...   # BotFather 创建机器人获取的 token
# TELEGRAM_CHAT_ID=123456789            # 接收通知的 chat id（私聊/群组/频道）
# TELEGRAM_TOPIC_ID=                    # 可选：论坛话题 id，设置后消息发往该话题
# 以上三个变量同时被 check-broken-links.mjs（文章外链失效扫描，scripts/lib/telegram.mjs 共享库）
# 复用：失效链接汇总报告推送同一 Chat；未配置时同样优雅跳过。