From 7414c3713fdc09e31dea5a3062a993c2585b0ccd Mon Sep 17 00:00:00 2001 From: waxgourd Date: Wed, 17 Sep 2025 18:58:27 +0800 Subject: [PATCH] =?UTF-8?q?=E9=A6=96=E6=AC=A1=E6=8E=A8=E5=87=BAbleachwrt?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- bleachwrt-plus/CHANGELOG.md | 2 + bleachwrt-plus/DOCS.md | 116 +++++++++++++++++++++++ bleachwrt-plus/README.md | 51 ++++++++++ bleachwrt-plus/config.yaml | 39 ++++++++ bleachwrt-plus/translations/en.yaml | 20 ++++ bleachwrt-plus/translations/zh-Hans.yaml | 20 ++++ 6 files changed, 248 insertions(+) create mode 100644 bleachwrt-plus/CHANGELOG.md create mode 100644 bleachwrt-plus/DOCS.md create mode 100644 bleachwrt-plus/README.md create mode 100644 bleachwrt-plus/config.yaml create mode 100644 bleachwrt-plus/translations/en.yaml create mode 100644 bleachwrt-plus/translations/zh-Hans.yaml diff --git a/bleachwrt-plus/CHANGELOG.md b/bleachwrt-plus/CHANGELOG.md new file mode 100644 index 0000000..24ca3d1 --- /dev/null +++ b/bleachwrt-plus/CHANGELOG.md @@ -0,0 +1,2 @@ +## 20250604 (2025-06-06) +- 首次推出 diff --git a/bleachwrt-plus/DOCS.md b/bleachwrt-plus/DOCS.md new file mode 100644 index 0000000..46ef000 --- /dev/null +++ b/bleachwrt-plus/DOCS.md @@ -0,0 +1,116 @@ +# 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 +``` diff --git a/bleachwrt-plus/README.md b/bleachwrt-plus/README.md new file mode 100644 index 0000000..370b8d0 --- /dev/null +++ b/bleachwrt-plus/README.md @@ -0,0 +1,51 @@ +# BleachWRT Plus + +适用于旁路由管理的 Home Assistant 加载项，提供完整的旁路由功能和 Web 管理界面。 + +## 功能特点 + +- 完整的 OpenWRT 旁路由功能 +- 内置 Web 管理界面 +- 支持 IP 转发 +- 自动网络配置 +- 自动 DHCP 配置（默认禁用） +- 支持日志级别调整 + +## 安装方法 + +1. 在 Home Assistant 中添加本仓库作为自定义存储库 +2. 在加载项商店中找到并安装"BleachWRT Plus" +3. 等待安装完成 + +## 配置选项 + +| 选项 | 描述 | 默认值 | +| ----------------- | -------------------- | -------------- | +| virtual_ip | 旁路由虚拟 IP 地址 | 192.168.68.111 | +| netmask | 子网掩码 | 255.255.255.0 | +| gateway | 网关地址 | 192.168.68.1 | +| enable_forwarding | 是否启用 IP 转发 | true | +| log_level | 日志级别(info/debug) | info | + +## 使用方法 + +1. 安装加载项 +2. 配置虚拟 IP 和网络参数 +3. 点击启动，等待约 1 分钟让服务完全启动 +4. 访问 http://[虚拟 IP] 进入 Web 管理界面 + +默认管理员账号密码：root/password + +## 常见问题 + +- **无法访问 Web 界面**：请检查网络配置是否正确，确保虚拟 IP 与您的网络环境匹配 +- **网络连接问题**：将日志级别设置为"debug"获取更详细的诊断信息 +- **DHCP 冲突**：本插件默认已禁用 DHCP 服务器功能，避免与主路由 DHCP 冲突 + +详细使用说明请参阅 DOCS.md 文档。 + +## 支持与反馈 + +本项目基于[openwrt](https://openwrt.mpdn.fun/?dir=lede)开发。 + +如有问题或建议，请在 GitHub 仓库提交 Issue。 diff --git a/bleachwrt-plus/config.yaml b/bleachwrt-plus/config.yaml new file mode 100644 index 0000000..9d1f445 --- /dev/null +++ b/bleachwrt-plus/config.yaml @@ -0,0 +1,39 @@ +name: "BleachWRT Plus" +version: "20250604" +slug: "bleachwrt_plus" +description: "BleachWRT Plus - 提供旁路由管理功能，集成WEB管理界面" +url: "https://gitcode.com/waxgourd/addons" +arch: + - aarch64 +startup: application +boot: manual +ports: + 80/tcp: 80 +ports_description: + 80/tcp: "WEB服务端口" +init: false +host_network: true +privileged: + - NET_ADMIN + - SYS_ADMIN + - SYS_RAWIO + - SYS_TIME + - SYS_NICE + - SYS_MODULE + - NET_RAW +webui: "http://[HOST]:[PORT:80]/" +watchdog: "http://[HOST]:[PORT:80]/" +apparmor: false +options: + virtual_ip: 192.168.68.111 + netmask: 255.255.255.0 + gateway: 192.168.68.1 + enable_forwarding: true + log_level: "info" +schema: + virtual_ip: str + netmask: str + gateway: str + enable_forwarding: bool + log_level: list(info|debug) +image: r.hassbus.com/wghaos/bleachwrt-{arch} diff --git a/bleachwrt-plus/translations/en.yaml b/bleachwrt-plus/translations/en.yaml new file mode 100644 index 0000000..34ebbb7 --- /dev/null +++ b/bleachwrt-plus/translations/en.yaml @@ -0,0 +1,20 @@ +--- +configuration: + virtual_ip: + name: "Virtual IP Address" + description: "Set the IP address for OpenWrt LAN interface (required)" + netmask: + name: "Subnet Mask" + description: "Set the subnet mask for OpenWrt LAN interface (default: 255.255.255.0)" + gateway: + name: "Default Gateway" + description: "Set the default gateway for OpenWrt LAN interface" + enable_forwarding: + name: "Enable IP Forwarding" + description: "Enable IP forwarding to allow packets to be routed through this device (default: enabled)" + log_level: + name: "Log Level" + description: "Set the log level (default: info)" + +network: + 80/tcp: "Web management interface port" diff --git a/bleachwrt-plus/translations/zh-Hans.yaml b/bleachwrt-plus/translations/zh-Hans.yaml new file mode 100644 index 0000000..f8bd7b0 --- /dev/null +++ b/bleachwrt-plus/translations/zh-Hans.yaml @@ -0,0 +1,20 @@ +--- +configuration: + virtual_ip: + name: "虚拟IP地址" + description: "设置OpenWrt的LAN接口IP地址（必填项）" + netmask: + name: "子网掩码" + description: "设置OpenWrt的LAN接口子网掩码（默认: 255.255.255.0）" + gateway: + name: "默认网关" + description: "设置OpenWrt的LAN接口默认网关" + enable_forwarding: + name: "启用IP转发" + description: "启用IP转发功能，允许数据包通过此设备转发（默认: 启用）" + log_level: + name: "日志级别" + description: "设置日志级别（默认: info）" + +network: + 80/tcp: "Web管理界面端口"