进阶 docs.lap.dev 2026-11-18 04:52:34 · 10 阅读

第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 个月前

评论 (0)