Если вы хотите, чтобы запросы не выходили за пределы вашей инфраструктуры, запустите частный экземпляр из официального образа на Docker Hub. Он работает на amd64 и arm64.

Быстрый старт

Самый быстрый способ начать:

docker run -d --init -p 8080:8080 lineofflight/frankfurter

Эта команда запускает Frankfurter на порту 8080 с временной базой данных. Некоторые эндпоинты могут возвращать пустые данные, пока не завершится начальная загрузка истории.

Production

Для production смонтируйте том, чтобы база данных SQLite сохранялась между перезапусками контейнера:

docker run -d --init -p 8080:8080 \
  -e DATABASE_URL="sqlite:///data/db.sqlite3" \
  -v ./data:/data \
  --pull always \
  lineofflight/frankfurter

Без смонтированного тома база данных временная и пересоздаётся при каждом перезапуске.

Флаг --pull always гарантирует, что Docker загружает самый свежий образ при каждом запуске.

Ключи API

Некоторые источники данных требуют ключи API. Все они бесплатные и необязательные.

docker run -d --init -p 8080:8080 \
  -e DATABASE_URL="sqlite:///data/db.sqlite3" \
  -e BAM_API_KEY="your_key" \
  -e BANXICO_API_KEY="your_key" \
  -e BCCH_USER="your_email" \
  -e BCCH_PASS="your_password" \
  -e BOT_API_KEY="your_key" \
  -e FRED_API_KEY="your_key" \
  -e TCMB_API_KEY="your_key" \
  -v ./data:/data \
  --pull always \
  lineofflight/frankfurter
BAM_API_KEY
Данные Bank Al-Maghrib. Зарегистрируйтесь на apihelpdesk.centralbankofmorocco.ma.
BANXICO_API_KEY
Данные Banco de México. Зарегистрируйтесь на banxico.org.mx.
BCCH_USER и BCCH_PASS
Данные Banco Central de Chile. Зарегистрируйтесь на bcentral.cl.
BOT_API_KEY
Данные Bank of Thailand. Зарегистрируйтесь на gateway.api.bot.or.th.
FRED_API_KEY
Данные Federal Reserve. Зарегистрируйтесь на fred.stlouisfed.org.
TCMB_API_KEY
Данные Central Bank of the Republic of Türkiye. Зарегистрируйтесь на evds3.tcmb.gov.tr.