You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

ESP32单网络接口配置多IP地址的实现方法咨询

avatar
开发者阿泽
2026-7-18
问题

在Windows/Linux系统中，单个网络接口可配置多个IP地址。现需为ESP32的Wi-Fi热点或以太网接口配置静态IP及DHCP服务，同时实现单接口双IP：

  • 192.168.4.1为固定IP，用于访问ESP32的Web配置界面
  • 192.168.4.2用于电脑端程序与ESP32的数据交互，该IP需支持通过命令修改

当前已实现Wi-Fi热点+DHCP服务的代码如下：

#include <stdio.h>
#include <stdbool.h>
#include <unistd.h>
#include <arpa/inet.h>
#include <stdio.h>
#include <string.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_netif.h"
#include "esp_eth.h"
#include "esp_event.h"
#include "esp_log.h"
#include "driver/gpio.h"
#include "./sdkconfig.h"
#include "esp_wifi.h"
#include "nvs_flash.h"
#include <esp_netif.h>
#include <esp_eth.h>

static const char *TAG = "eth_example";
esp_netif_t* esp_netif_ap=0;//Wi-Fi

static void wifi_event_handler(void* arg, esp_event_base_t event_base,
                                    int32_t event_id, void* event_data)
{
    if (event_id == WIFI_EVENT_AP_STACONNECTED) {
        wifi_event_ap_staconnected_t* event = (wifi_event_ap_staconnected_t*) event_data;
        ESP_LOGI(TAG, "station "MACSTR" join, AID=%d",
                 MAC2STR(event->mac), event->aid);
    } else if (event_id == WIFI_EVENT_AP_STADISCONNECTED) {
        wifi_event_ap_stadisconnected_t* event = (wifi_event_ap_stadisconnected_t*) event_data;
        ESP_LOGI(TAG, "station "MACSTR" leave, AID=%d",
                 MAC2STR(event->mac), event->aid);
    }
}

void wifi_init_softap(void)
{
    esp_netif_ap=esp_netif_create_default_wifi_ap();

    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
    ESP_ERROR_CHECK(esp_wifi_init(&cfg));

    ESP_ERROR_CHECK(esp_event_handler_instance_register(WIFI_EVENT,
                                                        ESP_EVENT_ANY_ID,
                                                        &wifi_event_handler,
                                                        NULL,
                                                        NULL));

    wifi_config_t wifi_config = {
        .ap = {
            .ssid = CONFIG_EXAMPLE_WIFI_SSID,
            .ssid_len = strlen(CONFIG_EXAMPLE_WIFI_SSID),
            .channel = CONFIG_EXAMPLE_WIFI_CHANNEL,
            .password = CONFIG_EXAMPLE_WIFI_PASSWORD,
            .max_connection = CONFIG_EXAMPLE_MAX_STA_CONN,
            .authmode = WIFI_AUTH_WPA_WPA2_PSK
        },
    };
    if (strlen(CONFIG_EXAMPLE_WIFI_PASSWORD) == 0) {
        wifi_config.ap.authmode = WIFI_AUTH_OPEN;
    }

    ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_AP));
    ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_AP, &wifi_config));
    
    //stop DHCP
    esp_netif_dhcp_status_t DHCPStatus;
    esp_netif_dhcps_get_status(esp_netif_ap,&DHCPStatus);
    if (DHCPStatus!=ESP_NETIF_DHCP_STOPPED){
        ESP_ERROR_CHECK(esp_netif_dhcps_stop(esp_netif_ap));
    }

    //Set static IP
    esp_netif_ip_info_t ip_info;
    IP4_ADDR(&ip_info.ip, 192, 168, 4, 1);
    IP4_ADDR(&ip_info.gw, 192, 168, 4, 1);
    IP4_ADDR(&ip_info.netmask, 255, 255, 255, 0);
    ESP_ERROR_CHECK(esp_netif_set_ip_info(esp_netif_ap, &ip_info));

    //Start DHCP
    ESP_ERROR_CHECK(esp_netif_dhcps_start(esp_netif_ap));
    
    //Start Wi-Fi
    ESP_ERROR_CHECK(esp_wifi_start());

    ESP_LOGI(TAG, "wifi_init_softap finished. SSID:%s password:%s channel:%d",
             CONFIG_EXAMPLE_WIFI_SSID, CONFIG_EXAMPLE_WIFI_PASSWORD, CONFIG_EXAMPLE_WIFI_CHANNEL);
             
}

