Maikr Pro 1.0.0 — Installation & Setup / 安装与运行手册

Read this before installing. Maikr Pro installs a kernel-mode network driver and reroutes your computer's internet traffic. It needs administrator rights every time it runs. If a bug occurs, you can temporarily lose internet access — recovery is covered in section 7.

Please install on a machine you can afford to disrupt, not your only work computer.

Contents
  1. Requirements
  2. Before you install
  3. Installing
  4. First launch
  5. Running day to day
  6. Caveats & known limitations
  7. If your internet stops working
  8. Troubleshooting
  9. Uninstalling
  10. Logs & privacy

1. Requirements

Operating system64-bit Windows 10 or Windows 11. 32-bit and Arm builds are not provided.
PrivilegesAdministrator. This is mandatory, not optional — see below.
Disk spaceRoughly 100 MB.
InternetRequired during installation. If your PC lacks the Microsoft WebView2 runtime, the installer downloads it silently. Most Windows 11 machines already have it.
Installer fileMaikr Pro_1.0.0_x64-setup.exe — this is the only file you need. If you were sent anything else, please ask us before running it.

2. Before you install — what this app does to your machine

Upgrading from an older build? Earlier versions were named ngrouter. Uninstall that entry first (Settings → Apps → Installed apps → ngrouter → Uninstall) so its own uninstaller removes its files and logs, then install this one.

3. Installing

  1. Close any previous version that is running. Right-click its tray icon and choose Quit Maikr Pro.
  2. Double-click Maikr Pro_1.0.0_x64-setup.exe.
  3. Windows SmartScreen will likely show "Windows protected your PC". Click More info, then Run anyway.
  4. Approve the User Account Control prompt. It will describe the publisher as unknown.
  5. Accept the default install location and complete the wizard.

Re-installing over an existing copy is supported. The installer automatically stops the running engines and unloads the network driver first. Without this, Windows would refuse to overwrite the driver file, because a loaded kernel driver's file stays locked even after the app closes.

What the installer adds

4. First launch

  1. Start Maikr Pro from the Start Menu.
  2. Approve the UAC prompt.
  3. Sign in with the account you were given.
  4. Select a server.
  5. Turn the VPN switch on and wait for it to settle on "connected", with a timer counting beside it.

A healthy first launch looks like this:

  • The main window opens.
  • No black console window appears behind it.
  • A Maikr Pro icon appears in the notification area (bottom-right; you may need the ^ arrow to reveal it).

If any of those three is wrong, that is worth reporting even if the app otherwise seems to work.

Confirming traffic really goes through the tunnel

  1. Visit any "what is my IP" site.
  2. It should report the server's location, not yours.
  3. Browse a few sites you use daily.
  4. Switch off. Your IP should return to normal and browsing should still work.

5. Running day to day

StartingStart Menu → Maikr Pro. Approve UAC each time.
Closing the windowThe X button does not quit — the app minimises to the tray and keeps running. It tells you this once.
ReopeningClick the tray icon, or right-click it → Open Dashboard.
Quitting properlyRight-click the tray icon → Quit Maikr Pro. This is the only action that fully exits.
Launching twiceRunning it again just focuses the existing window. A second copy never starts.

The tray menu

Right-clicking the notification-area icon gives four items. The tray is drawn by Windows itself, so it keeps working even if the app window has frozen:

After an Emergency Stop you must use Restart Engines before the VPN switch will work again. Flipping the switch first simply tells you to restart the engines.

6. Caveats & known limitations

Administrator rights are required on every launch. There is no way to run Maikr Pro unelevated. If your organisation's policy blocks elevation, or you use a standard (non-administrator) Windows account, the app cannot run at all.

A consequence: because the app runs elevated, tasklist and some tools in a normal command prompt cannot see its engine processes.

7. If your internet stops working

Because the app reroutes traffic, a bug can leave you without internet. There are two escape hatches, and neither needs the main window — important, since a network problem may be exactly what makes the window unusable.

First: Emergency Stop from the tray

Right-click the Maikr Pro icon in the notification area (bottom-right; the ^ arrow may hide it) and choose Emergency Stop (restore network). This shuts down the engines and returns your network immediately.

Second: the Start Menu shortcut

If the app is so stuck that even the tray menu does not respond, search the Start Menu for Maikr Pro Emergency Stop and run it. It requests administrator rights, ends the engine processes and unloads the capture driver.

Neither action changes any Windows network setting, because Maikr Pro never modified one. There is nothing to undo — stopping the engines is the entire fix.

