# password-package

**Repository Path**: pretend-work/password-package

## Basic Information

- **Project Name**: password-package
- **Description**: 一个简单但安全的个人密码管理系统，使用Python Flask开发。该系统允许用户安全地存储和管理各种服务的密码，并提供密码生成器等实用工具。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-11-05
- **Last Updated**: 2025-11-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 密码管理系统

一个简单但安全的个人密码管理系统，使用Python Flask开发。该系统允许用户安全地存储和管理各种服务的密码，并提供密码生成器等实用工具。

## 功能特性

- 🔐 **安全存储**：使用AES-256加密算法保护密码数据
- 🎯 **单用户模式**：专为个人用户设计，无需多用户管理
- 🔑 **主密码保护**：所有密码均由一个强主密码保护
- 📋 **便捷操作**：支持复制密码到剪贴板
- 🔧 **密码生成器**：可自定义的密码生成工具
- 🐳 **Docker支持**：提供Docker和Docker Compose部署方式

## 技术栈

- **后端**：Python 3.9, Flask 3.0
- **加密**：cryptography, pycryptodome
- **前端**：HTML5, Bootstrap 5, JavaScript
- **部署**：Docker, Docker Compose

## 安装和运行

### 使用Docker Compose（推荐）

1. 确保已安装Docker和Docker Compose

2. 克隆或下载项目到本地

3. 在项目根目录运行：
   ```bash
   docker-compose up -d
   ```

4. 访问 http://localhost:8080 开始使用

### 直接运行

1. 确保已安装Python 3.9+

2. 克隆或下载项目到本地

3. 安装依赖：
   ```bash
   pip install -r requirements.txt
   ```

4. 运行应用：
   ```bash
   python app.py
   ```

5. 访问 http://localhost:80 开始使用

## 首次使用

1. 首次访问时，系统会引导您设置一个主密码
2. 主密码非常重要，请务必牢记（忘记后无法恢复密码数据）
3. 设置完成后，您可以开始添加和管理密码

## 数据安全

- 所有密码数据使用Fernet对称加密算法加密存储
- 加密密钥由主密码派生并安全存储
- 密码在内存中临时解密，不会以明文形式持久化
- 建议定期备份`data`目录中的加密文件

## 注意事项

- 本系统仅适用于单用户使用场景
- 请妥善保管主密码，忘记后无法恢复数据
- 在生产环境中使用时，建议配置HTTPS
- 定期备份您的加密数据文件

## 主密码重置

**警告：重置主密码将会丢失所有已存储的密码数据！**

如果您确实需要重置主密码，请按照以下步骤操作：

### 直接运行方式
1. 停止应用程序
2. 删除或重命名`data`目录中的`master.key`文件：
   ```bash
   # Windows
   del data\master.key
   
   # Linux/Mac
   rm data/master.key
   ```
3. 重新启动应用程序
4. 访问应用时，系统将引导您设置新的主密码

### Docker方式
1. 停止并删除容器：
   ```bash
   docker-compose down
   ```
2. 删除存储卷中的master.key文件：
   ```bash
   # 如果使用命名卷
   docker volume rm password-package_data
   
   # 或者直接删除挂载目录中的文件
   rm data/master.key
   ```
3. 重新启动容器：
   ```bash
   docker-compose up -d
   ```
4. 访问应用时，系统将引导您设置新的主密码

## 项目结构

```
password-package/
├── app.py              # 主应用程序
├── requirements.txt    # 项目依赖
├── Dockerfile          # Docker构建文件
├── docker-compose.yml  # Docker Compose配置
├── .gitignore          # Git忽略文件
├── templates/          # HTML模板目录
│   ├── base.html       # 基础模板
│   ├── login.html      # 登录页面
│   ├── setup.html      # 主密码设置页面
│   ├── index.html      # 密码列表页面
│   ├── add.html        # 添加密码页面
│   ├── edit.html       # 编辑密码页面
│   └── generator.html  # 密码生成器页面
└── data/               # 数据存储目录（运行时创建）
```

## 许可证

MIT License