linkease/fastnet repository overview

⁠Docker FastNet

FastNet 是一个网络诊断与测速工具，提供 Web UI + API，用于在浏览器里完成常用网络体检与测试（NAT/IPv6/多源下载/Speedtest/LAN 测速等）。

可以在多个平台系统上运行一键测速： https://www.koolcenter.com/t/topic/9148⁠

本目录用于构建 Docker 镜像 linkease/fastnet:latest，容器默认运行：

fastnet web --addr 0.0.0.0:3200 --no-open

⁠功能概览

• Web UI（浏览器访问）
• 快速体检（Quick）
• NAT 类型测试
• IPv6 测试（含分阶段结果）
• 外网测速（多源下载）
• SpeedTest.net
• 内网测速（Homebox / LAN）
• 健康检查：/api/health

⁠快速开始（推荐：Docker Compose）

./prepare-dl.sh
docker compose up -d --build

访问：http://127.0.0.1:3200/

可选加 token（建议公网暴露时必开）：

FASTNET_TOKEN='change-me' docker compose up -d --build

⁠单容器运行（docker run）

docker run -d \
  --name fastnet \
  -p 3200:3200 \
  -e TZ=Asia/Shanghai \
  -e FASTNET_ADDR=0.0.0.0:3200 \
  linkease/fastnet:latest

加 token：

docker run -d --name fastnet -p 3200:3200 \
  -e FASTNET_TOKEN='change-me' \
  linkease/fastnet:latest

访问方式（二选一）：

• Authorization: Bearer <token>
• http://127.0.0.1:3200/?token=<token>

⁠配置（环境变量）

• FASTNET_ADDR：监听地址，默认 0.0.0.0:3200
• FASTNET_TOKEN：可选访问 token（Bearer 或 ?token=）
• TZ：默认 Asia/Shanghai

⁠镜像构建（当前目录）

由于 FastNet 二进制在其它机器上编译并发布，这里的构建方式是“下载官方多架构二进制包 → 打进镜像”。

1. 准备 dest/（下载并解压二进制包）

默认从 https://fw.koolcenter.com/binary/fastnet/ 拉取最新 fastnet-binary-<ver>.tar.gz：

./prepare-dl.sh

可选：

• 指定版本：FASTNET_VER=0.7.5 ./prepare-dl.sh
• 指定下载源：FASTNET_BASE_URL=https://fw.koolcenter.com/binary/fastnet ./prepare-dl.sh

1. 多架构 buildx 构建并推送（默认镜像名 linkease/fastnet:latest）

./build.sh

常见 tag 写法：

• linkease/fastnet:latest（默认）
• linkease/fastnet:<ver>

如需推送到 GHCR，参考 build-ghcr.sh 并自行修改镜像名/Tag；更多 buildx 细节见 howto.md。

⁠运行说明

• 容器内不会自动打开浏览器（已加 --no-open）。
• 容器启动后 Web UI 地址会输出在日志里；也可直接访问 http://<host>:3200/。
• 如需运行其它子命令，可覆盖参数，例如：docker run --rm linkease/fastnet:latest version（entrypoint 会把参数透传给 fastnet）。