# password-manager

**Repository Path**: star-sc/password-manager

## Basic Information

- **Project Name**: password-manager
- **Description**: 密码管理器
使用 Electron + Vue3 + Vite5 +  ElementPlus 开发的一个桌面端软件
适配 win, mac, linux 平台
- **Primary Language**: JavaScript
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2024-06-21
- **Last Updated**: 2026-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img alt="logo" src="./README.assets/icon.png" style="width:150px">
</p>

<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">密码管理器</h1>

<p align="center">
  <strong>一个安全、跨平台的本地密码管理解决方案</strong>
</p>

<p align="center">
  <img alt="GitHub release" src="https://img.shields.io/github/v/release/scgithub3220216/password-manager?include_prereleases">
  <img alt="GitHub stars" src="https://img.shields.io/github/stars/scgithub3220216/password-manager">
  <img alt="GitHub license" src="https://img.shields.io/github/license/scgithub3220216/password-manager">
  <img alt="platform" src="https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-blue">
</p>

---

## 简介

一款基于 Electron 开发的跨平台密码管理器，支持 Windows、macOS 和 Linux 系统。所有数据本地存储，无需联网即可使用，保障您的隐私安全。

> **注意：** 本人只在 `Windows` 平台下进行了充分测试，其他平台如有问题欢迎提 Issue。

## 功能特性

- **本地存储** - 数据完全存储在本地，无需联网，保护隐私
- **跨平台支持** - 支持 Windows、macOS、Linux 三大平台
- **密码加密** - 采用 AES 加密算法保护您的密码安全
- **分组管理** - 支持自定义分组，方便分类管理
- **搜索功能** - 支持拼音搜索，快速查找密码
- **导入导出** - 支持 Excel 导出，方便数据备份迁移
- **云同步** - 支持阿里云 OSS 云端同步（可选）
- **自动更新** - 支持应用自动检测更新
- **系统托盘** - 最小化到托盘，快速访问

## 技术栈

| 技术 | 版本 | 说明 |
|------|------|------|
| Electron | 30.x | 跨平台桌面应用框架 |
| Vue 3 | 3.4.x | 渐进式 JavaScript 框架 |
| TypeScript | 5.x | JavaScript 的超集 |
| Vite | 5.x | 下一代前端构建工具 |
| Element Plus | 2.7.x | Vue 3 UI 组件库 |
| Pinia | 2.x | Vue 状态管理 |
| better-sqlite3 | 12.x | SQLite 数据库 |

## 环境要求

- **Node.js**: 22.22.1 (推荐使用 nvm 管理)
- **npm**: 10.x+

## 快速开始

### 安装

```bash
# 克隆项目
git clone https://github.com/scgithub3220216/password-manager.git

# 进入项目目录
cd password-manager

# 安装依赖
npm install
```

### 开发

```bash
# 启动开发服务器
npm run dev
```

### 构建

```bash
# 构建生产版本
npm run build
```

> **注意：** Windows 平台下打包需要管理员权限。

## 项目结构

```
password-manager/
├── src/                    # 源代码目录
│   ├── main/               # Electron 主进程
│   ├── render/             # 渲染进程（Vue 应用）
│   └── preload/            # 预加载脚本
├── dist/                   # Vite 构建输出
├── dist-electron/          # Electron 构建输出
├── release/                # 打包输出目录
├── electron-builder.json5  # Electron Builder 配置
└── package.json            # 项目配置
```

## 软件下载

### GitHub Releases

[前往 Releases 页面下载最新版本](https://github.com/scgithub3220216/password-manager/releases)

### 百度网盘

- 链接：https://pan.baidu.com/s/1cuRzhTleXLY0ttTg0knaEw
- 提取码：`da2o`

## 界面预览

### 登录页
![登录页](./README.assets/image-20240711114438507.png)

### 主界面
![主界面](./README.assets/image-20240711114450924.png)

### 设置界面
![设置界面](./README.assets/image-20240711114459535.png)

### 菜单界面
![菜单界面](./README.assets/image-20240711114553712.png)

### 托盘界面
![托盘界面](./README.assets/image-20240711114610701.png)

## 常见问题

### better-sqlite3 NODE_MODULE_VERSION 版本不一致

**错误信息：**
```
Error: The module was compiled against a different Node.js version using
NODE_MODULE_VERSION 115. This version of Node.js requires NODE_MODULE_VERSION 123.
```

**解决方案：**

```bash
# 重新安装并编译原生模块
npm install better-sqlite3 --ignore-scripts
npx electron-rebuild --force --arch=x64
```

### Windows 打包失败

Windows 下打包需要管理员权限，请以管理员身份运行终端后执行 `npm run build`。

## 免责声明

- **合理使用，风险自担** - 本软件旨在帮助您管理如社交媒体、邮箱等非金融类账户的密码。强烈建议避免存储涉及资金交易的重要密码，例如银行卡、支付宝及微信支付密码等。
- **牢记登录密码** - 为保障账户安全，**若您遗失登录密码，当前版本暂不提供找回服务**。请务必妥善保管您的登录信息。
- **安全声明** - 虽然我们持续优化软件的安全性能，但任何电子设备和网络环境都无法保证绝对安全。使用本软件存储密码存在一定风险，一旦发生密码泄露、丢失等情况，作者不承担任何责任。
- **隐私保护承诺** - 本软件严格遵守隐私政策，**承诺永远不会以任何方式上传或保留您的任何数据**，确保最大程度的隐私安全。

## 开源协议

本项目采用 MIT 协议开源，个人及企业均可免费使用。

## 交流反馈

### 微信交流群

<img src="./README.assets/image-20240704170636650.png" alt="微信群" style="zoom:50%;">

### Issue 反馈

如有问题或建议，欢迎在 [GitHub Issues](https://github.com/scgithub3220216/password-manager/issues) 中反馈。

---

<p align="center">
  如果这个项目对您有帮助，欢迎 Star 支持 ⭐
</p>