更新 'repository.yaml'

2025-11-06 11:33:12 +00:00
parent 2f5067f5e3
commit 32d8b84bbe
501 changed files with 13838 additions and 1 deletions
--- a/bleachwrt-plus/CHANGELOG.md
+++ b/bleachwrt-plus/CHANGELOG.md
@@ -0,0 +1,6 @@
+## 20250924 (2025-09-24)
+- 版本升级
+## 20250922 (2025-09-22)
+- 版本升级
+## 20250604 (2025-06-06)
+- 首次推出
--- a/bleachwrt-plus/DOCS.md
+++ 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
+```
--- a/bleachwrt-plus/README.md
+++ 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。
--- a/bleachwrt-plus/config.yaml
+++ b/bleachwrt-plus/config.yaml
@@ -0,0 +1,40 @@
+name: "BleachWRT Plus"
+version: "20250924"
+slug: "bleachwrt_plus"
+description: "BleachWRT Plus - 提供旁路由管理功能，集成WEB管理界面"
+url: "https://gitcode.com/waxgourd/addons"
+arch:
+  - aarch64
+  - amd64
+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}
--- a/bleachwrt-plus/translations/en.yaml
+++ 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"
--- a/bleachwrt-plus/translations/zh-Hans.yaml
+++ 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管理界面端口"