macOS 使用 Colima 设置指南

本指南将引导您在 macOS 上使用 Colima 设置 Coolify。Colima 是一款专为 macOS 设计的轻量级容器运行时。

前置条件

注意

用于 Coolify 的 SSH 密钥必须未设置密码短语或启用双重认证（2FA），否则将无法完成初始设置流程。

提示

您可以根据实际需求调整这些数值。这些是运行 Coolify 及少量服务时的推荐最低配置。

Colima 支持两种网络模式：桥接模式（推荐）和 共享模式。

上述命令使用了 --network-address --network-mode bridged，它会让虚拟机直接从路由器的 DHCP 服务器获取 IP 地址。这使得虚拟机在网络上表现得像一台独立设备，允许局域网内的其他设备访问 Coolify。

默认情况下，桥接模式使用 en0 网络接口。如果您的 Mac 使用其他网络接口，请通过 --network-interface <名称> 进行指定。

您可以使用以下命令查看虚拟机的 IP 地址：

colima list

如果您不需要让网络上的其他设备访问 Coolify——例如，您计划使用 Tailscale 或仅需从 Mac 本身访问 Coolify——则可以省略网络参数：

colima start -c 2 -m 2 -d 30 --ssh-port 2222 --save-config

在共享模式下，虚拟机将在一个私有子网中获取 IP 地址，仅宿主机（Mac）可以访问它。

Coolify 通过 SSH 连接到服务器。由于我们在创建虚拟机时指定了 --ssh-port 2222，因此 SSH 端口是固定的，重启后不会改变。

您可以随时使用以下命令验证 SSH 配置：

colima ssh-config

该命令将输出完整的 SSH 配置信息，包括虚拟机配置的 主机名、端口、用户和 身份文件。

在 Coolify 的初始设置或服务器设置中添加服务器时，请使用输出结果中的主机名和端口。

提示

如果在创建虚拟机时省略了 --ssh-port，Colima 会分配一个随机可用端口，该端口在重启后可能会发生变化。请使用 colima ssh-config 查看当前端口。

SSH 登录到 Colima 虚拟机：
```
colima ssh
```
在虚拟机内部，继续执行 Coolify 安装。
安装完成后，根据您的网络模式访问 Coolify Web 界面：
- 桥接模式：从网络上的任意设备打开 http://<vm-ip>:8000。
- 共享模式：仅从您的 Mac 打开 http://<vm-ip>:8000（虚拟机无法被其他设备访问）。
使用 colima list 查看虚拟机的 IP 地址。
在 Coolify Web 界面中，进入服务器设置，并将 SSH 端口 设置为您创建虚拟机时指定的端口（例如 2222）。Coolify 将使用此端口通过 SSH 管理服务器。

如果出现问题并希望重新开始，您可以删除虚拟机并重新创建。

删除后，请返回创建虚拟机以设置新的虚拟机。

要使 Colima 在 Mac 开机时自动启动：

brew services start colima