Nếu muốn giữ các yêu cầu trong hạ tầng của riêng mình, bạn có thể chạy một phiên bản riêng bằng image chính thức trên Docker Hub. Image chạy được trên cả amd64 và arm64.

Bắt đầu nhanh

Cách nhanh nhất để bắt đầu:

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

Lệnh này khởi chạy Frankfurter ở cổng 8080 với cơ sở dữ liệu tạm thời. Một số endpoint có thể trả về dữ liệu rỗng cho đến khi quá trình nạp dữ liệu ban đầu hoàn tất.

Môi trường production

Với môi trường production, hãy gắn một volume để giữ cơ sở dữ liệu SQLite qua các lần khởi động lại container:

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

Nếu không gắn volume, cơ sở dữ liệu chỉ là tạm thời và được dựng lại sau mỗi lần khởi động lại.

Cờ --pull always đảm bảo Docker kéo image mới nhất mỗi lần chạy.

Khóa API

Một số nguồn dữ liệu yêu cầu khóa API. Tất cả đều miễn phí và không bắt buộc.

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
Dữ liệu của Bank Al-Maghrib. Đăng ký tại apihelpdesk.centralbankofmorocco.ma.
BANXICO_API_KEY
Dữ liệu của Banco de México. Đăng ký tại banxico.org.mx.
BCCH_USER và BCCH_PASS
Dữ liệu của Banco Central de Chile. Đăng ký tại bcentral.cl.
BOT_API_KEY
Dữ liệu của Bank of Thailand. Đăng ký tại gateway.api.bot.or.th.
FRED_API_KEY
Dữ liệu của Federal Reserve. Đăng ký tại fred.stlouisfed.org.
TCMB_API_KEY
Dữ liệu của Central Bank of the Republic of Türkiye. Đăng ký tại evds3.tcmb.gov.tr.