解密 Navicat 密码神器：NavicatPassword 的技术实现与架构解析

news/2026/1/27 8:29:48/文章来源:https://www.cnblogs.com/dingshuanglei/p/19536434

在日常的开发、运维工作中，Navicat作为一款主流的多数据库管理工具，几乎是每个数据库从业者的标配。但很多人都遇到过这样的痛点：Navicat会将数据库连接密码加密存储在本地配置文件中，一旦忘记密码，想要找回就成了一件麻烦事。基于此，我开发了NavicatPassword——一款基于Avalonia框架的跨平台Navicat密码解密工具，本文将从技术实现、架构设计、核心功能等维度，全面解析这个项目的开发思路与落地细节。

一、项目背景与核心价值

1. 解决的核心痛点

Navicat的数据库连接密码并非明文存储，而是通过AES算法加密后写入.ncx格式的XML配置文件中。一旦用户忘记密码，常规方式只能重新配置连接，效率极低。

2. 项目核心价值

跨平台运行：基于Avalonia与.NET 8，支持Windows、macOS、Linux全平台；
多场景解密：支持配置文件批量解析、单条连接解密、手动输入密文解密三种模式；
易用性拉满：现代化UI界面，支持深色模式，操作流程极简；
轻量高效：无需复杂依赖，基于.NET原生能力实现核心算法，解密速度毫秒级。

二、技术栈选型与考量

NavicatPassword的技术栈选择围绕「跨平台、低耦合、高性能」三个核心目标，具体选型如下：

技术领域	选型	选型考量
前端UI框架	Avalonia UI	替代WPF的跨平台UI框架，API与WPF高度兼容，原生支持多平台、深色模式、响应式布局
后端开发语言	C# (.NET 8)	.NET 8跨平台能力强，性能优异，原生支持加密算法、XML解析等核心能力
架构模式	MVVM (CommunityToolkit.Mvvm)	解耦UI与业务逻辑，简化数据绑定、命令管理，提升代码可维护性
加密算法	AES-128-CBC	匹配Navicat官方的加密标准，保证解密准确性
数据存储	SQLite	轻量级嵌入式数据库，用于保存用户的解密设置、历史记录等
配置文件解析	.NET XmlDocument/XDocument	原生XML解析能力，高效处理Navicat的.ncx配置文件

三、项目架构设计（MVVM）

项目严格遵循MVVM架构模式，代码目录结构与职责划分清晰，核心目录如下（对应项目NavicatPassword/目录）：

NavicatPassword/
├── Views/          # 视图层：UI界面（Axaml文件），仅负责展示，无业务逻辑
│   ├── MainView.axaml       # 主界面（解密操作核心页面）
├── ViewModels/     # 视图模型层：连接View与Model，处理UI交互逻辑
│   ├── MainViewModel.cs     # 主界面逻辑（文件选择、批量解密、单条解密）
├── Services/       # 服务层：核心业务逻辑封装
│   ├── SystemService.cs # 密码解密核心服务
├── Utils/          # 工具层：解密方法
└── App.axaml.cs    # 应用入口，全局配置

各层核心职责

View（视图层）：仅通过Axaml定义UI结构，通过数据绑定绑定ViewModel的属性和命令，无任何业务代码；
ViewModel（视图模型层）：通过ObservableProperty（CommunityToolkit.Mvvm特性）实现属性通知，通过ICommand处理按钮点击、文件选择等UI交互，调用Service层完成核心逻辑；
Service（服务层）：封装核心业务逻辑（解密、文件解析），是项目的「业务核心」，ViewModel仅调用Service，不直接处理业务；
Model（模型层）：定义数据结构，如数据库连接信息、应用配置等，仅承载数据，无业务逻辑。

这种架构的优势在于：UI与业务逻辑完全解耦，后续无论是修改界面样式，还是优化解密算法，都无需改动其他层的代码，可维护性和扩展性大幅提升。

四、核心功能实现解析

1. 密码解密核心算法（AES-128-CBC）

Navicat的密码加密采用固定的Key和IV，这是解密的关键。项目的核心解密代码如下，且完全基于.NET原生System.Security.Cryptography实现：

