Files
2026-11-02 22:54:14 +08:00

530 lines
26 KiB
Bash
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ======================================
# Universal Web-to-API 配置文件模板
# ======================================
# 复制为 .env 后按需修改;本模板的默认值即可安全地在本机直接使用。
# 布尔项只接受 true / false(也接受 1/0、yes/no、on/off)。
# 认证开关写成其它值(例如 your-secret-here)会被视为配置错误并拒绝启动。
#
# 本文件由 scripts/build_env_example.py 根据 app/core/settings_registry.py 生成,请勿手改;
# 以 “# 名称=值” 形式出现的是可选项,去掉行首的 # 即可启用,未写出的变量使用内置默认值。
# ========== 版本信息 ==========
# 旧版版本号记录:仅在缺少 VERSION 文件时由更新器读取(实际版本以 VERSION 文件为准)
# (类型: str)
CURRENT_VERSION=1.01
# ========== 更新配置 ==========
# 启用自动更新:开启后 start.bat 会在启动前检查并自动应用更新;关闭后仍会在服务启动后检查新版本,只提示手动更新
# (类型: bool;默认: true)
AUTO_UPDATE_ENABLED=true
# GitHub 仓库:自动更新和启动版本检查使用的仓库,格式为 owner/repo
# (类型: str;默认: lumingya/universal-web-api)
GITHUB_REPO=lumingya/universal-web-api
# 更新时保留的文件/目录(逗号分隔)
# (类型: str)
UPDATE_PRESERVE=chrome_profile,venv,.env.local,logs
# ========== 服务配置 ==========
# 调试模式:开启 API 文档和详细错误
# (类型: bool;默认: false)
APP_DEBUG=false
# 监听地址:127.0.0.1 仅本机(推荐);0.0.0.0 允许外部访问,此时必须同时启用控制面板认证和服务 API 认证,否则服务拒绝启动
# (类型: str;默认: 127.0.0.1)
APP_HOST=127.0.0.1
# 监听端口
# (类型: int;范围: 1..65535;默认: 8199)
APP_PORT=8199
# 日志级别
# (类型: enum;可选: DEBUG / INFO / WARNING / ERROR;默认: INFO)
LOG_LEVEL=INFO
# 公开访问地址:用于生成返回给客户端的可访问链接,例如图片下载地址
# (类型: str;默认: http://127.0.0.1:8199)
PUBLIC_BASE_URL=
# ========== 认证配置 ==========
# 仅在完全可信的隔离网络中、明确知道风险时才设为 true: 允许「非回环监听 + 未启用认证」启动(不推荐)。
# (类型: bool;默认: false)
ALLOW_INSECURE_PUBLIC_BIND=false
# 启用服务 API 认证:保护 /v1、/url/.../v1、/tab/.../v1 等对外调用接口
# (类型: bool;默认: false)
AUTH_ENABLED=false
# 服务 API Bearer Token:AUTH_ENABLED=true 时必须设置;可提供给项目 API 使用者
# (类型: secret)
AUTH_TOKEN=
# 启用控制面板认证:保护控制面板的配置、日志、命令和标签页管理接口;未设置时兼容沿用服务 API 认证开关
# (类型: bool;默认: false)
DASHBOARD_AUTH_ENABLED=
# 控制面板访问密钥:DASHBOARD_AUTH_ENABLED=true 时必须设置;留空时兼容沿用服务 API Bearer Token
# (类型: secret)
DASHBOARD_AUTH_TOKEN=
# 本机转发代理与服务共享的密钥:只有回环来源且携带匹配密钥时才采信 X-Forwarded-For 等转发头
# (类型: secret)
# UWAPI_PROXY_SECRET=
# ========== CORS 配置 ==========
# 启用 CORS
# (类型: bool;默认: true)
CORS_ENABLED=true
# 允许的跨域源:多个用逗号分隔(如 https://app.example.com);留空 = 不允许跨源网页调用(控制面板同源无需配置)。不推荐 *
# (类型: str)
CORS_ORIGINS=
# ========== 浏览器与标签页 ==========
# 启动时浏览器里没有已打开的页面,就自动打开各站点的起始页(自重启时不打开)
# (类型: bool;默认: true)
# AUTO_OPEN_BROWSER=true
# 自定义浏览器路径:可选,留空时自动检测 Chrome、Edge、Brave 等浏览器
# (类型: str)
# BROWSER_PATH=
# Chrome 调试端口
# (类型: int;范围: 1024..65535;默认: 9222)
BROWSER_PORT=9222
# 浏览器配置目录:留空时使用项目内的 chrome_profile 目录
# (类型: str)
# BROWSER_PROFILE_DIR=
# 浏览器配置名称:例如 Default、Profile 1
# (类型: str)
# BROWSER_PROFILE_NAME=
# 重连浏览器时主动关闭旧的连接句柄
# (类型: bool;默认: false)
# BROWSER_RECONNECT_QUIT_OLD_HANDLE=false
# 浏览器连接看门狗:近期有活动时的检查间隔(秒)
# (类型: float;范围: 0.5..;默认: 3)
# BROWSER_WATCHDOG_ACTIVE_INTERVAL=3
# 浏览器连接看门狗:空闲时的检查间隔(秒)
# (类型: float;范围: 0.5..;默认: 5)
# BROWSER_WATCHDOG_IDLE_INTERVAL=5
# 多久(秒)以内有请求算“近期有活动”
# (类型: float;范围: 1..;默认: 60)
# BROWSER_WATCHDOG_RECENT_ACTIVITY_WINDOW=60
# 单个请求的最长执行时间(秒);设置后覆盖 browser_config.json 中的同名常量
# (类型: float;范围: 1..)
# MAX_REQUEST_EXECUTE_TIME_SEC=
# 标签页池上限;设置后覆盖 browser_config.json 的 TAB_POOL_MAX_TABS
# (类型: int;范围: 1..)
# MAX_TABS=
# 标签页池下限;设置后覆盖 browser_config.json 的 TAB_POOL_MIN_TABS
# (类型: int;范围: 0..)
# MIN_TABS=
# 启动时清理浏览器缓存:每次启动脚本时自动清理 ShaderCache、GPUCache 等垃圾缓存,保留登录态和 Cookie
# (类型: bool;默认: false)
PROFILE_CLEAN_ENABLED=false
# 请求超过该时间(秒)仍未结束即判定为僵尸并清理
# (类型: int;范围: 1..;默认: 600)
# REQUEST_ZOMBIE_TTL=600
# 借用标签页执行请求时自动切到前台
# (类型: bool;默认: false)
# TAB_AUTO_ACTIVATE_ON_ACQUIRE=false
# ========== 标签页自动恢复 ==========
# API Key:外部 API 的 Bearer Key,仅在上面的 API 地址非空时使用。
# (类型: secret)
# TAB_RECOVERY_API_KEY=
# API 地址:OpenAI 兼容的 chat/completions 完整地址。⚠️ 填写外部地址后,出错标签页的截图会被发送到该外部服务。留空 = 本地模式:调用本服务自身的 /v1/chat/completions,用池中其他空闲标签页完成判断(自动复用 AUTH_TOKEN)。
# (类型: str)
# TAB_RECOVERY_API_URL=
# 启用 AI 恢复判断:关闭时:旧工作线程退出后直接解除隔离并自动重入池,不截图、不调用任何 AI API。隔离机制本身始终生效。
# (类型: bool;默认: false)
TAB_RECOVERY_ENABLED=false
# 每标签页最大恢复次数:恢复后再次超时即视为不可恢复,永久隔离且不再调用 AI API。设为 0 表示不尝试恢复。
# (类型: int;范围: 0..;默认: 1)
TAB_RECOVERY_MAX_ATTEMPTS=1
# 模型名称:判断使用的模型名,需支持图片输入。
# (类型: str;默认: gpt-4o)
TAB_RECOVERY_MODEL=gpt-4o
# 无法判断时仍尝试刷新:截图、AI 调用或解析失败等「无法判断」的情况:开启=刷新后重入池,关闭=直接永久隔离。
# (类型: bool;默认: true)
TAB_RECOVERY_REFRESH_ON_UNKNOWN=true
# AI 判断超时:本地模式要经过完整浏览器往返,不建议设置过短。
# (类型: int;范围: 1..;默认: 120)
TAB_RECOVERY_TIMEOUT_SEC=120
# 等待旧工作线程退出:超过该时长旧线程仍未退出,则永久隔离该标签页。
# (类型: int;范围: 0..;默认: 600)
TAB_RECOVERY_WORKER_EXIT_WAIT_SEC=600
# ========== 性能与内存(详见 docs/performance_refactor.md) ==========
# 标签页累计处理多少个请求后回收一次 CDP 会话
# (类型: int;范围: 1..;默认: 20)
BROWSER_CDP_RECYCLE_AFTER_REQUESTS=20
# 检查 DOM 节点数的间隔(秒)
# (类型: float;范围: 1..;默认: 300)
BROWSER_CDP_RECYCLE_DOM_CHECK_SEC=300
# 页面 DOM 节点数超过该值时触发回收
# (类型: int;范围: 1..;默认: 150000)
BROWSER_CDP_RECYCLE_DOM_NODES=150000
# 回收空闲标签页的 CDP 会话:断开并重建连接(不刷新页面),释放被钉住的旧 DOM / RemoteObject
# (类型: bool;默认: true)
BROWSER_CDP_RECYCLE_ENABLED=true
# 标签页空闲多久(秒)后才允许回收 CDP 会话
# (类型: float;范围: 0..;默认: 30)
BROWSER_CDP_RECYCLE_IDLE_SEC=30
# 定期回收 CDP 会话的间隔(秒)
# (类型: float;范围: 1..;默认: 1800)
BROWSER_CDP_RECYCLE_INTERVAL_SEC=1800
# 标签页空闲多久(秒)后冻结
# (类型: float;范围: 0..;默认: 60)
BROWSER_IDLE_FREEZE_AFTER_SEC=60
# 冻结空闲标签页(Page.setWebLifecycleState=frozen),被占用或页面检查前自动恢复;显式开启周期保活会让冻结基本失效
# (类型: bool;默认: true)
BROWSER_IDLE_FREEZE_ENABLED=true
# 只冻结用户看不到的标签页(后台标签或最小化窗口)
# (类型: bool;默认: true)
BROWSER_IDLE_FREEZE_REQUIRE_HIDDEN=true
# 标签页空闲多久(秒)后才参与内存清理
# (类型: float;范围: 0..;默认: 300)
# BROWSER_IDLE_MEMORY_PURGE_AFTER_SEC=300
# 空闲时定期清理浏览器内存(不影响正在执行的工作流)
# (类型: bool;默认: true)
# BROWSER_IDLE_MEMORY_PURGE_ENABLED=true
# 内存清理的检查间隔(秒)
# (类型: float;范围: 1..;默认: 180)
# BROWSER_IDLE_MEMORY_PURGE_INTERVAL_SEC=180
# 省内存模式:不再周期性唤醒后台标签页(页面检查与真实工作流仍按需唤醒)
# (类型: bool;默认: false)
# BROWSER_MEMORY_SAVER=false
# Chromium 进程模型(可选):per-site = 同站点标签页共用渲染进程;limit:N = 最多 N 个渲染进程 实测省 10%~20% 内存;同一站点并发标签页较多时会互相拖慢,默认留空(Chromium 默认)
# (类型: str)
BROWSER_PROCESS_MODEL=
# CDP 卫生总开关:释放用完的 RemoteObject,并限制 Network 缓冲区(详见 docs/performance_refactor.md)
# (类型: bool;默认: true)
CDP_HYGIENE_ENABLED=true
# Network.enable 的单个资源缓冲区上限(MB,0 = 不限制)
# (类型: float;范围: 0..;默认: 16)
CDP_NETWORK_MAX_RESOURCE_BUFFER_MB=16
# Network.enable 的总缓冲区上限(MB,0 = 不限制)
# (类型: float;范围: 0..;默认: 32)
CDP_NETWORK_MAX_TOTAL_BUFFER_MB=32
# run_js 返回的对象/数组 RemoteObject 用完即释放
# (类型: bool;默认: true)
CDP_RELEASE_JS_OBJECTS=true
# 面板内存统计口径:fast(默认,开销极低;Windows 用 private,Linux 用 rss-shared)、uss(旧口径,开销大)、rss
# (类型: enum;可选: fast / uss / rss;默认: fast)
PANEL_MEMORY_METRIC=fast
# 请求历史落盘去抖(秒):窗口内的多次更新合并为一次写入,进程退出时自动刷盘
# (类型: int;默认: 5)
REQUEST_HISTORY_SAVE_DEBOUNCE_SEC=5
# 流式监控页面快照:一次 CDP 调用完成“选元素 + 生成状态 + 提取文本/图片”(默认 true)
# (类型: bool;默认: true)
STREAM_PAGE_SNAPSHOT_ENABLED=true
# ========== 代理配置 ==========
# 代理地址:支持 socks5://、http:// 或 https://;Python 下载会通过 SOCKS 代理解析域名
# (类型: str;默认: socks5://127.0.0.1:1080)
PROXY_ADDRESS=
# 绕过代理:浏览器和 Python 下载均不走代理的地址,多个用逗号分隔
# (类型: str;默认: localhost,127.0.0.1)
PROXY_BYPASS=localhost,127.0.0.1,::1
# 启用代理:开启后浏览器和 Python 后端的远程资源下载将共用该代理
# (类型: bool;默认: false)
PROXY_ENABLED=false
# ========== Dashboard 配置 ==========
# 启用 Dashboard
# (类型: bool;默认: true)
DASHBOARD_ENABLED=true
# Dashboard 文件路径
# (类型: str;默认: static/index.html)
DASHBOARD_FILE=static/index.html
# 调试模式:开启调试接口与更详细的日志
# (类型: bool;默认: false)
# DEBUG=false
# ========== 服务守护 ==========
# 定时重启守护代理的全局请求缓冲上限(MiB)
# (类型: float;范围: 1..;默认: 256)
RESTART_PROXY_MAX_BUFFER_MB=256
# 定时重启守护代理的最大并发连接数
# (类型: int;范围: 1..;默认: 64)
RESTART_PROXY_MAX_CONNECTIONS=64
# 最长排空等待:到期后仍有工作流时的最大等待时间。超时后本轮不重启,以免中断工作流,并在下一周期重试。
# (类型: int;范围: 0..;默认: 1800)
SCHEDULED_RESTART_DRAIN_TIMEOUT_SECONDS=1800
# 启用定时后端重启:开启后由启动器保持对外端口;后端重启期间进入的新请求会等待新实例就绪后继续执行。
# (类型: bool;默认: false)
SCHEDULED_RESTART_ENABLED=false
# 重启间隔:默认 10800 秒(3 小时)。每次成功重启后重新计时。
# (类型: int;范围: 300..;默认: 10800)
SCHEDULED_RESTART_INTERVAL_SECONDS=10800
# 标签页状态策略:当前仅支持 preserve:不关闭浏览器,也不清理标签页。该独立设置为后续加入标签页状态清理策略预留。
# (类型: enum;可选: preserve;默认: preserve)
SCHEDULED_RESTART_TAB_STATE_POLICY=preserve
# ========== AI 分析配置 ==========
# Canvas 图片最大边长:浏览器内下载 URL 图片时,Canvas 压缩后的最长边。默认 1024;调大可保留更多细节,但会增加返回体和内存占用。
# (类型: int;范围: 1..;默认: 1024)
CANVAS_IMAGE_MAX_SIZE=1024
# API Key
# (类型: secret)
HELPER_API_KEY=
# API 提供商:支持 auto、openai、gemini、claude
# (类型: enum;可选: auto / openai / gemini / claude;默认: auto)
HELPER_API_PROVIDER=auto
# API 地址:留空则不启用外部辅助 AI。示例:http://127.0.0.1:8199/url/gemini.com/v1
# (类型: str)
HELPER_BASE_URL=http://127.0.0.1:8199/url/gemini.com/v1
# 模型名称
# (类型: str;默认: gpt-4)
HELPER_MODEL=gemini-3.0-pro
# HTML 最大字符数:超过会截断以节省 Token
# (类型: int;范围: 10000..;默认: 120000)
MAX_HTML_CHARS=120000
# ========== 函数调用 ==========
# 允许媒体后处理:开启后,函数调用隐藏回合也会执行媒体二次提取、占位补偿和 Markdown 媒体注入。兼容旧行为,但更容易污染 tool payload;默认关闭。
# (类型: bool;默认: false)
TOOL_CALLING_ALLOW_MEDIA_POSTPROCESS=false
# 部分工具调用校验失败时,仍返回通过校验的调用
# (类型: bool;默认: true)
# TOOL_CALLING_ALLOW_PARTIAL_SUCCESS=true
# 工具调用重试仍失败时降级为普通文本回复
# (类型: bool;默认: false)
# TOOL_CALLING_DEGRADE_ON_FAILURE=false
# 内部修复重试次数:函数调用结果校验失败时,自动修复后再次重试的次数。0 表示关闭自动修复;默认 2;最大 5。
# (类型: int;范围: 0..5;默认: 2)
TOOL_CALLING_INTERNAL_RETRY_MAX=2
# 单个工具调用参数的最大字符数
# (类型: int;范围: 256..500000;默认: 50000)
# TOOL_CALLING_MAX_ARGUMENT_CHARS=50000
# 工具调用参数 JSON 的最大嵌套深度
# (类型: int;范围: 2..100;默认: 20)
# TOOL_CALLING_MAX_ARGUMENT_DEPTH=20
# 工具调用参数 JSON 的最大节点数
# (类型: int;范围: 16..50000;默认: 4000)
# TOOL_CALLING_MAX_ARGUMENT_NODES=4000
# 单条 Tool Result 上限:单条函数调用结果超过此字符数时,后端会直接返回明确错误,避免把超大结果继续塞给网页模型。默认 300000,可按需要调大。
# (类型: int;范围: 1..;默认: 300000)
TOOL_CALLING_MAX_TOOL_RESULT_CHARS=300000
# 注入预填充/尾部提示词:开启后,会继续注入函数调用的预填充与尾部提示词;关闭后仅保留重试策略相关提示词。默认开启。
# (类型: bool;默认: true)
TOOL_CALLING_PROMPT_PADDING_ENABLED=true
# 预填充乱序零宽:开启后,函数调用的预填充和尾部提示词会随机乱序,并插入少量零宽字符。仅影响额外 padding,不改动工具定义;默认关闭。
# (类型: bool;默认: false)
TOOL_CALLING_PROMPT_PADDING_OBFUSCATE=false
# 日志与错误信息中被拒参数的预览长度
# (类型: int;范围: 0..;默认: 500)
# TOOL_CALLING_REJECTED_ARGUMENT_PREVIEW_CHARS=500
# 重试策略:聚焦修复只发送必要的修复信息;完整上下文会把原对话和修复反馈一起发给模型。
# (类型: enum;可选: focused_repair / full_context;默认: focused_repair)
TOOL_CALLING_RETRY_STRATEGY=focused_repair
# 解析前清洗回复:开启后,函数调用在解析 assistant 内容前会移除占位链接和尾部媒体 Markdown。推荐保持开启;只有需要完全回退旧行为时再关闭。
# (类型: bool;默认: true)
TOOL_CALLING_SANITIZE_ASSISTANT_CONTENT=true
# ========== 命令系统 ==========
# 执行命令时把目标标签页切到前台
# (类型: bool;默认: false)
# CMD_ACTIVATE_TAB_ON_COMMAND=false
# “追加写文件”命令允许写入的根目录;留空使用默认目录
# (类型: str)
# CMD_APPEND_FILE_BASE_DIR=
# 异步命令的最大并发线程数
# (类型: int;范围: 1..;默认: 20)
# CMD_ASYNC_MAX_WORKERS=20
# 导入模块时就启动命令调度器(默认由应用生命周期负责启动和停止,仅嵌入/调试时使用)
# (类型: bool;默认: false)
# CMD_ENGINE_AUTO_START=false
# 命令里“执行工作流”步骤的默认超时(秒)
# (类型: float;范围: 1..;默认: 45)
# CMD_EXECUTE_WORKFLOW_TIMEOUT_SEC=45
# 页面检查失败后的退避时间(秒)
# (类型: float;范围: 0..;默认: 30)
# CMD_PAGE_CHECK_FAILURE_BACKOFF_SEC=30
# 页面检查脚本的超时(秒);留空使用后台唤醒脚本的内置超时
# (类型: float;范围: 0.1..)
# CMD_PAGE_CHECK_JS_TIMEOUT_SEC=
# 页面刷新后多久(秒)内不做页面检查
# (类型: float;范围: 0..;默认: 2)
# CMD_PAGE_CHECK_REFRESH_GRACE_SEC=2
# 周期性保活后台标签页;留空时自动决定(开启省内存或空闲冻结时默认关闭,否则开启)
# (类型: bool)
# CMD_PERIODIC_KEEPALIVE_ENABLED=
# 周期保活的间隔(秒)
# (类型: float;范围: 1..;默认: 20)
# CMD_PERIODIC_KEEPALIVE_INTERVAL_SEC=20
# 周期性输出命令引擎摘要日志
# (类型: bool;默认: false)
# CMD_PERIODIC_SUMMARY_LOG_ENABLED=false
# Python 命令沙箱额外允许导入的模块(逗号分隔)
# (类型: str)
# CMD_PYTHON_SANDBOX_ALLOWED_IMPORTS=
# Python 命令沙箱是否允许使用 requests 发起网络请求
# (类型: bool;默认: true)
# CMD_PYTHON_SANDBOX_ALLOW_REQUESTS=true
# 命令触发的请求的基准优先级
# (类型: int;默认: 2)
# CMD_REQUEST_PRIORITY_BASELINE=2
# 命令引擎定期刷新标签页池
# (类型: bool;默认: true)
# CMD_TAB_POOL_AUTO_REFRESH=true
# 标签页池刷新间隔(秒)
# (类型: float;范围: 0.5..;默认: 5)
# CMD_TAB_POOL_REFRESH_INTERVAL_SEC=5
# 执行命令时启用焦点模拟(不切前台也让页面认为自己处于焦点)
# (类型: bool;默认: true)
# CMD_USE_FOCUS_EMULATION_ON_COMMAND=true
# 页面检查前先唤醒后台标签页
# (类型: bool;默认: true)
# CMD_WAKE_TAB_BEFORE_PAGE_CHECK=true
# 同一标签页两次唤醒的最小间隔(秒)
# (类型: float;范围: 0..;默认: 2)
# CMD_WAKE_TAB_MIN_INTERVAL_SEC=2
# ========== Arena 与代理轮换 ==========
# 事件桥接文件保留的轮转备份数
# (类型: int;范围: 1..;默认: 2)
# ARENA_EVENT_BRIDGE_BACKUPS=2
# 传给命令的结果文本最大字符数
# (类型: int;范围: 0..;默认: 60000)
# ARENA_EVENT_BRIDGE_COMMAND_TEXT_LIMIT=60000
# 事件去重缓存的最大条目数
# (类型: int;范围: 1..;默认: 4096)
# ARENA_EVENT_BRIDGE_DEDUPE_MAX_ENTRIES=4096
# 回复完成前是否也写出中间结果
# (类型: bool;默认: false)
# ARENA_EVENT_BRIDGE_EMIT_PARTIAL=false
# 把 Arena 结果写入事件桥接文件,供外部程序或命令读取
# (类型: bool;默认: true)
# ARENA_EVENT_BRIDGE_ENABLED=true
# 事件桥接文件达到该大小(字节,最小 1MB)后轮转
# (类型: int;范围: 1048576..;默认: 52428800)
# ARENA_EVENT_BRIDGE_MAX_BYTES=52428800
# 事件桥接文件路径;留空使用默认位置
# (类型: str)
# ARENA_EVENT_BRIDGE_PATH=
# 写出事件后是否触发匹配的命令
# (类型: bool;默认: true)
# ARENA_EVENT_BRIDGE_TRIGGER_COMMANDS=true
# Arena 模型列表缓存文件;留空为 scripts/arena_models_cache.json
# (类型: str)
# ARENA_MODELS_CACHE_PATH=
# Arena 模型别名本地覆盖文件;留空为 config/arena_model_aliases.local.json
# (类型: str)
# ARENA_MODEL_ALIAS_OVERRIDES_PATH=
# Arena 模型目录本地配置文件;留空为 config/arena_model_catalog.local.json
# (类型: str)
# ARENA_MODEL_CATALOG_CONFIG_PATH=
# 事件桥接使用的模型名映射文件路径(可选)
# (类型: str)
# ARENA_MODEL_MAP_PATH=
# Arena 代理轮换使用的 Clash 外部控制器地址
# (类型: str;默认: http://127.0.0.1:9097;旧名: ARENA_CLASH_API)
# CLASH_API=http://127.0.0.1:9097
# 参与轮换的节点名单:JSON 数组或逗号分隔;留空使用内置默认名单
# (类型: str;旧名: ARENA_PROXY_POOL)
# CLASH_PROXY_POOL=
# Clash 外部控制器密钥
# (类型: secret;旧名: ARENA_CLASH_SECRET)
# CLASH_SECRET=
# Clash 中用于切换节点的策略组名称
# (类型: str;默认: 主代理;旧名: ARENA_CLASH_SELECTOR)
# CLASH_SELECTOR=主代理
# ========== 资源预算与本地媒体访问 ==========
# /media 与 /download_images 是否需要令牌(AUTH_TOKEN / DASHBOARD_AUTH_TOKEN)或本机直连访问。 开启后,第三方聊天前端直接用 <img src> 引用生成媒体将无法加载。
# (类型: bool;默认: false)
MEDIA_REQUIRE_AUTH=false
# 媒体转码(ffmpeg)的全局并发上限
# (类型: int;范围: 1..;默认: 2)
MEDIA_TRANSCODE_MAX_CONCURRENCY=2
# 源文件超过该大小(MiB)时拒绝转码
# (类型: float;范围: 1..;默认: 200)
MEDIA_TRANSCODE_MAX_SOURCE_MB=200
# 媒体转码排队超过该时间(秒)返回 503
# (类型: float;范围: 0..;默认: 10)
MEDIA_TRANSCODE_QUEUE_TIMEOUT_SEC=10
# Responses API 续接历史:单条上限(MiB)
# (类型: float;范围: 0..;默认: 8)
RESPONSES_STATE_MAX_ENTRY_MB=8
# Responses API 续接历史:总量上限(MiB)
# (类型: float;范围: 0..;默认: 64)
RESPONSES_STATE_MAX_TOTAL_MB=64
# 标签页 acquire 等待者总量上限(通用/按编号/按域名/按路由组合计),满了立即 503;0 = 不限
# (类型: int;默认: 128)
TAB_ACQUIRE_MAX_WAITERS=128
# ========== 配置文件路径 ==========
# 命令配置文件;留空为 config/commands.json
# (类型: str)
# COMMANDS_CONFIG_FILE=
# 命令本地覆盖文件;留空为 config/commands.local.json
# (类型: str)
# COMMANDS_LOCAL_FILE=
# 文件粘贴转 PDF 时使用的中文字体;留空自动查找
# (类型: str)
# FILE_PASTE_PDF_FONT_PATH=
# 解析器配置文件;留空为 config/parsers.json
# (类型: str)
# PARSERS_CONFIG_FILE=
# 粘贴产生的临时文件至少保留多久(秒)才清理
# (类型: float;范围: 0..;默认: 900)
# PASTE_TEMP_CLEANUP_MIN_AGE_SECONDS=900
# 运行时数据库(请求历史、累计统计,SQLite);留空为 config/runtime.sqlite3
# (类型: str)
# RUNTIME_DB_PATH=
# 站点配置目录(每站点一个文件)
# (类型: str;默认: config/sites)
SITES_CONFIG_DIR=config/sites
# 旧版单文件站点配置,仅作为自动迁移来源;留空为 config/sites.json
# (类型: str)
# SITES_CONFIG_FILE=
# 站点本地覆盖文件;留空为 config/sites.local.json
# (类型: str)
# SITES_LOCAL_FILE=
# 站点规则文件;留空为 config/site_rules.json
# (类型: str)
# SITE_RULES_FILE=
# 其他临时文件至少保留多久(秒)才清理
# (类型: float;范围: 0..;默认: 3600)
# TEMP_CLEANUP_MIN_AGE_SECONDS=3600
# ========== 日志 ==========
# 日志轮转保留的备份数
# (类型: int;范围: 1..;默认: 5)
# LOG_BACKUP_COUNT=5
# 日志目录;留空为项目下的 logs/
# (类型: str)
# LOG_DIR=
# 日志文件路径;留空为日志目录下的默认文件
# (类型: str)
# LOG_FILE=
# 单个日志文件达到该大小(字节)后轮转
# (类型: int;范围: 1..;默认: 5242880)
# LOG_MAX_BYTES=5242880
# ========== 启动器与进程 ==========
# 启动器安装依赖时使用的 pip 镜像地址;留空使用内置默认镜像
# (类型: str)
# PIP_MIRROR_URL=
# 启动器自动安装 Python 时使用的版本
# (类型: str;默认: 3.13.6)
PYTHON_INSTALL_VERSION=3.13.6
# 进程模型(实验性):inproc 为单进程(默认);process 为 API 进程与持有浏览器的 worker 进程分离,worker 由 API 进程自动启动
# (类型: enum;可选: inproc / process;默认: inproc)
# UWAPI_WORKER_MODE=inproc
# (内部)进程角色,worker 进程由 API 进程启动时设为 worker,请勿手动设置
# (类型: str)
# UWAPI_WORKER_ROLE=
# (内部)worker 地址;留空时由 API 进程启动 worker 后自动设置
# (类型: str)
# UWAPI_WORKER_URL=
# (内部)API 进程与 worker 之间的鉴权令牌,启动时自动生成
# (类型: secret)
# UWAPI_WORKER_TOKEN=
# worker 监听的本机端口;0 表示自动选择空闲端口
# (类型: int;范围: 0..65535;默认: 0)
# UWAPI_WORKER_PORT=0
# 为 true 时 .env 中的值覆盖进程里已有的同名环境变量
# (类型: bool;默认: false)
# UWAPI_DOTENV_OVERRIDE=false
# (内部)启动器传给服务进程的实际监听地址,供启动安全检查使用
# (类型: str)
# UWAPI_PUBLIC_BIND_HOST=
# ========== 高危开关 ==========
# 允许非沙箱 Python 命令:⚠️ 高危:开启后命令引擎会跳过 Python 脚本安全校验,以完整 __builtins__ 执行任意脚本(可读写文件、发起网络请求、执行系统命令)。仅在站点配置完全可信、且确实需要平滑鼠标轨迹/物理点击时开启。默认关闭。
# (类型: bool;默认: false)
CMD_ALLOW_UNSAFE_PYTHON_COMMANDS=false
# 允许从控制面板安装第三方解析器代码(安全开关,默认关闭)
# (类型: bool;默认: false)
# PARSER_INSTALL_ENABLED=false