Dokku 应用部署成功后访问报 Bad Gateway 怎么排查【免费下载链接】dokkuA docker-powered PaaS that helps you build and manage the lifecycle of applications项目地址: https://gitcode.com/GitHub_Trending/do/dokku在 Dokku 上最常见的“假性部署失败”是git push全程无报错、deploy 阶段也全部走完但用浏览器或 curl 访问应用域名时却返回502 Bad Gateway。出现这个现象时问题通常不在构建而在 nginx 代理与应用容器之间。Dokku 用 nginx 做默认代理请求被转发到应用的web进程容器。官方文档给出了两个与 502 直接相关的事实自 0.38.0 起当一个应用尚未部署、没有web进程类型、或没有运行中的 web 进程时Dokku 会生成一个最小 nginx 配置直接返回502 Bad Gateway以便域名可解析、监控工具能探测到非 200 状态码排障文档则指出部署成功但访问报Bad Gateway时常见原因是应用没有使用 Dokku 分配的PORT端口或只监听了127.0.0.1而没有绑定0.0.0.0。下面的排查顺序对应这两类原因先确认 web 进程在跑再看日志然后核对端口映射与监听最后检查 nginx 侧配置和错误日志。所有命令在 Dokku 主机上执行文中以文档示例中的应用名node-js-app为例请替换成你的实际应用名。先确认是否有运行中的 web 进程Dokku 的 nginx 代理默认只代理web进程其他进程类型需要自定义nginx.conf.sigil处理。如果web进程不在502 就是上面说的预期行为。另外要注意dokku ps:stop停掉应用后访问返回 502 也是文档明确记载的正常现象此时用ps:start恢复即可。先用ps:report看应用状态dokku ps:report node-js-app文档示例输出注意其中会随应用状态变化的字段 node-js-app ps information Deployed: false Processes: 0 Ps can scale: true Ps computed restart policy: on-failure:10 Restore: true Running: false重点看Deployed和Running两项。也可以只取单个值dokku ps:report node-js-app --deployed dokku ps:report node-js-app --runningDeployed为false或Running为false时说明当前根本没有可代理的 web 容器先解决进程问题再谈端口。可以用ps:scale查看 formation 里web的数量dokku ps:scale node-js-app文档示例输出----- Scaling for python proctype: qty --------: --- web: 1如果web计数为 0按你的部署方式处理Procfile没有声明web进程类型补充web行并重新部署。初始部署时 Dokku 默认只把web进程自动扩到 1 个实例其他进程类型需要显式声明或ps:scale。进程被停掉了dokku ps:start node-js-app。容器启动后又退出dokku ps:restart node-js-app web只重启 web 进程类型再结合下一步的日志看退出原因。Dokku 默认对非零退出的容器应用on-failure:10重启策略即同一个容器最多自动重启 10 次超过后需要介入。查看 web 进程日志判断容器为何起不来进程存在但反复退出、或者根本没监听端口日志里通常能看到原因# 查看应用日志 dokku logs node-js-app # 持续跟踪 web 进程日志 dokku logs node-js-app -t -p web # 查看上一次失败部署的日志 dokku logs:failed node-js-app注意dokku logs是“live tailing”历史部署的日志通常拿不到logs:failed保存的日志在默认 docker-local 调度器下也只保留到下一次部署或旧容器被垃圾回收为止需要留档的话应接入日志转发。如果日志指向配置或环境问题还可以直接进容器排查# 进入 web 进程容器 dokku enter node-js-app web核对应用监听的端口与绑定地址这是排障文档对Bad Gateway给出的两个主要结论应用应当使用 Dokku 设置的PORT环境变量而不是写死端口。文档给出的示例写法var port process.env.PORT || 3000应用应当绑定到所有接口0.0.0.0。很多框架默认只监听127.0.0.1容器在跑但 nginx 从宿主机连不进去表现就是 Bad Gateway。端口映射侧的文档依据来自 Port Management 文档buildpack 部署的应用必须遵循PORT环境变量。Dokku 通常将其设为5000但不保证固定如果不遵循容器会启动、但服务在容器外不可访问。未使用EXPOSE指令的 Dockerfile 应用默认走5000端口与 buildpack 行为一致使用了EXPOSE的应用会在相同端口号上公开监听。不要手动覆盖PORT环境变量Dokku 通过端口映射来设置它的值手动覆盖可能造成路由问题。确认当前端口映射是否如预期dokku ports:list node-js-app文档示例输出----- Port mappings for node-js-app ----- scheme host port container port http 80 5000或者用 report 形式同时显示“检测到的映射”来自EXPOSE或运行容器与“配置的映射”dokku ports:report node-js-app node-js-app ports information Port map detected: http:80:5000 Port map: http:80:5000 https:443:5000根据结果修正应用代码没读PORT修改代码见上面的process.env.PORT写法后重新部署。Dockerfile 用EXPOSE暴露了非预期端口例如EXPOSE 1234导致映射成http:1234:1234访问 80 端口自然不通按文档推荐做法调整映射# add a port mapping to port 80 dokku ports:add node-js-app http:80:1234 # remove the incorrect port mapping dokku ports:remove node-js-app http:1234:1234端口映射被误配成其他值例如http:5000:5000用ports:set重新指定例如dokku ports:set node-js-app http:80:5000映射格式为scheme:host-port:container-port。确认无误但映射已被清掉dokku ports:clear会清除全部映射重新部署前不要误用需要整体重设时用ports:set。另一个容易混淆的现象如果访问看到的是nginx 默认页而不是 502排障文档把它归为另一类问题多为 nginx 的server_names_hash_bucket_size或 Dockerfile 中EXPOSE引起处理方式见 排障文档不要与 502 混在一起排查。检查 nginx 配置与错误日志前面两步都正常、应用确实在监听正确端口时问题可能出在 nginx 侧。Dokku 为每个应用生成独立的 nginx 配置访问日志和错误日志默认写在/var/log/nginx/${APP}-access.log和/var/log/nginx/${APP}-error.log。# 查看该应用 nginx 错误日志-t 可持续跟踪 dokku nginx:error-logs node-js-app # 查看该应用生成的 nginx 配置 dokku nginx:show-config node-js-app # 查看 nginx 属性报告超时、绑定地址等 dokku nginx:report node-js-app在主机上直接验证 nginx 整体配置nginx -t排障文档给出的示例配置不合法时会得到类似nginx: [emerg] could not build the server_names_hash, you should increase server_names_hash_bucket_size: 32的报错此时编辑/etc/nginx/nginx.conf在http段加入server_names_hash_bucket_size 64;然后dokku nginx:stop dokku nginx:startDokku 也提供了封装好的验证命令dokku nginx:validate-config node-js-app注意文档说明各应用配置实际运行在共享上下文中某个应用配置单独验证不合法、但在全局上下文中合法的情况是存在的所以该命令的退出码取的是nginx -t对服务器真实配置的退出码。如果怀疑代理配置漂移比如 web 容器重建后 nginx 还指向旧地址可以强制重建该应用的代理配置dokku proxy:build-config node-js-app文档提醒当应用当前没有 web 监听器时这条命令可能失败。也就是说如果这里直接报错反过来印证问题仍在 web 进程侧回到第一步继续查。验证恢复修改后用文档中同样的方式确认代理链路通了curl http://node-js-app.dokku.mePort Management 文档的示例输出仅为文档示例实际内容取决于你的应用Hello World!返回应用自身响应而不是 502 页面即代表代理到 web 容器的链路已恢复。边界与限制0.38.0 起“没有运行中的 web 进程 返回 502”是刻意设计的最小配置不是故障。该 502 错误页自带自动重试脚本应用恢复后会自行刷新。如果你的监控系统依赖非 200 状态码探测这个行为正好可用。使用自定义nginx.conf.sigil模板的用户注意0.38.0 起DOKKU_APP_WEB_LISTENERS变量在没有运行中 web 进程的应用上可能为空模板需要自行处理例如用条件判断在空时return 502细节见 0.38.0 迁移指南。如果web进程成功启动而其他进程部署失败nginx 可能最终停止路由请求文档给出的处理是回滚代码或手动执行dokku proxy:build-config app让请求路由到新 web 容器。参考文档排障文档、Nginx 代理、端口管理、进程管理、代理管理、日志管理、进入容器。【免费下载链接】dokkuA docker-powered PaaS that helps you build and manage the lifecycle of applications项目地址: https://gitcode.com/GitHub_Trending/do/dokku创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考