第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 控制台中选择要使用的环境:
- 进入 Environments 标签页
- 选择你要使用的环境
- 点击 Set as Active Environment
设置完成后,所有流量拦截和服务访问都会通过该当前环境路由。
拦截服务
连接成功后,你可以在 Lapdev 控制台中拦截特定工作负载的流量:
- 在 Lapdev 控制台中打开你的环境
- 停留在(或切换到)Workloads 标签页
- 找到拥有目标服务的工作负载(例如 checkout-service)
- 在该工作负载所在行点击 Start Intercept
Lapdev 会自动镜像每个容器端口,并复用你最近一次拦截的端口覆盖配置。如果启动拦截后需要自定义本地端口,可在拦截卡片上点击 Edit Ports 按钮修改映射。
启用拦截后:
- 该服务的所有集群流量都会路由到你的本地机器
- 你可以直接在 IDE 中编辑代码、热重载或调试
- 集群中的其他服务不受影响
访问集群内服务
通过 Devbox 连接期间,你可以直接在本地代码中使用集群 DNS 名称(例如 postgres-service:5432、redis-service:6379)访问环境中的任意服务。Devbox 会自动处理隧道连接,无需端口转发或 VPN。
下一步
- 了解更多 Devbox 架构
- 理解流量路由
- 创建 Preview URL 分享你的工作
上一篇:创建 Lapdev 环境 下一篇:使用 Preview URL
最后更新:11 个月前