revel 不能直接暴露公网，因其基于 net/http 的服务器缺乏 tls 终止、连接限速、真实 ip 透传、静态资源缓存控制及健康检查等生产必备能力；必须通过 nginx 反向代理，绑定 127.0.0.1 回环地址并配置 proxy_pass、proxy_set_header、websocket 升级头等关键项才能安全上线。
Revel 应用本身不内置反向代理能力，必须靠外部服务（如 Nginx）做反向代理才能进生产环境。直接暴露 http.port（默认 9000 或自定义如 8089）是危险且不可扩展的。
为什么不能让 Revel 直连公网？
Revel 的 HTTP server 是 Go net/http 实现，适合开发调试，但缺少生产必需能力：
- 无 TLS 终止支持 —— 无法原生处理 HTTPS，硬编码证书或用
ListenAndServeTLS会耦合密钥、难以轮换 - 无连接队列与请求节流 —— 高并发下易被慢连接拖垮，也缺乏 real-ip 透传、限速、黑白名单等基础防护
- 静态资源无缓存控制头 —— 即使配了
public/目录，返回的Cache-Control默认是no-cache，浏览器反复拉旧 JS/CSS - 单点故障 —— Revel 进程挂了就全站不可用，没有健康检查、自动摘除、多实例负载分发机制
Nginx 反向代理配置的关键项
核心是把 Nginx 当作唯一入口，Revel 只监听 127.0.0.1:8089 这类回环地址 + 非特权端口。配置中必须显式设置以下几项，否则会出现 502、静态资源 404、WebSocket 断连等问题：
-
proxy_pass http://127.0.0.1:8089;—— 地址末尾带斜杠与否影响路径拼接，推荐带斜杠避免/api/v1被错转成http://127.0.0.1:8089api/v1 -
proxy_set_header Host $host;和proxy_set_header X-Real-IP $remote_addr;—— Revel 的c.Request.Host和c.Request.RemoteAddr依赖这些头，否则日志和重定向出错 -
proxy_http_version 1.1;+proxy_set_header Upgrade $http_upgrade;+proxy_set_header Connection "upgrade";—— 缺一不可，否则 WebSocket 请求会被降级为 HTTP 长轮询甚至直接 400 -
proxy_buffering off;—— Revel 的 streaming 响应（如 SSE、大文件下载）若开启缓冲，会导致延迟或截断
Revel 多实例 + Nginx 负载均衡怎么配？
Revel 本身无集群状态同步机制（session 不共享、定时任务不互斥），所以「多实例」仅指无状态的 HTTP handler 层横向扩展。Nginx upstream 配置示例如下：
upstream revel_backend {
server 127.0.0.1:8089 max_fails=3 fail_timeout=30s;
server 127.0.0.1:8090 max_fails=3 fail_timeout=30s;
server 127.0.0.1:8091 max_fails=3 fail_timeout=30s;
keepalive 32;
}
<p>server {
listen 80;
location / {
proxy_pass <a href="https://www.php.cn/link/8a43068f6bfa2c01a05fe0ef8bfb3c82">https://www.php.cn/link/8a43068f6bfa2c01a05fe0ef8bfb3c82</a>;
proxy_http_version 1.1;
proxy_set_header Connection '';</p><h1>其他 proxy_* 头同上</h1><pre class="brush:php;toolbar:false;">}}
注意点：
- 每个 Revel 实例必须用不同
http.port，且在app.conf中设为http.addr = 127.0.0.1，禁止绑定0.0.0.0 -
max_fails和fail_timeout是健康检查基础，但 Nginx 不主动探活，需配合 Revel 自带的/health端点 +nginx-plus或第三方模块，或用 Consul + registrator - Revel 的 session 默认存在内存里，多实例下用户刷新可能跳到无 session 的节点 —— 必须外接 Redis 或数据库存 session，用
revel.SessionStore替换默认实现
静态资源缓存失效为什么总失效失败？
Revel 不自动加 hash 或版本号到 /public/ 文件 URL，浏览器强缓存导致上线后白屏或样式错乱。常见错误做法是手动改 HTML 里的 href="/public/app.js"，每次发布都要碰代码。
正确解法是用 Revel 的拦截器注入版本变量，再模板里动态拼参：
- 在
app.conf加resourceVersion = "v1.2.3-abc456"（可用构建时git rev-parse --short HEAD注入） - 拦截器里写
c.RenderArgs["rv"] = revel.Config.StringDefault("resourceVersion", "dev") - 模板中写
<script src="/public/app.js?v=%7B%7B.rv%7D%7D"></script>
这个方案轻量，但容易漏掉：如果用了 Revel 的 Asset 函数（如 {{asset "js/app.js"}}），它不读 .rv，必须统一改用手动拼接，否则部分资源仍走旧缓存。
