使用 Ngrok 将您的 Django 项目公开到 Internet

Django 开发中遭遇 you're accessing the development server over https, but it only supports http. 错误？本文为您提供解决方案：使用 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 文件中的 ALLOWED_HOSTS 列表：

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

这允许 Django 接受来自 ngrok 动态 URL (*.ngrok-free.app) 的请求，避免因 URL 不确定性导致的错误。

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 (例如 https://[random-id].ngrok-free.app) 访问您的 Django 应用。

ngrok 的其他应用场景

ngrok 不仅限于解决 HTTPS 问题，还可用于：

• 快速网络曝光: 方便地与他人分享本地开发项目。
• Webhook 测试: 测试需要公共 URL 的集成。
• 客户端预览: 让客户端无需部署即可预览项目。
• 跨设备测试: 轻松在多个设备上测试应用。

疑难解答

• 检查 ngrok 身份验证令牌是否正确配置。
• 确认 Django 服务器已启动后再启动 ngrok。
• 查看 ngrok 接口的请求日志和错误信息。

相关资源

更多 Web 开发知识，请阅读我的其他文章：

• 了解服务质量 (QoS)
• 制作响应式网站的艺术

感谢您的阅读，祝您编码愉快！欢迎在评论区分享您的项目。

以上就是使用 Ngrok 将您的 Django 项目公开到 Internet的详细内容，更多请关注php中文网其它相关文章！