最全 stable diffusion 启动参数

官方文档：https://github.com/AUTOMATIC1111/stable-diffusion-webui/wiki/

来源申明：本文由 极客飞兔 大佬翻译于官方文档

环境变量

PYTHON：设置 Python 可执行文件的自定义路径
VENV_DIR：指定虚拟环境的路径
COMMANDLINE_ARGS：主程序的附加命令行参数
IGNORE_CMD_ARGS_ERRORS：忽略命令行参数错误，不中断退出
REQS_FILE：默认为 requirements_versions.txt，设置运行时安装具有依赖项文件的名称
TORCH_COMMAND：用于安装 PyTorch 的命令
INDEX_URL：相当于 --index-url 的参数
TRANSFORMERS_CACHE：Transformers 库下载并保存与 CLIP 模型相关的文件的路径
CUDA_VISIBLE_DEVICES：如果系统上有多个 GPU，可以指定。例如，如果您想使用辅助 GPU，请设置成1，需在 webui-user.bat 中添加新行 set CUDA_VISIBLE_DEVICES=0，或者在 COMMANDLINE_ARGS 的参数中添加 --device-id 0

命令行参数 / 配置类

-h, --help：显示帮助消息并退出
--exit：安装后终止
--data-dir：存储所有用户数据的基本路径，默认为根目录下
--config：用于构建模型的配置文件路径，默认为 "configs/stable-diffusion/v1-inference.yaml"
--ckpt：稳定扩散模型的检查点路径；如果指定，该路径将被添加到检查点列表并加载
--ckpt-dir：稳定扩散检查点的目录路径
--no-download-sd-model：即使没有找到模型，也不下载SD1.5模型
--vae-dir：变分自编码器模型的路径
--vae-path：用作 VAE 的检查点
--gfpgan-dir：GFPGAN 目录
--gfpgan-model：GFPGAN模型文件名
--codeformer-models-path：Codeformer模型文件的目录路径
--gfpgan-models-path：GFPGAN模型文件的目录路径
--esrgan-models-path：ESRGAN模型文件的目录路径
--bsrgan-models-path：BSRGAN模型文件的目录路径
--realesrgan-models-path：RealESRGAN模型文件的目录路径
--scunet-models-path：ScuNET模型文件的目录路径
--swinir-models-path：SwinIR和SwinIR v2模型文件的目录路径
--ldsr-models-path：LDSR模型文件的目录路径
--lora-dir：Lora网络的目录路径
--clip-models-path：CLIP模型文件的目录路径
--embeddings-dir：用于文本逆向的嵌入目录，默认为 "embeddings"
--textual-inversion-templates-dir：文本逆向模板的目录
--hypernetwork-dir：超网络目录
--localizations-dir：本地化目录
--styles-file：用于样式的文件名，默认为 "styles.csv"
--ui-config-file：用于UI配置的文件名，默认为 "ui-config.json"
--no-progressbar-hiding：不隐藏Gradio UI中的进度条（默认隐藏，因为在浏览器中使用硬件加速会降低机器学习速度）
--max-batch-count：UI的最大批次计数值，默认为16
--ui-settings-file：用于UI设置的文件名，默认为 "config.json"
--allow-code：允许从Web UI执行自定义脚本
--share：使用Gradio的share=True，并使UI通过其网站访问
--listen：使用0.0.0.0作为服务器名称启动Gradio，允许响应网络请求
--port：使用给定的服务器端口启动Gradio，需要根/管理员权限才能使用1024以下的端口
--hide-ui-dir-config：从 Web UI 隐藏目录配置
--freeze-settings：禁用编辑设置
--enable-insecure-extension-access：无论其他选项如何，都启用扩展选项卡
--gradio-debug：使用--debug选项启动Gradio
--gradio-auth：设置Gradio身份验证，如 "username:password"；或逗号分隔多个，如 "u1:p1,"u2":p2,"u3":p3"
--gradio-auth-path：设置Gradio身份验证文件路径，例如 "/path/to/auth/file"，与--gradio-auth的格式相同
--disable-console-progressbars：不在控制台输出进度条。
--enable-console-prompts：在使用txt2img和img2img生成时，在控制台打印提示
--api：使用API启动Web UI
--api-auth：设置API身份验证，如 "username:password"；或逗号分隔多个，如 "u1:p1,"u2":p2,"u3":p3"
--api-log：启用所有API请求的日志记录
--nowebui：仅启动API，不启动UI
--ui-debug-mode：不加载模型以快速启动UI
--device-id：选择要使用的默认CUDA设备（可能需要在此之前设置CUDA_VISIBLE_DEVICES=0,1等环境变量）
--administrator：管理员权限
--cors-allow-origins：以逗号分隔的列表形式允许的CORS来源
--cors-allow-origins-regex：以单个正则表达式的形式允许的CORS来源
--tls-keyfile：部分启用TLS，需要--tls-certfile才能完全生效
--tls-certfile：部分启用TLS，需要--tls-keyfile才能完全生效
--disable-tls-verify：通过后，即可使用自签名证书
--server-name：设置服务器主机名
--no-gradio-queue：禁用渐变队列；导致网页使用http请求而不是websocket；是早期版本中的默认值
--no-hashing：禁用检查点的 SHA-256 哈希以帮助加载性能
--skip-version-check：不检查torch和xformers的版本
--skip-python-version-check：不检查 python 版本
--skip-torch-cuda-test：不检查CUDA是否能够正常工作
--skip-install：跳过软件包的安装