void app_main() {
    //Initialize NVS
    esp_err_t ret = nvs_flash_init();
    if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND) {
      ESP_ERROR_CHECK(nvs_flash_erase());
      ret = nvs_flash_init();
    }
    ESP_ERROR_CHECK(ret);

    // Initialize TCP/IP network interface (should be called only once in application)
    ESP_ERROR_CHECK(esp_netif_init());
    // Create default event loop that running in background
    ESP_ERROR_CHECK(esp_event_loop_create_default());//цикл событий

    wifi_init_softap();//Wi-Fi
}

尝试为以太网配置第二个netif时失败并报错，特此咨询实现方法。

解决方案

ESP-IDF的esp_netif组件支持为单个网络接口绑定多个IP地址，不需要创建多个esp_netif实例（这也是你之前尝试以太网时失败的核心原因）。核心是通过esp_netif_add_ip_address()接口添加额外IP，而非重复创建netif对象。

一、Wi-Fi AP双IP实现步骤

  1. 完成基础Wi-Fi AP初始化，设置固定主IP（192.168.4.1）并启动DHCP服务
  2. 调用esp_netif_add_ip_address()添加第二个静态IP（192.168.4.2）
  3. 实现动态修改第二个IP的接口：修改前先调用esp_netif_remove_ip_address()移除旧IP，再添加新IP

二、以太网双IP实现步骤

以太网的实现逻辑与Wi-Fi完全一致，仅初始化接口流程不同：

  1. 创建默认以太网netif实例
  2. 设置主IP（192.168.4.1）并配置DHCP服务
  3. 使用esp_netif_add_ip_address()添加第二个静态IP

三、修改后的Wi-Fi AP代码示例（含动态IP修改） 

#include <stdio.h>
#include <stdbool.h>
#include <unistd.h>
#include <arpa/inet.h>
#include <stdio.h>
#include <string.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_netif.h"
#include "esp_eth.h"
#include "esp_event.h"
#include "esp_log.h"
#include "driver/gpio.h"
#include "./sdkconfig.h"
#include "esp_wifi.h"
#include "nvs_flash.h"
#include <esp_netif.h>
#include <esp_eth.h>

static const char *TAG = "wifi_ap_multi_ip";
esp_netif_t* esp_netif_ap = NULL;
// 保存当前的额外IP信息
esp_netif_ip_info_t extra_ip_info;

static void wifi_event_handler(void* arg, esp_event_base_t event_base,
                                    int32_t event_id, void* event_data)
{
    if (event_id == WIFI_EVENT_AP_STACONNECTED) {
        wifi_event_ap_staconnected_t* event = (wifi_event_ap_staconnected_t*) event_data;
        ESP_LOGI(TAG, "station "MACSTR" join, AID=%d",
                 MAC2STR(event->mac), event->aid);
    } else if (event_id == WIFI_EVENT_AP_STADISCONNECTED) {
        wifi_event_ap_stadisconnected_t* event = (wifi_event_ap_stadisconnected_t*) event_data;
        ESP_LOGI(TAG, "station "MACSTR" leave, AID=%d",
                 MAC2STR(event->mac), event->aid);
    }
}

// 动态修改额外IP的函数
esp_err_t update_extra_ip(uint8_t ip1, uint8_t ip2, uint8_t ip3, uint8_t ip4) {
    if (!esp_netif_ap) {
        return ESP_ERR_INVALID_STATE;
    }

    // 移除旧的额外IP
    if (extra_ip_info.ip.addr != 0) {
        ESP_ERROR_CHECK(esp_netif_remove_ip_address(esp_netif_ap, &extra_ip_info.ip, &extra_ip_info.netmask));
    }

    // 设置新的额外IP信息（需与主IP同子网）
    IP4_ADDR(&extra_ip_info.ip, ip1, ip2, ip3, ip4);
    IP4_ADDR(&extra_ip_info.gw, 192, 168, 4, 1); // 网关与主IP一致
    IP4_ADDR(&extra_ip_info.netmask, 255, 255, 255, 0);

    // 添加新的额外IP
    return esp_netif_add_ip_address(esp_netif_ap, &extra_ip_info.ip, &extra_ip_info.netmask);
}

