简体中文 | English
IP Assistant is a Qt 6 network configuration switcher for Windows 10 and Windows 11. It stores multiple IPv4, IPv6, and DNS configurations for each network adapter and lets users activate them quickly from the main window or the system tray.
Current version: 1.0.0
License: MIT
Privacy and security:
- Create multiple network profiles for different adapters.
- Configure IPv4 DHCP, static addresses, subnet masks, default gateways, and DNS servers.
- Configure IPv6 automatic addressing, static addresses, prefix lengths, default gateways, and DNS servers.
- Bind profiles to stable adapter GUIDs so renaming an adapter does not break profile activation.
- Fall back to the adapter name when a GUID is no longer available; preserve the profile and show an invalid-adapter warning when neither identifier can be resolved.
- Save the current network state before applying changes, attempt to restore it if any step fails, and return the actual operation result.
- Support Windows startup, the system tray, and 18 interface languages.
The application includes the following languages and selects one on first launch according to the Windows regional settings:
| Language | Locale |
|---|---|
| English | en_US |
| 简体中文 | zh_CN |
| 繁體中文 | zh_TW |
| 日本語 | ja_JP |
| 한국어 | ko_KR |
| Deutsch | de_DE |
| Français | fr_FR |
| Español | es_ES |
| Português (Brasil) | pt_BR |
| Русский | ru_RU |
| Italiano | it_IT |
| Türkçe | tr_TR |
| Polski | pl_PL |
| Bahasa Indonesia | id_ID |
| Tiếng Việt | vi_VN |
| ไทย | th_TH |
| العربية | ar_SA |
| हिन्दी | hi_IN |
The language can be changed immediately in Settings. Arabic automatically
uses a right-to-left layout. Translation sources are stored in
src/translations; Qt Linguist compiles and embeds them during the CMake
build.
The application consists of two processes:
IPAssistant.exe: the graphical interface, running with standard user privileges.IPAssistantService.exe: theIPAssistantSvcWindows service, responsible for network configuration operations that require administrator privileges.
Administrator privileges are required to install the service during setup or first use. Activating a profile afterward does not repeatedly trigger UAC.
IPv4 addresses and DNS servers are configured through Windows
netsh interface commands. Manual IPv6 addresses and routes are configured
through the Windows IP Helper API. Before making changes, the service captures
a snapshot of the current adapter configuration and uses it for rollback if
the operation fails.
Each profile stores:
deviceGuid: the stable binding identifier.deviceName: the current display name and a fallback for legacy data.
Legacy profiles.json data is upgraded automatically to version 2 at startup.
Before upgrading, the application creates a one-time profiles.json.bak in
the same directory. Existing profiles are not deleted.
Windows may assign a new GUID after an adapter driver is uninstalled and reinstalled. IP Assistant then attempts to rebind the profile by its previous adapter name. If the name has also changed, edit the profile and select the adapter again.
Profiles are stored under the application directory:
data/profiles.json
data/profiles.json.bak
Interface preferences are stored for the current user through QSettings in
the Windows registry. The uninstaller preserves the data directory by
default so profiles remain available after an upgrade or reinstall.
Requirements:
- Windows 10/11 x64
- Qt 6.5 or later (Core, Gui, Widgets, Network, and Test)
- CMake 3.16 or later
- MinGW 13.x or a compatible MSVC toolchain
Example:
cmake -S . -B build `
-G "MinGW Makefiles" `
-DCMAKE_PREFIX_PATH="C:\Qt\6.9.1\mingw_64" `
-DCMAKE_BUILD_TYPE=Release `
-DBUILD_TESTING=ON
cmake --build build -j 4
ctest --test-dir build --output-on-failureThe build invokes Qt Linguist lrelease automatically, compiles the 17
non-English .ts files to .qm, and embeds them in IPAssistant.exe. After
adding or changing translatable source text, update a translation with:
& "C:\Qt\6.9.1\mingw_64\bin\lupdate.exe" `
src `
-no-obsolete `
-locations none `
-ts src\translations\ipassistant_zh_CN.tsMain outputs:
build/IPAssistant.exe
build/IPAssistantService.exe
build/ProfileBindingTests.exe
Before packaging, deploy the Qt DLLs and plugins into build with
windeployqt:
& "C:\Qt\6.9.1\mingw_64\bin\windeployqt.exe" `
--release `
--compiler-runtime `
build\IPAssistant.exeThe installer uses Inno Setup 6:
ISCC.exe installer\IPAssistant.issOutput:
installer/Output/IPAssistantSetup-1.0.0.exe
The installer:
- Stops the previous
IPAssistantSvc. - Updates the GUI, service, and Qt runtime.
- Removes the old service registration, then installs and starts the new service.
- Creates a desktop shortcut when selected by the user.
During uninstall, it closes the GUI before stopping and removing the service.
The installer wizard supports English, Simplified Chinese, Japanese, Korean, German, French, Spanish, Brazilian Portuguese, Russian, Italian, Turkish, Polish, Thai, and Arabic. The wizard falls back to English on Traditional Chinese, Indonesian, Vietnamese, and Hindi systems, while the installed application still uses the corresponding interface language.
.
├── CMakeLists.txt
├── IPAssistant.pro # Optional qmake project for the GUI
├── LICENSE # MIT License
├── PRIVACY.md # Privacy Policy
├── SECURITY.md # Vulnerability reporting policy
├── README.md # English README
├── README_CN.md # Simplified Chinese README
├── .github/workflows/ # Automated GitHub Release build
├── .signpath/ # SignPath policies and artifact constraints
├── installer/ # Inno Setup installer script
├── src/
│ ├── core/ # Profiles, persistence, adapters, and core calls
│ ├── service/ # Windows service, network changes, and rollback
│ ├── ui/ # Main window, profile editor, settings, and About
│ ├── translations/ # 17 non-English Qt Linguist source files
│ └── resources/ # Icons and Windows resources
└── tests/ # GUID binding and compatibility tests
- Switching network configurations may briefly interrupt the current connection.
- Static IP, gateway, and DNS values must be valid for the target network.
- If rollback also fails, the application explicitly reports the rollback failure. Check the adapter state in Windows network settings.
Copyright © 2026 Jiugang He.
IP Assistant is licensed under the MIT License.