跳到主内容

AUTOMATIC1111 WebUI 安装:Windows、Linux、Mac 官方仓库

版本 以官网当前版本为准(以官网为准)

源码与 Windows/Linux 安装步骤

NVIDIA 显卡安装与排错

AMD 平台安装说明

M 系列 Mac 安装说明

AUTOMATIC1111 WebUI 是独立社区维护的本地图像生成界面,并非 Stability AI 官方客户端。可信入口是 AUTOMATIC1111/stable-diffusion-webui 仓库和 Wiki;第三方整合包不属于官方发行。

AUTOMATIC1111 WebUI 安装与模型导入步骤示意图
AUTOMATIC1111 的安装步骤因显卡和系统不同,应使用项目 Wiki 对应章节。

Windows 用户怎么安装

NVIDIA 用户按 README 准备 Python、Git,克隆仓库后运行 webui-user.bat。官方当前指定 Python 3.10.6,并提醒以普通用户运行。早期 release 压缩包不是持续更新的现代安装器。

Linux、AMD 和 Mac 怎么选

  • Linux:安装 Git、Python、venv 等依赖,再运行官方 webui.sh 或克隆仓库。
  • AMD:查看项目 AMD Wiki;ROCm 路径不能照抄 NVIDIA CUDA 参数。
  • Apple Silicon:使用专门的 Mac Wiki,部分功能速度与兼容性不同。
  • Intel:README 指向外部 OpenVINO Wiki,需确认维护与兼容状态。

模型不包含在源码里

checkpoint、VAE、LoRA 和放大模型要分别下载并放入对应目录。每个模型都有独立来源、许可证和显存要求;项目采用 AGPL-3.0,不代表模型可任意商用。

扩展为什么要单独审查

扩展会在本机 Python 环境执行代码,可读写文件、联网或安装依赖。只安装维护者清楚、代码可查看且与当前版本兼容的扩展;出现问题时逐个停用排查。

本地 WebUI 的网络风险

  • 默认只在本机使用,不随意添加 --listen 或端口转发。
  • --share 会生成外部链接,需要时配置认证并及时关闭。
  • 不要启用 --allow-code,除非理解它允许运行任意 Python 代码。
  • 生成目录和上传素材可能含隐私或版权信息,应限制本机权限。

更新与兼容性

仓库、PyTorch、模型和扩展更新节奏不同,最新提交可能使旧扩展失效。正式环境应记录可用提交、Python 和启动参数,更新前备份配置与作品。

安装结论

NVIDIA Windows 用户按 README 的 Python 3.10.6、Git 和 webui-user.bat 路径最直接;Linux、AMD、Mac 或 Intel 用户进入对应 Wiki。不想维护环境时,可选带官方桌面安装器的工具。

反馈页面信息

请描述需要更正的地方,页面标题和网址会自动附上。

也可以发邮件至 [email protected]