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

第5章 使用 Devbox 实现本地开发指南

完整文档索引见 llms.txt。本页也提供 Markdown 版本。

使用 Devbox 进行本地开发

本指南介绍如何在 Lapdev 环境中配置和使用 Devbox 进行本地开发。

请先阅读 Devbox 文档,了解它的功能和适用场景。

前置条件

使用 Devbox 前,你需要:

  • 已安装 Lapdev CLI —— Devbox 内置于 lapdev 命令中
  • 一个可用的 Lapdev 环境 —— 个人环境、共享环境或分支环境均可

安装 Lapdev CLI

根据操作系统运行以下命令之一。

Linux 或 macOS

curl -fsSL https://get.lap.dev/lapdev-cli.sh | bash

该脚本会自动检测你的架构,下载最新版本,并把 lapdev 二进制文件放到 /usr/local/bin(必要时放到 ~/.local/bin)。随时可以重新运行以升级,或通过 --version <x.y.z> 指定版本。

Windows PowerShell

irm https://get.lap.dev/lapdev-cli.ps1 | iex

如果执行策略有要求,请在管理员权限的 PowerShell 窗口中运行。安装程序会把 lapdev.exe 复制到 %LOCALAPPDATA%\Lapdev\bin,并将该目录添加到你的用户 PATH。安装完成后请重启终端(或 VS Code 终端),以便加载新路径。

安装完成后,运行以下命令验证是否就绪:

lapdev --version

连接 Lapdev

首先,将你的 Devbox CLI 连接到 Lapdev:

这会在你的本地机器与 Lapdev 之间建立安全连接。

设置当前环境

连接后,在 Lapdev 控制台中选择要使用的环境:

  1. 进入 Environments 标签页
  2. 选择你要使用的环境
  3. 点击 Set as Active Environment

设置完成后,所有流量拦截和服务访问都会通过该当前环境路由。

拦截服务

连接成功后,你可以在 Lapdev 控制台中拦截特定工作负载的流量:

  1. 在 Lapdev 控制台中打开你的环境
  2. 停留在(或切换到)Workloads 标签页
  3. 找到拥有目标服务的工作负载(例如 checkout-service)
  4. 在该工作负载所在行点击 Start Intercept

Lapdev 会自动镜像每个容器端口,并复用你最近一次拦截的端口覆盖配置。如果启动拦截后需要自定义本地端口,可在拦截卡片上点击 Edit Ports 按钮修改映射。

启用拦截后:

  • 该服务的所有集群流量都会路由到你的本地机器
  • 你可以直接在 IDE 中编辑代码、热重载或调试
  • 集群中的其他服务不受影响

访问集群内服务

通过 Devbox 连接期间,你可以直接在本地代码中使用集群 DNS 名称(例如 postgres-service:5432、redis-service:6379)访问环境中的任意服务。Devbox 会自动处理隧道连接,无需端口转发或 VPN。

下一步

  • 了解更多 Devbox 架构
  • 理解流量路由
  • 创建 Preview URL 分享你的工作

上一篇:创建 Lapdev 环境 下一篇:使用 Preview URL

最后更新:11 个月前

评论 (0)