If it is still broken

  1. Quit properly — tray icon → Quit Maikr Pro.
  2. If unresponsive: Ctrl+Shift+Esc → Task Manager → end Maikr Pro.exe. The engine processes are designed to die with it automatically. If you still see maikr-engine.exe afterwards, that is a bug worth reporting.
  3. Reboot. Nothing this app does survives a restart.
  4. Last resort: uninstall (section 9), then reboot.

Manual recovery, only if the steps above all fail. Open an administrator Command Prompt and run:

taskkill /F /T /IM maikr-engine.exe
sc stop WinDivert
sc delete WinDivert
ipconfig /flushdns

The driver service is re-created automatically the next time the app captures traffic.

8. Troubleshooting

The installer fails with "Error opening file for writing"

An engine or the driver is still active. Quit Maikr Pro from the tray, then run Maikr Pro Emergency Stop from the Start Menu, then install again. If it persists, reboot and install before starting the app.

Antivirus blocks or quarantines it

Please tell us which product and what it said — that is genuinely useful, as we need these detections cleared before a wider release. Symptoms of a quarantined file: an error dialog naming something missing, or the VPN switch doing nothing when flipped.

If you wish to proceed, add an exclusion for C:\Program Files\Maikr Pro. Only do this if you are comfortable doing so; declining and simply reporting the detection is entirely reasonable.

The app opens but the switch does nothing

Usually a missing file (see antivirus above) or the driver failing to load. Try Restart Engines from the tray. If that fails, reboot and try again, then report it.

A black console window flashes or stays open

That should not happen — please report it, with a screenshot if you can capture one.

Connected, but a specific site will not load

Note whether it works with the switch off. If it is an IPv6-only service, see the IPv6 caveat in section 6. Report the exact address.

Reporting a problem

Please include, in this order:

  1. What you did, step by step, and what happened instead of what you expected.
  2. When it happened — an approximate timestamp helps us find it in the log.
  3. Your Windows version — press Win+R, type winver, press Enter, screenshot the result.
  4. A screenshot of any error message or banner.
  5. A diagnostics file — only if we ask for one.

9. Uninstalling

Settings → Apps → Installed apps → Maikr Pro → Uninstall, or run uninstall.exe from C:\Program Files\Maikr Pro.

The uninstaller stops the engines, unregisters the WinDivert kernel driver, and deletes the application together with its logs.

Please verify afterwards — this is a genuine test:

  1. C:\Program Files\Maikr Pro is gone.
  2. Win+R, paste %LOCALAPPDATA%\com.maikrapps.win — Windows should say the folder does not exist.
  3. The Maikr Pro Emergency Stop Start Menu shortcut is gone.
  4. Your internet works normally, including after a reboot.

If any of those fail, please tell us — leftover state after uninstall is a bug we specifically want to catch.

10. Logs & privacy

Logs are written to %LOCALAPPDATA%\com.maikrapps.win\logs. Paste that path into Win+R to open the folder.

By default the log is quiet. It records that the app started, connected and stopped, plus any errors. It does not record the sites you visited or the programs you ran.

If we ask you to enable verbose logging

For routing problems ("some sites will not load through the tunnel") we may need detailed logs. A single file switches this on. It is off by default and we will only ask when we need it.

  1. Quit Maikr Pro completely (tray icon → Quit Maikr Pro).
  2. Press Win+R, paste %LOCALAPPDATA%\com.maikrapps.win and press Enter.
  3. Create an empty text file named exactly verbose-logging.txt.
    Check Windows has not named it verbose-logging.txt.txt — turn on File name extensions in Explorer's View menu to be sure.
  4. Start Maikr Pro. The restart is required — the file is only checked at startup. Then reproduce the problem.

Please read before enabling. While that file exists, the log becomes an effective browsing record — the addresses your device connected to and the applications that requested them. Only enable it when we ask, and only send the file to the Maikr team.

To turn it off: quit Maikr Pro, delete verbose-logging.txt, start the app again. Please do switch it back off once you have sent us the file. You may also delete everything in the logs folder afterwards — the app creates new files as needed.

安装前请务必阅读。Maikr Pro 会安装一个内核级网络驱动， 并接管本机的上网流量。每次运行都需要管理员权限。若出现异常，可能会短暂失去网络连接， 恢复方法见第 7 节。

请安装在可以承受中断的电脑上， 不要用您唯一的办公电脑测试。

目录
  1. 系统要求
  2. 安装前须知
  3. 安装步骤
  4. 首次启动
  5. 日常使用
  6. 注意事项与已知限制
  7. 网络中断时的恢复方法
  8. 常见问题排查
  9. 卸载
  10. 日志与隐私

1. 系统要求

