macos-tools/network

国内网络加速配置工具

这个工具集提供了一键配置国内镜像加速源的脚本，帮助开发者在国内网络环境下快速配置各种开发工具的镜像源。

功能特性

• ✅ 自动清理全局代理配置（7890端口）
• ✅ 配置 Pip 使用中科大镜像源
• ✅ 配置 NPM 使用阿里云镜像源
• ✅ 配置 Maven 使用阿里云镜像源
• ✅ 配置 Docker 使用 Harbor 私有镜像代理
• ✅ 自动备份原有配置文件
• ✅ 提供配置恢复功能
• ✅ 支持 Docker Desktop 和 OrbStack

文件说明

network/
├── README.md                    # 本文档
├── setup-china-mirrors.sh       # 配置脚本（主脚本）
├── restore-configs.sh           # 恢复脚本
├── performance-test.sh          # Mac Studio Ultra 性能测试脚本
├── install-perf-deps.sh         # 性能测试依赖安装脚本
├── PERFORMANCE_TEST.md          # 性能测试说明文档
├── docker-proxy.sh              # Docker 代理配置脚本
├── setup-github-mirror.sh       # GitHub 镜像配置脚本
├── verify-config.sh             # 配置验证脚本
├── dns-config.sh                # DNS 配置工具（中国网络优化）
└── Makefile                     # Make 构建文件

快速开始

1. 应用配置

执行以下命令一键配置所有镜像源：

cd ~/work/codes/tools/macos/network
./setup-china-mirrors.sh

2. 性能测试

执行以下命令运行 Mac Studio Ultra 性能测试：

cd ~/work/codes/tools/macos/network
# 安装依赖（首次运行时）
./install-perf-deps.sh

# 运行性能测试
./performance-test.sh

或者使用 Make 命令：

make performance

3. DNS 配置优化

执行以下命令使用优化的 DNS 配置：

cd ~/work/codes/tools/macos/network
# 查看当前 DNS 设置
./dns-config.sh current

# 设置优化的 DNS（推荐 223.5.5.5 等国内快速 DNS）
./dns-config.sh setup

# 测试不同 DNS 服务器性能
./dns-config.sh test 223.5.5.5 114.114.114.114 119.29.29.29

# 恢复之前的 DNS 设置
./dns-config.sh restore

或者使用 Make 命令：

make dns

脚本将自动完成以下操作：

1. 清理代理配置

   • 清理 ~/.bashrc 中的 HTTP/HTTPS 代理
   • 清理 Git 全局代理配置
   • 提醒检查 ~/.zshrc 中的代理配置

2. 配置 Pip 镜像

   • 创建/更新 ~/.pip/pip.conf
   • 使用中科大镜像：https://pypi.mirrors.ustc.edu.cn/simple/

3. 配置 NPM 镜像

   • 设置全局 registry：https://registry.npmmirror.com

4. 配置 Maven 镜像

   • 创建/更新 ~/.m2/settings.xml
   • 使用阿里云镜像：https://maven.aliyun.com/repository/public

5. 配置 Docker 镜像代理

   • 更新 Docker daemon 配置（OrbStack 或 Docker Desktop）
   • 使用 Harbor 代理：https://harbor.omniverseai.net

2. 使配置生效

执行配置脚本后，运行以下命令使配置生效：

# 重新加载 Shell 配置
source ~/.zshrc

# 重启 Docker（如果使用 OrbStack）
orb restart

# 重启 Docker（如果使用 Docker Desktop）
# 通过 Docker Desktop 界面重启

3. 验证配置

配置脚本会自动进行验证，你也可以手动验证：

# 验证 Pip
pip config list

# 验证 NPM
npm config get registry

# 验证 Docker
docker info | grep -A 2 "Registry Mirrors"

# 验证 Maven
cat ~/.m2/settings.xml

配置恢复

如果需要恢复到原始配置，使用恢复脚本：

./restore-configs.sh

恢复脚本会：

• 列出所有可用的备份文件
• 让你确认是否恢复
• 恢复之前再次备份当前配置
• 恢复所有原始配置

配置详情

Pip 镜像源

配置文件：~/.pip/pip.conf

[global]
index-url = https://pypi.mirrors.ustc.edu.cn/simple/
trusted-host = pypi.mirrors.ustc.edu.cn
timeout = 60

[install]
trusted-host = pypi.mirrors.ustc.edu.cn

NPM 镜像源

npm config get registry
# https://registry.npmmirror.com

