1. 網(wǎng)絡(luò)配置簡(jiǎn)介

本文檔介紹了系統(tǒng)的網(wǎng)絡(luò)基礎(chǔ)配置。另外為了解決在程序中修改網(wǎng)絡(luò)配置需求，我們也提供使用yaml-cpp庫(kù)修改網(wǎng)絡(luò)配置的簡(jiǎn)單示例。

1.1 netplan與yaml文件

1.1.1 背景

本分析系統(tǒng)運(yùn)行環(huán)境采用的是Ubuntu22.04系統(tǒng)。由于Ubuntu從18.04版本不再使用 ifupdown 配置網(wǎng)絡(luò)，而改用 netplan，所以在 /etc/network/interfaces 配置固定IP是無(wú)效的，必須在/etc/netplan/xxxx.yaml中進(jìn)行網(wǎng)絡(luò)配置，即我們需要了解yaml文件的基礎(chǔ)語(yǔ)法。

1.1.2 語(yǔ)法基礎(chǔ)及注意事項(xiàng)

以下語(yǔ)法并不包含YAML的所有語(yǔ)法，只說(shuō)明網(wǎng)絡(luò)配置中所需語(yǔ)法。更詳細(xì)的語(yǔ)法知識(shí)請(qǐng)參考YAML官網(wǎng)：https://yaml.org/

l 數(shù)據(jù)結(jié)構(gòu)采用鍵值對(duì)的形式，即（鍵名稱: 值），注意冒號(hào)后面要有空格。

l 數(shù)組有兩種表達(dá)方式，例如配置雙ip地址時(shí)每個(gè)元素單獨(dú)一行，并以（- ）開頭；配置DNS時(shí)使用方括號(hào)，元素用逗號(hào)隔開。如下圖所示。

l 使用縮進(jìn)表示層級(jí)關(guān)系，縮進(jìn)使用空格不推薦使用 tab，因?yàn)樵诓煌到y(tǒng) tab 長(zhǎng)度可能不一樣。

l 字母大小寫敏感。

1.2 以太網(wǎng)卡使用操作

1.2.1 網(wǎng)口接線

1.2.2 修改以太網(wǎng)配置

用以下命令查看開發(fā)板網(wǎng)絡(luò)配置存放路徑，會(huì)發(fā)現(xiàn)有4個(gè)配置文件。其中50-eth0-init.yaml是【NET0】相關(guān)的netplan配置，51-eth1-init.yaml是【NET1】相關(guān)的netplan配置。

ls /etc/netplan/

內(nèi)容如下：

關(guān)于【DHCP】和【靜態(tài)IP】分別的配置細(xì)節(jié)說(shuō)明，如下圖所示：

注意：無(wú)論是【DHCP】還是【靜態(tài)IP】，均需要插上網(wǎng)線才能生效，ifconfig那里才能查到配下去的IP地址。

網(wǎng)絡(luò)配置既可以分開寫，也可以寫在同一個(gè)yaml文件里。下面是一個(gè)把NET0和NET1寫在一起（99_config.yaml），并且把eth0配置成DHCP，把eth1配置成靜態(tài)IP的示例：

如果對(duì)yaml進(jìn)行過(guò)了修改，則需要執(zhí)行下方命令進(jìn)行更新：

sudo netplan generate sudo netplan apply

2. 快速上手

2.1 開發(fā)環(huán)境準(zhǔn)備

如果您初次閱讀此文檔，請(qǐng)閱讀《入門指南/開發(fā)環(huán)境準(zhǔn)備/Easy-Eai編譯環(huán)境準(zhǔn)備與更新》，并按照其相關(guān)的操作，進(jìn)行編譯環(huán)境的部署。

在PC端Ubuntu系統(tǒng)中執(zhí)行run腳本，進(jìn)入EASY-EAI編譯環(huán)境，具體如下所示。

cd ~/develop_environment ./run.sh

2.2 源碼下載以及例程編譯

首先，在虛擬機(jī)后臺(tái)終端，執(zhí)行以下命令，創(chuàng)建外設(shè)單例源碼管理目錄：

cd /opt mkdir -p EASY-EAI-Nano-TB/demo

首先，到【百度網(wǎng)盤】上下載相關(guān)的單例程序：

鏈接：https://pan.baidu.com/s/1Br608Hiff2Xs65PzWO_qWQ?pwd=1234

提取碼：1234

比如把單例程序下載到：此電腦\D:\BaiduNetdisk (無(wú)規(guī)定，用戶可自主選擇)，如下圖所示。

