NETworkManager源码剖析：一个网络管理工具的实现细节

2026-07-14 约 2200 字预计阅读 5 分钟

/images/202607/15/maverick-frame-GswoB8XDnBc-unsplash.jpg

在 GitHub 闲逛时，我偶然发现了NETworkManager这个开源项目。作为一款网络管理和故障排查工具，它已经积累了超过 8.5k Star，足以说明社区对它的认可。更让我感兴趣的是，这个项目采用 C# + WPF 进行开发，与我当前正在深入学习和实践的技术栈高度契合。因此，我产生了一个想法：通过深入分析 NETworkManager 的源码，探索一个成熟的 WPF 桌面应用是如何进行架构设计、模块划分以及工程实践的。接下来，我将以 NETworkManager 为切入点，逐步拆解它在 WPF UI 设计、MVVM 架构、依赖注入、配置管理、网络通信、异步编程以及工程化实践等方面的实现，希望能够从优秀的开源项目中学习桌面应用开发的最佳实践。

`1`	`git clone --recurse-submodules https://github.com/BornToBeRoot/NETworkManager.git`

将项目Clone到本地，整个解决方案结构如下：

解决方案下包含了多个子项目，说明将实现逻辑进行了合理拆分，进行了模块化设计。

1. NETworkManager启动时，到底发生了什么？

WPF应用生命周期大致如下：

图表代码

          flowchart TD
    A[Application_Startup] --> B[创建Window]
    B --> C[用户正常使用]
    C --> D[Application_Exit]
    D --> E[程序结束]
          flowchart TD
    A[Application_Startup] --> B[创建Window]
    B --> C[用户正常使用]
    C --> D[Application_Exit]
    D --> E[程序结束]
          flowchart TD
    A[Application_Startup] --> B[创建Window]
    B --> C[用户正常使用]
    C --> D[Application_Exit]
    D --> E[程序结束]
        

1
2
3
4
5


flowchart TD
    A[Application_Startup] --> B[创建Window]
    B --> C[用户正常使用]
    C --> D[Application_Exit]
    D --> E[程序结束]

在Visual Studio 2026按F5调试启动后，首先映入眼帘的是启动画面窗口：

接着就会出现隐私政策设置界面：

点击“继续”后就进入到了主界面(仪表盘)：

NETworkManager项目的App.xaml.cs中包含了软件启动时的逻辑，里面主要包含了Application_Startup、OnSessionEnding、Application_Exit和Save等4个方法。

Application_Startup

设置了全局异常捕获：

1
2
3
4
5
6


AppDomain.CurrentDomain.UnhandledException += (_, args) =>
{
    Log.Fatal("Unhandled exception occured!");

    Log.Fatal($"Exception raised by: {args.ExceptionObject}");
};

等待旧进程退出：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


if (CommandLineManager.Current.RestartPid != -1)
{
    Log.Info(
        $"Waiting for another NETworkManager process with Pid {CommandLineManager.Current.RestartPid} to exit...");

    var processList = Process.GetProcesses();
    var process = processList.FirstOrDefault(x => x.Id == CommandLineManager.Current.RestartPid);
    process?.WaitForExit();

    Log.Info($"NETworkManager process with Pid {CommandLineManager.Current.RestartPid} has been exited.");
}

单实例检测：

1

_mutex = new Mutex(true, "{" + Guid + "}");

防止用户点击两次exe，两个程序运行。第一次创建Mutex成功，第二次创建Mutex失败。于是：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


var mutexIsAcquired = _mutex.WaitOne(TimeSpan.Zero, true);

Log.Info($"Mutex value for {Guid} is {mutexIsAcquired}");

// Release mutex
if (mutexIsAcquired)
    _mutex.ReleaseMutex();

// If another instance is running, bring it to the foreground
if (!mutexIsAcquired && !SettingsManager.Current.Window_MultipleInstances)
{
    // Bring the already running application into the foreground
    Log.Info(
        "Another NETworkManager process is already running. Trying to bring the window to the foreground...");
    SingleInstance.PostMessage(SingleInstance.HWND_BROADCAST, SingleInstance.WM_SHOWME, IntPtr.Zero,
        IntPtr.Zero);

    // Close the application                
    _singleInstanceClose = true;
    Shutdown();

    return;
}

