flutter国内镜像配置

在windows中添加镜像

打开环境变量

PUB_HOSTED_URL=https://pub.flutter-io.cn

FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

为 Flutter 设定镜像配置

如果你在国内使用 Flutter,那么你可能需要找一个与官方同步的可信的镜像站点,帮助你的 Flutter 命令行工具到该镜像站点下载其所需的资源。你需要为此设置两个环境变量:PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL,然后再运行 Flutter 命令行工具。

以 macOS 或者与 Linux 相近的系统为例,这里有以下步骤帮助你设定镜像。在系统终端里执行如下命令设定环境变量,并通过 GitHub 检出 Flutter SDK:

content_copy

复制代码
$ export PUB_HOSTED_URL=https://pub.flutter-io.cn
$ export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
$ git clone -b dev https://github.com/flutter/flutter.git
$ export PATH="$PWD/flutter/bin:$PATH"
$ cd ./flutter
$ flutter doctor

如上步骤设定之后,你可以继续进行 Flutter 安装的下一步:编辑工具设定,在这两个环境变量(PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL)设定过后,未来通过命令 flutter pub get 获取 packages 的时候,网络请求将会通过 flutter-io.cn 提供的镜像进行。

flutter-io.cn 所提供的镜像由中国的 Flutter 开发者社区提供和维护, Flutter 团队无法保证其的长期稳定运作,你也可以自由使用其他可信的机构提供的镜像服务。

社区运行的镜像站点

如下列表为目前在国内提供镜像的社区以及其镜像配置,由于镜像的实现方式有所不同,可能会导致数据的滞后等问题。我们制作了一个 镜像可用性监控页面 供参考。

Flutter 社区

社区主镜像,采用多种方式同步 Flutter 开发者资源(推荐)。有任何镜像相关的问题,请与我们 反馈镜像问题,中国镜像存储由 七牛云 提供服务。

content_copy

复制代码
$ export PUB_HOSTED_URL=https://pub.flutter-io.cn
$ export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

上海交大 Linux 用户组

使用全量同步方式建立 Flutter 镜像,配置了完善的回源 (flutter-io.cn 主镜像和 GCS 站源) 策略(推荐),有任何镜像相关的问题,请向上海交大 Linux 用户组 反馈镜像问题。

查看帮助文档: Flutter 镜像安装帮助, Pub 镜像安装帮助。

content_copy

复制代码
$ export PUB_HOSTED_URL=https://mirror.sjtu.edu.cn/dart-pub
$ export FLUTTER_STORAGE_BASE_URL=https://mirror.sjtu.edu.cn

清华大学 TUNA 协会

采取自定义脚本定时主动抓取策略,并配置了完善的回源 (flutter-io.cn 主镜像和 GCS 站源) 策略(推荐),有任何镜像相关的问题(包含 TUNA、OpenTUNA),请向清华大学 TUNA 协会 反馈镜像问题。

查看帮助文档: Flutter 镜像安装帮助, Pub 镜像安装帮助。

content_copy

复制代码
$ export PUB_HOSTED_URL=https://mirrors.tuna.tsinghua.edu.cn/dart-pub
$ export FLUTTER_STORAGE_BASE_URL=https://mirrors.tuna.tsinghua.edu.cn/flutter

OpenTUNA

数据策略与 TUNA 镜像一致、由清华 TUNA 协会运行维护, OpenTUNA 镜像通过 CloudFront CDN 进行分发。

已知问题:Pub API 与预期返回值不一致,可能造成请求无效 (2021/6/8)。

content_copy

复制代码
$ export PUB_HOSTED_URL=https://opentuna.cn/dart-pub
$ export FLUTTER_STORAGE_BASE_URL=https://opentuna.cn/flutter

CNNIC

基于 TUNA 协会的镜像服务,数据策略和内容与 TUNA 一致,通过非教育网的域名访问(建议选择 TUNA)。暂无反馈渠道,可尝试 TUNA 反馈渠道。

content_copy

复制代码
$ export PUB_HOSTED_URL=http://mirrors.cnnic.cn/dart-pub
$ export FLUTTER_STORAGE_BASE_URL=http://mirrors.cnnic.cn/flutter

腾讯云开源镜像站

使用 TUNA 开源的脚本每天凌晨 0 - 2 点执行同步,未配置回源策略。使用腾讯云服务器的用户,可将源域名从 mirrors.cloud.tencent.com 修改为 mirrors.tencentyun.com,使用内网流量不占用公网流量。有任何镜像问题,请通过邮件 (mirrors@tencent.com) 向腾讯云开源镜像站反馈。

已知问题:

  • Flutter Storage 已经从 flutter_infra 调整为 flutter_infra_release,腾讯云开源镜像并未对此做调整,可能会在更新的 Flutter 版本里无法请求到完整数据 (2021/6/8)。
  • 根据反馈 (#1135),腾讯云对 CIPD 的支持尚不确定是否完整。

content_copy

复制代码
$ export PUB_HOSTED_URL=https://mirrors.cloud.tencent.com/dart-pub
$ export FLUTTER_STORAGE_BASE_URL=https://mirrors.cloud.tencent.com/flutter

其他已知问题

  • 所有 Flutter 镜像目前均不支持/也不应支持上传 packages 到 pub.dev 网站。这个过程通常需要登陆谷歌账号,而这将是一个无法绕开且复杂的挑战。
  • 上海大学的镜像 暂时只允许校内访问,故暂未展示,感谢上海大学 Linux 用户组的同学。
  • 腾讯云开源镜像站使用 TUNA 开源脚本制作,每天同步一次,经测试,其数据延迟较大并尚未配置有效的回源策略,有待于社区成员进一步验证。
  • 任何其他与镜像相关的问题,请通过 Issue 向我们反馈。
  • 部分镜像的问题已经特别标识,待镜像修复之后移除。
相关推荐
SoaringHeart1 天前
Flutter最佳实践:用 flutter_html 渲染富文本
前端·flutter
恋猫de小郭2 天前
Flutter 3.50.0 Release 的第一个崩溃,修好了,还没 hotfix
android·前端·flutter
程序员老刘2 天前
跨平台开发地图 | 2026年11月
flutter·ai编程·客户端
传奇开心果编程3 天前
【Flutter踩坑排雷】第30课:异常未捕获坑|未捕获异常直接闪退,全局兜底故障处理
android·flutter·ios·移动开发·dart·ui框架·声明式ui
恋猫de小郭3 天前
Flutter Native Interop 稳定了,Platform Channel 要退场了
android·前端·flutter
好的佩奇3 天前
Dart 之可迭代对象与生成器
android·flutter·dart
恋猫de小郭4 天前
Flutter Analyzer 系列坑推进,必看,AI 时代这玩意最吃你内存
android·前端·flutter
LinXunFeng4 天前
拿竞品 App 一扫,技术栈全暴露了
android·flutter·开源
传奇开心果编程5 天前
【Flutter踩坑排雷】第28课:平台目录缺失与修复坑|`flutter create` 的“重建”与“覆盖”边界
android·flutter·ios·移动开发·跨平台·dart·声明式ui
程序员老刘·6 天前
Flutter 3.50更新,开发者应该关注什么?
flutter·ai编程·跨平台开发