镜像
配置 Micromamba、PyPI、GitHub、Hugging Face 和模型下载来源。
镜像可以改善特定网络下的软件包和资源下载速度,但镜像内容可能延迟或缺失。普通用户建议先使用“自动选择镜像”,只有需要固定来源或排查问题时才改为手动。
自动与手动模式
开启“自动选择镜像”后,应用会按当前网络为 Micromamba 解析通道,并把自动策略交给 Python 安装流程处理其支持的软件源。此时手动开关和自定义地址会被禁用,避免两套策略同时生效。
关闭自动选择后,可以分别控制:
| 设置 | 主要用途 |
|---|---|
| Micromamba 镜像 | Conda 环境、Git 等受管工具的包与通道 |
| PyPI 镜像 | WebUI Python 依赖安装 |
| GitHub 镜像 | Core、扩展和发布资源 |
| Hugging Face 镜像 | Hugging Face 仓库与文件 |
| 模型下载源 | 在 ModelScope 与 Hugging Face 之间选择 |
自定义 GitHub 或 Hugging Face 地址只有在关闭自动选择并启用对应手动镜像后才可填写。
推荐配置顺序
先在“网络与代理”确认连接方式正确,避免把代理问题误判为镜像问题。
保留自动镜像并重新执行一次失败任务,记录任务输出中的目标来源和错误。
确实需要固定来源时关闭自动镜像,只修改与失败资源有关的一项。
重新运行同一个任务,确认错误是否变化以及实际来源是否可用。
出现版本、提交或校验不一致时,关闭对应镜像并切回官方来源验证。
模型下载源只影响使用内置模型下载能力的操作,不会移动现有模型,也不会改变扩展从 Git 仓库下载的来源。
不要混用来历不明的镜像
镜像可能缺少最新提交、返回不同文件或延迟同步。安装结果出现异常时,应使用官方来源重试并核对任务输出;不要通过关闭校验来接受不一致文件。
如果所有来源都连接失败,优先检查系统时间、DNS、代理和防火墙;如果只有某一种资源失败,再检查对应镜像或切换模型下载源。