其他可选镜像源：

• 淘宝镜像：https://registry.npmmirror.com（推荐）
• 腾讯云：https://mirrors.cloud.tencent.com/npm/
• 华为云：https://repo.huaweicloud.com/repository/npm/

Maven 镜像源

配置文件：~/.m2/settings.xml

• 阿里云 Maven Central：https://maven.aliyun.com/repository/public
• 阿里云 Spring：https://maven.aliyun.com/repository/spring-plugin

Docker 镜像代理

配置文件：

• OrbStack：~/.orbstack/config/daemon.json
• Docker Desktop：~/.docker/daemon.json

{
  "registry-mirrors": [
    "https://harbor.omniverseai.net"
  ],
  "insecure-registries": [
    "harbor.omniverseai.net"
  ]
}

备份说明

所有原始配置文件都会自动备份，备份文件命名格式：

原文件名.backup.YYYYMMDD_HHMMSS

示例：

~/.pip/pip.conf.backup.20251219_093045
~/.bashrc.backup.20251219_093045

备份文件与原文件在同一目录下，方便管理。

故障排除

1. Docker 镜像代理未生效

问题：运行 docker info 看不到 Registry Mirrors

解决方案：

# 检查配置文件
cat ~/.orbstack/config/daemon.json  # OrbStack
# 或
cat ~/.docker/daemon.json          # Docker Desktop

# 重启 Docker
orb restart  # OrbStack
# 或通过 Docker Desktop 界面重启

2. Pip 安装仍然很慢

问题：pip install 仍然从官方源下载

解决方案：

# 检查配置
pip config list

# 手动指定镜像源安装
pip install -i https://pypi.mirrors.ustc.edu.cn/simple/ package-name

3. NPM 安装报错

问题：npm install 报证书或网络错误

解决方案：

# 验证配置
npm config get registry

# 清理缓存
npm cache clean --force

# 重新配置
npm config set registry https://registry.npmmirror.com

4. 需要临时使用代理

问题：某些包国内镜像没有，需要临时使用代理

解决方案：

# 临时使用代理
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890

# 安装后取消代理
unset http_proxy
unset https_proxy

版本历史

v1.0.0 (2025-12-19)

• 初始版本
• 支持 Pip/NPM/Maven/Docker 镜像配置
• 支持自动备份和恢复
• 支持 OrbStack 和 Docker Desktop

维护与贡献

这个工具集是 macOS DevOps 工具链的一部分，如需修改或贡献：

1. Fork 项目
2. 创建特性分支
3. 提交变更
4. 创建 Pull Request

许可证

MIT License

相关链接

• 中科大开源镜像站
• 阿里云镜像站
• NPM 淘宝镜像
• Harbor 文档

性能测试功能

功能特性

• ✅ CPU 性能测试（单核/多核、计算能力）
• ✅ GPU 性能测试（Metal 框架、计算能力）
• ✅ 内存性能测试（带宽、分配速度）
• ✅ 磁盘 I/O 性能测试（顺序/随机读写）
• ✅ 网络性能测试（连接速度、下载速度）
• ✅ 热性能测试（温度监控）
• ✅ 系统信息收集
• ✅ 详细结果记录

测试内容

1. CPU 性能

   • 单核和多核性能基准测试
   • 大数计算（质数计算）
   • 并行处理能力

2. 内存性能

   • 内存带宽测试
   • 内存分配速度测试
   • 大内存块操作

3. 磁盘 I/O 性能

   • 顺序读写测试
   • 随机 I/O 测试
   • 文件系统性能

4. GPU 性能

   • Metal 框架支持
   • 图形处理能力
   • 计算着色器性能

5. 网络性能

   • DNS 性能测试（支持国内外多个 DNS 服务器）
   • 本地网络连接
   • 下载速度测试
   • 网络延迟测试

6. 热性能

   • 温度传感器监控
   • 压力测试期间温度变化
   • 系统散热性能

DNS 配置优化工具

功能特性

• ✅ 自动备份当前 DNS 设置
• ✅ 配置国内最优 DNS 服务器（如 223.5.5.5）
• ✅ DNS 性能测试和比较
• ✅ 快速恢复原始设置
• ✅ 支持多种国内 DNS 服务（阿里、腾讯、百度、114等）

推荐的国内 DNS 服务器

1. 阿里 DNS:

   • 主: 223.5.5.5
   • 备: 223.6.6.6

2. 114 DNS:

   • 主: 114.114.114.114
   • 备: 114.114.115.115

