KennethCheng
c64f1d6b2b
NAS 部署时 builder 阶段 `go mod download` 失败: go: go.mod requires go >= 1.26.0 (running go 1.22.12; GOTOOLCHAIN=local) 根因:今天早上 `go mod tidy` 用本机 Go 1.27.0 跑,`go.mod` 的 go 指令 被写到 1.26.0(`go mod tidy` 行为:用当前 toolchain 的 minor), 但 `fuellog-api/Dockerfile` 写死 `FROM golang:1.22-alpine`,base 自带 Go 1.22.12,跟 go.mod 不一致 → Go 工具链自检不通过,go mod download 直接 exit 1。 GOTOOLCHAIN=local 也是这个错的成因:容器内默认不下载更新 toolchain, 如果 go.mod 要求的版本高于 base,会拒绝构建。要么升 base,要么放开 GOTOOLCHAIN=auto 走网络下载新工具链。升 base 是更确定的做法(无网也跑)。 修法:把 builder 阶段的 `FROM golang:1.22-alpine` 改成 `FROM golang:1.27-alpine`(与本机一致,与 go.mod 要求 >=1.26 都满足)。 runner 阶段 (alpine:3.20) 不需要 Go,不动。 未做(留待后续): - 用 ARG 让 base Go 版本参数化,后续 `go mod tidy` 升 go.mod 时同步 Dockerfile base。短期先写死 1.27 - 同样的"go.mod vs Dockerfile base"漂移问题可能在 web 那边再出现 (目前 web 用 node:20-alpine,本机 node 24,node 不会因 minor 不一致 拒绝 npm install,暂时没风险)
FuelLog 部署
目录
docker-compose.yml— 生产:api + web(nginx),宿主机 :8080docker-compose.dev.yml— 开发:api 容器 + 本地 build 出来的 dist 挂到 nginxnginx/web.conf— web 容器用的 nginx 配置
生产部署
# 在仓库根跑
docker compose -f deploy/docker-compose.yml up -d
# 浏览器 http://your-host:8080
数据卷 fuellog-data 名固定;容器删了 SQLite 还在。
反向代理建议
不要直接把 8080 暴露到公网,前面挡一个 Nginx Proxy Manager 或者 Traefik:
- 申请域名 → 配 SSL(Let's Encrypt)
- 反代到
127.0.0.1:8080 - 容器只 listen 8080,不暴露 80
开发模式
# 1. 本地 build 前端
cd fuellog-web
pnpm install
pnpm build
# 2. 启 api + nginx(nginx 挂载刚才 build 出的 dist)
cd ..
docker compose -f deploy/docker-compose.dev.yml up
# 3. 改前端代码后只需重新 pnpm build,再 docker compose restart web
日常前端调试更推荐直接 pnpm dev(Vite :5173 自带 /api 代理),上面这套只在你不想装 Go 的时候用。