void wifi_init_softap(void)
{
    esp_netif_ap = esp_netif_create_default_wifi_ap();

    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
    ESP_ERROR_CHECK(esp_wifi_init(&cfg));

    ESP_ERROR_CHECK(esp_event_handler_instance_register(WIFI_EVENT,
                                                        ESP_EVENT_ANY_ID,
                                                        &wifi_event_handler,
                                                        NULL,
                                                        NULL));

    wifi_config_t wifi_config = {
        .ap = {
            .ssid = CONFIG_EXAMPLE_WIFI_SSID,
            .ssid_len = strlen(CONFIG_EXAMPLE_WIFI_SSID),
            .channel = CONFIG_EXAMPLE_WIFI_CHANNEL,
            .password = CONFIG_EXAMPLE_WIFI_PASSWORD,
            .max_connection = CONFIG_EXAMPLE_MAX_STA_CONN,
            .authmode = WIFI_AUTH_WPA_WPA2_PSK
        },
    };
    if (strlen(CONFIG_EXAMPLE_WIFI_PASSWORD) == 0) {
        wifi_config.ap.authmode = WIFI_AUTH_OPEN;
    }

    ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_AP));
    ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_AP, &wifi_config));
    
    // 停止DHCP服务
    esp_netif_dhcp_status_t DHCPStatus;
    esp_netif_dhcps_get_status(esp_netif_ap, &DHCPStatus);
    if (DHCPStatus != ESP_NETIF_DHCP_STOPPED) {
        ESP_ERROR_CHECK(esp_netif_dhcps_stop(esp_netif_ap));
    }

    // 设置主静态IP（192.168.4.1）
    esp_netif_ip_info_t main_ip_info;
    IP4_ADDR(&main_ip_info.ip, 192, 168, 4, 1);
    IP4_ADDR(&main_ip_info.gw, 192, 168, 4, 1);
    IP4_ADDR(&main_ip_info.netmask, 255, 255, 255, 0);
    ESP_ERROR_CHECK(esp_netif_set_ip_info(esp_netif_ap, &main_ip_info));

    // 添加第二个静态IP（192.168.4.2）
    ESP_ERROR_CHECK(update_extra_ip(192, 168, 4, 2));

    // 启动DHCP服务
    ESP_ERROR_CHECK(esp_netif_dhcps_start(esp_netif_ap));
    
    // 启动Wi-Fi
    ESP_ERROR_CHECK(esp_wifi_start());

    ESP_LOGI(TAG, "wifi_init_softap finished. SSID:%s password:%s channel:%d",
             CONFIG_EXAMPLE_WIFI_SSID, CONFIG_EXAMPLE_WIFI_PASSWORD, CONFIG_EXAMPLE_WIFI_CHANNEL);
    ESP_LOGI(TAG, "Main IP: 192.168.4.1, Extra IP: 192.168.4.2");
             
}

void app_main() {
    // 初始化NVS
    esp_err_t ret = nvs_flash_init();
    if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND) {
      ESP_ERROR_CHECK(nvs_flash_erase());
      ret = nvs_flash_init();
    }
    ESP_ERROR_CHECK(ret);

    // 初始化TCP/IP网络接口（应用中仅需调用一次）
    ESP_ERROR_CHECK(esp_netif_init());
    // 创建默认事件循环
    ESP_ERROR_CHECK(esp_event_loop_create_default());

    wifi_init_softap();

    // 示例：5秒后修改额外IP为192.168.4.100
    vTaskDelay(pdMS_TO_TICKS(5000));
    if (update_extra_ip(192, 168, 4, 100) == ESP_OK) {
        ESP_LOGI(TAG, "Extra IP updated to 192.168.4.100");
    }
}

四、关键注意事项

  • 额外IP必须与主IP处于同一子网，否则无法正常工作
  • 修改IP时必须先移除旧IP，再添加新IP，避免IP冲突
  • DHCP服务仅绑定主IP，不会影响额外IP的使用
  • 以太网场景下，只需将Wi-Fi初始化部分替换为以太网初始化逻辑，双IP配置逻辑完全复用

内容的提问来源于stack exchange，提问作者Vladimir

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级，最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分)， 限时 9.9 元起

产品介绍相关文档
相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级，最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分)， 限时 9.9 元起

产品介绍相关文档
火山引擎 最新活动
全面开放
Doubao-Seedance-2.5全新模型升级

模型再升级,30秒超长叙事, 模态参考扩容

HOT
方舟Codingplan

模型自由，工具不限，最新支持 Deepseek-V4 系列、GLM-5.3 系列

HOT
方舟Agent plan

超全模态模型 × Harness 升级，最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列

HOT
新用户特惠专场

大模型19元起，Al应用9.9元畅享，新人首购爆款尽享优惠

最近更新时间：2026.07.18 05:18:08