3. 腾讯 DNS:

   • 主: 119.29.29.29
   • 备: 182.254.116.116

4. 百度 DNS:

   • 180.76.76.76

基于您的测试 results，223.5.5.5 (阿里 DNS) 表现出色，延迟约 6-7ms，是极佳的 DNS 选择。

VNC 高分辨率设置工具

功能特性

• ✅ 一键设置 VNC 为 4K (3840x2160) 分辨率
• ✅ 支持多种分辨率快速切换（1080p/2K/3K/4K）
• ✅ 自动重启 VNC 服务使设置生效
• ✅ VNC 高质量模式配置
• ✅ 简单易用的命令行界面

使用场景

通过 VNC 从 MacBook 远程连接到 Mac Studio 时，默认分辨率仅为 1920x1080，使用本工具可以提升到 4K 或更高分辨率，获得更清晰的显示效果。

快速开始

方法 1: 一键设置 4K（推荐）

cd ~/work/codes/tools/macos/network
./set-4k-vnc.sh

方法 2: 使用分辨率切换器

cd ~/work/codes/tools/macos/network

# 设置为 4K（推荐）
./vnc-resolution-switcher.sh 4k

# 设置为其他分辨率
./vnc-resolution-switcher.sh 1080p   # 降回 1080p
./vnc-resolution-switcher.sh 2k      # 2K+ (2624x1696)
./vnc-resolution-switcher.sh 3k      # 3K (2880x1800)

# 查看所有可用分辨率
./vnc-resolution-switcher.sh list

方法 3: 手动设置（高级用户）

# 查看当前显示器配置
displayplacer list

# 设置为 4K
displayplacer "id:50AEDA84-525C-41A7-8919-157C070FD63F res:3840x2160 hz:60 color_depth:4 enabled:true origin:(0,0) degree:0"

# 重启 VNC 服务
sudo /System/Library/CoreServices/RemoteManagement/ARDAgent.app/Contents/Resources/kickstart -restart -agent -console

分辨率对照表

级别	分辨率	命令	适用场景
Full HD	1920x1080	./vnc-resolution-switcher.sh 1080p	默认设置，较低清晰度
2K+	2624x1696	./vnc-resolution-switcher.sh 2k	较高清晰度
3K	2880x1800	./vnc-resolution-switcher.sh 3k	高清晰度
4K UHD	3840x2160	./vnc-resolution-switcher.sh 4k	推荐使用 ✅

VNC 客户端优化建议

在 MacBook 端连接 VNC 后，建议进行以下设置：

1. 使用内置 Screen Sharing：

   • 菜单栏 → 查看 → 质量 → 最佳
   • 菜单栏 → 查看 → 缩放以适应屏幕（取消勾选）
   • 菜单栏 → 查看 → 全屏

2. 使用第三方 VNC 客户端（可选）：

   # RealVNC Viewer
   brew install --cask vnc-viewer
   
   # Royal TSX
   brew install --cask royal-tsx
   

网络带宽要求

分辨率	最低带宽	推荐带宽
1080p	10 Mbps	25 Mbps
2K	15 Mbps	35 Mbps
3K	20 Mbps	45 Mbps
4K	25 Mbps	50 Mbps

注意：局域网千兆网络（1 Gbps）完全支持 4K 分辨率。

故障排除

问题 1: 设置后分辨率未改变

# 重启 WindowServer
sudo killall -HUP WindowServer

# 或注销重新登录

问题 2: VNC 连接后分辨率自动降低

解决方案：

• 使用 BetterDisplay 锁定分辨率
• 在 VNC 客户端禁用自动缩放

问题 3: 画面卡顿

解决方案：

• 降低分辨率（从 4K 降到 3K 或 2K）
• 使用有线网络连接而非 WiFi
• 检查网络带宽

相关脚本

network/
├── set-4k-vnc.sh                   # 一键设置 4K 分辨率
├── vnc-resolution-switcher.sh      # 分辨率快速切换器
├── set-vnc-resolution.sh           # 高级设置工具
└── VNC-HIGH-RESOLUTION-GUIDE.md    # 详细指南文档

详细文档

完整的 VNC 高分辨率设置指南请参阅：VNC-HIGH-RESOLUTION-GUIDE.md

联系方式

如有问题或建议，请通过以下方式联系：

• Issues: 项目 Issues 页面
• Email: DevOps Team

---

注意：本工具仅适用于 macOS 系统，其他系统请根据实际情况修改脚本。