启动配置
配置 WebUI 启动参数和实例环境变量,并处理启动前的参数检查。
“启动”页保存当前实例下次启动时使用的命令行参数和环境变量。配置由后端校验和持久化,修改后需要重新启动 WebUI 才会进入新的启动计划。
两种参数编辑方式
| 编辑方式 | 适合情况 | 保存与校验 |
|---|---|---|
| 原始参数字符串 | 已经知道参数写法,希望快速复制完整命令行 | 按命令行语法解析;未知参数会显示警告但不会被静默删除 |
| 结构化编辑器 | 希望从当前 WebUI 实际支持的参数中选择 | 检查参数数量、取值、重复、必填项和互斥组 |
原始参数只填写传给 WebUI 的参数,不要包含 Python 可执行文件或启动脚本。例如:
--listen --port 7860这只是命令行格式示例。参数是否存在、是否需要值以及允许的取值,都应以当前实例结构化编辑器加载到的目录为准。
配置启动参数
停止 WebUI
已运行的 WebUI 不会因为修改配置而自动重启。先停止实例可以避免忘记重新启动并误以为参数已经生效。
编辑原始字符串
按命令行方式输入参数;包含空格的单个值需要使用引号。提交后检查页面列出的解析错误和未知参数警告。
按需打开结构化编辑器
点击“配置启动参数”,从参数目录启用选项并填写值。编辑器会随着修改保存;发现配置过期时,应重新加载后再编辑。
检查重启提示
页面出现“需要重启”时,返回“实例信息”启动 WebUI,并在启动任务中确认最终参数检查通过。
结构化目录无法读取时,页面会退回原始编辑模式。此时可以保留并保存参数,但自动校验能力较少;先检查管理 API 和 Core 环境,再使用“重试发现”。
环境变量
环境变量只应用于当前实例的受管进程。填写完整的名称和值后会保存;变量名重复或存在空白名称时不会提交。
- 只添加当前 WebUI、扩展或脚本明确需要的变量。
PATH、PYTHONPATH、MAMBA_*和CONDA_*等受管环境值可能被应用保留或重新组合,不应依赖它们覆盖桌面运行环境。- 环境变量值会正常显示,也可能进入任务输出或诊断包;分享截图和诊断前先检查令牌等敏感内容。
启动时发现不兼容参数
保存阶段允许保留当前参数目录尚未识别的选项,以兼容分支、扩展或未来版本。真正启动时,后端会再次使用当前参数目录检查未知参数、孤立值和其他约束,并提供以下选择:
| 选择 | 结果 |
|---|---|
| 取消 | 不创建 WebUI 运行资源,返回配置页修改 |
| 仅本次忽略 | 本次继续使用原始参数,保存的配置不改变 |
| 移除不兼容项并启动 | 删除后端明确定位到的无效片段,保存清理后的完整参数并继续启动 |
不要把“忽略”当作修复
仅本次忽略适合确认某个分支参数仍然有效的情况。如果启动仍然失败,应回到本页修正参数,而不是反复忽略同一警告。