Lerd 适用于 Linux、macOS 和 Windows 的本地 PHP 开发环境
Lerd 为每个项目提供带 HTTPS 的 .test 域名、独立的 PHP 和 Node 版本,以及所需的数据库和服务,全部运行在无 root 的 Podman 容器中。免费开源,无需 Docker 守护进程。


安装一次, 就能得到这些。
为 Claude Code、Cursor 和 Codex 准备的 MCP 服务器。
Lerd 自带 MCP 服务器,你写代码时用的助手也能管理你的环境:关联站点、切换 PHP 版本、启动服务和 worker、运行 artisan 和 composer,并查看某个请求做了什么。一条命令即可注册到下方列出的所有助手。
管理环境
site · service · worker关联站点,切换 PHP 和 Node 版本,启动数据库和缓存,运行队列 worker 和调度器。
运行命令
exec在站点使用的 PHP 版本上运行 artisan、composer 和项目自己的控制台命令。
读取每个请求
request lenses按 id 查找某个请求的 N+1 和慢查询、异常、错误日志和失败的任务。
查看浏览器错误
diag browser_events为站点开启浏览器日志后,可查看页面中的 JavaScript 错误和失败的 fetch。
在 worktree 中工作
worktree add每个 worktree 拥有自己的 .test 域名、已安装的依赖,以及共享、克隆或空白的数据库。
为数据库创建快照
db snapshot在切换分支或执行迁移之前。每个快照都会记录所属分支,之后可以恢复正确的那一个。
Claude Code·Cursor·Codex CLI·Gemini CLI·Copilot·Junie·Antigravity·Windsurf·OpenCode
你的 Node、Python 和 Rails 应用, 使用同样的 .test 域名。
lerd init 会识别项目,选择开发服务器和空闲端口,并在主机上运行它,因此文件监听和热重载照常工作。进程退出时 Lerd 会重启它,保存日志,并在前面放上带 TLS 的 nginx。数据库和服务会像任何 PHP 站点一样写入它的 .env。 非 PHP 应用指南 →
Node.js
npm run devNext、Nuxt、NestJS、Vite、Angular 或纯 Express,使用项目固定的 Node 版本。
Python
manage.py runserverDjango 会自动用 runserver 启动。Flask、FastAPI 等运行你指定的命令。
Rails 与 Rack
bin/rails serverRails 运行 bin/rails server,config.ru 以 Rack 方式运行,并能找到 mise 或 rbenv 的 Ruby。
Go 与 Rust
go run . / cargo rungo run . 和 cargo run 开箱即用,也可以让 Lerd 改为运行你自己的文件监听工具。
容器
Containerfile.lerd如果不想安装运行时,Lerd 会写好一个初始 Containerfile,并以无 root 方式运行。
数据库、缓存、搜索 和邮件。
MariaDB·Valkey·Memcached·Typesense·ClickHouse·OpenSearch·Solr·RabbitMQ·Kafka·Beanstalkd·Soketi·Mercure·Selenium·Gotenberg·LocalStack·SpamAssassin·pgvector·TimescaleDB
phpMyAdmin·Adminer·pgAdmin·Mongo Express·RedisInsight·Elasticvue·Typesense Dashboard·OpenSearch Dashboards·Kafbat UI
Linux、macOS 和 Windows。
Linux
在 Ubuntu、Fedora、Arch、Omarchy 以及任何使用 systemd 的发行版上,以 systemd 管理的无 root Podman 运行,并提供 Omarchy 状态栏小组件。无需 Docker 守护进程。
Linux 安装指南 →macOS
在 Mac 上进行本地 PHP 开发,无需付费方案,使用同样的控制台、TUI 和 MCP 服务器。PHP-FPM 和 worker 也可以直接在主机上运行(测试版)。
macOS 安装指南 →Windows
Lerd 运行在 WSL2 中,拥有同样的 CLI、控制台、服务和 MCP 服务器。Windows 安装程序会完成全部配置,WSL2 指南会讲解每一步。
Windows 安装指南 →Lerd 是这样构建的。
无 root 的 Podman
容器以你自己的 systemd 用户身份无 root 运行,背后没有守护进程。
以你的身份运行
安装到 ~/.local/bin。DNS、TLS 和端口的配置都不会触碰系统文件。
识别你的项目
框架从仓库中自动识别。可选的 .lerd.yaml 用来添加服务或 worker。
一天内更新
框架和服务是带版本的定义,无需等待新版本发布即可送达。
开源,MIT
全部免费,打包在一个 MIT 许可的二进制文件中,没有付费方案,也不需要账号。
留在你的主目录
所有内容都在你的主目录下,卸载后机器恢复原样。
Lerd 与 Herd、Laragon、DDEV、Lando 和 Sail 对比。
| Lerd | Laravel Herd | Laragon | DDEV | Lando | Sail | |
|---|---|---|---|---|---|---|
| 支持 Linux | ✓ | ✕ | ✕ | ✓ | ✓ | ✓ |
| 支持 macOS | ✓ | ✓ | ✕ | ✓ | ✓ | ✓ |
| 支持 Windows | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| 无需 Docker 守护进程 | ✓ | ✓ | ✓ | ✕ | ✕ | ✕ |
| 无 root | ✓ | ✓ | – | – | – | ✕ |
| 开源 | ✓ | ✕ | ✕ | ✓ | ✓ | ✓ |
| 免费,无付费方案 | ✓ | – | – | ✓ | ✓ | ✓ |
| 自动配置 .test + TLS | ✓ | ✓ | ✓ | ✓ | – | ✕ |
| 无需任何配置 | ✓ | ✓ | ✓ | ✕ | ✕ | ✕ |
| git worktree 作为站点 | ✓ | ✓ | ✕ | ✕ | ✕ | ✕ |
| 内置 Web UI | ✓ | ✓ | ✕ | – | ✕ | ✕ |
| 终端控制台 | ✓ | ✕ | ✕ | ✕ | ✕ | ✕ |
| 面向 AI 智能体的 MCP 服务器 | ✓ | ✓ | ✕ | ✕ | ✕ | ✕ |
| 性能分析器和调试窗口 | ✓ | ✓ | ✕ | ✕ | ✕ | ✕ |
| 插件 | ✓ | ✕ | ✕ | ✓ | ✓ | ✕ |
从其他工具迁移过来?请看 Linux 版 Laravel Herd、Linux 版 Laragon 和完整对比。
大家 最常问的问题。
Lerd 免费吗?
免费。Lerd 采用 MIT 许可,全部功能都在一个二进制文件中,没有付费方案,也不需要账号。
我需要 Docker 吗?
不需要。Lerd 以你自己的用户身份,在无 root 的 Podman 容器中运行一切,没有守护进程。如果缺少 Podman,安装程序会提示安装。
能在 Windows 上用吗?
可以,在 WSL2 中运行。Windows 安装程序会配置 WSL2、带有你 Linux 用户的 Ubuntu 发行版、Lerd 以及 Lerd 桌面应用。 Windows (WSL2) 指南 →
我需要修改项目吗?
不需要。Lerd 从仓库中识别框架,按原样提供服务。可选的 .lerd.yaml 可以固定 PHP 和 Node 版本、服务和 worker。
能和我已有的 MySQL 或 PostgreSQL 共存吗?
可以。当主机上安装的数据库已占用默认端口时,Lerd 会把容器发布到下一个空闲端口,并写入站点的 .env。
Lerd 能配合 Claude Code 或 Cursor 使用吗?
可以。运行 lerd mcp:enable-global,Lerd 的 MCP 服务器就会注册到 Claude Code、Cursor、Codex CLI、Gemini CLI、VS Code 中的 GitHub Copilot、Junie、Antigravity、Windsurf 和 OpenCode。之后助手就能管理站点、服务、worker 和数据库,并运行 artisan 和 composer。 配置 MCP →
可以扩展吗?
可以,通过社区插件添加命令、控制台页面、AI 工具和服务。每个插件都在 Lerd 安装的那个提交上经过审核。 浏览社区插件 →
如何卸载?
运行 lerd uninstall。它会停止容器,删除 unit、二进制文件和网络,然后询问是否同时删除你的数据和受信任的证书。 卸载会删除什么 →
安装,然后运行 lerd init。
脚本会安装 Lerd 并配置 DNS 和证书。然后 cd 进入项目,运行 lerd init,打开它的 .test 地址即可。