00 / 开源、无 root、无需 Docker

Lerd 适用于 Linux、macOS 和 Windows 的本地 PHP 开发环境

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

$curl -fsSL https://lerd.sh/install.sh | bash
Windows阅读文档 →
7.4 – 8.6PHP 版本
40服务预设
25框架定义
8社区插件
Lerd 网页控制台,显示站点、服务和 workerLerd 网页控制台,显示站点、服务和 worker
01–08 / 功能一览

安装一次, 就能得到这些。

01 / 站点稳定

运行 lerd init,获得 .test 域名。

Lerd 会识别框架,运行 composer 和 npm,迁移数据库,启动 worker,并签发受信任的证书。Nginx 和 PHP-FPM 在 https://project.test 上提供服务。

LinuxmacOSWSL2
$ lerd init
了解站点 →
09 / AI 智能体

为 Claude Code、Cursor 和 Codex 准备的 MCP 服务器。

Lerd 自带 MCP 服务器,你写代码时用的助手也能管理你的环境:关联站点、切换 PHP 版本、启动服务和 worker、运行 artisan 和 composer,并查看某个请求做了什么。一条命令即可注册到下方列出的所有助手。

$ lerd mcp:enable-global
01

管理环境

site · service · worker

关联站点,切换 PHP 和 Node 版本,启动数据库和缓存,运行队列 worker 和调度器。

02

运行命令

exec

在站点使用的 PHP 版本上运行 artisan、composer 和项目自己的控制台命令。

03

读取每个请求

request lenses

按 id 查找某个请求的 N+1 和慢查询、异常、错误日志和失败的任务。

04

查看浏览器错误

diag browser_events

为站点开启浏览器日志后,可查看页面中的 JavaScript 错误和失败的 fetch。

05

在 worktree 中工作

worktree add

每个 worktree 拥有自己的 .test 域名、已安装的依赖,以及共享、克隆或空白的数据库。

06

为数据库创建快照

db snapshot

在切换分支或执行迁移之前。每个快照都会记录所属分支,之后可以恢复正确的那一个。

支持

Claude Code·Cursor·Codex CLI·Gemini CLI·Copilot·Junie·Antigravity·Windsurf·OpenCode

11 / 不止 PHP

你的 Node、Python 和 Rails 应用, 使用同样的 .test 域名。

lerd init 会识别项目,选择开发服务器和空闲端口,并在主机上运行它,因此文件监听和热重载照常工作。进程退出时 Lerd 会重启它,保存日志,并在前面放上带 TLS 的 nginx。数据库和服务会像任何 PHP 站点一样写入它的 .env。 非 PHP 应用指南 →

01

Node.js

npm run dev

Next、Nuxt、NestJS、Vite、Angular 或纯 Express,使用项目固定的 Node 版本。

02

Python

manage.py runserver

Django 会自动用 runserver 启动。Flask、FastAPI 等运行你指定的命令。

03

Rails 与 Rack

bin/rails server

Rails 运行 bin/rails server,config.ru 以 Rack 方式运行,并能找到 mise 或 rbenv 的 Ruby。

04

Go 与 Rust

go run . / cargo run

go run . 和 cargo run 开箱即用,也可以让 Lerd 改为运行你自己的文件监听工具。

05

容器

Containerfile.lerd

如果不想安装运行时,Lerd 会写好一个初始 Containerfile,并以无 root 方式运行。

12 / 服务

数据库、缓存、搜索 和邮件。

01 MySQL:3306
02 PostgreSQL:5432
03 Redis:6379
04 Meilisearch:7700
05 S RustFS / S3:9000
06 Mailpit:1025
07 MongoDB:27017
08 Stripe Mock:12111
09 Elasticsearch:9200
++你的框架,用 YAML 定义 →
商店中还有 18 个

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

13 / 社区插件

其他一切, 交给社区插件。

插件可以添加 Lerd 尚未提供的功能:CLI 命令、控制台页面、站点标签页、AI 助手工具,以及在特定事件发生时运行的钩子。可以用你机器上能运行的任何语言来写。目录中的每个插件都在 Lerd 安装的那个提交上经过审核。

14 / 平台

Linux、macOS 和 Windows。

01稳定

Linux

在 Ubuntu、Fedora、Arch、Omarchy 以及任何使用 systemd 的发行版上,以 systemd 管理的无 root Podman 运行,并提供 Omarchy 状态栏小组件。无需 Docker 守护进程。

Linux 安装指南 →
02稳定

macOS

在 Mac 上进行本地 PHP 开发,无需付费方案,使用同样的控制台、TUI 和 MCP 服务器。PHP-FPM 和 worker 也可以直接在主机上运行(测试版)。

macOS 安装指南 →
03WSL2

Windows

Lerd 运行在 WSL2 中,拥有同样的 CLI、控制台、服务和 MCP 服务器。Windows 安装程序会完成全部配置,WSL2 指南会讲解每一步。

Windows 安装指南 →
15 / 设计原则

Lerd 是这样构建的。

01

无 root 的 Podman

容器以你自己的 systemd 用户身份无 root 运行,背后没有守护进程。

02

以你的身份运行

安装到 ~/.local/bin。DNS、TLS 和端口的配置都不会触碰系统文件。

03

识别你的项目

框架从仓库中自动识别。可选的 .lerd.yaml 用来添加服务或 worker。

04

一天内更新

框架和服务是带版本的定义,无需等待新版本发布即可送达。

05

开源,MIT

全部免费,打包在一个 MIT 许可的二进制文件中,没有付费方案,也不需要账号。

06

留在你的主目录

所有内容都在你的主目录下,卸载后机器恢复原样。

16 / 对比

Lerd 与 Herd、Laragon、DDEV、Lando 和 Sail 对比。

LerdLaravel HerdLaragonDDEVLandoSail
支持 Linux✓✕✕✓✓✓
支持 macOS✓✓✕✓✓✓
支持 Windows✓✓✓✓✓✓
无需 Docker 守护进程✓✓✓✕✕✕
无 root✓✓–––✕
开源✓✕✕✓✓✓
免费,无付费方案✓––✓✓✓
自动配置 .test + TLS✓✓✓✓–✕
无需任何配置✓✓✓✕✕✕
git worktree 作为站点✓✓✕✕✕✕
内置 Web UI✓✓✕–✕✕
终端控制台✓✕✕✕✕✕
面向 AI 智能体的 MCP 服务器✓✓✕✕✕✕
性能分析器和调试窗口✓✓✕✕✕✕
插件✓✕✕✓✓✕

从其他工具迁移过来?请看 Linux 版 Laravel Herd、Linux 版 Laragon 和完整对比。

17 / 价格

人人免费, 需要时也有支持。

01MIT

免费 永久

Lerd 的全部功能,个人和商业用途均可。没有付费方案,不需要账号,不保留任何功能。

安装 Lerd →
02可选

赞助

离不开 Lerd?赞助能支持维护它的时间,带来新功能,并让修复更快发布。

成为赞助者 →
03团队

商业支持

在团队中使用 Lerd?支持服务包括上手指导、优先修复以及针对你技术栈的帮助。

联系我们 →
18 / 常见问题

大家 最常问的问题。

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、二进制文件和网络,然后询问是否同时删除你的数据和受信任的证书。 卸载会删除什么 →

19 / 开始使用

安装,然后运行 lerd init。

脚本会安装 Lerd 并配置 DNS 和证书。然后 cd 进入项目,运行 lerd init,打开它的 .test 地址即可。

$curl -fsSL https://lerd.sh/install.sh | bash
Windows在 GitHub 上点星1.5k