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

> 配置日期：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：临时修改（立即生效，重启后失效）

```bash
sudo vim /etc/resolv.conf
```

删除原有 `nameserver` 行，添加：

```text
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 配置文件：

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

找到 `nameservers:` 区域，修改为：

```yaml
nameservers:
    addresses:
    - 100.90.90.90
    - 100.90.90.100
```

保存并立即生效：

```bash
sudo netplan apply
```

---

## 五、本机实际配置记录

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

```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 配置验证命令

```bash
# 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 解析路由（已接入加速网关）

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

```text
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 文件）

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

### 6.4 加速节点连通性

```text
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 快速自检脚本

```bash
# 检查当前 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 配置：

```bash
# 从备份还原
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
```