Go to file
Tim Small c67b8ec91d
Support systemd socket activation (#35)
* Support systemd socket activation

If the process has been started with systemd socket activation
configured, then serve requests on the passed-in socket instead of
attempting to bind to an address.

* Add example systemd unit files.

Add example systemd unit files which make use of systemd's security
facilities, and also allow binding to port 80 whilst running as an
unpriviliged process (using systemd socket activation).
2022-01-18 15:47:32 +08:00
.github/ISSUE_TEMPLATE Migrate code from Go branch to new repo 2020-06-02 18:10:50 +08:00
.logo Migrate code from Go branch to new repo 2020-06-02 18:10:50 +08:00
config Embed default assets 2021-09-17 21:06:00 +08:00
database Support in-memory telemetry/stats database 2021-09-18 02:19:14 +08:00
results Support none database type to disable stats/telemetry 2021-09-18 01:48:10 +08:00
rpm/el7 Add RPM package SPEC (#23) 2021-07-05 14:02:19 +08:00
systemd Support systemd socket activation (#35) 2022-01-18 15:47:32 +08:00
web Support systemd socket activation (#35) 2022-01-18 15:47:32 +08:00
.gitignore Migrate code from Go branch to new repo 2020-06-02 18:10:50 +08:00
.goreleaser.yml Fix windows/arm64 build 2021-09-18 13:56:26 +08:00
Dockerfile Update Dockerfile (#36) 2022-01-18 15:46:15 +08:00
go.mod Embed tzdata and rootcerts in binary 2021-09-18 01:58:35 +08:00
go.sum Embed tzdata and rootcerts in binary 2021-09-18 01:58:35 +08:00
LICENSE Migrate code from Go branch to new repo 2020-06-02 18:10:50 +08:00
main.go Embed tzdata and rootcerts in binary 2021-09-18 01:58:35 +08:00
README.md Support in-memory telemetry/stats database 2021-09-18 02:19:14 +08:00
settings.toml Support in-memory telemetry/stats database 2021-09-18 02:19:14 +08:00

LibreSpeed Logo

LibreSpeed

No Flash, No Java, No WebSocket, No Bullshit.

This is a very lightweight speed test implemented in JavaScript, using XMLHttpRequest and Web Workers.

Try it

Take a speed test

Compatibility

All modern browsers are supported: IE11, latest Edge, latest Chrome, latest Firefox, latest Safari. Works with mobile versions too.

Features

  • Download
  • Upload
  • Ping
  • Jitter
  • IP Address, ISP, distance from server (optional)
  • Telemetry (optional)
  • Results sharing (optional)
  • Multiple Points of Test (optional)
  • Compatible with PHP frontend predefined endpoints (with .php suffixes)
  • Supports Proxy Protocol (without TLV support yet)

Screencast

Server requirements

  • Any Go supported platforms
  • BoltDB, PostgreSQL or MySQL database to store test results (optional)
  • A fast! Internet connection

Installation

You need Go 1.16+ to compile the binary. If you have an older version of Go and don't want to install the tarball manually, you can install newer version of Go into your GOPATH:

  1. Install Go 1.17

    $ go get golang.org/dl/go1.17.1
    # Assuming your GOPATH is default (~/go), Go 1.17.1 will be installed in ~/go/bin
    $ ~/go/bin/go1.17.1 version
    go version go1.17.1 linux/amd64
    
  2. Clone this repository:

    $ git clone github.com/librespeed/speedtest-go
    
  3. Build

    # Change current working directory to the repository
    $ cd speedtest-go
    # Compile
    $ go build -ldflags "-w -s" -trimpath -o speedtest main.go
    
  4. Copy the assets directory, settings.toml file along with the compiled speedtest binary into a single directory

  5. If you have telemetry enabled,

    • For PostgreSQL/MySQL, create database and import the corresponding .sql file under database/{postgresql,mysql}

      # assume you have already created a database named `speedtest` under current user
      $ psql speedtest < database/postgresql/telemetry_postgresql.sql
      
    • For embedded BoltDB, make sure to define the database_file path in settings.toml:

      database_file="speedtest.db"
      
  6. Put assets folder under the same directory as your compiled binary.

    • Make sure the font files and JavaScripts are in the assets directory
    • You can have multiple HTML pages under assets directory. They can be access directly under the server root (e.g. /example-singleServer-full.html)
    • It's possible to have a default page mapped to /, simply put a file named index.html under assets
  7. Change settings.toml according to your environment:

    # bind address, use empty string to bind to all interfaces
    bind_address="127.0.0.1"
    # backend listen port, default is 8989
    listen_port=8989
    # proxy protocol port, use 0 to disable
    proxyprotocol_port=0
    # Server location, use zeroes to fetch from API automatically
    server_lat=0
    server_lng=0
    # ipinfo.io API key, if applicable
    ipinfo_api_key=""
    
    # assets directory path, defaults to `assets` in the same directory
    # if the path cannot be found, embedded default assets will be used
    assets_path="./assets"
    
    # password for logging into statistics page, change this to enable stats page
    statistics_password="PASSWORD"
    # redact IP addresses
    redact_ip_addresses=false
    
    # database type for statistics data, currently supports: none, memory, bolt, mysql, postgresql
    # if none is specified, no telemetry/stats will be recorded, and no result PNG will be generated
    database_type="postgresql"
    database_hostname="localhost"
    database_name="speedtest"
    database_username="postgres"
    database_password=""
    
    # if you use `bolt` as database, set database_file to database file location
    database_file="speedtest.db"
    

Differences between Go and PHP implementation and caveats

  • Since there is no CGo-free SQLite implementation available, I've opted to use BoltDB instead, as an embedded database alternative to SQLite
  • Test IDs are generated ULID, there is no option to change them to plain ID
  • You can use the same HTML template from the PHP implementation
  • Server location can be defined in settings
  • There might be a slight delay on program start if your Internet connection is slow. That's because the program will attempt to fetch your current network's ISP info for distance calculation between your network and the speed test client's. This action will only be taken once, and cached for later use.

License

Copyright (C) 2016-2020 Federico Dossena Copyright (C) 2020 Maddie Zhan

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this program. If not, see https://www.gnu.org/licenses/lgpl.