macOS

桌面版客户端支持: macOS12+

命令行客户端支持: macOS10.15+

安装桌面版客户端

适用于 macOS12+ 的系统, 您可以通过以下方式安装:

通过下载安装

安装 Cloudnet 客户端: 点此下载

桌面客户端已内置命令行工具,无需再安装命令行客户端.

通过在线脚本安装

打开“终端”或 iTerm，以当前桌面用户执行：

# 安装或升级完整桌面客户端及 cloudnetd 服务
curl -fsSL https://pkgs.cloudnet.world/stable/installer.sh | sh

# 显式执行升级（与上面的安装命令使用同一流程）
curl -fsSL https://pkgs.cloudnet.world/stable/installer.sh | sh -s -- upgrade

# 重启已安装的 cloudnetd 网络服务（等价于 cnet restart）
curl -fsSL https://pkgs.cloudnet.world/stable/installer.sh | sh -s -- restart

# 仅退出并重新打开桌面程序
curl -fsSL https://pkgs.cloudnet.world/stable/installer.sh | sh -s -- reopen

# 查看帮助
curl -fsSL https://pkgs.cloudnet.world/stable/installer.sh | sh -s -- -h

在线脚本适用于 macOS 12+ 的 Intel 与 Apple Silicon，安装 1.36.2.23 起的 stable 桌面版本，无需安装 Homebrew。脚本从官方包站下载 DMG，核对长度、SHA-256、App 版本和签名后，安装或升级桌面程序及其服务；终端可能通过 sudo 要求管理员密码。下载中断后，重复执行命令可继续下载。

默认安装到 /Applications/CloudNet.app。如果已运行的客户端位于其他正常安装目录，脚本会沿用该位置。已有设备升级保留设备身份、登录状态及 DNS、路由设置，无需重新入网；首次安装完成后，仍需通过托盘菜单登录网络。

restart 调用已安装的 /usr/local/cloudnet/bin/cnet restart，校验资源及版本、重启 cloudnetd 并检查服务状态；可能通过 sudo 要求管理员密码。此操作不下载、不重开 GUI、不重置身份或重新入网，但会短暂中断 CloudNet 网络。远程执行时请使用物理网络连接，不要通过 CloudNet 虚拟地址管理设备。服务尚未安装时，请先执行安装命令。

reopen 仅重开当前用户的桌面程序，不下载、不请求管理员权限，也不操作网络服务。此前在线脚本的 restart 用于 GUI 重开；现在需要改用 reopen。安装、升级、服务重启与 GUI 重开均不会重启电脑、重置设备或自动登录网络。

也可通过 CLOUDNET_ACTION 指定操作；显式参数优先，例如：

curl -fsSL https://pkgs.cloudnet.world/stable/installer.sh | CLOUDNET_ACTION=restart sh
# 仅重开 GUI
curl -fsSL https://pkgs.cloudnet.world/stable/installer.sh | CLOUDNET_ACTION=reopen sh

安装失败时

• 下载中断或超时：网络恢复后重复执行安装命令，脚本会继续已验证范围的部分下载。
• 长度、哈希或签名校验失败：脚本不会安装未通过校验的包。下载内容异常会有限次重试，并刷新元数据一次；仍失败时请稍后重试或联系支持。
• 管理员授权取消或被拒绝：现有程序和服务保持原状；准备好管理员权限后重新执行即可。
• 复制或替换失败：完整复制和校验在退出 GUI 前完成；替换失败时尝试恢复原 App。若提示恢复失败，请按输出位置保留原 App，并联系支持。
• 服务安装失败：新 App 保留供修复，脚本报告失败阶段，不写入整体成功记录。可重新执行安装命令，或使用客户端的“安装服务(管理员)”入口；不必重新入网。
• 已有设备升级后要求重新登录：这是登录状态异常，请保留诊断信息并联系支持，不要用重置或重新入网掩盖问题。
• 另一个安装器或服务操作正在运行：等待其结束后再执行，避免并发操作。

通过 Homebrew 安装（备选）

此方式需要先安装 Homebrew。由于软件源同步和审核，提供的版本可能晚于官方包站：

brew install --cask cloudnet

注册设备

通过客户端注册(推荐)

在注册设备前,您需要先登录用户中心创建子网,然后才能在客户端上进行登录网络.

• 启动程序
• 在线脚本已安装或验证服务；通过 DMG 手动安装时，如托盘提示服务未安装或版本不匹配，请选择“安装服务(管理员)”并完成系统授权
• 点击托盘图标, 在弹出菜单中点击 登录网络
• 选择 网页登录 或 授权码登录
• 如果选择 网页登录, 会自动打开浏览器, 请在浏览器中完成登录
• 如果选择 授权码登录, 请在弹出的对话框中输入授权密钥即可

通过命令行注册

命令行工具在 /usr/local/cloudnet/bin, 您需要将该目录添加到环境变量中才能使用

网页注册

cnet start --accept-dns=false --accept-routes=false
# 请将输出的 URL 复制到浏览器中打开完成注册

密钥注册

cnet start --accept-dns=false --accept-routes=false --auth-key=<PreAuthKey>

更新客户端

在线脚本安装的桌面客户端可重复执行以下命令升级，保留设备身份与配置：

curl -fsSL https://pkgs.cloudnet.world/stable/installer.sh | sh -s -- upgrade

以下命令仅适用于通过 Homebrew 安装的桌面客户端：

brew upgrade --cask cloudnet

卸载客户端

以下命令仅适用于通过 Homebrew 安装的桌面客户端；不适用于在线脚本或手动 DMG 安装：

brew uninstall --cask cloudnet

安装命令行客户端

适用于 macOS10.15+ 的旧版本系统, 您可以通过以下方式安装:

brew install dayunet2009/tap/cloudnet
sudo brew services restart cloudnet

更新客户端

brew upgrade dayunet2009/tap/cloudnet
sudo brew services restart cloudnet

卸载客户端

brew uninstall dayunet2009/tap/cloudnet