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

从现在开始，努力学习吧！本文《使用 Ngrok 将您的 Django 项目公开到 Internet》主要讲解了等等相关知识点，我会在golang学习网中持续更新相关的系列文章，欢迎大家关注并积极留言建议。下面就先一起来看一下本篇正文内容吧，希望能帮到你！

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》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！