SailNode

GET STARTED

装好 App，就能开始。

先添加自己的服务器。需要多台电脑同步或网页访问时，再从 App 安装 Web。

01

安装 SailNode App

  1. 下载同一个 Mac 安装包

    支持 macOS 13 或更高版本。Intel 和 M 系列 Mac 都用这一个 DMG，无需选择芯片版本。

    前往下载页

  2. 拖到「应用程序」

    双击下载的 DMG，把 SailNode 图标拖进「应用程序」。打开访达的「应用程序」，双击 SailNode 启动；之后可以推出安装镜像。

  3. 如果第一次打开被 macOS 拦截

    先确认安装包来自 SailNode 官网。到「系统设置 → 隐私与安全性」，找到 SailNode 的拦截提示，点击「仍要打开」，再按系统提示确认。保留系统安全检查，不要关闭它。

    没有这条提示时，先尝试打开一次 App，再回到该页面查看。

02

添加第一台服务器

  1. 填入服务器登录资料

    在 App 左侧「所有服务器」点「添加」。填写名称、IP 或域名、SSH 端口和登录账号，选择密码或私钥。第一次连接时核对服务器身份。

  2. 把常用资料一起记下来

    用途标签、费用和到期日期都可不填。「更多信息」可以保存管理面板、服务商网站及对应的账号密码。

  3. 看状态，或连接 SSH

    在服务器设置中安装探针后，CPU、内存、网络和历史记录会持续更新，关掉 App 也会继续采集。鼠标放在 CPU 或内存上，可查看占用前五的进程。

    需要操作服务器时，点「SSH 连接」。终端内可打开文件管理，上传、下载、编辑和删除文件。会话默认闲置 15 分钟断开，可以在设置里调整。

可选：从 App 安装 Web需要网页访问或多端同步时再安装，平常可以收起。
先准备服务器和域名。

在 App 保存好这台服务器的 SSH 登录资料，并连接一次确认身份。安装账号需要服务器管理权限。然后到域名服务商的「域名解析」添加 A 记录：主机记录填写要用的前缀（例如 nodes），记录值填写服务器的公网 IPv4。准备好的完整域名例如 nodes.example.com。

到云服务器的安全组允许网站的 80、443 端口。不要开放内部的 8787 端口。等解析生效后，再进行安装。

  1. 在宝塔添加一个独立网站

    登录宝塔面板，点左侧「网站」，再点「添加站点」。在「域名」填入完整域名（例如 nodes.example.com）。网站目录沿用宝塔的默认值；FTP 和数据库都选「不创建」，PHP 版本选「纯静态」，点「提交」。网站服务需要使用 Nginx。

    为 SailNode 新建网站，不使用已经运行其他业务的网站。

  2. 给这个网站开启 HTTPS

    在宝塔网站列表找到刚建的网站，点右侧「设置 → SSL → Let’s Encrypt」。勾选域名，申请证书，按面板提示部署证书或开启 SSL。域名必须已经解析到这台服务器。

  3. 回 App 选择「面板方式」

    打开 SailNode 左侧「备份与同步」，点顶部「Web 管理」选项卡，再展开「安装新 Web」。选择刚才这台服务器，选择「面板方式」，填入与宝塔完全相同的域名。

    App 会自动找到宝塔网站目录，不用填写路径。

  4. 设置网页登录账号，点击安装

    填写新的网页登录账号和密码，密码至少 12 个字符。这是登录 SailNode Web 的账号，不会修改服务器的系统密码。保留「关联当前 App」开启，点击「安装 Web」，保持 App 打开直到显示完成。

  5. 打开自己的网站

    点击 App 中的「打开网站」，或在浏览器地址栏输入自己的 HTTPS 域名，用刚设置的账号登录。当前 App 会自动关联并进行首次同步。

    以后网站、域名和证书仍能在宝塔中管理；安装、状态和更新在 App 的「Web 管理」里查看。无需额外下载 Web、上传文件或添加计划任务。

  1. 使用没有面板的 Linux 服务器

    支持 Debian 12、Ubuntu 22.04 及更新版本，x86_64 和 ARM64 会自动识别。已经安装宝塔的服务器，请使用「宝塔面板方式」。

  2. 在 App 选择「全托管」

    打开「备份与同步 → Web 管理」，展开「安装新 Web」。选择服务器和「全托管」，填入已经解析好的域名。

  3. 填网页登录账号并安装

    设置网站账号和至少 12 个字符的密码，保留「关联当前 App」开启。阅读并同意证书服务条款后，点击「安装 Web」。

    App 会上传内置程序、配置 Nginx 和 HTTPS、设置开机启动。不需要打开命令行或手写安装命令。

  4. 等完成后打开网站

    保持 App 打开，看到安装完成后点「打开网站」，使用刚才设置的账号登录。安装步骤会自动收起；以后在「Web 管理」里检查状态或更新。

