macOS 适合在个人电脑或开发机上快速部署 ZeroNews 客户端。当前快速开始页提供了 Apple 芯片与 Intel 芯片两种安装命令,建议先确认设备架构,再执行对应步骤。

安装前准备

  • 在用户控制台的“快速开始”页面复制自己的 AuthToken
  • 打开终端应用,后续所有命令都在终端中执行
如果你不知道自己的 Mac 是哪种芯片,可以在“关于本机”里查看芯片或处理器信息。

第一步:安装客户端

Apple 芯片

适用于 M1、M2、M3、M4 等 Apple Silicon 设备:
mkdir -p /Applications/zeronews
cd /Applications/zeronews
curl -o zeronews.tmp https://download.zeronews.cc/macos/arm/zeronews
mv zeronews.tmp zeronews
chmod +x zeronews

Intel 芯片

适用于 x86_64 架构的 Intel Mac:
mkdir -p /Applications/zeronews
cd /Applications/zeronews
curl -o zeronews.tmp https://download.zeronews.cc/macos/amd/zeronews
mv zeronews.tmp zeronews
chmod +x zeronews
安装完成后,客户端二进制默认位于 /Applications/zeronews/zeronews。

第二步:认证设备

在安装目录中执行设备认证命令:
cd /Applications/zeronews
./zeronews authtoken <YOUR_AUTH_TOKEN>
每台 Mac 设备只需认证一次。

第三步:添加本地服务(可选步骤)

cd /Applications/zeronews
./zeronews add https --local_ip=127.0.0.1 --port=80
请把 https、127.0.0.1、80 替换成你的真实服务信息。 如果你当前只是先把客户端装好,也可以暂时跳过这一步,后续再到控制台“隧道管理”中补充配置。

第四步:启动 ZeroNews

前台运行:
cd /Applications/zeronews
./zeronews start
后台运行并注册为系统服务:
cd /Applications/zeronews
sudo ./zeronews service install
sudo ./zeronews service start
后台运行适合长期驻留,终端关闭后客户端仍会继续工作。

验证安装是否成功

  • 客户端启动后,返回 ZeroNews 控制台确认设备是否在线
  • 检查刚添加的本地服务是否已经出现在隧道列表中
  • 若 macOS 弹出安全提示,请允许终端或客户端继续执行