使用 Ngrok 将您的 Django 项目公开到互联网

你在使用 Django 进行开发时遇到过这个错误吗？

You're accessing the development server over HTTPS, but it only supports HTTP.

如果您习惯通过“http://localhost:8000”访问开发服务器，此错误可能会令人沮丧 - 尤其是在更新强制 HTTPS 连接的防火墙规则后。除了恢复安全设置外，还有一个更好的解决方案：Ngrok。

Ngrok 是什么？

Ngrok 是一款功能强大的工具，可将本地应用程序公开到互联网，而无需复杂的网络配置（如端口转发或 DNS 设置）。有关 ngrok 的更多信息，请参阅其官方文档。

先决条件

在开始之前，请确保您已：

Django 项目设置

已安装 Python 3.x

配置虚拟环境

一个 ngrok 帐户（免费套餐也可以）

逐步设置

1.安装pyngrok包

在安装任何东西之前，请先激活你的虚拟环境，然后安装 ngrok 的 Python 包装器：

pip install pyngrok
pip freeze > requirements.txt

2.配置Django设置

将 ngrok 的域名添加到项目的“settings.py”中的允许主机列表中：

# settings.py
ALLOWED_HOSTS = ['localhost', '127.0.0.1', '.ngrok-free.app']

这允许 Django 接受来自 ngrok 的动态 URL（`*.ngrok-free.app`）的请求。即使我们无法预测 URL 的随机字符串部分，Django 也不会产生任何错误。

3.启动Django服务器

在项目的根目录中：

python manage.py runserver

注意：Windows 用户可以使用“py manage.py runserver”

4. 身份验证并启动 Ngrok

在 ngrok.com 注册

从仪表板复制您的身份验证令牌

在新的终端窗口中，验证 ngrok：

ngrok config add-authtoken YOUR_TOKEN_HERE

启动隧道：

ngrok http 8000

确保 ngrok 和 Django 服务器端口相同。默认端口通常为 8000。

您应该看到类似以下内容的输出：

Account                       Your Name (Plan: Free)
Version                       3.19.0
Region                       United States (us)
Latency                      Your Latency
Web Interface                An Unsecure HTTP address
Forwarding                   https://[random-id].ngrok-free.app -> http://localhost:8000

5. 测试您的设置

在控制台窗口上仅使用 ngrok 提供的 HTTPS URL 访问您的 Django 应用程序。它看起来类似于以下内容：

https://[random-id].ngrok-free.app

ngrok 的其他用例

Ngrok 不只是用于解决 HTTPS 问题。它的价值在于：

快速互联网曝光：即时分享您的本地开发工作

Webhook 测试：测试需要公共 URL 的集成

客户端预览：让客户端无需部署即可预览工作

跨设备测试：轻松在多种设备上测试您的应用

故障排除提示

检查你的 ngrok 身份验证令牌是否配置正确

在启动 ngrok 之前验证你的 Django 服务器是否正在运行

监控 ngrok 接口的请求日志和错误

CLIS.CC