效果圖
前置需求
- TRMNL 設備（已刷公開固件）
- Laravel 項目（已安裝 LaraPaper）
- NWFB / Citybus API 密鑰（data.gov.hk 免費申請）
安裝 LaraPaper/官方提供Dockerfile
services:
app:
image: ghcr.io/usetrmnl/larapaper:0.32.1
ports:
- "3001:8080"
environment:
# Generate the APP_KEY with `echo "base64:$(openssl rand -base64 32)"`
#- APP_KEY=
- PHP_OPCACHE_ENABLE=1
- TRMNL_PROXY_REFRESH_MINUTES=15
- TRMNL_PROXY_BASE_URL=https://terminal.domain.com
- REGISTRATION_ENABLED=0
- FORCE_HTTPS=1
- APP_URL=https://terminal.domain.com
- DB_DATABASE=database/storage/database.sqlite
volumes:
- database:/var/www/html/database/storage
- storage:/var/www/html/storage/app/public/images/generated
restart: unless-stopped
volumes:
database:
storage:.env
TRMNL_API_KEY=你的TRMNL_API_KEY
TRMNL_DEVICE_ID=你的設備Friendly_ID安裝 TRMNL Plugin
TRMNL 官方有個"Bus ETA" 插件
也支持“MTR"到站提示
5. 配置巴士線路
.env
KMB_ROUTE=89C
KMB_STOP_ID=KT331
KMB_DIRECTION=1常用站點 ID：
KT331- 觀塘道休憩處001943- 沙田第一城
6. 供電方式
| 方式 | 說明 |
|---|---|
| USB供電 | 持續運行，刷新最快 |
| 太陽能 + 鋰電 | 環保，但刷新頻率受限 |
在家使用建議 USB 供電，可做到每 5 分鐘刷新。
7. 效果
開機後，TRMNL 屏幕自動顯示：
89C 往觀塘
1️⃣ 3 分鐘
2️⃣ 12 分鐘
3️⃣ 25 分鐘每 5-15 分鐘自動更新，無需干預。
常見問題
Q: 設備顯示 "Setup Required"
A: 按住 Reset 鍵 5 秒清除 WiFi，重新配網
Q: API 返回空資料
A: 檢查 stop_id 和 route 是否匹配，可在瀏覽器直接測試 API
Q: 刷新太慢
A: 在 TRMNL App 中調整 Plugin 刷新頻率，或訂閱 TRMNL Pro 主動推送