跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashAI

1Panel 部署 Open WebUI:ghcr.io 镜像加速与无缝切换方案

Open WebUI 部署常因 ghcr.io 网络问题受阻。对比南京大学、华为云等镜像源,推荐稳定方案,并提供 1Panel 下配置 Docker 镜像加速的具体步骤,实现快速拉取与部署。

灵魂伴侣发布于 2026/3/26更新于 2026/10/24113 浏览

为什么需要镜像加速

在国内使用 Docker 拉取 GitHub Container Registry(ghcr.io)的镜像时,经常会遇到下载速度极慢甚至完全无法连接的问题。这主要是因为 ghcr.io 的服务器位于海外,国内访问存在网络延迟和带宽限制。以 Open WebUI 为例,一个 3GB 左右的镜像可能需要数小时才能下载完成,严重影响开发效率。

我曾经在部署 Open WebUI 时就遇到过这个问题。当时尝试从 ghcr.io 直接拉取镜像,速度只有几十 KB/s,而且经常中断。后来发现国内高校和云服务商提供了 ghcr.io 的镜像服务,切换到南京大学镜像源后,下载速度立刻提升到 10MB/s 以上,整个镜像几分钟就完成了下载。

国内镜像站的选择

目前国内可用的 ghcr.io 镜像站主要有以下几种:

  1. 南京大学镜像站(ghcr.nju.edu.cn):这是最稳定的选择之一,更新频率高,支持匿名拉取
  2. 华为云镜像仓库(swr.cn-north-4.myhuaweicloud.com):提供企业级镜像服务,需要登录后使用
  3. 阿里云镜像加速器:需要开通容器镜像服务,提供专属加速地址

我测试下来,南京大学镜像站对个人开发者最友好,无需注册即可使用,而且支持绝大多数 ghcr.io 上的公开镜像。下面是几个常用镜像站的对比:

镜像站是否需要认证更新频率最大带宽适用场景
南京大学否每日100Mbps个人开发、测试
华为云是实时1Gbps企业生产环境
阿里云是实时不限已有阿里云生态用户

1Panel 下的配置实践

有了镜像源,接下来就是如何在 1Panel 中生效。虽然 1Panel 界面直观,但底层还是依赖 Docker 的配置。

打开 1Panel 控制台,进入左侧菜单的'应用商店'或直接找到'容器'管理模块。在 Docker 设置里,通常能找到'镜像加速器'或'Registry 配置'的选项。如果没有图形化入口,直接编辑 /etc/docker/daemon.json 也是通用的做法。

{
  "registry-mirrors": [
    "https://ghcr.nju.edu.cn"
  ]
}

保存后记得重启 Docker 服务,这样新拉取的镜像就会自动走加速通道了。

验证与运行

配置完成后,先别急着部署应用,建议先手动拉取一个测试镜像看看效果:

docker pull ghcr.io/open-webui/open-webui:latest

如果看到下载速度瞬间飙升到几 MB/s,说明配置成功。这时候再回到 1Panel 创建应用,或者通过 docker-compose 启动 Open WebUI,整个过程会顺畅很多。

注意一点,有些镜像可能带有标签后缀,比如 :latest 或具体版本号,镜像加速对它们都有效,不用额外担心。如果遇到特定镜像依然拉取失败,可以检查该镜像是否被源站屏蔽,或者尝试更换上述列表中的其他镜像源。

目录

  1. 为什么需要镜像加速
  2. 国内镜像站的选择
  3. 1Panel 下的配置实践
  4. 验证与运行

更多推荐文章

查看全部
  • GitHub 开源项目 llm-course:免费大模型学习路线图与实战指南
  • Seedance 2.0 重构 AIGC 工作流:语义映射与热更新实战解析
  • 比迪丽 AI 绘画多设备协同:PC 生成、手机审核与平板标注
  • C++ 继承机制深度解析:从基础到菱形继承
  • C++ 继承进阶:友元、静态成员与菱形继承的底层逻辑
  • C++ 继承进阶:友元、静态成员与菱形继承详解
  • C++ 继承:派生类构造、多继承与菱形虚拟继承详解
  • Linux 动态链接库使用详解:dlopen/dlsym/dlclose/dlerror
  • 本地化 AI 量化分析平台搭建:Docker 部署与波浪理论实战
  • 算法实战:机器人摧毁墙壁最大数目的线段树与离散化方案
  • DeepSeek-V3 开源:671B 参数 MoE 模型性能媲美商业闭源
  • 基于 A* 算法的无人机三维路径规划 MATLAB 实现
  • GraphRAG 提升 LLM 摘要总结能力的原理与实践
  • C++ 实现 AVL 平衡二叉搜索树
  • 速卖通商品详情 API 接口详解:注册、签名与 Python 调用示例
  • Docker 详细安装与基础命令指南
  • 基于 Trae IDE 与 MCP Server 实现 Figma 设计稿自动转前端代码
  • Windows 系统下 Git 安装与配置详解
  • Docker 部署 MySQL 8.0:镜像拉取、配置与远程访问
  • Android 动态替换 Application 实现

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online