요청을 자체 인프라 안에서 처리하고 싶다면 Docker Hub의 공식 이미지로 비공개 인스턴스를 실행할 수 있습니다. amd64와 arm64를 모두 지원합니다.

빠른 시작

가장 빠르게 시작하는 방법:

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

Frankfurter가 8080 포트에서 임시 데이터베이스로 시작됩니다. 초기 백필이 끝나기 전에는 일부 엔드포인트가 빈 데이터를 반환할 수 있습니다.

프로덕션

프로덕션에서는 컨테이너를 재시작해도 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

튀르키예 공화국 중앙은행 데이터. evds3.tcmb.gov.tr에서 등록하세요.