操作系统64 位 Windows 10 或 Windows 11。不提供 32 位与 Arm 版本。
权限管理员权限。这是强制要求，无法绕过，原因见下文。
磁盘空间约 100 MB。
网络安装过程中需要联网。若本机缺少 Microsoft WebView2 运行时，安装程序会静默下载。多数 Windows 11 电脑已自带。
安装文件Maikr Pro_1.0.0_x64-setup.exe —— 您只需要这一个文件。若收到其他文件，请先与我们确认再运行。

2. 安装前须知 —— 本程序会对电脑做什么

从旧版本升级？早期版本名为 ngrouter。请先卸载该条目（设置 → 应用 → 已安装的应用 → ngrouter → 卸载），让它自带的卸载程序清理掉旧文件与日志，然后再安装本版本。

3. 安装步骤

  1. 先关闭正在运行的旧版本：右键点击托盘图标，选择 Quit Maikr Pro（退出）。
  2. 双击 Maikr Pro_1.0.0_x64-setup.exe。
  3. Windows SmartScreen 通常会显示「Windows 已保护你的电脑」。 请点击「更多信息」，再点击「仍要运行」。
  4. 同意用户账户控制（UAC）提示，其中会显示发布者未知。
  5. 保持默认安装路径，完成安装向导。

支持覆盖安装。安装程序会自动先停止正在运行的 引擎进程并卸载网络驱动。若不这样处理，Windows 会拒绝覆盖驱动文件 —— 因为已加载的内核 驱动，其文件即使在程序关闭后仍处于锁定状态。

安装程序会添加的内容

4. 首次启动

  1. 从开始菜单启动 Maikr Pro。
  2. 同意 UAC 提示。
  3. 使用我们提供的账号登录。
  4. 选择一个服务器。
  5. 打开 VPN 开关，等待状态稳定为「已连接」，旁边出现计时器。

启动正常时应该是这样：

  • 主窗口正常打开。
  • 背后不会出现黑色命令行窗口。
  • 通知区域（托盘）出现 Maikr Pro 图标 （屏幕右下角，可能需要点击 ^ 箭头展开）。

以上三点若有任何一项不符，即使程序看起来能用，也请向我们反馈。

确认流量确实经过了隧道

  1. 访问任意「查询我的 IP」网站。
  2. 显示的应当是服务器所在位置，而不是您本地的位置。
  3. 浏览几个您日常使用的网站。
  4. 关闭开关，确认 IP 恢复正常，且浏览依然正常。

5. 日常使用

启动开始菜单 → Maikr Pro。每次都需同意 UAC。
关闭窗口点击 X 并不会退出程序，只是最小化到托盘并继续运行。程序会提示您一次。
重新打开点击托盘图标，或右键 → Open Dashboard。
彻底退出右键托盘图标 → Quit Maikr Pro。这是唯一能完全退出的操作。
重复启动再次启动只会聚焦已有窗口，不会开启第二个实例。

托盘菜单

右键点击通知区域图标可看到四个菜单项。托盘由 Windows 自身绘制， 因此即使程序窗口卡死，该菜单仍然可用：

执行紧急停止后，必须先点击 Restart Engines，VPN 开关才会重新生效。若直接去拨开关， 程序只会提示您先重启引擎。

6. 注意事项与已知限制

每次启动都必须使用管理员权限。没有任何方式能以普通权限运行 Maikr Pro。如果您所在单位的策略禁止提权，或您使用的是标准（非管理员）Windows 账户，本程序将完全无法运行。

由此带来的一个现象：由于程序以提权方式运行， 普通命令行窗口中的 tasklist 等工具看不到它的引擎进程。

7. 网络中断时的恢复方法

由于程序会改变流量走向，一旦出现异常可能导致无法上网。为此提供了两条应急通道， 都不依赖主窗口 —— 这一点很关键，因为网络故障往往正是导致窗口失去响应的原因。

方法一：托盘中的紧急停止

右键点击通知区域的 Maikr Pro 图标（屏幕右下角，可能被 ^ 箭头折叠）， 选择 Emergency Stop (restore network)。程序会立即关闭引擎并恢复网络。

方法二：开始菜单中的快捷方式

若程序卡死到连托盘菜单都没有反应，请在开始菜单中搜索 Maikr Pro Emergency Stop 并运行。它会请求管理员权限， 结束引擎进程并卸载抓包驱动。

这两项操作都不会改动任何 Windows 网络设置 —— 因为 Maikr Pro 本来就没有修改过。没有任何东西需要还原，停止引擎就是完整的修复。

若仍未恢复

  1. 正常退出 —— 托盘图标 → Quit Maikr Pro。
  2. 若程序无响应：按 Ctrl+Shift+Esc 打开任务管理器， 结束 Maikr Pro.exe。引擎进程设计为随之自动结束。 若之后仍能看到 maikr-engine.exe，这是一个值得反馈的缺陷。
  3. 重启电脑。本程序所做的一切都不会在重启后残留。
  4. 最后手段：卸载程序（第 9 节）后重启。

