mirror of
https://codeberg.org/icewind/tasproxy.git
synced 2026-06-03 10:14:09 +02:00
38 lines
1.2 KiB
Markdown
38 lines
1.2 KiB
Markdown
# Tasproxy
|
|
|
|
Auto-discovery reverse proxy for [tasmota](https://tasmota.github.io/docs/)
|
|
|
|
## Why
|
|
|
|
Remembering what ip addresses all of your tasmota devices is a pain.
|
|
|
|
## Setup
|
|
|
|
Ensure your tasmota devices are connected to an MQTT server with the following
|
|
"Full Topic":
|
|
|
|
%prefix%/%topic%/
|
|
|
|
And the "Topic" set to the desired name for the device.
|
|
|
|
Run the binary with the following environment variables
|
|
|
|
- `MQTT_HOSTNAME`: hostname of the MQTT server to connect to
|
|
- `MQTT_PORT`: port of the mqtt server to connect to, defaults to 1883
|
|
- `MQTT_USERNAME`: username to authenticate against the mqtt server
|
|
- `MQTT_PASSWORD`: password to authenticate against the mqtt server
|
|
- `PORT`: port this binary MQTT listen on, defaults to 80
|
|
|
|
You can also configure the proxy to send HTTP Basic authentication to the
|
|
tasmota devices by setting the `TASMOTA_USERNAME` and `TASMOTA_PASSWORD`
|
|
environment variables.
|
|
|
|
Setup dns/hosts/etc to point `*.example.com` to the server running this binary
|
|
|
|
## Usage
|
|
|
|
The proxy server will use MQTT to discover and gather the ip addresses of your
|
|
tasmota devices.
|
|
|
|
Any request made to `%hostname%.example.com` will be proxied to the tasmota
|
|
device with the corresponding topic.
|