警告：这是早期版本，请阅读截至目前所有版本的发布说明

OpenSOHO

文档

OpenSOHO 旨在管理少量基于 OpenWRT 的网络设备。因此得名 SOHO，即小型办公室/家庭办公室 (SOHO) 网络。

• 2 到 20 台设备（没有硬性限制）
• 不支持多租户
• 与 openwisp-config 和 openwisp-monitoring 兼容。
• 部署简单

它受 OpenWISP 的启发，但针对那些规模太小、不适合用 OpenWISP 维护的网络。正如 OpenWISP 所说：

然而，OpenWISP 可能不适合非常小的网络（少于 20 台设备）、缺乏 IT 专业知识的组织，或仅仅为了节省成本而寻求开源替代方案的企业。

以下版本已测试

• OpenWRT 24.10.x DSA
• OpenWRT 25.12.x DSA（测试版支持）

开始使用 OpenSOHO

概述

设置 OpenSOHO 只需几个简单步骤，以下各节详细介绍：

• 在服务器上安装 OpenSOHO。
• 在 OpenWRT 设备上安装 OpenWisp 软件包。
• 在每个 OpenWRT 设备上配置 OpenWisp，使其连接到 OpenSOHO。
• 开始在 OpenSOHO 中进行配置！

安装 OpenSOHO

• 下载最新的 OpenSOHO 版本（或使用 Docker 容器）

  版本发布

  使用 Docker、Podman 或 Kubernetes 设置

• 启动 OpenSOHO

首先，选择一个共享密钥，允许 OpenWRT 设备（使用 openwisp-config）注册到 OpenSOHO。

选择一个长的随机字符串以获得最佳安全性。

它应与下一步在 LuCI 中配置的内容一致。

OPENSOHO_SHARED_SECRET=randompassphrase ./opensoho serve --http 0.0.0.0:8090

现在，OpenSOHO 会在命令行输出一个 URL，允许你创建管理员账户。只需在浏览器中打开该 URL。

或者，通过命令行创建管理员账户：

./opensoho superuser upsert EMAIL PASS

配置（采用）OpenWRT 设备

安装 OpenWISP 软件包

opkg install openwisp-config openwisp-monitoring luci-app-openwisp # OpenWRT 24.10
apk add openwisp-config openwisp-monitoring luci-app-openwisp # OpenWRT 25.12+

如果你想使用 802.11v 客户端漫游，则需要完整的 wpad-mbedtls。

在 OpenWRT 24.10 上

opkg remove wpad-basic-mbedtls && \
opkg install wpad-mbedtls && \
service wpad restart

在 OpenWRT 25.12+ 上

apk del wpad-basic-mbedtls && \
apk add wpad-mbedtls && \
service wpad restart

安装 wpad-mbedtls 后，先尝试 service restart wpad，否则可能需要重启才能切换到新的 wpad 二进制文件。如果没有重启，你可能会遇到类似 daemon.notice netifd: radio1 (28210): WARNING (wireless_add_process): executable path /usr/sbin/wpad does not match process 1842 path (/usr/sbin/wpad (deleted)) 的错误。 （请注意，802.11v 客户端漫游仍在开发中）

在 LuCI 中配置 OpenWISP

• 仅设置 服务器 URL 和 共享密钥。
  • 不要在 服务器 URL 后面添加斜线。示例 URL：http://192.168.1.1:8090
  • 共享密钥是之前选择的值（OPENSOHO_SHARED_SECRET）。
• 可选择将 更新间隔 降低到 30 秒，以加快更新速度。（如果你不设置，OpenSOHO 会为你做这件事）
• OpenSOHO 还会启用监控，并将监控间隔降低到 15 秒，以便更快地更新网络状态。

强烈建议启用监控，因为 OpenSOHO 会推断许多当前的 OpenWRT 设置并自动填充，方便配置。

配置 OpenSOHO

