初始化

This commit is contained in:
gozeros committed 2026-09-07 18:24:55 +08:00
1 parent 34474bd5fc
commit b638b541d0
3008 files changed
+837699

No files matched your search

@@ -0,0 +1,48 @@
# 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,需要下载对应平台版本。