Gunicorn绑定443端口失败：无法连接到('0.0.0.0',443)

错误信息 #

Retrying in 1 second.
Retrying in 1 second.
Retrying in 1 second.
Retrying in 1 second.
Retrying in 1 second.
Can't connect to ('0.0.0.0',443)

or

Can't connect to ('',443)

原因分析 #

Linux/Unix系统中，1-1024范围内的端口属于特权端口，只有root用户才有绑定权限。普通用户运行Gunicorn时，无法直接绑定443端口，就会触发上述错误。

解决办法 #

1. 使用root用户启动（不推荐生产环境） #

直接通过sudo以root权限运行Gunicorn：

sudo gunicorn --bind 0.0.0.0:443 your_app:app

这种方式操作简单，但root权限运行服务存在安全隐患，生产环境不建议使用。

2. 端口转发（推荐） #

通过iptables将443端口的流量转发到Gunicorn监听的非特权端口（比如8000），普通用户即可正常运行Gunicorn：

sudo iptables -t nat -A PREROUTING -p tcp --dport 443 -j REDIRECT --to-port 8000

之后启动Gunicorn监听8000端口：

gunicorn --bind 0.0.0.0:8000 your_app:app

3. 给Gunicorn添加绑定特权端口的权限 #

通过setcap命令给Gunicorn二进制文件赋予CAP_NET_BIND_SERVICE能力，让普通用户也能绑定特权端口：
先找到Gunicorn的实际路径：

which gunicorn

再执行权限赋予命令：

sudo setcap 'cap_net_bind_service=+ep' /path/to/your/gunicorn

将/path/to/your/gunicorn替换为上一步得到的实际路径即可。

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