再將下載好的單例復(fù)制進(jìn)入虛擬機(jī)的文件系統(tǒng)，過(guò)程如下圖所示。

最后，進(jìn)入到對(duì)應(yīng)的例程目錄執(zhí)行編譯操作，具體命令如下所示：

cd EASY-EAI-Nano-TB/demo/01_network ./build.sh

注：* 由于依賴庫(kù)部署在板卡上，因此交叉編譯過(guò)程中必須保持/mnt掛載。

若有以下報(bào)錯(cuò)則需要在【開發(fā)板上】安裝一下libyaml-cpp-dev庫(kù)

sudo apt-get install libyaml-cpp-dev

2.3 例程運(yùn)行

通過(guò)串口調(diào)試或ssh調(diào)試，進(jìn)入板卡后臺(tái)，定位到例程部署的位置，如下所示：

cd /userdata

運(yùn)行例程命令如下所示：

./test-ethernet

此demo的效果是把eth0的配置修改成【靜態(tài)IP：192.168.1.170】，如果編譯環(huán)境mount的是eth0或者是通過(guò)ssh調(diào)試，且之前DHCP到的IP不是192.168.1.170，此例程執(zhí)行完畢后，所有鏈接會(huì)被斷開。

2.4 運(yùn)行效果

執(zhí)行效果如下所示。

配置文件也同時(shí)被修改了：

3. 操作例程

例程位于01_network/test-ethernet/main.cpp。

3.1 例程源碼

以下代碼展示了設(shè)置eth0的ip地址、DNS、網(wǎng)關(guān)參數(shù)的使用案例，供用戶編碼參考：

int main() { // 加載YAML文件 YAML::Node config = YAML::LoadFile("/etc/netplan/50-eth0-init.yaml"); // =====================修改eth0的參數(shù)========================== //把DHCP禁用 config["network"]["ethernets"]["eth0"]["dhcp4"] = "false"; // 修改eth0的IP地址 //方式1：固定寫入第一個(gè)位置 config["network"]["ethernets"]["eth0"]["addresses"][0] = "192.168.1.170/24"; //方式2：追加插入 // 輸入 IP 地址和子網(wǎng)掩碼 std::string eth0_ip_str = "192.168.1.171"; std::string eth0_mask_str = "255.255.255.0"; std::string eth0_cidr = mask_transition_cidr(eth0_ip_str, eth0_mask_str); //config["network"]["ethernets"]["eth0"]["addresses"].push_back(eth0_cidr); // 修改eth0的DNS地址 YAML::Node addresses_eht0_dns = YAML::Load("[8.8.8.8,8.8.4.4]");//[8.8.8.8, 8.8.4.4]這是一個(gè)序列，需要轉(zhuǎn)換 config["network"]["ethernets"]["eth0"]["nameservers"]["addresses"] = addresses_eht0_dns; // 修改eth0的routes地址 config["network"]["ethernets"]["eth0"]["routes"][0]["to"] = "0.0.0.0/0"; config["network"]["ethernets"]["eth0"]["routes"][0]["via"] = "192.168.1.1"; config["network"]["ethernets"]["eth0"]["routes"][0]["metric"] = "100"; #if 0 // =====================修改eth1的參數(shù)========================= config["network"]["ethernets"]["eth1"]["dhcp4"] = "false"; //方式1：固定寫入第一個(gè)位置 config["network"]["ethernets"]["eth1"]["addresses"][0] = "192.168.1.172/24"; //方式2：追加插入 //std::string eth1_ip_str = "192.168.1.171"; //std::string eth1_mask_str = "255.255.255.0"; //std::string eth1_cidr = mask_transition_cidr(eth1_ip_str,eth1_mask_str); //config["network"]["ethernets"]["eth1"]["addresses"].push_back(eth1_cidr); YAML::Node addresses_eht1_dns = YAML::Load("[8.8.8.8,8.8.4.4]"); config["network"]["ethernets"]["eth1"]["nameservers"]["addresses"] = addresses_eht1_dns; config["network"]["ethernets"]["eth1"]["routes"][0]["to"] = "0.0.0.0/0"; config["network"]["ethernets"]["eth1"]["routes"][0]["via"] = "192.168.1.1"; config["network"]["ethernets"]["eth1"]["routes"][0]["metric"] = "150"; #endif // ==============將修改后的YAML文檔寫回到文件中================== std::ofstream fout("/etc/netplan/50-eth0-init.yaml"); fout << config; fout.close(); // =======================重啟網(wǎng)卡=============================== system("sudo netplan generate"); system("sudo netplan apply"); return 0; }