命令行参数 / 性能类

--xformers：启用xformers，加快图像的生成速度
--force-enable-xformers：强制启动xformers，无论是否可以运行都不报错
--xformers-flash-attention：启用带有 Flash Attention 的 xformers 以提高再现性（仅支持 SD2.x）
--opt-sdp-attention：启用缩放点积交叉注意层优化；需要 PyTorch 2.*
--opt-sdp-no-mem-attention：启用缩放点积交叉注意力层优化，无需内存高效注意力，使图像生成具有确定性；需要 PyTorch 2.*
--opt-split-attention：强制启用 Doggettx 的交叉注意力层优化。默认情况下，它在启用 CUDA 的系统上处于打开状态
--opt-split-attention-invokeai：强制启用 InvokeAI 的交叉注意力层优化。默认情况下，当 CUDA 不可用时它会打开
--opt-split-attention-v1：启用旧版本的分割注意力优化，不会消耗所有可用的 VRAM
--opt-sub-quad-attention：实现内存高效的子二次交叉注意力层优化
--sub-quad-q-chunk-size：用于子二次交叉注意力层优化的查询块大小
--sub-quad-kv-chunk-size：用于子二次交叉注意力层优化的 KV 块大小
--sub-quad-chunk-threshold：使用分块进行子二次交叉注意力层优化的 VRAM 阈值的百分比
--opt-channelslast：启用 4d 张量的替代布局，可能会导致仅在具有 Tensor 核心（16xx 及更高）的 Nvidia 卡上更快的推理
--disable-opt-split-attention：强制禁用跨注意层优化
--disable-nan-check：不检查生成的图像/潜在空间是否包含nan值；在持续集成中运行时无需检查点
--use-cpu：对指定模块使用CPU作为torch设备
--no-half：不将模型切换为16位浮点数
--precision：以此精度进行评估
--no-half-vae：不将VAE模型切换为16位浮点数
--upcast-sampling：向上采样。与 --no-half 无效。通常产生与 --no-half 类似的结果，但在使用较少内存的情况下性能更好
--medvram：启用稳定扩散模型优化，牺牲一点速度以减少显存使用
--lowvram：启用稳定扩散模型优化，牺牲大量速度以极低的显存使用
--lowram：将稳定扩散检查点权重加载到显存而非RAM
--always-batch-cond-uncond：禁用使用 --medvram 或 --lowvram 时为节省内存而启用的条件/无条件批处理

命令行参数 / 通用类

--autolaunch：在启动时使用系统的默认浏览器打开WebUI URL
--theme：在WebUI中使用指定的主题light/dark。如果未指定，则使用浏览器的默认主题
--use-textbox-seed：在UI中使用文本框输入种子（没有上/下箭头，但可以输入长种子）
--disable-safe-unpickle：禁用对PyTorch模型的恶意代码检查
--ngrok：用于ngrok的自动令牌，是gradio --share的替代方案
--ngrok-region：ngrok应该在其中启动的区域
--update-check：启动时，通知您的 Web UI 版本（提交）是否与当前主分支保持同步
--update-all-extensions：启动时，它会提取您已安装的所有扩展的最新更新
--reinstall-xformers：强制重新安装 xformers。对于升级很有用 - 但升级后将其删除，否则您将永久重新安装 xformers
--reinstall-torch：强制重新安装割炬。对于升级很有用 - 但升级后将其删除，否则您将永久重新安装 torch
--tests：运行测试以验证 Web UI 功能，请参阅 wiki 主题了解更多详细信息
--no-tests：即使指定了 --tests 选项，也不运行测试

命令行参数 / 已过期（不再有效果）

--show-negative-prompt：显示否定提示
--deepdanbooru：二次元TAG解析
--unload-gfpgan：卸载 gfpgan
--gradio-img2img-tool：图生图处理工具
--gradio-inpaint-tool：重绘处理工具
--gradio-queue：梯度队列 

作者：极客飞兔 https://www.bilibili.com/read/cv25208455/ 出处：bilibili