如何在Phusion Passenger中配置Fastify实现反向端口绑定？

核心解决方案 #

在Fastify的listen配置中指定host: '127.0.0.1'，规避默认localhost同时触发IPv4和IPv6绑定的行为，适配Phusion Passenger仅允许单次listen调用的限制。

示例代码 #

const fastify = require('fastify')({ logger: true })

// 示例路由
fastify.get('/', async (request, reply) => {
  return { hello: 'world' }
})

// 启动服务时明确指定IPv4地址
const start = async () => {
  try {
    await fastify.listen({ 
      port: process.env.PORT || 3000, 
      host: '127.0.0.1' // 关键配置
    })
    console.log(`Server listening on ${fastify.server.address().port}`)
  } catch (err) {
    fastify.log.error(err)
    process.exit(1)
  }
}
start()

问题根源说明 #

Phusion Passenger采用反向端口绑定机制，要求应用仅调用一次listen方法。而Fastify默认host值为localhost时，会同时尝试绑定IPv4（127.0.0.1）和IPv6（::1）地址，等价于触发两次listen操作，这会直接导致Passenger报错崩溃。将host明确设置为127.0.0.1（仅绑定IPv4）即可避免该冲突，满足Passenger的运行要求。

内容的提问来源于stack exchange，提问作者Exprove