开始使用
连接 Mac
在 macOS 上打开「远程登录」，并用密码或密钥把这台 Mac 添加到 SwiftServer。
macOS 自带 SSH 服务器，只需要把它打开。
打开远程登录
在你要连接的那台 Mac 上：
- 打开系统设置（苹果菜单 → 系统设置）。
- 进入通用 → 共享。
- 打开远程登录（Remote Login）。
- 点它旁边的 ⓘ 可以控制谁能登录：所有用户，或者仅这些用户 （Only these users）加一份明确的名单。允许远程用户完全访问磁盘 （Allow full disk access for remote users）是可选项， 只有当会话需要读取受保护的位置时才要打开。
Apple 的参考文档： 允许远程电脑访问你的 Mac。
在更早的系统上（macOS 12 及更早），同一个开关位于 系统偏好设置 → 共享 → 远程登录。
在 SwiftServer 里添加这台 Mac
添加一台机器，填写：
- 主机：这台 Mac 的地址。在家里或办公室的网络里，它就是本地 IP
（共享面板里会直接显示，例如
192.168.1.20），或者name.local形式的主机名。 - 用户名 / 密码：macOS 账户的短名称和登录密码。要用密钥登录， 请先把公钥装到这台 Mac 上。
测试连接、信任主机密钥之后，各项功能都可以用了：监控（与 Linux 的差异见 macOS 平台说明）、终端、SFTP， 以及装有 Docker Desktop 或 Docker 命令行时的 Docker。
从网络外部连接 Mac
192.168.* 这类地址只在同一个网络里有效。从别处连接需要下列条件之一：
接入该网络的 VPN（包括 Tailscale 这类 mesh VPN）、把路由器的端口转发到这台 Mac 的
22 端口，或者一台两边都能访问的跳板机。
连接失败时
- 连接被拒绝或超时：远程登录没有打开，或者防火墙挡住了 22 端口。 检查系统设置 → 网络 → 防火墙。
- 认证失败：这个账户不在仅这些用户的名单里；另外用户名要填账户的 短名称，也就是主目录的名称，不要填全名或 Apple ID 邮箱。
- 首次连接时，macOS 可能会向服务器一侧的用户弹出提示，出现时请允许本地网络访问。
更多内容见故障排查 → 连接。