如果你希望请求不离开自己的基础设施,可以使用 Docker Hub 上的官方镜像运行私有实例。镜像同时支持 amd64 和 arm64。

快速开始

最快的上手方式:

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

这会在 8080 端口启动 Frankfurter,并使用临时数据库。在首次回填完成之前,部分端点可能返回空数据。

生产环境

在生产环境中,请挂载一个卷,使 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 注册。