using System.Security.Cryptography;
using System.Text;namespace NavicatPassword.Services;public static class NavicatDecryptService
{// Navicat固定的Key和IV（核心！）private static readonly byte[] _key = Encoding.UTF8.GetBytes("libcckeylibcckey");private static readonly byte[] _iv = Encoding.UTF8.GetBytes("libcciv libcciv ");////// 解密Navicat加密的密码字节数组//////加密后的字节数组///明文密码///解密失败时抛出异常public static string DecryptNavicatPassword(byte[] cipherBytes){if (cipherBytes == null || cipherBytes.Length == 0){throw new ArgumentException("加密字节数组不能为空", nameof(cipherBytes));}try{using Aes aes = Aes.Create();// 匹配Navicat的加密模式：CBC + PKCS7填充aes.Mode = CipherMode.CBC;aes.Padding = PaddingMode.PKCS7;aes.Key = _key;aes.IV = _iv;// 创建解密器并执行解密ICryptoTransform decryptor = aes.CreateDecryptor(aes.Key, aes.IV);byte[] plainBytes = decryptor.TransformFinalBlock(cipherBytes, 0, cipherBytes.Length);// 转换为UTF8明文return Encoding.UTF8.GetString(plainBytes);}catch (Exception ex){throw new ArgumentException("解密失败，可能是密文格式错误", ex);}}////// 重载：解密Base64编码的密文字符串//////Base64密文/// 明文密码public static string DecryptNavicatPassword(string cipherBase64){byte[] cipherBytes = Convert.FromBase64String(cipherBase64);return DecryptNavicatPassword(cipherBytes);}
}

关键细节说明：

固定Key/IV：Navicat所有版本均使用libcckeylibcckey（Key）和libcciv libcciv （IV），这是解密的核心前提；
填充模式：必须使用PKCS7（而非PKCS5），否则解密结果会出现乱码；
异常处理：针对空值、格式错误等场景做了容错，保证用户体验。

2. .ncx配置文件解析

Navicat的.ncx文件是XML格式，核心是<Connection>节点，包含连接名称、地址、加密密码等信息。解析逻辑封装在NcxFileParserService中，核心步骤如下：

using System.Xml.Linq;
using NavicatPassword.Models;namespace NavicatPassword.Services;public class NcxFileParserService
{////// 解析.ncx配置文件，提取所有数据库连接信息//////配置文件路径/// 数据库连接列表public List ParseNcxFile(string filePath){if (!File.Exists(filePath)){throw new FileNotFoundException("配置文件不存在", filePath);}XDocument doc = XDocument.Load(filePath);var connections = new List();// 遍历所有Connection节点foreach (var connNode in doc.Descendants("Connection")){var connection = new NavicatConnection{Name = connNode.Attribute("Name")?.Value ?? string.Empty,Host = connNode.Element("Host")?.Value ?? string.Empty,Port = connNode.Element("Port")?.Value ?? string.Empty,Database = connNode.Element("Database")?.Value ?? string.Empty,// 加密密码是Base64编码的字符串CipherPassword = connNode.Element("Password")?.Value ?? string.Empty};// 自动解密（可选）if (!string.IsNullOrEmpty(connection.CipherPassword)){try{connection.PlainPassword = NavicatDecryptService.DecryptNavicatPassword(connection.CipherPassword);}catch{connection.PlainPassword = "解密失败";}}connections.Add(connection);}return connections;}
}

解析逻辑的核心是提取<Connection>节点的属性和子节点值，并自动调用解密方法生成明文密码，最终封装为NavicatConnection模型返回给ViewModel，由View展示。

五、跨平台适配要点

基于Avalonia和.NET 8，项目的跨平台适配几乎「零成本」，但仍有几个关键细节需要注意：

文件路径适配：不同系统的Navicat配置文件路径不同，自动适配：Windows：C:\Users\{用户名}\Documents\Navicat\
UI适配：Avalonia的布局系统原生支持响应式，通过Grid、StackPanel等布局控件，保证在不同分辨率、不同系统下的UI一致性；深色模式通过Avalonia的ThemeVariant实现，无需单独开发。

发布打包：通过.NET Publish命令可一键打包不同平台的可执行文件：

# Windows (x64)
dotnet publish -c Release -r win-x64 --self-contained true -o publish/win# macOS (x64)
dotnet publish -c Release -r osx-x64 --self-contained true -o publish/macos# Linux (x64)
dotnet publish -c Release -r linux-x64 --self-contained true -o publish/linux

六、使用场景与落地效果

1. 核心使用场景

开发人员找回密码：忘记Navicat连接密码，快速解析配置文件找回；
运维批量管理：批量解析服务器上的Navicat配置文件，统一管理数据库连接密码；
测试环境核查：验证测试环境数据库密码是否符合规范，提升安全合规性；
已通过测试版本：Navicat Premium Lite (Free) 17.3.6版本。

附：项目快速上手

从源码构建

# 克隆仓库
git clone https://gitee.com/dingshuanglei/NavicatPassword.git
or
git clone https://github.com/dingshuanglei/NavicatPassword.git
# 进入目录
cd NavicatPassword# 构建项目
dotnet build -c Release# 运行
dotnet run --project NavicatPassword/NavicatPassword.csproj