第6章 使用 Preview URLs
完整文档索引请见 llms.txt。本页面也提供 Markdown 版本。使用 Preview URLs
Lapdev 允许你为环境创建 Preview URL,从而安全地访问和分享正在运行的服务——无需手动配置 DNS、ingress 或 TLS 证书。
每个 Preview URL 都指向环境中的一个特定服务(例如 frontend、api-gateway 或 admin 服务)。一个环境可以创建多个 Preview URL,分别对应不同的服务。
阅读 Preview URL 了解它们是什么、有什么用处。
前提条件
开始之前:
- 你在 Lapdev 中至少要有一个活跃环境(个人、共享或分支环境)。 - 环境在 Lapdev 控制台中需显示 Active 状态。 - 你的应用必须在 Kubernetes 中至少暴露一个 Service。
创建 Preview URL
打开 Lapdev 控制台:https://app.lap.dev 进入 Environments 标签页。 选择要创建预览的环境。 在环境详情页,滚动到 Preview URLs 区域。 点击 Create Preview URL。
示例截图:
在 Create Preview URL 对话框中:
- 选择该 URL 要指向的 Service(例如 frontend、api-gateway 或 admin)。 - 可选填写 Description(如“前端 QA 演示”)。 - 选择 Access Level(默认为 Organization,也可选 Public)。 - 点击 Create。
Lapdev 将会:
- 为所选服务自动生成一个唯一的 HTTPS 域名 - 处理该 URL 的路由、DNS 和 TLS 证书 - 将流量直接路由到你环境内的所选服务
查看和打开 Preview URLs
创建完成后:
- 环境的所有 Preview URL 都会显示在 Preview URLs 区域。 - 每条记录列出: - 目标 Service 的名称 - URL 本身 - 访问级别(Organization 或 Public)
点击 URL 即可在浏览器中打开。
分享 Preview URL
Preview URL 可以安全地分享给:
- 团队成员或 QA 工程师,用于快速测试 - 产品经理或设计师,用于功能评审 - 自动化测试系统,用于集成测试
只需复制链接分享即可——无需 VPN、防火墙或集群访问权限。
💡 提示:如果你的应用暴露了多个服务(如 frontend、admin、gateway),可以在同一环境中创建多个 Preview URL。
管理访问控制
每个 Preview URL 都有独立的访问策略。修改方法:
在 Preview URLs 区域,点击 URL 旁边的设置图标。 选择访问对象: - Organization(推荐,默认):仅经过身份验证的 Lapdev 用户可访问。 - Public:任何持有链接的人均可访问。 - (即将推出)组织级别的自定义规则。 点击 Save。
🔒 内部分支或未发布的功能建议使用 Organization 访问级别。
删除 Preview URL
删除某个 Preview URL:
进入环境的 Preview URLs 区域。 点击 URL 旁的 Delete 图标。 确认删除。
删除 Preview URL 不会影响环境及其工作负载——只是移除那个特定的公开端点。
故障排查
| 问题 | 可能原因 | 解决方法 | | Service 未列出 | 服务未暴露端口 | 检查 Kubernetes Service 是否定义了有效端口 | | Preview URL 无法打开 | 服务未就绪或端点不可达 | 确认 pods 和 services 正在运行 | | HTTPS 警告 | 证书仍在传播中 | 等待 30–60 秒;Lapdev 会自动处理 TLS |
下一步
- 进一步了解 Preview URLs 及其内部工作原理 - 使用 Devbox 连接你的环境进行实时调试 - 探索 App Catalogs,定义哪些工作负载出现在你的环境中
上一篇:使用 Devbox 进行本地开发 下一篇:架构
最后更新于 11 个月前