先准备服务器和域名
全托管支持 Debian 12、Ubuntu 22.04 及更新版本;已有宝塔时使用下方的宝塔方式,需要 Nginx。两个安装包都自动识别 x86_64 / ARM64。
解析自己的域名
到域名服务商的「域名解析」添加 A 记录。主机记录填要用的前缀,例如 nodes,记录值填服务器公网 IPv4。之后用完整域名 nodes.example.com 安装;这里的 example.com 要换成你自己的域名。
允许网站访问
到云服务器的安全组开放 80、443。准备 root 或有 sudo 权限的 SSH 账号。不要把内部端口 8787 对公网开放。
没有面板:运行一个安装文件
在服务器下载并运行
用 SSH 登录服务器,在终端粘贴下面整段命令并按回车。下载成功后才会开始安装;不需要安装 Go、Node.js 或数据库。
sudo bash SailNode-Web-0.11.3-linux.run也可以在下载页保存 RUN 文件,用自己的 SFTP 工具上传到服务器,再进入文件所在目录,运行
sudo bash SailNode-Web-0.11.3-linux.run。填写域名并同意证书条款
程序会问网站域名,以及是否同意 Let’s Encrypt 的证书服务条款。填自己的域名;同意时输入 yes。程序会配置网站、HTTPS、开机启动及证书续期。
看到「安装完成」再继续
安装完成后会给出自己的 HTTPS 网站地址。继续下方的「创建网页登录账号」。安装时不要关闭终端。
宝塔:网站仍由面板管理
先新建网站并启用 HTTPS
宝塔左侧「网站 → 添加站点」,填写自己的完整域名。网站目录保留默认值,FTP 和数据库不创建,PHP 版本选「纯静态」。为 SailNode 新建独立网站,不使用现有业务网站。
在这个网站右侧的「设置 → SSL → Let’s Encrypt」勾选域名,申请并部署证书。
上传 ZIP 到临时目录
从下载页保存「宝塔 ZIP」。打开宝塔左侧「文件」,进入 /www,创建 sailnode-install 文件夹。进入这个文件夹,点「上传」,选择 ZIP;上传后右键点「解压」。
解压后应有
/www/sailnode-install/SailNode-Web/install.sh。这是临时安装包目录,正式程序会放到自己网站的根目录。在宝塔终端执行一次
打开宝塔的「终端」并连接这台服务器。把下面两个 nodes.example.com 都换成自己的完整域名,再粘贴执行。第二处是网站目录:若创建网站时改过目录,用网站列表中的实际根目录。
bash /www/sailnode-install/SailNode-Web/install.sh --domain nodes.example.com --panel-root /www/wwwroot/nodes.example.com如果面板没有「终端」入口,用自己的 SSH 工具登录同一服务器,执行这条命令。无需添加计划任务,也不用另外手建反向代理。
等安装完成,再创建账号
看到「安装完成。打开:https://你的域名」后,按下面的宝塔账号步骤操作。网站运行、域名和证书仍在宝塔管理。成功后可以删除 /www/sailnode-install 临时文件夹,不要删除网站根目录。
打开网站,创建自己的账号
在浏览器地址栏输入安装完成时给出的 HTTPS 域名,打开 SailNode 初始化页面。
取得一次性的初始化令牌
全托管安装:在服务器终端执行下面这条命令,只在自己的终端查看输出。
sudo cat /var/lib/sailnode-web/setup-token宝塔安装:打开「文件」,进入自己的网站目录下的
.sailnode-data文件夹,找到 setup-token,点「编辑」,只复制内容并关闭,不修改或保存。在网页填入令牌和登录账号
把令牌填入「初始化令牌」,设置自己的管理账号和密码,密码至少 12 个字符,点击「创建工作区」。以后用这个账号登录,令牌只用一次,完成后会自动删除。
这是 SailNode Web 的账号,不是服务器 SSH 或宝塔账号。不要分享令牌、密钥或私人数据目录。
在 Web 添加服务器
登录后点「所有服务器 → 添加」,填写要管理的服务器资料。探针、SSH、文件管理和资产资料都可从 Web 使用。App 关联是可选功能,不影响独立使用。
出错后,不用从头来
找不到文件或安装文件损坏
重新下载并上传。宝塔 ZIP 要解压到正确目录,并确认有 install.sh。文件核验失败时不要跳过检查。
域名无法验证,或 HTTPS 申请失败
核对 A / AAAA 解析和安全组的 80、443。域名有 CDN 代理时,先使用直连解析。解析生效后重试;证书申请次数受限时先等待,别反复申请。
宝塔网站找不到,或 HTTPS 没准备好
核对使用 Nginx、网站域名和实际根目录,并确认 SSL 证书已经部署。修好后重复同一条安装命令。
服务没有启动,或网站仍打不开
全托管执行 sudo bash /opt/sailnode-web/tools/diagnose.sh;宝塔执行包内的 bash /www/sailnode-install/SailNode-Web/diagnose.sh。查看错误编号和「下一步」,修正后重试安装。反馈时不要包含令牌或密码。
更新时需要重新建账号吗?
不需要。下载新版安装文件,在原服务器执行 sudo bash SailNode-Web-0.11.3-linux.run --update。宝塔在解压目录执行 bash update.sh。程序会保留账号、密钥和资料;不要删数据库重装。旧方式安装的站点先按原方式维护,不能直接覆盖迁移。