没有 WebDonkey 时
你把域名加进 hosts 文件,写一个 vhost,生成证书,并在钥匙串里把它标记为受信任。下一个项目,你再把这一切重做一遍,这次用的是另一个 PHP 版本。
有了 WebDonkey
选择文件夹,输入域名,选好 PHP 或 Node 版本。其余的由 WebDonkey 配置。无论旁边的项目需要什么,每个站点都保留自己的 Web 服务器和版本。
你能得到什么
- 通过表单创建新项目新的客户项目运行在自己的域名下,并带有效证书。配置文件由应用写入。
- 项目互相分开新旧项目并行运行。更新其中一个,不会改变另一个。
- 像线上一样测试你的项目在自己的域名下通过 HTTPS 运行,和日后用户访问它的方式一样。
详细介绍
WebDonkeyFree 与 Premium
“WebDonkey”标签页显示 WebDonkey 为你运行的所有站点,包括 Web 服务器、PHP 和 Node 版本以及状态。在每一行中,你可以在浏览器中打开站点,在访达或编辑器中打开其文件夹,在项目文件夹中打开终端,也可以关闭或编辑它。Free 允许无限站点,其中同时最多三个使用 SSL。
新建站点
名称、域名和别名、文档根目录,以及(如果需要)单独的项目文件夹、Web 服务器、PHP 和 Node 版本以及 SSL。域名可自由选择,例如 shop.dev 或 client.local。在“创建”旁边,“还需要”会列出按钮变为可用之前还缺什么。“编辑”打开同一个表单,在那里也可以切换 Web 服务器或 PHP 版本。
站点包Premium
十一款站点包,从 WordPress、Shopware 6、Laravel、Symfony、Drupal 到 Vite、Astro、Angular 和 Hugo,一键即可搭建:创建站点时,站点包会安装整个应用,包括配置、文档根目录,以及(如果需要)数据库。WebDonkey 会事先检查所需条件,并提示安装缺少的部分。
启动命令
自带服务器的项目,例如使用 npm start 的 Node 项目,会获得启动命令,而不是文档根目录。WebDonkey 启动该进程,把一个空闲端口以 PORT 的形式交给它,前置代理再把该域名的请求转发给它。
诊断
诊断会检查浏览器与文件之间的每一层:文档根目录和索引文件是否存在,域名是否在 /etc/hosts 中,前置代理和 Web 服务器是否在运行,PHP-FPM socket 是否存在、vhost 是否已写入,证书是否已签发,443 端口是否接受连接?对于 nginx,还会加上配置的语法检查。每一行都会得到绿色对勾或红色叉号,修复之后点“重新检查”即可再运行一次。
来自 WebDonkey Pages
你在 WebDonkey Pages 中构建、但这里还没有对应站点的网站,会出现在列表下方 WebDonkey 选项卡的“来自 WebDonkey Pages”下。“在本地设置”会在 .test 域名下用 PHP 创建它们并启动,“在 Pages 中打开”会跳回 Pages 应用。以这种方式设置的站点,在列表中带有 Pages 徽章。
DDEV
你 Mac 上的所有 DDEV 项目,含状态和类型。启动、停止、在浏览器中打开、跳转到项目文件夹、在容器中打开 shell。详情区域显示配置、快照、日志、附加组件,以及一个可执行任意 ddev 命令的输入框。新项目也直接在这里创建。
DDEV 项目
点击 DDEV 行会打开其管理界面,共有五个标签页:配置、快照、日志、附加组件和命令。你可以用表单或 YAML 编辑配置;“重启”使更改生效。
Docker
Docker 守护进程当前所持有的内容,无论由 Docker Desktop、Colima、OrbStack 还是 Rancher Desktop 提供。启动、停止、重启和暂停容器,在浏览器中打开已发布的端口,在容器内打开终端。WebDonkey 只与你自己的 docker CLI 通信,绝不会改动你的配置。
容器详情
点击某个容器会展开它的详情:ID、镜像、创建时间、重启策略、命令、用量、端口、网络、挂载和环境变量。“日志”开关则改为显示它的日志。
镜像、卷、网络
容器旁边是“镜像”“卷”“网络”和 Compose 标签页。镜像可通过“拉取”获取,“清理”会移除未使用的镜像、卷或网络,Compose 项目则可以启动、关闭并查看其文件。“启动容器”会根据镜像创建一个新容器,可设置端口、环境变量、卷和重启策略;除非你在前面加上地址,否则这些端口只能在这台 Mac 上访问。
Free 包含什么?
在 Free 中,你可以创建数量不限的站点,其中三个可同时使用 HTTPS。能顺带搭好 WordPress、Shopware 6 或 Laravel 的站点包属于 Premium。
比较 Free 与 Premium相关功能
-

本地 HTTPS,没有警告WebDonkey 拥有自己的根 CA,为每个站点签发证书。只需信任一次 CA,每个 .test 域名在浏览器中都会显示为安全。 -

所有服务集中一处Web 服务器、PHP、Node、数据库、缓存、邮件、搜索、队列、存储、应用和 AI 工具。安装、启动、停止、切换版本。服务和数据存放在各自的文件夹中;为了域名、端口和证书,WebDonkey 会在你同意后设置少量系统条目。此外,你的 ~/.zshrc 末尾会加入一个带标记的代码块,让终端使用当前启用的版本,你可以在设置中将其关闭。 -

创建和浏览数据库管理 MySQL、MariaDB、PostgreSQL 和 MongoDB,创建数据库和用户。Adminer 已内置,可直接在应用中打开,服务器和用户均已预先填好。 -

每封邮件都落到你这里,不会发给客户Mailpit 捕获项目发出的所有邮件。订单确认、密码重置链接、新闻简报测试:全部进入 Mailpit 的收件箱,支持 HTML 视图、源码和附件。使用 Premium 时直接在 WebDonkey 中阅读,Free 则在浏览器中打开。