117 lines
3.8 KiB
Markdown
117 lines
3.8 KiB
Markdown
# BleachWRT Plus 使用文档
|
||
|
||
## 简介
|
||
|
||
BleachWRT Plus 是一个基于 OpenWRT 的 Home Assistant 加载项，提供旁路由功能和完整的 Web 管理界面。本加载项可以让您的 Home Assistant 设备同时作为网络旁路由使用，提供丰富的网络管理功能。
|
||
|
||
## 安装前准备
|
||
|
||
在安装和配置 BleachWRT Plus 之前，请确保您了解以下内容：
|
||
|
||
1. 旁路由的基本工作原理
|
||
2. 您当前网络的 IP 地址范围、网关地址和子网掩码
|
||
3. 确保选择的虚拟 IP 不会与现有网络中的设备冲突
|
||
|
||
## 安装步骤
|
||
|
||
1. 在 Home Assistant 中添加本仓库作为自定义存储库
|
||
2. 在加载项商店中找到并安装"BleachWRT Plus"
|
||
3. 等待安装完成
|
||
4. 进入加载项配置页面，设置必要的网络参数
|
||
|
||
## 配置选项详解
|
||
|
||
### 基本网络配置
|
||
|
||
| 选项 | 描述 | 默认值 | 说明 |
|
||
| ----------------- | ------------------ | -------------- | ------------------------------------------------ |
|
||
| virtual_ip | 旁路由虚拟 IP 地址 | 192.168.68.111 | 设置为与您主网络同一网段但未被使用的 IP 地址 |
|
||
| netmask | 子网掩码 | 255.255.255.0 | 通常保持默认值即可 |
|
||
| gateway | 网关地址 | 192.168.68.1 | 设置为您主路由器的 IP 地址 |
|
||
| enable_forwarding | 是否启用 IP 转发 | true | 启用后可实现旁路由功能 |
|
||
| log_level | 日志级别 | info | 可选值：info（基本信息）或 debug（详细调试信息） |
|
||
|
||
### 网络配置示例
|
||
|
||
假设您的主路由器 IP 为 192.168.1.1，网络段为 192.168.1.0/24：
|
||
|
||
```yaml
|
||
virtual_ip: 192.168.1.111
|
||
netmask: 255.255.255.0
|
||
gateway: 192.168.1.1
|
||
enable_forwarding: true
|
||
log_level: info
|
||
```
|
||
|
||
## 使用指南
|
||
|
||
### 首次访问
|
||
|
||
1. 配置完成并启动加载项后，等待约 1 分钟让所有服务完全启动
|
||
2. 使用浏览器访问您设置的虚拟 IP 地址：http://[虚拟 IP]
|
||
3. 使用默认账号密码登录：root/password
|
||
4. 首次登录后，建议立即修改默认密码
|
||
|
||
### 基本功能
|
||
|
||
BleachWRT Plus 提供了丰富的功能，包括但不限于：
|
||
|
||
- 网络状态监控
|
||
- 防火墙配置
|
||
- 流量统计
|
||
- 端口转发
|
||
- 自定义防火墙规则
|
||
- 软件包管理
|
||
|
||
### DHCP 配置
|
||
|
||
本加载项默认已禁用 DHCP 服务器功能（option ignore '1'），以避免与主路由器的 DHCP 服务冲突。如需启用，可通过 Web 界面修改 DHCP 配置。
|
||
|
||
## 故障排除
|
||
|
||
### 无法访问 Web 界面
|
||
|
||
1. 检查虚拟 IP 配置是否正确
|
||
2. 确认 Home Assistant 主机能够正常访问网络
|
||
3. 检查加载项日志，将 log_level 设置为"debug"获取更详细信息
|
||
4. 确认主机防火墙未阻止相关端口
|
||
|
||
### 网络连接问题
|
||
|
||
1. 检查虚拟 IP 与网关配置是否正确
|
||
2. 确认 IP 转发功能已启用
|
||
3. 查看详细日志以排查网络接口配置问题
|
||
4. 检查 NAT 规则是否正确设置
|
||
|
||
### 性能优化
|
||
|
||
1. 如果不需要详细日志，将 log_level 设置为"info"可减少日志输出
|
||
2. 根据实际需求启用或禁用不必要的服务
|
||
3. 定期清理缓存和日志文件
|
||
|
||
## 更新与维护
|
||
|
||
1. 定期检查加载项更新
|
||
2. 更新前建议备份重要配置
|
||
3. 更新后可能需要重新配置部分设置
|
||
|
||
## 支持与反馈
|
||
|
||
如有问题或建议，请通过以下方式获取支持：
|
||
|
||
1. 查阅本文档
|
||
2. 在 GitHub 仓库提交 Issue
|
||
3. 在 Home Assistant 社区论坛寻求帮助
|
||
|
||
本项目基于[BleachWRT](https://openwrt.mpdn.fun/?dir=lede)开发。
|
||
|
||
```bash
|
||
# 需要在宿主机上进行下面操作
|
||
|
||
#开启桥接网卡混淆模式
|
||
ip link set end0 promisc on
|
||
|
||
# 添加macvlan
|
||
ip link add mynet link end0 type macvlan mode bridge
|
||
```
|