hair/网络加速配置说明.md

优云智算 网络加速配置说明

配置日期：2026-07-01 适用实例：虚机实例（系统镜像） 操作系统：Ubuntu 22.04.4 LTS (Jammy Jellyfish) 主机名 / 内网 IP：10-60-64-219 / 10.60.64.219

---

一、功能简介

优云智算「网络加速」通过独立 DNS 服务器提供优化解析服务，有效提升海外资源访问下载的网络稳定性和速度，解决：

• 大模型网站（HuggingFace、PyTorch 等）下载缓慢
• Github 访问卡顿、丢包、克隆失败
• Docker / Conda / Go 模块等拉取超时

已支持加速域名

分类	域名
代码托管	.github.com
GPU / 容器镜像	.nvidia.com、.nvcr.io、.docker.com、.k8s.io、.gcr.io
开发语言	.golang.org、.googlesource.com
Python 生态	.pythonhosted.org、.pytorch.org、.anaconda.org、.conda.io、.anaconda.com
AI 模型库	.huggingface.co、.civitai.com、.wandb.ai

---

二、加速 DNS 服务器地址

主 DNS	备 DNS
100.90.90.90	100.90.90.100

主备顺序建议优先填写前者。

---

三、实例类型与配置方式

实例类型	是否需手动配置
容器实例（基础镜像 / 社区镜像）	❌ 否，开通加速后自动配置
虚机实例（系统镜像）	✅ 是，需按本文档手动配置

本机为虚机实例，已按下方步骤完成配置。

---

四、配置方式（Ubuntu 20.04 / 22.04 / 24.04）

方式 A：临时修改（立即生效，重启后失效）

sudo vim /etc/resolv.conf

删除原有 nameserver 行，添加：

nameserver 100.90.90.90
nameserver 100.90.90.100

⚠️ 注意：本机的 /etc/resolv.conf 是指向 /run/systemd/resolve/resolv.conf 的软链接（由 systemd-resolved 管理），重启后会被 netplan / systemd 重新生成覆盖。推荐使用方式 B 持久化配置。

方式 B：持久化配置（重启后保留）✅ 本机采用

编辑 netplan 配置文件：

sudo vim /etc/netplan/50-cloud-init.yaml

找到 nameservers: 区域，修改为：

nameservers:
    addresses:
    - 100.90.90.90
    - 100.90.90.100

保存并立即生效：

sudo netplan apply

---

五、本机实际配置记录

5.1 配置文件（/etc/netplan/50-cloud-init.yaml）

network:
    ethernets:
        eth0:
            addresses:
            - 10.60.64.219/16
            match:
                macaddress: 52:54:00:5c:90:69
                name: eth0
            mtu: 1452
            nameservers:
                addresses:
                - 100.90.90.90        # 加速 DNS（主）
                - 100.90.90.100       # 加速 DNS（备）
            routes:
            -   to: default
                via: 10.60.0.1
            set-name: eth0
    version: 2

配置修改前已备份至：/etc/netplan/50-cloud-init.yaml.bak.20260701_223916

5.2 配置验证命令

# 1. 语法校验（无输出即通过）
sudo netplan generate

# 2. 应用配置
sudo netplan apply

# 3. 查看当前生效的 DNS
resolvectl dns
# 期望输出：Link 2 (eth0): 100.90.90.90 100.90.90.100

# 4. 查看 /etc/resolv.conf
cat /etc/resolv.conf | grep nameserver
# 期望输出：
#   nameserver 100.90.90.90
#   nameserver 100.90.90.100

---

六、加速效果实测（配置前后对比）

6.1 DNS 解析速度

域名	配置前	配置后	提升
huggingface.co	7 ms	0 ms	✅
github.com	3 ms	0 ms	✅
pytorch.org	487 ms	0 ms	✅ 显著
nvidia.com	-	0 ms	✅
nvcr.io	-	0 ms	✅

6.2 解析路由（已接入加速网关）

加速域名均被解析到内网加速节点：

huggingface.co  -> 10.60.132.229   (优云加速网关)
github.com      -> 10.60.132.229
pytorch.org     -> 10.60.132.229
nvcr.io         -> 10.60.132.229

6.3 实际下载测试（GitHub raw 文件）

下载大小 : 916,147 bytes (~896 KB)
总耗时   : 0.88 s
平均速度 : ~1.04 MB/s
DNS解析  : 0.7 ms
连接时间 : 1.8 ms

6.4 加速节点连通性

ping 10.60.132.229
4 packets transmitted, 4 received, 0% packet loss
rtt min/avg/max = 0.186 / 0.302 / 0.588 ms   (内网级延迟)

结论：DNS 切换、加速路由、下载链路均已正常工作，0 丢包。

---

七、日常验证与排障

7.1 快速自检脚本

# 检查当前 DNS 是否为加速服务器
echo "当前 DNS："; resolvectl dns
# 检查加速域名是否解析到加速网关
for d in huggingface.co github.com pytorch.org nvcr.io; do
  printf "%-18s -> %s\n" "$d" "$(dig +short $d | head -1)"
done

7.2 常见问题

现象	原因	解决
重启后 DNS 变回旧地址	仅做了临时修改（方式 A）	改用方式 B 持久化配置
netplan apply 报 Open vSwitch 警告	未启用 OVS，可忽略	不影响使用
修改后无法解析任何域名	DNS 地址填写错误	核对为 100.90.90.90 / 100.90.90.100
非加速域名解析变慢	正常现象	仅支持域名列表内的加速，其他域名走常规解析

---

八、回滚方法

如需恢复原始 DNS 配置：

# 从备份还原
sudo cp /etc/netplan/50-cloud-init.yaml.bak.20260701_223916 /etc/netplan/50-cloud-init.yaml
sudo netplan apply

# 验证已恢复为 100.65.128.2 / 100.65.128.3 / 114.114.114.114
resolvectl dns