إذا أردت إبقاء الطلبات داخل بنيتك التحتية، يمكنك تشغيل نسخة خاصة بالصورة الرسمية على Docker Hub. تعمل على amd64 وarm64 كليهما.

البدء السريع

أسرع طريقة للبدء:

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

يشغّل هذا Frankfurter على المنفذ 8080 بقاعدة بيانات مؤقتة. وقد تُرجع بعض نقاط النهاية بيانات فارغة إلى أن يكتمل ملؤها الأولي بالبيانات التاريخية.

بيئة الإنتاج

في بيئة الإنتاج، اربط وحدة تخزين (volume) لحفظ قاعدة بيانات 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
بيانات بنك المغرب. سجّل في 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
بيانات بنك تايلاند. سجّل في gateway.api.bot.or.th.
FRED_API_KEY
بيانات الاحتياطي الفيدرالي. سجّل في fred.stlouisfed.org.
TCMB_API_KEY
بيانات البنك المركزي لجمهورية تركيا. سجّل في evds3.tcmb.gov.tr.