# asyncmy 离线安装说明

本目录用于给无法联网的后端服务器补装 MySQL 异步驱动 `asyncmy==0.2.11`。

项目的 `pyproject.toml` 已经声明该依赖；服务器启动报 `MySQL async driver is not installed`，说明实际运行后端的 Python 虚拟环境尚未安装它。

## 文件选择

- `asyncmy-0.2.11-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl`：Ubuntu、CentOS、RHEL、Debian 等常见 glibc Linux（x86_64）。
- `asyncmy-0.2.11-cp312-cp312-musllinux_1_2_x86_64.whl`：Alpine Linux（x86_64）。

这两个 wheel 都只适用于 **CPython 3.12、x86_64**。在服务器执行 `python -V` 和 `uname -m` 确认：应分别显示 Python 3.12 和 `x86_64`/`amd64`。

## 安装步骤

1. 将整个 `offline-wheels` 目录复制到后端目录（与 `pyproject.toml` 同级）。
2. 进入后端实际运行的虚拟环境；若项目使用默认虚拟环境：

   ```bash
   cd /path/to/backend
   source .venv/bin/activate
   ```

3. 普通 Linux（Ubuntu/CentOS/RHEL/Debian）执行：

   ```bash
   python -m pip install --no-index ./offline-wheels/asyncmy/asyncmy-0.2.11-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
   ```

   Alpine Linux 则执行：

   ```bash
   python -m pip install --no-index ./offline-wheels/asyncmy/asyncmy-0.2.11-cp312-cp312-musllinux_1_2_x86_64.whl
   ```

4. 验证：

   ```bash
   python -c "import asyncmy; print(asyncmy.__version__)"
   ```

5. 重启后端服务。

## 注意事项

- 必须使用**启动后端服务的同一个 Python/虚拟环境**安装，系统 Python 安装成功并不代表服务能找到该包。
- 不要使用 `--force-reinstall`；安装缺失的 `asyncmy` 即可。
- 若服务器是 Python 3.13、ARM/aarch64，或不是上述 Linux 类型，请不要安装本目录 wheel，需要下载对应平台版本。