自己架一台 fapio 伺服器
這一頁帶你從零到開出第一張驗測區發票。全部指令都能複製貼上。橘越不會拿到你的任何憑證與密碼；卡住可以買架設服務，我們在你的 AWS 帳號裡幫你做完再交接。
0你需要準備什麼
工商憑證 IC 卡與讀卡機（申請軟體憑證要用）。
國稅局核配的電子發票字軌（或先用驗測區）。
一台能跑 Docker、有固定 IP 的 Linux 機器。AWS Lightsail 1 GB 每月 7 美元就夠測試。
注意Turnkey 是財政部的 Java 程式，只能跑 Linux／Windows／FreeBSD，Mac 或手機本身跑不了，所以一定要有這台機器。
1開一台機器
AWS Lightsail 東京，Ubuntu 24.04，micro 1 GB，配一個靜態 IP。這個 IP 之後要登錄在大平台。
# 裝 Docker（Ubuntu）
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER2一鍵起 Turnkey 與 fapio
把安裝包放到 /srv/fapio/turnkey，然後起容器。fapio API 會在 3010 埠，只綁本機。
git clone https://github.com/RenzeH/FAPIO_TW fapio && cd fapio/deploy
cp .env.example .env # 填賣方統編、名稱、ADMIN_TOKEN
docker compose up -d
curl http://127.0.0.1:3010/health # {"status":"ok"}注意Turnkey 安裝包要用工商憑證登入大平台下載（導覽列選你的營業人 › Turnkey），我們不能替你放進 image。
3申請軟體憑證、登錄 IP
到大平台用工商憑證申請「軟體憑證」，正式區與驗測區各一張，PFX 放到 /srv/fapio/certs。
申請 Turnkey 使用時把第 1 步的靜態 IP 填進去。
4設定 Turnkey（文字模式）
不需要圖形介面。工作目錄指到 /turnkey-work 底下五個資料夾，憑證選 /turnkey-certs 裡的 PFX。
docker compose run --rm -it turnkey ./run_cmd.sh
# 1 傳輸設定 › 2 基本設定 › 1 系統環境設定 › 3 工作目錄 …注意不要啟用「啟動密碼」，一旦啟用無法取消、忘了要重設所有密碼。
5跑驗測、拿上線通行碼
大平台驗測區有約 30 個自行檢測案例。用 App 或 API 開票，Turnkey 會自動上傳；全部通過後向財政部申請上線通行碼。
6填字軌、裝 App、開第一張
在 App 的「字軌」新增國稅局核配的區段；「設定」貼上伺服器網址與 API 金鑰；回總覽按「開一張發票」。
# 在伺服器本機建第一把 App 金鑰
curl -s -X POST http://127.0.0.1:3010/admin/api-keys \
-H "x-admin-token: $ADMIN_TOKEN" -H "content-type: application/json" \
-d '{"name":"我的 Mac","expiresInDays":365}'