Loading... # Homebox [](https://github.com/XGHeaven/homebox#homebox) 家庭网络工具箱。用于组建家庭局域网时,对网络进行调试、检测、压测的工具集合。 ## Feature [](https://github.com/XGHeaven/homebox#feature) * 面向未来浏览器设计 * 高达 10G 的浏览器速度测试 * 自带 Ping 检测 * 丰富的自定义测速参数 * 服务端无需像传统文件拷贝一样需要固态的支持 * 友好的 UI 交互 * 针对低速网络(< 2.5G)优化测速资源占用 [v1 进度追踪看板](https://github.com/XGHeaven/homebox/projects/1) [![dark-theme](https://github.com/XGHeaven/homebox/raw/master/doc/dark-theme.png)](https://github.com/XGHeaven/homebox/blob/master/doc/dark-theme.png) [![light-theme](https://github.com/XGHeaven/homebox/raw/master/doc/light-theme.png)](https://github.com/XGHeaven/homebox/blob/master/doc/light-theme.png) ## Requirement [](https://github.com/XGHeaven/homebox#requirement) * 本软件需要一个服务端进行部署,然后通过客户端访问网页进行测试 * 当需要对万兆以上网络测试的时候,需要保证客户端的性能(主要为 CPU 单核)足够强劲,否则可能会成为瓶颈。 具体的要求可以看后文的[性能测试](https://github.com/XGHeaven/homebox#Performance) ## Install [](https://github.com/XGHeaven/homebox#install) ### Docker [](https://github.com/XGHeaven/homebox#docker) 首先你需要有一台服务器,只要能支持安装 Docker 即可,比如群辉、FreeNas、unRaid、CentOS 等等,暂时只支持 x86 服务器。 一键安装docker ``` curl -fsSL https://get.docker.com | bash -s docker ``` ```shell docker run -d -p 3300:3300 --name homebox xgheaven/homebox ``` 安装并启动 `xgheaven/homebox` 镜像,默认情况下暴露的端口是 `3300`。 然后在浏览器中输入 `http://your.server.ip:3300` 即可。 ### Binary [](https://github.com/XGHeaven/homebox#binary) 直接在 [Release](https://github.com/XGHeaven/homebox/releases) 下载对应版本即可。 解压之后直接执行 serve 命令即可启动服务,参数如下 ``` Usage: homebox serve [OPTIONS] Options: --port <PORT> Port to listen --host <HOST> Host to listen -h, --help Print help ``` ## Usage [](https://github.com/XGHeaven/homebox#usage) 输入网址之后,会看到分为两种测试模式,分别是单次测速和持续压测。 * **单次测速**的模式下,会依次执行 Ping/Download/Upload 测试,一般可以直接用这个模式。 * **持续压测**的模式下,可以不限时的以最高速度压测链路,通常可以用于设备移动中链路稳定性测试、多设备压测、路由器转发散热性能测试等。 默认情况下,设备会以低速模式运行,适用于大部分网络情况。 也可以在**高级配置**中切换为高速模式,此时会将客户端资源榨干的方式尽可能压榨网络流量,用于万兆以上的高速网络。 ### Terminal(WIP) [](https://github.com/XGHeaven/homebox#terminalwip) 某些极端情况下,机器性能不足或者浏览器版本过低,可以直接通过复制浏览器中提供的测速脚本,在终端中测速。 一方面方便某些懒人不愿意打命令行,另一方面脱离了浏览器的环境,测速性能和准确度会更高 最后修改:2025 年 01 月 09 日 © 允许规范转载 打赏 赞赏作者 支付宝微信 赞 如果觉得我的文章对你有用,请随意赞赏