หากต้องการให้คำขอทั้งหมดทำงานอยู่ภายในโครงสร้างพื้นฐานของคุณเอง สามารถรันอินสแตนซ์ส่วนตัวด้วยอิมเมจอย่างเป็นทางการบน Docker Hub รองรับทั้งสถาปัตยกรรม amd64 และ arm64

เริ่มต้นอย่างรวดเร็ว

วิธีเริ่มต้นที่เร็วที่สุด:

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

คำสั่งนี้จะเริ่มทำงาน Frankfurter บนพอร์ต 8080 โดยใช้ฐานข้อมูลชั่วคราว บาง endpoint อาจส่งคืนข้อมูลว่างจนกว่าการดึงข้อมูลย้อนหลังเริ่มต้นจะเสร็จสมบูรณ์

การใช้งานจริง (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 Keys

แหล่งข้อมูลบางแห่งต้องใช้ API key ซึ่งทั้งหมดขอรับได้ฟรีและไม่บังคับ

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