Stable Diffusion Web ui各个系统的环境变量与命令行参数的设置方法（Linux/Windows/macOS）

Stable Diffusion WebUI的项目文件夹附带了启动主程序的指令稿，称为启动指令稿。

1. 环境变量与命令行参数的设置方法

在Linux/macOS系统中，变量与参数可以在webui-user.sh文件中进行设置。用户可以在终端中运行webui.sh，该脚本会读取webui-user.sh中设置的变量和值，并将其传递给launch.py，然后启动WebUI。

在Windows系统中也是类似的，变量与参数可以在webui-user.bat批处理文件中进行设置。用户可以在终端中运行该批处理文件（或者在文件管理器中双击），即可启动主程序。

例如，在Windows系统中，可以右键点击webui-user.bat并使用记事本编辑，然后添加以下命令行参数：

bat

set COMMANDLINE_ARGS=--xformers --no-half-vae --medvram

2. 环境变量

启动指令稿中可以使用以下环境变量：

名称说明
PYTHON 设置Python运行文件的路径。
VENV_DIR 设置Python虚拟环境的路径。默认为venv。如果设置为“-”，则不创建虚拟环境，直接运行Python程序。
COMMANDLINE_ARGS 主程序的额外命令行参数。
IGNORE_CMD_ARGS_ERRORS 设置为任意值，使程序在遇到未知的命令行参数时不显示错误。
REQS_FILE 启动launch.py时安装依赖套件所使用的requirements.txt文件名。默认为requirements_versions.txt。
TORCH_COMMAND 安装PyTorch的指令。
INDEX_URL pip的–index-url参数。
TRANSFORMERS_CACHE Transformer函数库下载的路径，以及CLIP模型相关文件的路径。

3. 命令行参数

命令行参数是在启动WebUI时使用的选项，写在启动指令稿的COMMANDLINE_ARGS之后。

注意，以下命令行参数使用双横线“–”。

参数指令数值默认值说明
设置值
-h, –help None False 显示此帮助消息并退出。
–exit 安装后终止程序。
–data-dir DATA_DIR ./ 用户数据保存的路径。
–config CONFIG configs/stable-diffusion/v1-inference.yaml 建构模型设置档的路径。
–ckpt CKPT model.ckpt Stable Diffusion模型的存盘点模型路径。一旦指定，该模型会加入至存盘点模型列表并加载。
–ckpt-dir CKPT_DIR None 存放Stable Diffusion模型存盘点模型的路径。
–no-download-sd-model None False 即使找不到模型，也不自动下载SD1.5模型。
–vae-dir VAE_PATH None VAE的路径。
–gfpgan-dir GFPGAN_DIR GFPGAN/ GFPGAN路径
–gfpgan-model GFPGAN_MODEL GFPGAN模型文件名
–codeformer-models-path CODEFORMER_MODELS_PATH models/Codeformer/ Codeformer模型档的路径。
–gfpgan-models-path GFPGAN_MODELS_PATH models/GFPGAN GFPGAN模型档的路径。
–esrgan-models-path ESRGAN_MODELS_PATH models/ESRGAN ESRGAN模型档的路径。
–bsrgan-models-path BSRGAN_MODELS_PATH models/BSRGAN BSRGAN模型档的路径。
–realesrgan-models-path REALESRGAN_MODELS_PATH models/RealESRGAN RealESRGAN模型档的路径。
–scunet-models-path SCUNET_MODELS_PATH models/ScuNET ScuNET模型档的路径。
–swinir-models-path SWINIR_MODELS_PATH models/SwinIR SwinIR和SwinIR v2模型档的路径。
–ldsr-models-path LDSR_MODELS_PATH models/LDSR 含有LDSR模型档的路径。
–lora-dir LORA_DIR models/Lora 含有LoRA模型档的路径。
–clip-models-path CLIP_MODELS_PATH None 含有CLIP模型档的路径。
–embeddings-dir EMBEDDINGS_DIR embeddings/ Textual inversion的embeddings路径（默认值：embeddings）。
–textual-inversion-templates-dir TEXTUAL_INVERSION_TEMPLATES_DIR textual_inversion_templates Textual inversion范本的路径。
–hypernetwork-dir HYPERNETWORK_DIR models/hypernetworks/ Hypernetwork路径。
–localizations-dir LOCALIZATIONS_DIR localizations/ 在地化翻译路径。
–styles-file STYLES_FILE styles.csv 风格文件名。
–ui-config-file UI_CONFIG_FILE ui-config.json UI设置档文件名。
–no-progressbar-hiding None False 取消隐藏Gradio UI的进度条（我们之所以将其隐藏，是因为在浏览器启动硬件加速的情况下，进度条会降低机器学习的性能）。
–max-batch-count MAX_BATCH_COUNT 16 UI的最大批量数值。
–ui-settings-file UI_SETTINGS_FILE config.json UI设置值画面的文件名。
–allow-code None False 允许在WebUI运行自定义指令稿。
–share None False 使用此参数在启动后会生成Gradio网址，使WebUI能够从外部网络访问。
–listen None False 以0.0.0.0主机名称启动Gradio，使其能够响应连接请求。
–port PORT 7860 以给定的通信端口启动Gradio。1024以下的通信端口需要root权限。如果可用的话，默认使用7860通信端口。
–hide-ui-dir-config None False 在WebUI中隐藏设置档目录。
–freeze-settings None False 停用编辑设置。
–enable-insecure-extension-access None False 无视其他选项，强制激活扩展功能页签。
–gradio-debug None False 使用–debug选项启动Gradio。
–gradio-auth GRADIO_AUTH None 设置Gardio授权，例如”username:password”，或是逗号分隔值形式”u1:p1,u2:p2,u3:p3″。
–gradio-auth-path GRADIO_AUTH_PATH None 设置Gardio授权文件路径。例如“/路径/”再加上–gradio-auth的格式。
–disable-console-progressbars None False 不在终端中显示进度条。
–enable-console-prompts None False 在使用文生图和图生图时，在终端中打印提示词。
–api None False 以API模式启动WebUI。
–api-auth API_AUTH None 设置API授权，例如”username:password”，或是逗号分隔值形式”u1:p1,u2:p2,u3:p3″。
–api-log None False 激活所有API请求的记录档。
–nowebui None False 仅启动API，不启动WebUI。
–ui-debug-mode None False 不加载模型，以更快启动WebUI。
–device-id DEVICE_ID None 选择要使用的CUDA设备（例如，在启动指令稿中使用export CUDA_VISIBLE_DEVICES=0或1）。
–administrator None False 使用系统管理员权限。
–cors-allow-origins CORS_ALLOW_ORIGINS None 允许跨来源资源共享，列表以逗号分隔，不可有空格。
–cors-allow-origins-regex CORS_ALLOW_ORIGINS_REGEX None 允许跨来源资源共享，后面加上单一正则表达式。
–tls-keyfile TLS_KEYFILE None 部分激活TLS，需要配合–tls-certfile才能正常运作。
–tls-certfile TLS_CERTFILE None 部分激活TLS，需要配合–tls-keyfile才能正常运作。
–server-name SERVER_NAME None 设置服务器主机名称。
–gradio-queue None False 使用Gradio队列，限制短时间内API的请求数量。实验性功能，可能导致重启按钮损坏。
–skip-version-check None False 不检查torch和xformers的版本。
–no-hashing None False 停用计算存盘点模型的sha256哈希值，加快加载速度。