133 lines
3.0 KiB
Markdown
133 lines
3.0 KiB
Markdown
# Ubuntu 快速入门指南
|
||
|
||
## 快速安装（推荐）
|
||
|
||
使用自动安装脚本：
|
||
|
||
```bash
|
||
cd ~/project/jdpl # 进入项目目录
|
||
chmod +x jd/setup_ubuntu.sh
|
||
./jd/setup_ubuntu.sh
|
||
```
|
||
|
||
脚本会自动：
|
||
1. ✅ 检查并安装 Python3 和依赖
|
||
2. ✅ 检查并安装 Chrome/Chromium
|
||
3. ✅ 安装 Chrome 运行时依赖
|
||
4. ✅ 创建 Python 虚拟环境
|
||
5. ✅ 安装 DrissionPage
|
||
6. ✅ 创建便捷运行脚本
|
||
|
||
## 手动安装
|
||
|
||
### 1. 安装 Chrome
|
||
|
||
```bash
|
||
# Google Chrome (推荐)
|
||
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
|
||
sudo apt install -y ./google-chrome-stable_current_amd64.deb
|
||
|
||
# 或 Chromium
|
||
sudo apt install -y chromium-browser
|
||
```
|
||
|
||
### 2. 安装系统依赖
|
||
|
||
```bash
|
||
sudo apt update
|
||
sudo apt install -y python3 python3-pip python3-venv \
|
||
libnss3 libatk-bridge2.0-0 libdrm2 libxkbcommon0 \
|
||
libxcomposite1 libxdamage1 libxfixes3 libxrandr2 \
|
||
libgbm1 libasound2
|
||
```
|
||
|
||
### 3. 创建虚拟环境
|
||
|
||
```bash
|
||
cd ~/project/jdpl
|
||
python3 -m venv venv
|
||
source venv/bin/activate
|
||
pip install DrissionPage
|
||
deactivate
|
||
```
|
||
|
||
### 4. 运行脚本
|
||
|
||
```bash
|
||
# 方式1: 使用便捷脚本（如果运行了 setup_ubuntu.sh）
|
||
./run_logistics.sh
|
||
|
||
# 方式2: 手动运行
|
||
source venv/bin/activate
|
||
python jd/fetch_logistics_ubuntu.py
|
||
deactivate
|
||
```
|
||
|
||
## 常见问题
|
||
|
||
### Q: 遇到 "externally-managed-environment" 错误？
|
||
|
||
A: 这是 Ubuntu 22.04+ 的保护机制。**必须使用虚拟环境**，不要使用 `--break-system-packages`。
|
||
|
||
### Q: 虚拟环境在哪里？
|
||
|
||
A: 在项目目录下的 `venv` 文件夹。每次运行前需要激活：`source venv/bin/activate`
|
||
|
||
### Q: 找不到 Chrome？
|
||
|
||
A: 脚本会自动查找，也可以手动安装。常见路径：
|
||
- `/usr/bin/google-chrome`
|
||
- `/usr/bin/chromium-browser`
|
||
|
||
### Q: 无头模式 vs 有界面模式？
|
||
|
||
A: 在 `fetch_logistics_ubuntu.py` 中修改：
|
||
```python
|
||
USE_HEADLESS = True # 无头模式（服务器环境）
|
||
USE_HEADLESS = False # 有界面模式（需要图形界面）
|
||
```
|
||
|
||
### Q: 如何修改默认 URL？
|
||
|
||
A: 编辑 `fetch_logistics_ubuntu.py`，找到：
|
||
```python
|
||
tracking_url = "https://3.cn/2t-Iibig"
|
||
```
|
||
修改为你想要的 URL。
|
||
|
||
## 验证安装
|
||
|
||
运行测试：
|
||
|
||
```bash
|
||
source venv/bin/activate
|
||
python -c "
|
||
from DrissionPage import ChromiumPage, ChromiumOptions
|
||
import os
|
||
chrome_path = '/usr/bin/google-chrome'
|
||
if not os.path.exists(chrome_path):
|
||
chrome_path = '/usr/bin/chromium-browser'
|
||
options = ChromiumOptions()
|
||
options.set_browser_path(chrome_path)
|
||
options.headless(True)
|
||
page = ChromiumPage(options)
|
||
page.get('https://www.baidu.com')
|
||
print('✅ 测试成功！')
|
||
page.quit()
|
||
"
|
||
deactivate
|
||
```
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
jdpl/
|
||
├── jd/
|
||
│ ├── fetch_logistics_ubuntu.py # Ubuntu 主脚本
|
||
│ ├── setup_ubuntu.sh # 自动安装脚本
|
||
│ └── UBUNTU_SETUP.md # 详细文档
|
||
├── venv/ # Python 虚拟环境（运行脚本后创建）
|
||
└── run_logistics.sh # 便捷运行脚本（运行 setup 后创建）
|
||
```
|
||
|