docs(env): translate .env.example comments to Chinese

纯文档翻译,无行为变化。把英文注释全部译为中文,保持原有中文注释
(限流段)和变量名、默认值、文件结构不变。
This commit is contained in:
xfy 2026-06-22 13:20:31 +08:00
parent a3ed0a2b4e
commit 2c7319c220

View File

@ -19,57 +19,56 @@ RATE_LIMIT_COMMENT_BURST=5
RATE_LIMIT_UNKNOWN_PER_SEC=30
RATE_LIMIT_UNKNOWN_BURST=100
# Security
# Trusted origin for CSRF checks on write requests (POST/PUT/PATCH/DELETE).
# Set to your production origin, e.g. https://your-domain.example.
# Unset: falls back to the request Host header + X-Forwarded-Proto (behind a reverse proxy).
# Security 安全相关
# 写请求POST/PUT/PATCH/DELETECSRF 校验的可信来源。
# 生产环境设为你的源站,例如 https://your-domain.example。
# 不设:回退到请求的 Host 头 + X-Forwarded-Proto在反向代理后生效
APP_BASE_URL=
# Set true/1/yes to add the Secure flag to the session cookie (enable in HTTPS production).
# 设为 true/1/yes 给会话 cookie 加上 Secure 标志HTTPS 生产环境启用)。
COOKIE_SECURE=false
# Number of reverse proxies in front of the app; used to extract the real client IP
# from X-Forwarded-For. 0 when serving directly; 1 behind one proxy (e.g. nginx/Caddy).
# 应用前方的反向代理层数;用于从 X-Forwarded-For 中提取真实客户端 IP。
# 直接对外服务时为 0经过一层代理如 nginx/Caddy时为 1。
TRUSTED_PROXY_COUNT=0
# Per-query timeout in seconds; slow queries are canceled to protect the connection pool.
# 单条查询的超时秒数;慢查询会被取消以保护连接池。
STATEMENT_TIMEOUT_SECS=30
# WebP encoding configuration
# Quality: 0.0 (smallest) to 100.0 (best), default 85.0
# WebP 编码配置
# 质量0.0(最小体积)到 100.0(最佳质量),默认 85.0
WEBP_QUALITY=85.0
# Method: 0 (fastest) to 6 (best quality), default 2
# 方法0最快到 6最佳质量默认 2
WEBP_METHOD=2
# Maximum concurrent sessions per user (default: 5, minimum: 1)
# 每用户最大并发会话数(默认 5最小 1
MAX_SESSIONS_PER_USER=5
# Database connection pool size (default: 20)
# 数据库连接池大小(默认 20
DB_POOL_SIZE=20
# Startup DB connection retry window in seconds (default: 30).
# How long the server waits for PostgreSQL to become reachable at startup before giving up.
# Useful when the DB starts slower than the app (docker-compose without healthchecks, cold
# local Postgres, etc.). Only affects startup; runtime connection retries are separate and
# fast-fail to avoid cascading failures.
# 启动时数据库连接重试窗口,单位秒(默认 30
# 服务器在启动期间等待 PostgreSQL 可达的最长时间,超时则放弃。
# 适用于 DB 启动比 app 慢的场景docker-compose 无 healthcheck、本机冷启动 Postgres 等)。
# 仅影响启动;运行时连接重试走独立的快速失败策略,以避免级联故障。
MIGRATE_STARTUP_TIMEOUT_SECS=30
# SSR page cache duration in seconds (default: 3600).
# src/ssr_cache.rs maintains a global generation counter bumped on every post write, but
# Dioxus 0.7 does not expose an API to wire it into the incremental SSR cache key. Until such
# an API is available, this TTL is the only effective SSR cache invalidation mechanism.
# SSR 页面缓存时长,单位秒(默认 3600
# src/ssr_cache.rs 维护了一个全局 generation 计数器,每次文章写入时自增,
# 但 Dioxus 0.7 暴露的 API 无法把它接入增量 SSR 缓存的 key。在该 API 可用前,
# 此 TTL 是唯一有效的 SSR 缓存失效手段。
SSR_CACHE_SECS=3600
# Compression algorithms for HTTP responses.
# Comma-separated list, case-insensitive. Supported: gzip, brotli (or br), deflate, zstd.
# Use "all" to enable everything (default when unset); use "none" or "off" to disable.
# HTTP 响应压缩算法。
# 逗号分隔大小写不敏感。支持gzip、brotli或 br、deflate、zstd。
# 用 "all" 启用全部(不设时的默认);用 "none" 或 "off" 关闭。
COMPRESSION_ALGORITHMS=gzip,brotli,deflate,zstd
# Image serving cache headers (hardcoded defaults)
# Uploaded image assets are served with Cache-Control: public, max-age=31536000, immutable.
# Processed variants (?w=, ?format=, etc.) are cached for 24 hours.
# To invalidate a cached raw upload, change its file path.
# To refresh a processed variant, change its processing parameters.
# 图片响应的缓存头(硬编码默认值)
# 上传的原始图片资源以 Cache-Control: public, max-age=31536000, immutable 提供。
# 处理变体(?w=、?format= 等)缓存 24 小时。
# 要使已缓存的原始上传失效,请更改其文件路径。
# 要刷新某个处理变体,请更改其处理参数。
# Image disk cache limits
# Max total size in MB (default: 1024)
# 图片磁盘缓存上限
# 最大总容量,单位 MB默认 1024
IMAGE_DISK_CACHE_MAX_MB=1024
# Max file age in hours before forced deletion (default: 168)
# 文件被强制删除前的最大存在时长,单位小时(默认 168即 7 天)
IMAGE_DISK_CACHE_MAX_AGE_HOURS=168