网络环境配置指南 (GFW & Mirrors)

解决国内开发环境下的网络连接问题，包括工具推荐与镜像站配置。

🌏 背景与说明

为什么需要关注网络环境

在开发面向海外市场的产品（MVP）或从事外贸行业时，稳定访问国际互联网基础设施（如 GitHub, Docker Hub, HuggingFace, OpenAI 等）是开展业务的前提。由于国内特殊的网络环境（GFW），直接访问这些服务常面临速度极慢或连接中断的问题。

合理性与灰色地带

网络防火墙的存在有其历史与国家安全层面的考量，旨在管理信息跨境流动。然而，对于程序员、科研人员及外贸从业者而言，使用网络加速工具（俗称“梯子”或 VPN）已成为工作的刚需。

目前这一领域在国内属于灰色地带：

合规性：国家明令禁止未经许可建立或使用非法定信道进行国际联网。
现实情况：在技术开发、学术研究等非政治敏感领域，合理使用个人工具通常处于监管的默许范围，但切勿用于传播违规信息或从事违法活动。

⚙️ 原理与核心概念

为了让你更顺滑地使用工具，这里用大白话解释几个核心概念：

1. 代理 (Proxy) 工作原理

💡 通俗理解：这就好比你想去一家不送外卖的餐厅（比如 Google）吃饭，但你自己去不了，于是找了个**“跑腿小哥”**（中转节点）帮你去买。你把需求告诉小哥，他去买了送回来给你。
⚙️ 技术原理：它在你的电脑和目标网站之间建立了一条专用通道。你的请求不再直接发给目标，而是先发给海外的服务器，由它帮你“代购”数据并加密传回给你，从而绕过本地的访问限制。

2. TUN 模式 (增强模式/虚拟网卡)

💡 通俗理解：默认情况下，代理软件只管得了浏览器（Chrome/Edge），很多软件（比如终端命令行、游戏）会**“装傻”不走代理，导致依然连不上。开启 TUN 模式，就是给系统装了一个“强制关卡”**，不管什么软件发出的请求，统统都要经过它，确保所有软件都能联网。
⚙️ 技术原理：开启后，软件会模拟出一张虚拟网卡。操作系统会认为这是一张真实的网卡，从而把所有网络数据（包括那些平时不听话的软件流量）都交给它处理，实现了对全系统所有软件的强制接管。
使用场景：比如你需要终端 Terminal 走代理，或者 Google Antigravity 这种软件，需要开启 TUN 模式才能正常使用。

3. 节点选择建议

💡 通俗理解：选节点就像选**“中转站”**。
- 🇸🇬 新加坡 (推荐)：它是**“全能型选手”**。既快又稳，而且像 ChatGPT、Claude 这种“挑剔”的 AI 服务都支持它，中英文环境也友好。
- 🇭🇰 香港 (慎用)：虽然离得近、速度快，但它在很多 AI 服务的**“黑名单”**上（如 OpenAI），会导致无法访问。

🛠️ 推荐工具 (客户端)

⚠️ 注意：本文档 仅介绍开源/常用的客户端软件，无法也不提供 任何节点订阅服务推荐。请读者自行寻找可靠的服务商，并确保用途合法合规。

平台	推荐软件	说明
Windows / macOS / Linux	Clash Verge Rev	基于 Clash Meta 内核，开源免费，UI 现代化，支持多平台。
Windows / macOS / Linux / ios / Android	Hiddify	新一代通用客户端，支持多种协议，界面简洁。
iOS / iPadOS	Shadowrocket	(付费)俗称“小火箭”，功能强大，几乎是 iOS 标配。
Android	Clash Meta for Android	安卓端的主流选择。

💻 终端代理配置 (Terminal Proxy)

大多数开发工具（git, curl, wget, homebrew 等）默认不走系统代理，需要在终端手动设置。这是开发者最高频的配置之一。

临时生效 (当前窗口):

# 假设代理端口为 7890 (请根据你的客户端实际端口修改)
export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890 all_proxy=socks5://127.0.0.1:7890

永久生效 (添加到 ~/.zshrc 或 ~/.bashrc):

# 将上面的 export 命令添加到配置文件末尾
# 或者定义一个别名函数方便开关
# 注意 7890 需要替换为你实际的端口
alias proxy="export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890 all_proxy=socks5://127.0.0.1:7890"
alias unproxy="unset https_proxy http_proxy all_proxy"

🚀 常用镜像站大全

为了加速开发资源的下载，建议优先配置国内镜像源，既合规又高速。

核心开发资源镜像表

类型	名称/来源	镜像地址/配置命令	备注
Docker	轩辕镜像	`https://docker.xuanyuan.me/`	长期维护，推荐
Docker	DaoCloud	`https://github.com/DaoCloud/public-image-mirror`	需关注其 GitHub 获取最新列表
NPM	淘宝/阿里源	`registry=https://registry.npmmirror.com/`	前端必备
PyPI (Pip)	腾讯云	`https://mirrors.cloud.tencent.com/pypi/simple`	速度快，稳定
PyPI (Pip)	阿里云	`https://mirrors.aliyun.com/pypi/simple/`	老牌镜像源
Conda	清华 TUNA	`https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/`	学术界常用
HuggingFace	HF-Mirror	`export HF_ENDPOINT=https://hf-mirror.com`	AI 模型下载必备
GitHub	GH-Proxy	`https://mirror.ghproxy.com/`	用于加速 git clone 或 release 下载

📝 详细配置指南

通常来讲，如果你不知道怎么配置，或者懒得自己动手的话，把下面的内容复制给 AI，让它帮你操作就好

以下是各工具的详细配置方法，方便直接复制使用。

1. Docker 镜像加速

国内 Docker Hub 访问经常中断，建议使用镜像加速器。

一键配置脚本 (轩辕镜像):

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

手动配置 (/etc/docker/daemon.json):

{
  "registry-mirrors": [
    "https://docker.xuanyuan.me",
    "https://docker.m.daocloud.io",
    "https://npmmirror.com/mirrors/dockerhub"
  ]
}

2. 前端包管理器 (NPM/Yarn/PNPM)

推荐使用 npmmirror (原淘宝源)。

一行命令设置:

# NPM
npm config set registry https://registry.npmmirror.com/

# Yarn
yarn config set registry https://registry.npmmirror.com/

# PNPM
pnpm config set registry https://registry.npmmirror.com/

Electron 镜像 (常见安装失败项):

# .npmrc 配置
electron_mirror=https://npmmirror.com/mirrors/electron/
electron_builder_binaries_mirror=https://npmmirror.com/mirrors/electron-builder-binaries/

3. Python (Pip & Conda)

Pip 全局配置:

# 设置腾讯源 (推荐)
pip config set global.index-url https://mirrors.cloud.tencent.com/pypi/simple

Conda 配置:

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --set show_channel_urls yes

4. GitHub 加速

如果 git clone 慢，可以使用代理前缀。

使用 ghproxy:

# 原链接: https://github.com/user/repo.git
# 加速链接:
git clone https://mirror.ghproxy.com/https://github.com/user/repo.git

5. 系统源 (Ubuntu/Debian)

推荐使用清华源 (TUNA) 或阿里源 (Aliyun)。

Ubuntu 换源示例:

sed -i s@/archive.ubuntu.com/@/mirrors.aliyun.com/@g /etc/apt/sources.list
apt-get update

网络环境配置指南 (GFW & Mirrors)

On this page