dekun
106 lines
3.2 KiB
Markdown
106 lines
3.2 KiB
Markdown
# 更新说明 — crypto_key
|
||
|
||
本文档记录各版本功能变更与升级注意事项。
|
||
|
||
---
|
||
|
||
## v2.0.0（当前）
|
||
|
||
### 新增
|
||
|
||
- **登录系统**：用户名 + 密码（单用户），凭据保存在 `.env`
|
||
- **数据加密**：`data.json` 使用 Fernet（AES）加密存储，密钥为 `DATA_ENCRYPTION_KEY`（`.env`）
|
||
- **凭证类型扩展**：
|
||
- 交易所 API（Binance / OKX / Gate）
|
||
- 网站账号（网址可点击）
|
||
- 邮箱账户（mailto / 网页登录链接）
|
||
- 企业微信机器人、钉钉机器人
|
||
- 微信（微信号 + 手机号）、QQ（QQ 号 + 手机号）
|
||
- **自定义类型**：系统设置中自行添加字段（如小红书、抖音、快手）
|
||
- **系统设置页**：
|
||
- 修改登录用户名/密码（写入 `.env`）
|
||
- 管理自定义类型（增删、搜索）
|
||
- **查询机制**：添加后不自动展示；按类型 + 关键词 +「确认」后显示
|
||
- **类型搜索**：添加/查询时支持输入过滤类型
|
||
- **旧数据迁移**：明文 `data.json` 首次加载自动转为加密格式
|
||
|
||
### 变更
|
||
|
||
- 监听地址由 `127.0.0.1` 改为 **`0.0.0.0`**，支持局域网访问
|
||
- API 主路径由 `/api/accounts` 扩展为 `/api/credentials`（保留旧路径兼容）
|
||
- 数据模型由固定 `username/api_key/api_secret` 改为 `type_id + fields` 结构
|
||
- 依赖增加：`python-dotenv`、`cryptography`、`werkzeug`
|
||
|
||
### 安全
|
||
|
||
- 浏览器 **不** 使用 localStorage/sessionStorage 存储明文
|
||
- Session Cookie 设置 `HttpOnly`、`SameSite=Lax`
|
||
- `.env`、`data.json`、`settings.json` 默认加入 `.gitignore`
|
||
|
||
### 升级注意（从 v1.x 升级）
|
||
|
||
1. 备份现有 `data.json`：
|
||
```bash
|
||
cp data.json data.json.bak
|
||
```
|
||
2. 安装新依赖：
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
3. 配置 `.env`（可复制 `.env.example`，或首次运行自动生成）：
|
||
- `SECRET_KEY`
|
||
- `AUTH_USERNAME` / `AUTH_PASSWORD`
|
||
- `DATA_ENCRYPTION_KEY`
|
||
4. 启动服务，旧明文数据将 **自动迁移** 为加密格式。
|
||
5. 使用默认或自定义账号登录，在「系统设置」中修改密码。
|
||
6. PM2 用户执行：`pm2 restart api-key-manager`
|
||
|
||
> **重要**：升级后切勿删除或修改 `.env` 中的 `DATA_ENCRYPTION_KEY`，否则无法解密已有数据。
|
||
|
||
---
|
||
|
||
## v1.2.0
|
||
|
||
### 新增
|
||
|
||
- 交易所下拉：Binance / OKX / Gate
|
||
- OKX 专用 Passphrase 字段
|
||
- 按交易所查询（下拉 + 确认）
|
||
- 添加成功后默认不展示列表
|
||
- 敏感字段打码显示（复制仍为明文）
|
||
|
||
### 变更
|
||
|
||
- 支持局域网访问（`0.0.0.0:5200`）
|
||
|
||
---
|
||
|
||
## v1.1.0
|
||
|
||
### 新增
|
||
|
||
- PM2 守护进程支持（`ecosystem.config.cjs`）
|
||
- Ubuntu `/opt/crypto_key` 部署脚本与文档
|
||
- 启动脚本：`pm2-start.sh` / `pm2-start.ps1`
|
||
|
||
---
|
||
|
||
## v1.0.0
|
||
|
||
### 初始功能
|
||
|
||
- Flask 后端 + 单页前端（黑色主题）
|
||
- 多账户 API 密钥管理：`username`、`api_key`、`api_secret`
|
||
- 本地 `data.json` 明文存储
|
||
- 每条记录三个复制按钮
|
||
- 端口 5200，无登录
|
||
|
||
---
|
||
|
||
## 版本规划（待定）
|
||
|
||
- [ ] 可选 HTTPS / 反向代理说明模板
|
||
- [ ] 凭证编辑（当前仅支持添加、删除）
|
||
- [ ] 导出/导入加密备份包
|
||
- [ ] 登录失败次数限制
|