• 等待 OpenWRT 设备使用共享密钥完成自我注册。
• 将设备的 已启用 标志设置为 true。
• 将 numradios 设置为正确值。例如，对于 2.4 + 5GHz 设备，该值应为 2。
• 设置一个 Wi-Fi 接入点（SSID+密钥）。此过程使 OpenSOHO 能够在设备注册时正确检测无线电配置。
• 将配置好的 Wi-Fi 接入点附加到设备上，以便进行配置。
• 目前，每个网络将自动在所有无线电上配置（使用 numradios 配置）。
• 可选地，LED 也可以打开或关闭（目前仅支持静态配置）。
• 现在支持配置无线电频率。OpenSOHO 会读取当前的无线电配置一次，并在无线电配置中提供。可能需要一两分钟才会出现无线电配置（配置和监控步骤需要一些时间才能完成）。

仪表盘

OpenSOHO 附带一个基本仪表盘。可通过左侧边栏最下方的按钮访问，该按钮位于 OpenSOHO 徽标下方。

请注意，此仪表盘并非旨在替代更高级的图形化工具，它有意保持简单。

配置

现在可以通过 http://ipaddress:8090/_/ 访问 OpenSoho。

有多个配置集合：

客户端

这些是连接到 Wi-Fi 的客户端。此表只读，但别名除外。可用于为设备提供人类可读的名称。仅当客户端不随机化其 MAC 地址时，此功能才能正常工作。

已连接客户端

包含当前连接到 Wi-Fi 的客户端列表。要显示设备的 IP 地址，OpenSOHO 需要访问 DHCP 租约。因此，需要在包含 DHCP 服务器的设备上运行 openwisp 监控守护进程。静态 IP 设备不会获得 IP。这是 0.12.0 版本已知的限制。

设备

这些是已连接的设备。

• 使用启用/禁用来禁用配置更新。这有助于避免同时更新所有设备。监控仍保持活动。
• 健康状态为只读字段。healthy 表示设备在过去一分钟内已通信。如果没有通信，健康状态变为 unhealthy，设备或其连接可能存在问题。
• LED 允许选择 LED 配置
• Numradios 允许设置设备上的无线电数量。OpenWisp 初始不会发送此信息，因此需要由用户设置。
• Wifis 允许选择要应用于该设备的 SSID。

LED

• 基本 LED 配置（目前更像是一个概念验证）

无线电

• 允许设置每个无线电的频率。
• 不应修改频段，因为这允许 OpenSOHO 验证频率配置。由于 PocketBase 的限制，这是必要的。

Wi-Fi

• 允许设置各种 SSID。加密模式的选择目前有限。出于设计考虑，不支持 WEP 或开放式网络。

监控

设备监控

验证设备健康状态是否为 healthy。

已连接客户端

此视图显示在前 30 秒内仍连接的所有 Wi-Fi 客户端。

Home Assistant 集成

OpenSOHO 监控可以与 Home Assistant 集成。（更多信息） 此 REST API 设计用于 Home Assistant，但也可以与其他工具集成。

故障排除

重新注册设备

当在 LuCI 中更改 OpenWISP 的 服务器 URL 似乎没有正确注册到新控制器时。 解决方法：

uci delete openwisp.http.uuid
uci delete openwisp.http.key
/etc/init.d/openwisp-config restart

第一个 SSID 未启用

OpenWRT 中似乎存在一个问题，Wi-Fi 设备上配置的第一个 SSID 不会自动启用。 解决方法：在 LuCI 中点击启用按钮。

开发者

• 安装依赖

go mod tidy

• 启动 OpenSOHO

共享密钥用于 openwisp-config 注册。选择一个长的随机字符串以获得最佳安全性。

运行单元测试：

go test -cover -v -coverprofile=coverage.out
go tool cover -html=coverage.out

范围

功能

一些 OpenWISP 功能目前被认为不在 OpenSOHO 范围内：

• 固件更新：OpenWRT 不需要频繁更新；在每台设备上手动使用 Attended sysupgrade 功能。
• 多租户
• 模板：OpenWISP 有一个强大且通用的模板机制，这里用一组更具针对性的功能子集替代，以提供更简单的配置体验。

开发

目标是充分利用 pocketbase。由于 pocketbase 后端目前缺乏插件系统，可以进行小修改。但目标不是创建 pocketbase 的分支，因此保持合并上游更改简单。

发布

GITHUB_TOKEN=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa goreleaser release