如何将FastAPI应用暴露至公网？本地部署共享链接问题求助

核心问题分析 #

你无法通过公网IP访问的原因主要有几点：

• 本地服务默认仅绑定localhost（127.0.0.1），仅限本机访问
• 本地防火墙拦截了外部端口请求
• 公网IP归属路由器，未做端口转发映射到你的本地机器
• 本地服务默认走HTTP协议，直接用https://访问必然失败

分步解决方案 #

1. 修改服务绑定地址，允许外部访问 #

启动服务时，将绑定地址改为0.0.0.0，让服务监听所有网卡的请求。以下是常见框架的启动示例：

• FastAPI：uvicorn main:app --host 0.0.0.0 --port 8000
• Flask：flask run --host=0.0.0.0 --port=8000
• Express：代码中改为app.listen(8000, '0.0.0.0')

2. 开放本地防火墙端口 #

确保操作系统防火墙允许外部访问服务使用的端口（以8000为例）：

• Windows：打开「Windows Defender防火墙」→「高级设置」→「入站规则」→「新建规则」，选择「端口」，填入服务端口，允许连接。
• Linux：Debian/Ubuntu用ufw allow 8000/tcp；CentOS/RHEL用firewall-cmd --add-port=8000/tcp --permanent && firewall-cmd --reload。

3. 配置路由器端口转发 #

公网IP属于路由器，需将路由器端口映射到本地机器的内网IP和服务端口：

1. 查看本地内网IP：Windows用ipconfig，Linux/macOS用ip addr，比如192.168.1.105。
2. 登录路由器管理后台（通常是192.168.1.1或192.168.0.1，参考路由器底部标签）。
3. 找到「端口转发」/「虚拟服务器」选项，添加规则：
   • 外部端口：与服务端口一致（如8000）
   • 内部端口：与服务端口一致
   • 内部IP：你的本地内网IP
   • 协议：选择TCP

4. 处理HTTPS访问需求 #

本地服务默认走HTTP，直接用https://访问会失败。两种简单解决方式：

• 临时共享（推荐）：用ngrok工具做隧道转发。安装后运行ngrok http 8000，工具会生成带HTTPS的公网链接（如https://xxxx-xx-xx-xx-xx.ngrok.io），直接将该链接加/docs发给他人即可，无需配置路由器和防火墙。
• 自签名证书：给服务配置自签名证书，比如FastAPI可用uvicorn main:app --host 0.0.0.0 --port 443 --ssl-keyfile=./key.pem --ssl-certfile=./cert.pem，但他人访问会有证书警告，适合测试场景。

5. 验证访问 #

• 先在局域网内测试：用内网IP访问http://192.168.1.105:8000/docs，确认能正常打开。
• 再用移动流量测试：切换手机到移动网络（不要连同一WiFi），访问公网IP加端口（如http://你的公网IP:8000/docs）或ngrok生成的HTTPS链接，验证能否发送POST请求。

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