bwtest

A lightweight Linux bandwidth test panel and agent.

Features

• Server-side web panel (HTTP Basic Auth)
• Client approval workflow
• Upload / download / both task modes
• Configurable speed (Mbps) and duration (seconds)
• SQLite persistence (no external DB required)
• SSE live refresh in the panel
• Linux amd64 / arm64 release binaries via GitHub Actions

Install server

curl --proto '=https' --tlsv1.2 -fsSL \
  https://raw.githubusercontent.com/ctsunny/bwtest/main/scripts/install_server.sh | \
sudo bash -s -- \
  --server-host 1.2.3.4 \
  --panel-port 8080 \
  --data-port 9000 \
  --admin-user admin \
  --admin-pass 'YourStrongPass123' \
  --init-token 'YourInitToken123'

Installation output example:

Panel URL : http://1.2.3.4:8080/admin
Admin User: admin
Admin Pass: <generated or provided>
Init Token: <generated or provided>

Install client

curl --proto '=https' --tlsv1.2 -fsSL \
  https://raw.githubusercontent.com/ctsunny/bwtest/main/scripts/install_client.sh | \
sudo bash -s -- \
  --server-url http://1.2.3.4:8080 \
  --init-token 'YourInitToken123' \
  --client-name "$(hostname)"

Usage

1. Open http://1.2.3.4:8080/admin and log in.
2. Wait for the client to appear in the Clients table.
3. Click Approve to allow the client to receive tasks.
4. Fill in the Create Task form:
   • client_id: copy from the Clients table
   • mode: upload / download / both
   • up_mbps / down_mbps: speed limit in Mbps
   • duration_sec: how many seconds to run
5. Click Create Task. The panel auto-refreshes via SSE.
6. To stop a running task early, click Stop in the Tasks table.

Troubleshooting

• If a task appears as pending for a long time after service restarts, use the panel's 取消/停止 action to mark it stopped and recreate the task.
• If action buttons in the web panel do not respond, hard refresh the browser (Ctrl+F5) and verify Basic Auth is still valid.

Useful commands

# Server
systemctl status bwpanel
journalctl -u bwpanel -f
cat /etc/default/bwpanel

# Client
systemctl status bwagent
journalctl -u bwagent -f
cat /etc/bwagent/config.json

Uninstall completely

Uninstall Server:

systemctl stop bwpanel
systemctl disable bwpanel
rm -f /etc/systemd/system/bwpanel.service
rm -f /usr/local/bin/bwpanel /usr/local/bin/bwpanel-menu
rm -f /etc/default/bwpanel
rm -rf /opt/bwtest
systemctl daemon-reload

Uninstall Client:

systemctl stop bwagent
systemctl disable bwagent
rm -f /etc/systemd/system/bwagent.service
rm -f /usr/local/bin/bwagent
rm -rf /etc/bwagent
rm -rf /opt/bwtest/client_source
systemctl daemon-reload

Release a new version

git tag v0.1.0
git push origin v0.1.0

GitHub Actions will build binaries for linux/amd64 and linux/arm64 and attach them to the release automatically.