mirror of
https://github.com/foxhui/WebAI2API.git
synced 2026-06-16 21:03:59 +08:00
docs: 更新文档
This commit is contained in:
foxhui
@@ -46,8 +46,8 @@
|
||||
添加或修改以下内容：
|
||||
|
||||
```bash
|
||||
# 使用 zstd 压缩算法，速度和压缩率最平衡
|
||||
ALGO=zstd
|
||||
# 使用 lz4 压缩算法，速度和压缩率最平衡
|
||||
ALGO=lz4
|
||||
|
||||
# 使用内存总量的 60% 作为 ZRAM 大小
|
||||
PERCENT=60
|
||||
@@ -85,8 +85,8 @@
|
||||
[zram0]
|
||||
# 使用内存总量的 60%
|
||||
zram-size = ram * 0.6
|
||||
# 使用 zstd 压缩算法
|
||||
compression-algorithm = zstd
|
||||
# 使用 lz4 压缩算法
|
||||
compression-algorithm = lz4
|
||||
# 优先级高于磁盘 Swap
|
||||
swap-priority = 100
|
||||
```
|
||||
@@ -102,7 +102,7 @@
|
||||
无论使用哪种系统，都建议调整 `swappiness` 以更积极地使用 ZRAM。
|
||||
|
||||
```bash
|
||||
grep -q "vm.swappiness" /etc/sysctl.conf || echo "vm.swappiness=80" | tee -a /etc/sysctl.conf
|
||||
grep -q "vm.swappiness" /etc/sysctl.conf || echo "vm.swappiness=20" | tee -a /etc/sysctl.conf
|
||||
sysctl -p
|
||||
```
|
||||
|
||||
|
||||
@@ -57,6 +57,27 @@ browser:
|
||||
# ⚠️ 风险提示: 正常 Firefox 用户默认开启 Fission，虽然关闭它不会泄露常规指纹，
|
||||
# 但极高阶的反爬系统可能会通过检测“单进程模型”或“跨进程通信延迟”来识别自动化特征！
|
||||
fission: true
|
||||
|
||||
# CSS 性能优化注入
|
||||
# 通过禁用网页特效在无显卡环境下降低 CPU 压力
|
||||
cssInject:
|
||||
# 禁用网页动画
|
||||
# 作用：移除 transition 和 animation
|
||||
# 收益：显著降低 CPU 持续占用
|
||||
# 风险：极低。几乎不影响浏览器指纹
|
||||
animation: false
|
||||
|
||||
# 禁用滤镜和阴影
|
||||
# 作用：移除 blur(模糊)、box-shadow(阴影) 等复杂渲染
|
||||
# 收益：在无显卡环境下，能避免 CPU 占用 100% 导致卡顿
|
||||
# 风险：中。界面会变得难看，少数反爬可能会检测样式计算结果
|
||||
filter: false
|
||||
|
||||
# 降低字体渲染质量
|
||||
# 作用：关闭字体抗锯齿，强制使用极速渲染模式
|
||||
# 收益：微量减少 CPU 绘图压力
|
||||
# ⚠️ 风险：高。会导致文字边缘有锯齿，且可能导致字体指纹与标准浏览器不符（易被高级反爬识别）
|
||||
font: false
|
||||
|
||||
# [全局代理] 如果 Instance 没有独立配置代理，将使用此配置
|
||||
proxy:
|
||||
@@ -109,6 +130,26 @@ browser:
|
||||
| `headless` | boolean | `false` | 是否启用无头模式 |
|
||||
| `fission` | boolean | `true` | 是否启用站点隔离 (fission.autostart) |
|
||||
| `proxy` | object | - | 全局代理配置 |
|
||||
| `cssInject` | object | - | CSS 性能优化注入配置 |
|
||||
|
||||
#### CSS 优化注入 (cssInject)
|
||||
|
||||
针对无显卡 (CPU-Only) 环境的性能优化选项。通过注入 CSS 禁用部分网页特效来降低 CPU 负载。
|
||||
|
||||
| 配置项 | 类型 | 默认值 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| `animation` | boolean | `false` | **禁用动画** (推荐)<br>作用：移除 transition 和 animation<br>收益：显著降低 CPU 持续占用<br>风险：极低 (几乎不影响指纹) |
|
||||
| `filter` | boolean | `false` | **禁用特效**<br>作用：移除 blur、box-shadow 等<br>收益：避免复杂渲染导致的卡顿<br>风险：中 (界面美观度下降，极少反爬检测) |
|
||||
| `font` | boolean | `false` | **极速字体**<br>作用：关闭字体抗锯齿<br>收益：微量减少绘图压力<br>风险：**高** (字体指纹异常，易被高级反爬识别) |
|
||||
|
||||
### 后端资源池 (backend.pool)
|
||||
|
||||
| 配置项 | 类型 | 默认值 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| `strategy` | string | `least_busy` | 负载均衡策略，可选：`least_busy` |
|
||||
| `failover.enabled` | boolean | `true` | 是否启用故障自动转移 |
|
||||
| `failover.maxRetries` | number | `2` | 故障转移最大重试次数 |
|
||||
| `instances` | array | - | 浏览器实例列表，详见 [实例配置](/config/instances) |
|
||||
|
||||
### 适配器配置 (backend.adapter)
|
||||
|
||||
|
||||
@@ -50,8 +50,8 @@ This English version is translated by **Gemini 3 Flash**.
|
||||
Add or modify the following:
|
||||
|
||||
```bash
|
||||
# Use zstd compression algorithm for the best balance of speed and ratio
|
||||
ALGO=zstd
|
||||
# Use lz4 compression algorithm for the best balance of speed and ratio
|
||||
ALGO=lz4
|
||||
|
||||
# Use 60% of total memory as ZRAM size
|
||||
PERCENT=60
|
||||
@@ -89,8 +89,8 @@ Recommended to use `zram-generator` for these systems.
|
||||
[zram0]
|
||||
# Use 60% of total memory
|
||||
zram-size = ram * 0.6
|
||||
# Use zstd compression algorithm
|
||||
compression-algorithm = zstd
|
||||
# Use lz4 compression algorithm
|
||||
compression-algorithm = lz4
|
||||
# Higher priority than disk Swap
|
||||
swap-priority = 100
|
||||
```
|
||||
@@ -106,7 +106,7 @@ Recommended to use `zram-generator` for these systems.
|
||||
Regardless of the system, it is recommended to adjust `swappiness` to use ZRAM more aggressively.
|
||||
|
||||
```bash
|
||||
grep -q "vm.swappiness" /etc/sysctl.conf || echo "vm.swappiness=80" | tee -a /etc/sysctl.conf
|
||||
grep -q "vm.swappiness" /etc/sysctl.conf || echo "vm.swappiness=20" | tee -a /etc/sysctl.conf
|
||||
sysctl -p
|
||||
```
|
||||
|
||||
|
||||
@@ -61,6 +61,27 @@ browser:
|
||||
# ⚠️ Risk: Normal Firefox users have Fission enabled by default. While disabling it does not leak common fingerprints,
|
||||
# extremely advanced anti-bot systems might identify automated features via "single-process model" or "IPC delays".
|
||||
fission: true
|
||||
|
||||
# CSS Performance Injection
|
||||
# Reduce CPU load by disabling web effects (Best for CPU-only environments)
|
||||
cssInject:
|
||||
# Disable web animations
|
||||
# Effect: Removes transition and animation
|
||||
# Benefit: Significantly lowers continuous CPU usage
|
||||
# Risk: Very low. Almost no impact on browser fingerprint
|
||||
animation: false
|
||||
|
||||
# Disable filters and shadows
|
||||
# Effect: Removes blur, box-shadow, etc.
|
||||
# Benefit: Prevents CPU spikes and lag in no-GPU environments
|
||||
# Risk: Medium. Interface aesthetics degraded, few anti-bots might detect style calculations
|
||||
filter: false
|
||||
|
||||
# Reduce font rendering quality
|
||||
# Effect: Disables font anti-aliasing, forces fast rendering mode
|
||||
# Benefit: Slightly reduces CPU drawing pressure
|
||||
# ⚠️ Risk: High. Jagged text edges; font fingerprint differs from standard browsers (detected by advanced anti-bots)
|
||||
font: false
|
||||
|
||||
# [Global Proxy] Used if an Instance does not have its own proxy configuration
|
||||
proxy:
|
||||
@@ -113,6 +134,26 @@ browser:
|
||||
| `headless` | boolean | `false` | Whether to enable headless mode. |
|
||||
| `fission` | boolean | `true` | Whether to enable Site Isolation (fission.autostart). |
|
||||
| `proxy` | object | - | Global proxy configuration. |
|
||||
| `cssInject` | object | - | CSS performance injection configuration. |
|
||||
|
||||
#### CSS Injection (cssInject)
|
||||
|
||||
Performance optimization options for CPU-Only environments. Reduces CPU load by disabling specific web effects via CSS injection.
|
||||
|
||||
| Item | Type | Default | Description |
|
||||
| --- | --- | --- | --- |
|
||||
| `animation` | boolean | `false` | **Disable Animations** (Recommended)<br>Effect: Removes transition and animation.<br>Benefit: Significantly reduces continuous CPU usage.<br>Risk: Very Low (Negligible impact on fingerprint). |
|
||||
| `filter` | boolean | `false` | **Disable Effects**<br>Effect: Removes blur, box-shadow, etc.<br>Benefit: Prevents UI lag caused by complex rendering.<br>Risk: Medium (UI Aesthetics degraded, rarely checked by anti-bots). |
|
||||
| `font` | boolean | `false` | **Fast Rendering Fonts**<br>Effect: Disables font anti-aliasing.<br>Benefit: Slightly reduces rendering pressure.<br>Risk: **High** (Font fingerprint anomaly, easily detected by advanced anti-bots). |
|
||||
|
||||
### Backend Resource Pool (backend.pool)
|
||||
|
||||
| Item | Type | Default | Description |
|
||||
| --- | --- | --- | --- |
|
||||
| `strategy` | string | `least_busy` | Load balancing strategy. Option: `least_busy`. |
|
||||
| `failover.enabled` | boolean | `true` | Whether to enable automatic failover. |
|
||||
| `failover.maxRetries` | number | `2` | Maximum retry attempts for failover. |
|
||||
| `instances` | array | - | List of browser instances. See [Instances Configuration](/en/config/instances). |
|
||||
|
||||
### Adapter Configuration (backend.adapter)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user