# autoclearnuser

**Repository Path**: alamhubb/autoclearnuser

## Basic Information

- **Project Name**: autoclearnuser
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-13
- **Last Updated**: 2026-04-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# autoclearnuser

一套用于 Sub2API 号池清理、删除检测、统计汇总的脚本集合。

当前仓库包含：

- `sub2api_db_cleanup.py`
  单次清理脚本，负责测试账号可用性并按规则做临时下线或软删除。
- `cleanup_loop.py`
  轮询 4 台目标机，按配置持续执行清理。
- `cleanup_metrics_store.py`
  本地 SQLite 事件库，保存上传、软删、硬删、轮询记录。
- `cleanup_metrics_ingest.py`
  轻量 HTTP 接收端，用来接收上传事件。
- `cleanup_metrics_sync_logs.py`
  从各目标机 `ops/system-logs` 增量回补上传与后台硬删事件。
- `cleanup_metrics_report.py`
  输出 `10m / 30m / 2h / 12h` 等窗口的上传、删除、当前可用统计。
- `clean_config.json`
  默认 4 台机子的配置模板。
- `*.service` / `*.timer`
  systemd 部署文件。

## 目标机器

默认配置已包含：

- `sub2api` -> `http://43.159.170.109`
- `sub2api3` -> `http://10.4.0.44`
- `sub2api4` -> `http://10.4.4.9`
- `sub2api5` -> `http://10.4.4.16`

## 统计口径

- `uploaded`
  来自上传脚本主动上报，或后台 `POST /api/v1/admin/accounts` 系统日志回补。
- `soft_deleted`
  来自清理脚本直接写库的软删。
- `hard_deleted`
  来自后台 `DELETE /api/v1/admin/accounts/:id` 系统日志。
- `deleted`
  等于 `soft_deleted + hard_deleted`。
- `available_now`
  通过后台 API 实时查询当前仍可调度的账号数。

## 依赖

Python 3.10+，以及：

```bash
pip install -r requirements.txt
```

## 常用命令

启动统计接收端：

```bash
python3 cleanup_metrics_ingest.py --config clean_config.json
```

同步系统日志：

```bash
python3 cleanup_metrics_sync_logs.py --config clean_config.json
```

查询报表：

```bash
python3 cleanup_metrics_report.py --config clean_config.json --sync-before-report --windows 10m,30m,12h
```

持续轮询清理：

```bash
python3 cleanup_loop.py --config clean_config.json
```

## 部署说明

更完整的部署步骤见：

- `cleanup_metrics_usage.md`

## 注意

- `clean_config.json` 里的 API key 只是占位符，部署前请改成自己的。
- 如果上传脚本也要打点，需要同时配置 `SUB2API_METRICS_ENDPOINT` 和 `SUB2API_METRICS_API_KEY`，或者在命令行显式传参。