teslamate-addr-fix

To fix teslamate broken addresses caused by openstreetmap unavailability

中文说明

Notice

Must create a backup before doing this.

Pre-requisite

• You have teslamate broken address issue

• You have access to openstreetmap.org via your HTTP proxy

Demo

Before: (no start/destination info since OSM blocked)

After fixed:

Install Guide (Choose one only)

1. Docker Compose (Recommended)

• Ensure your HTTP proxy is set to "allow LAN use", and find the LAN IP:Port. For example, a proxy LAN IP is set to 192.168.x.x. Commonly SHOULD NOT be the localhost 127.x.x.x or docker host 172.x.x.x

• Modify teslamate docker compose file:

  # Insert below 'database' section
  
  teslamate-addr-fix:
    image: waynejz/teslamate-addr-fix
    restart: always
    platform: linux/amd64
    environment:
      - PROXY=http://192.168.0.100:7890    # Set your HTTP proxy
      - DATABASE_USER=teslamate
      - DATABASE_PASS=123456               # Copy from 'teslamate' section
      - DATABASE_NAME=teslamate
      - DATABASE_HOST=database
    depends_on:
      - database

  If you have modified the other default values (such as DATABASE_HOST), then you should copy and replace them from 'teslamate' section as well.

• Then execute docker-compose up -d to recreate docker. This tool will run with teslamate in the same subnetwork. After serveral minutes, check your teslamate grafana drive graph if anything correct.

2. Binary Installation

• Download this tool from releases page. Ensure you download the right binary for your OS arch/version.

• Expose your teslamate postgres port to your host. If you are using docker compose, just simply add port in the .yml file, then execute docker-compose up -d to recreate docker.

  database:
      image: postgres:14
      restart: always
      environment:
      - POSTGRES_USER=teslamate
      - POSTGRES_PASSWORD=xxxxxxxx
      - POSTGRES_DB=teslamate
  
      # add this
      ports:
      - 5432:5432 

• Configure and turn your HTTP proxy on. You can either set the system proxy beforehand or set the proxy at runtime. System proxy setting is like:

  # Your .bashrc/.zshrc
  
  export all_proxy=socks5://127.0.0.1:7890
  export http_proxy=http://127.0.0.1:7890
  export https_proxy=http://127.0.0.1:7890

• Run the help command by ./teslamate-addr-fix -h. At least you should specify your teslamate psql password, otherwise it cannot connect to teslamate database. The other arguments should be specified if not same as default.

  Usage of ./teslamate-addr-fix:
  -db string
          teslamate psql database (default "teslamate")
  -host string
          teslamate psql host (default "127.0.0.1")
  -interval int
          interval (minutes) for running in daemon mode
  -password string
          teslamate psql password
  -port string
          teslamate psql port (default "5432")
  -proxy string
          http proxy (default use system proxy)
  -timeout int
          timeout of openstreetmap request (default 5)
  -user string
          teslamate psql user (default "teslamate")

• Follow the instruction and start fixing. Run the program with arguments such as ./teslamate-addr-fix -password 123456 , and the log will be printed in teslamate-addr-fix.log

• After the program finished, check your teslamate grafana drive graph if anything correct.

3. Native Docker (Not recommended)

Of course you can use docker separately to run this tool, but since the tool has not join your teslamate subnetwork without docker compose, it could be hard and not recommended.

• To run as native docker, the preparation includes "allow LAN use" AND "exposing teslamate postgres port to your host", see content above for details

• Pull the image and run in daemon mode:

  docker pull waynejz/teslamate-addr-fix:latest
  
  docker run --name 'teslamate-addr-fix' --platform 'linux/amd64' \
  -e PROXY='http://192.168.0.100:7890' \ 
  -e DATABASE_USER='teslamate' \
  -e DATABASE_PASS='123456' \
  -e DATABASE_NAME='teslamate' \
  -e DATABASE_HOST='192.168.0.100' \
  -e DATABASE_PORT='5432' \
  -d waynejz/teslamate-addr-fix

  Note both the PROXY and DATABASE_HOST should be LAN IPs. If encountered with syntax error, merge into one line and remove slashes and try again.

• If run successfully, check your teslamate grafana drive graph if anything correct after serveral minutes.

FAQ

• Q: My docker has problems when running, does the docker has other parameters to adjust?

  A: Extra parameters below can be set if necessary (DO NOT set if run properly):

  - OSM_TIMEOUT=5          # timeout of openstreetmap request (default 5 seconds)
  - DATABASE_PORT=5432     # port of teslamate postgres (default 5432)
  - INTERVAL=5             # interval for running in daemon mode (default 5 minutes)

  After adjust, a restart is required to take effect.

• Q: This program has no log output, is it running correctly?

  A: If no broken address data to fix, then the program will not output any logs. You can check your drive graph.

• Q: The addresses have been fixed, why I still cannot see the drive map?

  A: Drive map in Grafana is a frontend feature, so ensure your working computer (not NAS server) has access to openstreetmap, through web proxy if necessary.

Disclaimer

Only use this program after properly created backups, I am not responsible for any data loss or software failure related to this.

This project is only for study purpose, and no web proxy (or its download link) provided. If the network proxy is used in violation of local laws and regulations, the user is responsible for the consequences.

When you download, copy, compile or execute the source code or binary program of this project, it means that you have accepted the disclaimer as mentioned.