接下来会显示启动画面窗口和主窗口：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


// Show splash screen
if (SettingsManager.Current.SplashScreen_Enabled)
{
    Log.Info("Show SplashScreen while application is loading...");
    new SplashScreen(@"SplashScreen.png").Show(true, true);
}

// Show main window
Log.Info("Set StartupUri to MainWindow.xaml...");
StartupUri = new Uri("MainWindow.xaml", UriKind.Relative);

启动流程如下：

图表代码

          flowchart TD
    A[Application_Startup] --> B[启动日志]
    B --> C[异常捕获]
    C --> D[检查旧实例]
    D --> E[加载Policy]
    E --> F[加载Settings]
    F --> G[升级配置]
    G --> H[初始化语言]
    H --> I[单实例检测]
    I --> J[启动后台任务]
    J --> K[调整线程池]
    K --> L[SplashScreen]
    L --> M[MainWindow]
          flowchart TD
    A[Application_Startup] --> B[启动日志]
    B --> C[异常捕获]
    C --> D[检查旧实例]
    D --> E[加载Policy]
    E --> F[加载Settings]
    F --> G[升级配置]
    G --> H[初始化语言]
    H --> I[单实例检测]
    I --> J[启动后台任务]
    J --> K[调整线程池]
    K --> L[SplashScreen]
    L --> M[MainWindow]
          flowchart TD
    A[Application_Startup] --> B[启动日志]
    B --> C[异常捕获]
    C --> D[检查旧实例]
    D --> E[加载Policy]
    E --> F[加载Settings]
    F --> G[升级配置]
    G --> H[初始化语言]
    H --> I[单实例检测]
    I --> J[启动后台任务]
    J --> K[调整线程池]
    K --> L[SplashScreen]
    L --> M[MainWindow]
        

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


flowchart TD
    A[Application_Startup] --> B[启动日志]
    B --> C[异常捕获]
    C --> D[检查旧实例]
    D --> E[加载Policy]
    E --> F[加载Settings]
    F --> G[升级配置]
    G --> H[初始化语言]
    H --> I[单实例检测]
    I --> J[启动后台任务]
    J --> K[调整线程池]
    K --> L[SplashScreen]
    L --> M[MainWindow]

Policy从exe所在目录的config.json加载，而LocalSettings从用户家目录\\AppData\\Local\\NETworkManager\\Settings.json文件加载，Settings从用户家目录\\Documents\\NETworkManager\\Settings\\Settings.json文件加载。

Application_Exit

Application_Exit会在应用退出时调用，主要调用了Save，在退出时保存程序设置和配置文件。

Save

Save如果检测到更改，会保存应用程序设置和配置文件数据。

OnSessionEnding

OnSessionEnding会在Windows注销或者Windows关机时被调用。

2. 日志保存在什么位置？

NETworkerManager使用的是log4net日志库。在项目的根目录下有一个log4net.config文件用于配置日志：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24


<log4net>
    <root>
        <!-- Log level: ALL, DEBUG, INFO, WARN, ERROR, FATAL, OFF -->
        <level value="INFO"/>        
        <appender-ref ref="console"/>
        <appender-ref ref="file"/>
    </root>
    <appender name="console" type="log4net.Appender.ConsoleAppender">
        <layout type="log4net.Layout.PatternLayout">
            <conversionPattern value="%date [%thread] %-5level %logger - %message%newline"/>
        </layout>
    </appender>
    <appender name="file" type="log4net.Appender.RollingFileAppender">
        <file value="${LocalAppData}\\NETworkManager\NETworkManager.log"/>
        <appendToFile value="true"/>
        <rollingStyle value="Size"/>
        <maxSizeRollBackups value="5"/>
        <maximumFileSize value="10MB"/>
        <staticLogFileName value="true"/>
        <layout type="log4net.Layout.PatternLayout">
            <conversionPattern value="%date [%thread] %-5level %logger - %message%newline"/>
        </layout>
    </appender>
</log4net>

日志保存在${LocalAppData}\\NETworkManager目录中。

3. 仪表盘界面中的IP地址是如何获取的？

如4所示，仪表盘界面中的IPv4、IPv6以及DNS地址是如何获取的呢？ViewModels/NetworkConnectionWidgetViewModel.cs可以找到答案。