KennethCheng
7d5ab0a2ec
NAS 部署时 POST /api/vehicles 返 502 Bad Gateway,根因是 compose 改
SERVER_ADDR: ":8081" 但 fuellog-web/nginx/web.conf 里 upstream 还写死
server api:8080 → nginx upstream 连不上,web 容器把请求反代失败,返 502。
修法:把端口做成 build arg + sed 替换:
- fuellog-web/Dockerfile 加 `ARG API_PORT=8080` + `sed` 在 build 时把
web.conf 里的 __API_PORT__ 占位替换为真实端口
- deploy/docker-compose.yml:
* api.SERVER_ADDR 改成 `:${API_PORT:-8080}`(默认仍是 8080)
* api.expose / healthcheck 端口都改用 ${API_PORT:-8080}
* web build args 传 API_PORT,容器内 web 镜像就有了对的 upstream
* 新增 WEB_PORT 控制宿主机 → web 容器 :80 映射
- README 新增"改端口"小节,说明 API_PORT / WEB_PORT 用法;
新增"排错:502 Bad Gateway"小节,把这次踩的坑(改 SERVER_ADDR 忘
改 web upstream、忘重 build)写明,下次再撞就有现成排查路径
期间的小坑(都修了):
- web.conf 占位用 __API_PORT__(双下划线)而不是 ${API_PORT},避免
nginx 把它当成变量语法尝试解析
- docker-compose 用 ${API_PORT:-8080} 而不是裸 ${API_PORT},这样
用户不传环境变量也能跑(默认 8080)
- README 里 web/api 表格里"golang:1.22-alpine"也顺手改成 1.27-alpine
跟实际 Dockerfile 一致(上次 f81047f 提过但 README 漏了)
未做(留待后续):
- 端口改成可改 web upstream 后,理论上仍然可能出现 build-time / run-time
不一致(build args vs 环境变量);更稳的方案是给 web 加个 entrypoint 脚本,
启动时再 sed 一次 env 变量到 nginx conf —— 留到真有"频繁换端口"的
场景再做
- `.env.example` 没改,只加了 README 文档化的 .env 用法;compose 默认值
已经是 8080,本地 dev 不需要 .env
73 lines
1.9 KiB
YAML
73 lines
1.9 KiB
YAML
# FuelLog 生产部署
|
|
# 用法:
|
|
# docker compose -f deploy/docker-compose.yml up -d
|
|
# 浏览器访问 http://your-host
|
|
|
|
services:
|
|
api:
|
|
build:
|
|
context: ../fuellog-api
|
|
dockerfile: Dockerfile
|
|
image: fuellog/api:latest
|
|
container_name: fuellog-api
|
|
restart: unless-stopped
|
|
environment:
|
|
# SERVER_ADDR 改端口时,记得 web 的 build.args.API_PORT 一起改
|
|
# (compose 已通过 ${API_PORT:-8080} 自动串联)
|
|
SERVER_ADDR: ":${API_PORT:-8080}"
|
|
GIN_MODE: release
|
|
DB_PATH: /data/fuellog.db
|
|
TZ: Asia/Shanghai
|
|
LOG_LEVEL: info
|
|
CORS_ORIGINS: "*"
|
|
volumes:
|
|
- fuellog-data:/data
|
|
networks:
|
|
- fuellog-net
|
|
# 不直接对外暴露 api 端口,仅 web 容器能访问
|
|
expose:
|
|
- "${API_PORT:-8080}"
|
|
healthcheck:
|
|
test: ["CMD", "wget", "-q", "-O-", "http://127.0.0.1:${API_PORT:-8080}/health"]
|
|
interval: 30s
|
|
timeout: 3s
|
|
retries: 3
|
|
start_period: 10s
|
|
|
|
web:
|
|
build:
|
|
context: ../fuellog-web
|
|
dockerfile: Dockerfile
|
|
args:
|
|
# 跟 api.SERVER_ADDR 保持一致;默认 8080 不用传
|
|
# - compose 改了 SERVER_ADDR,这里也要改 API_PORT
|
|
- API_PORT=${API_PORT:-8080}
|
|
image: fuellog/web:latest
|
|
container_name: fuellog-web
|
|
restart: unless-stopped
|
|
depends_on:
|
|
api:
|
|
condition: service_healthy
|
|
environment:
|
|
# web 容器需要知道 api 端口,镜像里 build 阶段就替换好了
|
|
API_PORT: ${API_PORT:-8080}
|
|
ports:
|
|
# 宿主机 :8080 -> 容器 :80;改 :80 则直接用 80
|
|
- "${WEB_PORT:-8080}:80"
|
|
networks:
|
|
- fuellog-net
|
|
healthcheck:
|
|
test: ["CMD", "wget", "-q", "-O-", "http://127.0.0.1/"]
|
|
interval: 30s
|
|
timeout: 3s
|
|
retries: 3
|
|
|
|
networks:
|
|
fuellog-net:
|
|
driver: bridge
|
|
|
|
volumes:
|
|
fuellog-data:
|
|
# SQLite 持久化 volume,容器删了数据还在
|
|
name: fuellog-data
|