Hanafubuki

启动配置

配置 WebUI 启动参数和实例环境变量,并处理启动前的参数检查。

“启动”页保存当前实例下次启动时使用的命令行参数和环境变量。配置由后端校验和持久化,修改后需要重新启动 WebUI 才会进入新的启动计划。

两种参数编辑方式

编辑方式适合情况保存与校验
原始参数字符串已经知道参数写法,希望快速复制完整命令行按命令行语法解析;未知参数会显示警告但不会被静默删除
结构化编辑器希望从当前 WebUI 实际支持的参数中选择检查参数数量、取值、重复、必填项和互斥组

原始参数只填写传给 WebUI 的参数,不要包含 Python 可执行文件或启动脚本。例如:

--listen --port 7860

这只是命令行格式示例。参数是否存在、是否需要值以及允许的取值,都应以当前实例结构化编辑器加载到的目录为准。

配置启动参数

停止 WebUI

已运行的 WebUI 不会因为修改配置而自动重启。先停止实例可以避免忘记重新启动并误以为参数已经生效。

编辑原始字符串

按命令行方式输入参数;包含空格的单个值需要使用引号。提交后检查页面列出的解析错误和未知参数警告。

按需打开结构化编辑器

点击“配置启动参数”,从参数目录启用选项并填写值。编辑器会随着修改保存;发现配置过期时,应重新加载后再编辑。

检查重启提示

页面出现“需要重启”时,返回“实例信息”启动 WebUI,并在启动任务中确认最终参数检查通过。

结构化目录无法读取时,页面会退回原始编辑模式。此时可以保留并保存参数,但自动校验能力较少;先检查管理 API 和 Core 环境,再使用“重试发现”。

环境变量

环境变量只应用于当前实例的受管进程。填写完整的名称和值后会保存;变量名重复或存在空白名称时不会提交。

  • 只添加当前 WebUI、扩展或脚本明确需要的变量。
  • PATHPYTHONPATHMAMBA_*CONDA_* 等受管环境值可能被应用保留或重新组合,不应依赖它们覆盖桌面运行环境。
  • 环境变量值会正常显示,也可能进入任务输出或诊断包;分享截图和诊断前先检查令牌等敏感内容。

启动时发现不兼容参数

保存阶段允许保留当前参数目录尚未识别的选项,以兼容分支、扩展或未来版本。真正启动时,后端会再次使用当前参数目录检查未知参数、孤立值和其他约束,并提供以下选择:

选择结果
取消不创建 WebUI 运行资源,返回配置页修改
仅本次忽略本次继续使用原始参数,保存的配置不改变
移除不兼容项并启动删除后端明确定位到的无效片段,保存清理后的完整参数并继续启动

不要把“忽略”当作修复

仅本次忽略适合确认某个分支参数仍然有效的情况。如果启动仍然失败,应回到本页修正参数,而不是反复忽略同一警告。

本页目录