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
48 lines
1.2 KiB
Docker
48 lines
1.2 KiB
Docker
# 多阶段:Vite 构建 -> Nginx 静态服务
|
|
# Builder
|
|
FROM node:20-alpine AS builder
|
|
|
|
# 国内可换源
|
|
# RUN sed -i 's|dl-cdn.alpinelinux.org|mirrors.aliyun.com|g' /etc/apk/repositories
|
|
|
|
ENV PNPM_HOME=/pnpm \
|
|
PATH=/pnpm:$PATH
|
|
|
|
# 装 pnpm(用 corepack 更省事)
|
|
RUN corepack enable && corepack prepare pnpm@9.7.1 --activate
|
|
|
|
WORKDIR /src
|
|
|
|
# 利用 layer 缓存
|
|
COPY package.json pnpm-lock.yaml* ./
|
|
RUN pnpm install --frozen-lockfile
|
|
|
|
COPY . .
|
|
RUN pnpm build
|
|
|
|
# Runner:用 nginx 提供静态资源 + 反代 /api
|
|
FROM nginx:1.27-alpine
|
|
|
|
# API 容器端口 —— 跟 deploy/docker-compose.yml 的 SERVER_ADDR 保持一致
|
|
# web.conf 里用 __API_PORT__ 占位,RUN sed 替换
|
|
# 默认 8080(对应 Dockerfile 的 ENV SERVER_ADDR=:8080 / compose 默认)
|
|
ARG API_PORT=8080
|
|
|
|
# 删掉默认配置
|
|
RUN rm /etc/nginx/conf.d/default.conf
|
|
|
|
# 我们的反代 + SPA fallback 配置 + 端口占位替换
|
|
COPY nginx/web.conf /etc/nginx/conf.d/web.conf
|
|
RUN sed -i "s|__API_PORT__|${API_PORT}|g" /etc/nginx/conf.d/web.conf
|
|
|
|
# 静态产物
|
|
COPY --from=builder /src/dist /usr/share/nginx/html
|
|
|
|
# 健康检查
|
|
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
|
|
CMD wget -q -O- http://127.0.0.1/ > /dev/null || exit 1
|
|
|
|
EXPOSE 80
|
|
|
|
CMD ["nginx", "-g", "daemon off;"]
|