手把手教你离线部署Selenium：从下载到安装的完整指南

1. 为什么需要离线安装Selenium？

在实际开发中，我们经常会遇到一些特殊环境：比如企业内网开发机、保密项目服务器，或者网络条件受限的生产环境。这些地方往往无法直接联网安装Python包，这时候就需要掌握离线安装技能。我去年参与过一个银行系统升级项目，所有服务器都处于物理隔离状态，正是靠这套方法才顺利完成自动化测试环境的搭建。

离线安装的核心思路很简单：先在能上网的机器下载好安装包，再通过U盘或内部网络传输到目标机器。听起来容易，但实际操作时会遇到不少坑。比如依赖包缺失、版本不匹配、系统环境差异等问题。下面我就把踩过的坑和解决方案都整理出来，帮你一次搞定。

2. 准备离线安装包

2.1 选择合适的Selenium版本

首先访问PyPI官网（https://pypi.org/project/selenium），不要直接点击下载按钮，而是找到页面右侧的"Release history"链接。这里有个小技巧：建议选择3.x系列的稳定版本，比如3.141.0。新版4.x虽然功能更强，但对浏览器驱动的要求更高，离线环境下调试会更麻烦。

我推荐3.141.0这个版本是因为：

• 兼容Python 2.7和3.x
• 支持主流浏览器稳定版本
• 经过长期验证的可靠性

2.2 下载安装包的两种方式

进入版本详情页后，点击"Download files"会看到两种包格式：

1. 源码包（.tar.gz后缀）：适合需要自定义修改的情况
2. 预编译包（.whl后缀）：推荐大多数用户使用

以selenium-3.141.0为例：

• 源码包文件名：selenium-3.141.0.tar.gz
• whl包文件名：selenium-3.141.0-py2.py3-none-any.whl

建议两个都下载备用，whl包安装更简单，但某些特殊环境可能需要从源码编译。

3. 处理依赖关系

3.1 识别依赖包

Selenium本身依赖不多，但实际使用时需要浏览器驱动。执行以下命令可以查看完整依赖：

pip download selenium==3.141.0 --no-deps pip show selenium

关键依赖包括：

• urllib3：网络请求库
• certifi：SSL证书验证

3.2 下载依赖包

在有网络的机器上执行：

pip download selenium==3.141.0 --dest ./offline_packages

这个命令会把所有依赖包都下载到offline_packages目录。记得把浏览器驱动（如chromedriver）也打包进去，不同系统需要不同版本。

4. 离线安装实战

4.1 使用whl包安装

这是最简单的方式，把下载的.whl文件拷贝到目标机器后：

pip install --no-index --find-links=/path/to/offline_packages selenium-3.141.0-py2.py3-none-any.whl

参数说明：

• --no-index：禁止从PyPI下载
• --find-links：指定本地包目录

4.2 从源码安装

如果需要自定义修改，可以解压.tar.gz文件：

tar -xzvf selenium-3.141.0.tar.gz cd selenium-3.141.0 python setup.py install

源码安装可能需要额外开发工具，比如gcc和Python头文件。在Ubuntu上可以提前准备：

sudo apt-get install python3-dev build-essential

5. 验证安装结果

安装完成后，做个简单测试：

from selenium import webdriver driver = webdriver.Chrome(executable_path='/path/to/chromedriver') driver.get("http://www.example.com") print(driver.title) driver.quit()

常见问题排查：

1. ImportError：检查Python环境是否匹配
2. DriverNotFound：确认浏览器驱动路径正确
3. 版本冲突：用pip check命令验证

6. 浏览器驱动的特殊处理

离线环境下最麻烦的是浏览器驱动管理。以Chrome为例：

1. 在有网络的机器访问 https://chromedriver.chromium.org/downloads
2. 下载与本地Chrome版本匹配的驱动
3. 通过版本号命令检查兼容性：

chromedriver --version google-chrome --version

建议把常用浏览器驱动都打包成一个离线资源库，我通常这样组织目录：

offline_selenium/ ├── packages/ │ ├── selenium-3.141.0-py2.py3-none-any.whl │ └── urllib3-1.26.5-py2.py3-none-any.whl └── drivers/ ├── linux/ │ └── chromedriver ├── windows/ │ └── chromedriver.exe └── mac/ └── chromedriver

7. 进阶技巧：创建离线安装脚本

对于需要频繁部署的环境，可以编写自动化脚本：

#!/bin/bash # offline_install.sh INSTALL_DIR="/opt/selenium_offline" DRIVER_PATH="$INSTALL_DIR/drivers/$(uname -s)" # 安装Python包 pip install --no-index --find-links=$INSTALL_DIR/packages selenium # 设置浏览器驱动 mkdir -p /usr/local/bin/ cp "$DRIVER_PATH/chromedriver" /usr/local/bin/ chmod +x /usr/local/bin/chromedriver # 验证安装 python -c "from selenium import webdriver; print(webdriver.__version__)"

这个脚本可以大大简化部署流程，特别是在多台机器上部署时。我在实际项目中用类似脚本把部署时间从2小时缩短到10分钟。