goweb

Multi domain/host web server written in Golang.

If you just want to host websites of a bunch of html/js/css files, and you don't want to be intimidated by the configuration files of Nginx or Apache, this might be for you.

Install and Run

$ go install github.com/elgs/goweb@latest

Assuming you have go's bin directory in your PATH, otherwise, you could add the following line to your .zshrc or .bashrc.

export PATH=$HOME/go/bin:$PATH

Then run the server:

$ goweb -c /path/to/config.json
# if the config file happens to be goweb.json in the same directory, you could simply run:
$ goweb
# for help, run
$ goweb --help

or if you will listen to any ports lower than 1024:

$ sudo goweb -c /path/to/config.json

Web Admin Interface

The goweb admin is a web interface that will help you to generate config json and test server configurations.

$ goweb -admin
2022/08/06 03:05:17 Listening on https://[::]:443/
Web admin url: http://[::]:54666/admin
Access token: pj8s1jy7n5ep0l9j9rwdk70a7j6ppmf7

A config file will be optional to run goweb in admin mode.

Uninstall

$ rm -rf $HOME/go/bin/goweb

Configurations

Bare minimum

[
  {
    "type": "http",
    "listen": "[::]:80",
    "hosts": [
      {
        "name": "example.com",
        "type": "serve_static",
        "path": "/path/to/webroot"
      }
    ]
  }
]

Https with redirect

[
  {
    "type": "http",
    "listen": "[::]:80",
    "hosts": [
      {
        "name": "example.com",
        "type": "301_redirect",
        "redirect_url": "https://example.com"
      }
    ]
  },
  {
    "type": "https",
    "listen": "[::]:443",
    "hosts": [
      {
        "name": "example.com",
        "type": "serve_static",
        "path": "/path/to/webroot",
        "cert_path": "/path/to/certfile",
        "key_path": "/path/to/keyfile"
      }
    ]
  }
]

Reverse Proxy and Load Balancer

[
  {
    "type": "https",
    "listen": "[::]:443",
    "hosts": [
      {
        "name": "example.com",
        "type": "reverse_proxy",
        "forward_urls": "http://s1.example.com:1234 http://s2.example.com",
        "cert_path": "/path/to/certfile",
        "key_path": "/path/to/keyfile"
      }
    ]
  }
]

TCP Proxy and Load Balancer

[
  {
    "type": "tcp",
    "listen": "[::]:1234",
    "hosts": [
      {
        "name": "server1",
        "upstream": "192.168.0.1"
      },
      {
        "name": "server2",
        "upstream": "192.168.0.2"
      }
    ]
  }
]

Multiple domains

[
  {
    "type": "https",
    "listen": "[::]:443",
    "hosts": [
      {
        "name": "example.com",
        "type": "serve_static",
        "path": "/path/to/webroot",
        "cert_path": "/path/to/certfile",
        "key_path": "/path/to/keyfile"
      },
      {
        "name": "example.net",
        "type": "serve_static",
        "path": "/path/to/webroot",
        "cert_path": "/path/to/certfile",
        "key_path": "/path/to/keyfile"
      }
    ]
  }
]

All parameters

Server

Field	Type	Descriptions	Examples
name	string	Name of the server. Please make it unique	443, 80, my_server
type	string	http, https or tcp	http, https, tcp
listen	string	Host and port the server listens on.	127.0.0.1:80, 0.0.0.0:443, [::]:443
disabled	bool	True to disable the server, defaults to false.	false, true
hosts	array	A list of hosts the server is hosting.	See the host definition.

Host

Field	Type	Descriptions	Examples
name	string	Full domain name, which is used to match the domain name in the browser/request url.	example.com, www.example.com
type	string	Possible types are: serve_static, 301_redirect and reverse_proxy.	serve_static, 301_redirect, reverse_proxy
path	string	Path to the web root.	/path/to/webroot
redirect_url	string	The URL that will be 301 redirected to host type is set to 301_redirect.	https://example.com
forward_urls	string	Space separated list of upstream servers.	http://s1.example.com:1234 http://s2.example.com
upstream	string	Upstream tcp socket address.	192.168.0.1:1234
cert_path	string	Path to the X.509 cert file.	/path/to/certfile
key_path	string	Path to the X.509 key file.	/path/to/keyfile
disable_dir_listing	bool	True to disable dir listing if index.html file is not present. Defaults to false.	false, true
disabled	bool	True to disable the host. Defaults to false.	false, true

Auto start with systemd

Create service unit file /etc/systemd/system/goweb.service with the following content:

[Unit]
After=network.target

[Service]
ExecStart=/home/elgs/go/bin/goweb -c /home/elgs/goweb.json

[Install]
WantedBy=default.target

Enable the service:

$ sudo systemctl enable goweb

Remove the service:

$ sudo systemctl disable goweb

Start the service

$ sudo systemctl start goweb

Stop the service

$ sudo systemctl stop goweb

Check service status

$ sudo systemctl status goweb

Auto renew certificates with certbot

Assuming certbot is installed. I use the command certbot certonly to get a new cert/key pair.

Create service unit file /etc/systemd/system/certbot.service with the following content:

[Unit]
Description=Let's Encrypt renewal

[Service]
Type=oneshot
ExecStartPre=systemctl stop goweb
ExecStart=/usr/bin/certbot renew --agree-tos
ExecStartPost=systemctl start goweb

Create timer unit file /etc/systemd/system/certbot.timer with the following content:

[Unit]
Description=Twice daily renewal of Let's Encrypt's certificates

[Timer]
OnCalendar=0/12:00:00
RandomizedDelaySec=1h
Persistent=true

[Install]
WantedBy=timers.target

Enable the timer:

$ sudo systemctl enable certbot.timer