手动恢复 —— 仅在以上步骤全部无效时使用。 以管理员身份打开命令提示符并执行：

taskkill /F /T /IM maikr-engine.exe
sc stop WinDivert
sc delete WinDivert
ipconfig /flushdns

驱动服务会在程序下次拦截流量时自动重新创建。

8. 常见问题排查

安装时提示「打开文件以写入时出错」

说明引擎或驱动仍在运行。请先从托盘退出 Maikr Pro，再从开始菜单运行 Maikr Pro Emergency Stop，然后重新安装。若仍不行， 请重启电脑，并在启动程序之前先完成安装。

杀毒软件拦截或隔离

请告诉我们是哪款产品、提示了什么内容 —— 这对我们很有价值， 因为在更大范围发布之前，我们需要消除这些误报。文件被隔离的典型表现： 弹出提示某个文件缺失的错误框，或者拨动 VPN 开关后毫无反应。

若您愿意继续使用，可为 C:\Program Files\Maikr Pro 添加排除项。 请仅在您确认可以接受的前提下这样做；选择拒绝并只是向我们反馈，也完全合理。

程序能打开，但开关没有任何反应

通常是文件缺失（参见上面的杀毒软件部分）或驱动加载失败。 可先尝试托盘中的 Restart Engines。若仍无效，请重启电脑后再试，并反馈给我们。

出现黑色命令行窗口一闪而过或长时间停留

这属于不应出现的情况，请反馈给我们，如能截图更好。

已连接，但某个特定网站打不开

请留意关闭开关后是否可以访问。若该服务仅支持 IPv6， 请参见第 6 节中关于 IPv6 的说明。反馈时请附上准确的网址。

如何反馈问题

请按以下顺序提供信息：

  1. 您做了什么操作（逐步描述），以及实际结果与预期的差异。
  2. 发生时间 —— 大致时间点即可，便于我们在日志中定位。
  3. Windows 版本 —— 按 Win+R， 输入 winver 回车，将结果截图。
  4. 任何错误提示或横幅的截图。
  5. 诊断文件 —— 仅在我们主动索取时提供。

9. 卸载

设置 → 应用 → 已安装的应用 → Maikr Pro → 卸载， 或运行 C:\Program Files\Maikr Pro 目录下的 uninstall.exe。

卸载程序会停止引擎、注销 WinDivert 内核驱动， 并删除程序本体及其日志。

卸载后请验证以下几点 —— 这本身就是一项有效的测试：

  1. C:\Program Files\Maikr Pro 已不存在。
  2. 按 Win+R，粘贴 %LOCALAPPDATA%\com.maikrapps.win —— Windows 应提示该文件夹不存在。
  3. 开始菜单中的 Maikr Pro Emergency Stop 快捷方式已消失。
  4. 网络一切正常，重启后依然正常。

若以上任何一项不符，请告知我们 —— 卸载后仍有残留是我们此轮测试特别希望发现的缺陷。

10. 日志与隐私

日志写入 %LOCALAPPDATA%\com.maikrapps.win\logs。 将该路径粘贴到 Win+R 中即可打开该文件夹。

默认情况下日志非常简洁。 它只记录程序的启动、连接与停止，以及出现的错误， 不会记录您访问过的网站或运行过的程序。

当我们请您开启详细日志时

对于路由类问题（例如「某些网站无法通过隧道访问」），我们可能需要详细日志。 只需一个文件即可开启。该功能默认关闭，只有在确有需要时我们才会请您开启。

  1. 彻底退出 Maikr Pro（托盘图标 → Quit Maikr Pro）。
  2. 按 Win+R，粘贴 %LOCALAPPDATA%\com.maikrapps.win 并回车。
  3. 在该文件夹中新建一个空文本文件，名称必须正好是 verbose-logging.txt。
    请确认 Windows 没有把它命名为 verbose-logging.txt.txt —— 可在资源管理器「查看」菜单中 勾选「文件扩展名」以便确认。
  4. 启动 Maikr Pro。必须重启程序 —— 该文件只在启动时被读取。 然后复现问题。

开启前请务必阅读。只要该文件存在， 日志实际上就成为一份上网记录 —— 包含您的设备连接过的地址，以及发起这些连接的应用程序。 请仅在我们请求时开启，并且只将该文件发送给 Maikr 团队。

关闭方法：退出 Maikr Pro，删除 verbose-logging.txt， 再重新启动程序。将文件发送给我们之后，请务必将其关闭。之后您也可以删除 logs 文件夹中的所有内容，程序会按需重新生成。