Revel生产环境必须容器化，使用Docker Compose编排Revel二进制、Nginx反向代理和数据库；需多阶段构建镜像、限定监听地址为127.0.0.1:9000、由Nginx处理TLS与静态资源，并确保目录结构完整及REVEL_RUNMODE=prod。
Revel 应用直接用 revel run 启动只适合开发，生产环境必须容器化——否则端口暴露、日志无管理、依赖版本漂移、静态资源没缓存、TLS 终止全得自己硬扛。Docker Compose 是最稳妥的选择，它把 Revel 二进制、Nginx 反向代理、数据库（如 MySQL）三者声明式编排，一条 docker-compose up -d 就能拉起完整栈。
为什么不能直接 docker run revel 二进制？
很多人试过把 revel build 出来的可执行文件 COPY 进 Alpine 镜像，再 CMD ["./myapp"]，结果启动就 panic 或 404。根本原因是 Revel 默认加载路径硬编码为 conf/、app/、public/ 相对当前工作目录，而容器里你没把整个项目结构挂进去，或者 WORKDIR 设错。更隐蔽的问题是：Revel 的模板渲染、模块扫描、静态文件服务都依赖运行时目录结构，不是纯二进制就能跑的“黑盒”。
- 必须保证容器内存在
conf/app.conf、app/controllers/、public/css/等完整子目录 -
REVEL_RUNMODE=prod必须设，否则会启用开发模式的热重载和调试页面（不安全） - 不能用
revel run，必须用revel build生成独立二进制，再由该二进制启动 - 监听地址必须限定为
127.0.0.1:9000，绝不能是0.0.0.0:9000（交由 Nginx 对外暴露）
Dockerfile 多阶段构建的关键点
单阶段镜像体积动辄 300MB+（含 Go 编译器），多阶段能压到 15MB 左右。但 Revel 的构建阶段不能简单照搬 Gin 的写法——它依赖 revel CLI 工具来解析模块和生成路由表。
- 构建阶段必须
RUN go install github.com/revel/cmd/revel@latest，否则revel build命令不存在 -
COPY . .要在go mod download之后，否则revel build找不到app/目录 - 构建命令必须带
-t /app/target指定输出路径，且该路径要与运行阶段COPY --from=builder的源路径一致 - 运行阶段用
alpine:3.18而非scratch，因为 Revel 依赖libc和tzdata（时区支持），scratch会报standard_init_linux.go:228: exec user process caused: no such file or directory
docker-compose.yml 必须包含 Nginx 反向代理
Revel 自带的 HTTP server 不处理 TLS、不压缩响应、不缓存静态资源、不支持连接队列控制。跳过 Nginx 直连 Revel 容器等于裸奔。
- Nginx 容器必须通过
networks与 Revel 容器同属一个自定义网络，不能靠localhost - 反向代理配置里
proxy_pass http://revel-app:9000中的revel-app是docker-compose.yml中服务名，不是容器 hostname - 必须加
proxy_set_header Host $host;和proxy_set_header X-Real-IP $remote_addr;，否则 Revel 的Request.RemoteAddr会变成 Docker 网络 IP - 静态资源（
/public/下文件）建议由 Nginx 直接 serve，不要转发给 Revel，避免额外进程开销
容易被忽略的三个运行时细节
即使镜像构建成功、compose 启动无报错，访问仍可能 502 或 404——问题往往出在运行时绑定和路径上。
-
revel-app容器启动后，检查日志是否输出Running web server on 127.0.0.1:9000，而不是0.0.0.0:9000；后者说明-addr参数没生效 - 确保
docker-compose.yml中 Revel 服务的command显式写成：["./myapp", "-port=9000", "-addr=127.0.0.1"]，别依赖app.conf里的http.port，它在容器里不可靠 - 如果用
volume挂载配置，宿主机路径必须包含完整conf/目录，且权限为 644，否则 Revel 启动时读取app.conf失败会静默退出
