sd webui 国内镜像下载

简介

stable-diffusion-webui-china 是把 Stable Diffusion Web UI 所依赖的 GitHub 源码与依赖下载地址替换为国内镜像地址的分支，面向在国内网络环境下部署 SD WebUI 时经常遇到克隆中断、依赖下载超时的用户。它尽量保持原版的目录结构、启动脚本与日常出图操作不变，只替换下载地址，从而提高拉取成功率、缩短等待时间。适合在 Windows、Linux 平台自行部署 WebUI 的新手，以及已经能跑通流程但希望减少网络排错时间的进阶用户；如果你只想快速出图，也可以改用云上预装镜像。

核心功能

• 把源码克隆与依赖下载指向国内可访问的镜像地址，缓解国内访问 GitHub 不稳定造成的克隆中断和下载报错，减少反复重试。
• 尽量保持原版 Stable Diffusion Web UI 的目录结构与启动脚本，镜像替换只改地址，不改变文生图、图生图、高清修复等日常操作方式。
• 依赖包下载同样走镜像通道，首次拉取依赖的等待时间更短，网络中断后重试的失败概率更低。
• 覆盖 Windows 与 Linux 平台：有教程在 Windows + NVIDIA GPU 环境下完成部署并验证，Linux 平台理论上同样适用。
• 可与 SD WebUI All In One 的 gh_mirror.txt 自定义镜像机制配合使用，手动填写自己测通的镜像源地址，覆盖自动检测结果。
• 与容器镜像方案互补：阿里云 GPU 上可按文档部署 SD-WebUI 容器镜像，featurize 平台的镜像预装了 Web UI，开机即可直接使用。

使用场景

• 国内网络下首次克隆 SD WebUI 源码屡次中断，需要换用国内镜像地址重新拉取，且希望尽量不影响后续使用体验。
• 依赖下载阶段频繁超时或报错，启动脚本长时间停在准备依赖的步骤，需要走镜像通道重试。
• 在 Windows 10/11 搭配 NVIDIA 显卡的本地机器上部署，追求与原版一致的目录结构和操作流程。
• 从 GitHub 在线列表添加插件时连接失败，需要先解决 GitHub 连通性问题，再继续插件的查找、评估与使用。
• 排查中文路径报错、CUDA 版本不匹配、依赖下载失败等新手常见问题时，把网络环节单独隔离出来对照验证。
• 只想快速出图、不愿配置本地环境：直接选择阿里云 GPU 的容器镜像或 featurize 的预装镜像。

安装与获取步骤

1. 打开 https://github.com/georgezouq/stable-diffusion-webui-china ，克隆或下载仓库到本地的纯英文路径下，避免中文路径引发后续报错。
2. 准备运行环境：安装 Python 3.10.6 并勾选 Add to PATH，安装 git；随后手动确认 Python 安装目录与 pip 所在目录已加入 PATH 环境变量。
3. 进入项目目录，双击 webui-user.bat 启动，首次启动会拉取依赖；走国内镜像地址时该阶段等待更短，中断后可直接重试。
4. 使用 SD WebUI All In One 脚本时，在与脚本同级的目录创建 gh_mirror.txt 文件，写入镜像源地址并保存；再次启动脚本会取消自动检测，改为读取该文件的配置。
5. 不配置本地环境时：在阿里云 GPU 上按官方文档部署 SD-WebUI 容器镜像并填入配置代码，或在 featurize 开机时选择预装 Stable Diffusion Web UI 的镜像。

与同类方案的区别

• 本仓库属于替换地址的分支：改动集中在源码与依赖的下载地址，目录结构与启动方式与原版保持一致，适合想沿用原流程的用户。
• gh_mirror.txt 属于配置层方案：不改动源码，只通过一个文本文件指定镜像源，地址可随时替换，也会覆盖脚本的自动检测逻辑。
• 秋叶一键整合包与 Docker 属于另一种部署路线：整合包省去依赖准备环节，Docker 走容器化，与镜像源方案解决的问题不同、可叠加使用。
• 云上预装镜像把环境准备全部前置：开机即带 Web UI，省去本地依赖与网络环节，代价是运行位置从本机转到云上实例。

注意事项

• 中文路径是常见报错来源，项目目录、模型目录尽量使用纯英文路径，出现问题时优先检查路径。
• CUDA 版本不匹配、依赖下载失败、模型重复占用磁盘等问题需分别核对显卡驱动、网络与磁盘空间，不要笼统归因于镜像。
• 系统支持范围为 Windows 10/11（NVIDIA 或 AMD 显卡）、搭载 Apple Silicon 芯片的 macOS 以及 Linux，其中优先推荐搭载 N 卡的 Windows。
• gh_mirror.txt 一旦存在就会覆盖自动检测，删除该文件后脚本才会恢复自动检测可用镜像源的流程。
• 镜像源的可用性、仓库内容与文档细节以官方页面为准，云上镜像的具体配置同样以其官方文档为准。