Beego项目Docker生产部署必须编译静态二进制、关闭热重载、显式指定conf/static/views路径，禁用bee run；需设runmode=prod、httpport=8080、viewspath=views、staticdir=static，并用环境变量注入敏感配置。
Beego 项目用 Docker 部署，不能直接照搬开发时的 bee run 方式上线。生产环境必须编译成二进制、关闭热重载、显式指定配置路径，否则容器一启就崩，或配置不生效、静态资源 404。
bee run 在 Docker 里为什么不行
-
bee run是开发工具，依赖源码 + 文件监听 + 进程守护，不是生产级启动方式 - 容器内无 shell 环境或信号转发时，
bee run可能静默退出 - 它默认读取当前目录下的
conf/app.conf，但 Docker 中工作目录、挂载路径、权限稍有偏差就会报open conf/app.conf: no such file or directory - 日志输出不标准（混用
fmt.Println和beego.Trace），难以被docker logs正确捕获
你看到的很多教程用 CMD ["bee", "run"]，只适用于本地快速验证，切勿用于生产镜像构建。
构建生产镜像：多阶段构建 + 静态二进制
Dockerfile 必须分两步：编译阶段用完整 Go 环境，运行阶段用极简镜像（如 alpine 或 scratch），避免把 go、bee、源码全塞进最终镜像。
FROM golang:1.21-alpine AS builder WORKDIR /app COPY go.mod go.sum ./ RUN go mod download COPY . . RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o beego-app . <p>FROM alpine:latest RUN apk --no-cache add ca-certificates WORKDIR /root/ COPY --from=builder /app/beego-app . COPY conf/ ./conf/ COPY static/ ./static/ COPY views/ ./views/ EXPOSE 8080 CMD ["./beego-app"]</p>
-
CGO_ENABLED=0确保生成纯静态二进制，不依赖宿主机 libc -
GOOS=linux防止在 macOS 或 Windows 上构建时出错 - 所有资源目录（
conf、static、views）必须显式 COPY 进镜像，不能靠挂载或相对路径猜测 - 不要设
ENTRYPOINT包裹sh -c，会干扰 beego 的信号处理（比如 SIGTERM 无法优雅关闭）
启动前必须改的配置项
conf/app.conf 里这几项不手动设，容器跑起来大概率监听失败或配置无效：
-
runmode = prod：强制关闭开发模式（否则自动加载dev.conf，且启用RecoverPanic等调试行为） -
httpport = 8080：和EXPOSE、-p映射端口保持一致；别写0.0.0.0:8080，beego 会解析失败 -
appname = myapp：避免日志里出现空 appname 导致字段缺失 -
viewspath = views：明确路径，防止容器内beego.SetViewsPath()拿到错误根目录 -
staticdir = static：同理，不然 CSS/JS 404
如果用了数据库或 Redis，app.conf 中的连接串也建议用环境变量注入（通过 beego.AppConfig.String("db::host") 读取），而不是硬编码。
容器启动时容易忽略的细节
-
docker run不要加-it参数上线：它绑定伪终端，导致容器无法作为后台服务被 systemd 或 k8s 正确管理 - 端口映射格式必须是
-p 8080:8080，左边宿主机端口，右边容器内 beego 实际监听的端口（由httpport决定） - 若挂载配置文件（比如
-v ./prod.conf:/root/conf/app.conf），注意 Linux 文件权限：容器内用户默认是 root，但如果你用非 root 用户启动，得提前chown 65534:65534 app.conf（对应unprivileged用户） - 日志别重定向到文件：beego 默认写 stdout/stderr，这样
docker logs才能实时看到；若强行写logs/目录，需确保该目录存在且可写，否则启动失败无提示
真正的难点不在构建，而在让 beego 信任容器内的路径和环境——它不像 Gin 那样默认“只认当前工作目录”，而是会尝试向上找 conf、向下找 views，一旦 WORKDIR 或 COPY 顺序错一拍，就静默失败。
