Skip to content

Commit c342656

Browse files
Document Camoufox proxy error and fix
Added troubleshooting section for Camoufox proxy error.
1 parent 7138ee4 commit c342656

1 file changed

Lines changed: 37 additions & 0 deletions

File tree

docs/troubleshooting.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -113,6 +113,43 @@ source venv/bin/activate # Linux/macOS
113113

114114
- 或修改 [`launch_camoufox.py`](../launch_camoufox.py)`--server-port` 参数。
115115

116+
### Camoufox 启动时 proxy 错误
117+
118+
**问题现象**: 未配置代理环境变量时,Camoufox 启动失败:
119+
120+
```
121+
Error: proxy: expected object, got null
122+
```
123+
124+
**原因**: Camoufox 0.4.11 的 utils.py 会无条件传递 proxy 参数给 Playwright,即使值为 None。
125+
126+
**修复方法**: 修改 Camoufox 源码文件:
127+
128+
```
129+
/usr/local/lib/python3.10/site-packages/camoufox/utils.py
130+
```
131+
132+
`launch_options` 函数中,将:
133+
134+
```python
135+
return {
136+
...
137+
"proxy": proxy,
138+
...
139+
}
140+
```
141+
142+
改为:
143+
144+
```python
145+
result = {
146+
... # 删除 "proxy": proxy,其他配置保持不变
147+
}
148+
if proxy is not None:
149+
result["proxy"] = proxy
150+
return result
151+
```
152+
116153
## 认证相关问题
117154

118155
### 认证失败 (特别是无头模式)

0 commit comments

Comments
 (0)