# crypto_key — 币圈 API 密钥管理工具

本地 Web 工具，管理多个交易所/平台 API 账户（账户名称、API Key、API Secret）。数据保存在本地 `data.json`，无登录。

| 项目 | 说明 |
|------|------|
| 仓库 | [git.bz121.com/dekun/crypto_key](https://git.bz121.com/dekun/crypto_key.git) |
| Ubuntu 部署路径 | `/opt/crypto_key` |
| 服务端口 | `5200` |
| 进程守护 | PM2 |

---

## 功能

- 交易所：`binance` / `okx` / `gate`（OKX 额外保存密码 Passphrase）
- 账户数量不限，每项含 `exchange` / `username` / `api_key` / `api_secret`
- 添加后默认不展示列表，需选择交易所点击「确认」查询
- 黑色专业界面，列表展示 + 每项 3 个复制按钮（**复制始终为明文**）
- 可选界面打码显示，不影响复制内容
- 数据持久化至 `data.json`

---

## Ubuntu 服务器部署（/opt）

完整步骤见 **[DEPLOY.md](./DEPLOY.md)**。

```bash
sudo git clone https://git.bz121.com/dekun/crypto_key.git /opt/crypto_key
cd /opt/crypto_key
sudo bash scripts/install-ubuntu.sh
```

访问：

- 本机：**http://127.0.0.1:5200**
- 局域网：**http://<服务器局域网IP>:5200**（如 `http://192.168.1.100:5200`）

查看本机 IP：`hostname -I` 或 `ip addr`

```bash
pm2 status
pm2 logs api-key-manager
```

---

## 本地开发

```bash
python3 -m venv venv
source venv/bin/activate          # Windows: venv\Scripts\activate
pip install -r requirements.txt
python app.py
```

浏览器打开 http://127.0.0.1:5200（局域网内其他设备用 `http://<本机IP>:5200`）

PM2 守护：`./pm2-start.sh`（Linux）或 `.\pm2-start.ps1`（Windows）

---

## 文件说明

| 文件 | 说明 |
|------|------|
| `app.py` | Flask 后端 |
| `index.html` | 前端页面 |
| `ecosystem.config.cjs` | PM2 配置 |
| `scripts/install-ubuntu.sh` | Ubuntu 一键安装 |
| `DEPLOY.md` | 完整部署文档 |

---

## 数据格式

```json
{
  "id": "uuid",
  "exchange": "binance",
  "username": "账户名称",
  "api_key": "API Key",
  "api_secret": "API Secret",
  "password": "仅 OKX 需要"
}
```

---

## API

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/` | 前端页面 |
| GET | `/api/accounts` | 获取全部账户 |
| GET | `/api/accounts?exchange=binance` | 按交易所筛选 |
| POST | `/api/accounts` | 新增账户 |
| DELETE | `/api/accounts/<id>` | 删除账户 |

---

## 安全提示

- 无认证，监听 `0.0.0.0`（局域网可访问），请勿暴露到公网；建议仅在可信局域网使用
- `data.json` 为明文密钥，已 `.gitignore`，请定期备份

---

## 依赖

```
flask>=3.0.0,<4.0.0
```

服务器另需：Python 3.8+、Node.js（PM2）