Netmiko 离线安装需在**无外网访问能力的目标环境（如生产内网、隔离 CentOS 7 主机）**中，通过预下载依赖链并适配平台架构完成部署。其本质是绕过 `pip install netmiko` 的在线解析与递归拉取机制，转为手动管理 `.whl`/`.tar.gz` 包及其全部运行时依赖。以下从**问题解构→方案推演→实操验证**三阶段展开。 --- ### 一、问题解构：离线安装的三大核心约束 | 约束维度 | 具体表现 | 根本原因 | |----------|----------|----------| | **网络隔离** | 目标主机无法访问 PyPI 或镜像源 | 安全策略或物理断网 | | **平台异构** | 下载环境（Windows/macOS）与目标环境（CentOS 7 x86_64）ABI 不兼容 | `.whl` 文件含平台标签（如 `cp39-cp39-manylinux_2_17_x86_64`），Windows 下下载的 `win_amd64` 包无法在 Linux 运行 [ref_2] | | **依赖闭环** | Netmiko 依赖 `paramiko`（→ `cryptography`, `pycparser`, `setuptools`, `wheel` 等）及 `scp`、`textfsm`、`ntc-templates`（可选） | `pip download --no-deps` 仅得主包，缺失依赖将导致 `ImportError` [ref_1] | --- ### 二、方案推演：双机协同离线部署流程 #### ✅ 推荐路径（基于 [ref_2] 实践验证） ```mermaid graph LR A[联网 Windows 机] -->|1. pip download --platform manylinux2014_x86_64<br>--python-version 39<br>--only-binary=all netmiko| B[下载所有 .whl] B -->|2. 替换平台标签| C[重命名：netmiko-4.3.0-py3-none-any.whl →<br>netmiko-4.3.0-py3-none-manylinux2014_x86_64.whl] C -->|3. lrzsz/winscp 上传| D[CentOS 7 目标机] D -->|4. pip install --find-links ./packages --no-index --trusted-host None netmiko| E[成功安装] ``` > ⚠️ 关键细节： > - `--platform manylinux2014_x86_64` 强制指定目标平台（CentOS 7 默认 ABI）； > - `--python-version 39` 需与目标 `python3.9` 版本严格一致； > - `--only-binary=all` 防止触发源码编译（避免缺失 `gcc`, `openssl-devel` 等构建工具）[ref_2]。 #### ❌ 常见失效路径 - 直接复制 Windows 下 `pip download netmiko` 生成的 `win_amd64` 包 → 安装报错 `ERROR: netmiko-4.3.0-py3-none-win_amd64.whl is not a supported wheel on this platform` [ref_2]； - 忽略 `cryptography` 依赖 → 运行时报 `ModuleNotFoundError: No module named 'cryptography.hazmat.primitives.asymmetric'` [ref_1]。 --- ### 三、实操代码：全链路离线安装脚本 #### 步骤 1：联网机批量下载（Windows PowerShell） ```powershell # 创建下载目录 mkdir netmiko_offline && cd netmiko_offline # 下载 netmiko 及全部依赖（指定 CentOS 7 兼容平台） pip download --platform manylinux2014_x86_64 ` --python-version 39 ` --only-binary=all ` --no-deps netmiko pip download --platform manylinux2014_x86_64 ` --python-version 39 ` --only-binary=all ` --no-deps paramiko cryptography pyyaml scp textfsm ntc-templates # 合并所有 .whl 到同一目录（自动去重） Get-ChildItem -Recurse -Filter "*.whl" | ForEach-Object { $target = Join-Path (Get-Location) $_.Name if (-not (Test-Path $target)) { Move-Item $_.FullName $target } } ``` #### 步骤 2：CentOS 7 目标机安装（bash） ```bash # 上传后进入包目录 cd /root/netmiko_offline # 批量重命名平台标签（修复 Windows 下下载的包名） for whl in *.whl; do if [[ $whl == *"win_amd64"* ]]; then new_name=$(echo "$whl" | sed 's/win_amd64/manylinux2014_x86_64/g') mv "$whl" "$new_name" fi done # 离线安装（--find-links 指向本地目录，--no-index 禁用网络索引） pip3 install --find-links . --no-index --trusted-host None netmiko # 验证 python3 -c "from netmiko import ConnectHandler; print('Netmiko OK')" ``` > ✅ 验证输出：`Netmiko OK` 表示安装成功且可导入 [ref_3]。 > 📌 补充：若需连接华为设备，还需 `pip3 install --find-links . --no-index textfsm ntc-templates` 加载模板 [ref_3]。 --- ### 四、替代方案对比（适用场景决策） | 方案 | 适用场景 | 优势 | 劣势 | 来源依据 | |------|----------|------|------|----------| | **`pip download + 平台重写`** | 企业级离线环境（CentOS/RHEL） | 依赖可控、版本精确、无需 Docker | 步骤繁琐，需人工校验 ABI | [ref_2] | | **`conda-pack` 打包** | 已部署 conda 的科研/测试环境 | 自动解决 C 依赖（如 `openssl`）、跨平台移植性强 | 包体积大（>200MB），不适用于轻量容器 | — | | **Docker 镜像分发** | K8s/容器化网络自动化平台 | 环境完全隔离，一键部署 | 需额外维护镜像仓库与 CI 流程 | [ref_5] | --- 综上，Netmiko 离线安装的本质是**依赖拓扑的静态快照+平台 ABI 显式声明**。任何跳过 `--platform` 和 `--python-version` 参数的“快捷方法”，在 CentOS 7 等旧系统上均存在 runtime failure 风险 [ref_2]。