安装没完成，先看这里

提示服务器身份尚未确认

在 App 点这台服务器的「SSH 连接」，核对并确认身份。回到「Web 管理」重新安装。

找不到宝塔网站，或提示没有 HTTPS

检查是否在同一台服务器创建了完全相同的域名，是否使用 Nginx。到该网站的 SSL 页面确认已部署证书，再回 App 重试。

提示域名无法访问

核对域名解析是否指向这台服务器的公网 IP，安全组是否允许 80、443。等待解析生效后重试；域名有 AAAA 记录时，也要确认 IPv6 地址正确。

提示权限不足

检查保存的 SSH 账号是否为 root，或能直接执行 sudo。普通网站后台账号不能代替服务器 SSH 账号。

网站已装好，但账号或同步没有完成

在「Web 管理」点「检查状态」，根据提示完成账号设置。网站能登录但同步失败时，到「备份与同步」选项卡重新关联或点「立即同步」。不必清空网站重装。

03

让其他电脑也能同步

安装 Web 时若保留「关联当前 App」开启，第一台电脑已完成关联。其他电脑按下面三步操作。

  1. 在自己的网站创建设备密钥

    登录 SailNode Web，打开「工作区与同步」，展开「关联新的 App」，为另一台电脑创建设备密钥并复制。每台电脑使用独立密钥。

  2. 在另一台 App 填入网站和密钥

    打开「备份与同步」选项卡，填写自己网站的 HTTPS 地址和刚才的设备密钥，点击「连接并同步」。设备密钥不是网页登录密码。

  3. 之后直接使用

    服务器资料、账号密码和相关配置会双向同步。两端同时修改时，按提示选择保留的版本。断开关联会保留本机资料；终端会话和监控历史不作为资料同步。

04

以后怎样更新

下载新版 App，退出旧 App，再把新版拖入「应用程序」并选择替换。服务器资料和设置会保留。在线更新接入后，也可以在「设置 → 关于 → 产品更新」主动检查。

服务器上的 Web 单独确认更新：在 App 的「Web 管理」里选服务器，点「检查状态」。有新版时显示「更新 Web」；版本相同时会显示「无需更新 Web」。更新会保留账号和服务器资料，网站终端连接会结束，完成后可以重新连接。

只想用浏览器、不安装 App？查看独立 Web 安装教程，也可在下载页取得 Linux 安装包。

开始使用前的几个问题

只有 App，可以用吗？

可以。添加服务器就能使用 App。Web 只在需要多端同步或网页访问时安装。

其他系统可以安装 App 吗？

当前 App 仅支持 macOS 13 及以上，Intel 和 M 系列通用。Windows、Linux 桌面版、iOS 和 Android App 暂不支持。Linux 服务器可以运行 Web 和探针；其他系统可通过浏览器访问自己的 SailNode Web。

资料会经过官方服务器吗？

服务器资料保存在本机。开启同步后，直接连接你自己的 Web，不经过官方中转。可选 AI 会把请求发送到你配置的模型服务。