海豹手册

主题

快速开始 ​

本节内容

本节将会指导你如何在你的 PC、服务器、甚至安卓手机上搭建和部署海豹核心。

如果你对计算机、服务器等相关知识没有任何了解，或者在阅读本节时，对内容中的一些名词完全不理解，我们非常建议你先自行学习，对基本计算机知识有所了解之后，再阅读本节进行部署。

获取海豹 ​

可以从以下两个渠道获取海豹核心安装包：

  • 官网：从 官网下载页 获取最新的正式版海豹核心安装包。

  • GitHub：从 GitHub Release 获取海豹核心安装包。

    这一渠道提供两个版本：以 版本号+发布日期 命名的正式版，与官网一致；以 Latest Dev Build+日期 命名的最新构建，可能有各种 Bug，不推荐一般用户使用。

提示：我该选择从哪里获取？

我们非常建议你使用从官网获取的正式版海豹。对于绝大多数用户来说，官网的下载最顺畅和便捷，所提供的正式版也适合绝大多数用户使用。

海豹提供了多个平台的安装包，请确认你的操作系统并选择对应版本的安装包。提供的平台如下：

  • Windows：普通用户首选，适用于 Windows 7 或者更高，同样可以部署在 Windows 云服务器。
    • 64 位：适合绝大多数用户使用。
    • 32 位：只在你明确知道为何要使用 32 位版本的情况下使用 32 位版本。
  • Linux: 提供给更专业的用户使用，需要使用终端启动。适用于服务器、树莓派等设备。
    • x64：绝大多数使用 Intel 或 AMD CPU 的服务器都应使用此版本。
    • arm64：树莓派等 arm 设备请使用 arm64 版。
  • macOS：提供给 Mac 用户使用，需要使用终端启动。
    • arm64：Apple Silicon 芯片（M1、M2 等）请使用 arm64 版。
    • x64：Intel 芯片请使用 x64 版。
  • Docker：提供对应 Docker 镜像，支持多种架构。
    • amd64
    • arm64
  • Android：提供 Android 的 apk 安装包。

启动 ​

注意

永远不要直接运行压缩包中的海豹核心，也不要在临时目录中运行海豹核心。

将安装包解压到合适的目录。考虑到后续升级，将目录名中的版本号删去或许是更好的做法。

根据系统不同，用以下方法即可启动海豹：

双击运行 sealdice-core.exe。数秒钟后，海豹核心将会在后台运行并弹出提示。

在任务栏中找到海豹图标，点击即可打开后台（WebUI）。

连接平台 ​

在完成上面的步骤后，你已经成功启动了海豹核心。接下来请根据你所需要对接平台的接入手册，来连接海豹和对应平台。

见「连接平台」一章，包括：

安装为系统服务（可选） ​

如果你使用远程 Linux 服务器部署，或者使用终端启动海豹核心，那么，随着终端关闭，通常海豹核心也会一同关闭。

海豹核心提供了一种自动安装为系统服务（systemd 服务项）的功能，可以免去手动配置。

服务名称和服务的启动用户均可以通过提供命令行参数自定义，请运行 ./sealdice-core -h 查阅详细说明。

默认情况下，海豹核心将尝试安装一个由 root 用户运行的，名为 sealdice.service 的服务。这要求海豹核心拥有 root 权限（通常由 sudo 运行得到）。

bash
$ ./sealdice-core -i
正在安装系统服务，安装完成后，SealDice将自动随系统启动
安装完成，正在启动……

也提供自动卸载：

bash
$ ./sealdice-core --uninstall
正在卸载系统服务……
系统服务已删除

安装完成后，可以使用 systemctl 来管理服务：

shell
systemctl status sealdice   # 查看运行状态
systemctl start sealdice    # 启动海豹核心
systemctl restart sealdice  # 启动或重启海豹核心
systemctl stop sealdice     # 停止海豹核心
journalctl -xe -u sealdice.service # 查看日志

以上命令的详细用法，请查阅你系统的 systemd 文档。

更新海豹 ​

当有新版本海豹核心时，你可以从 WebUI 或 .bot 回复语中看见新版本提示。

目前海豹有三种更新方法，用户可以自行选择自己喜欢的方式，对于安卓端用户请看安卓豹更新。

请骰主进行更新时确保自己可以接触海豹后台，以免更新失败。同时更新前请做好备份，以免数据丢失。

自动更新 ​

若有新版本，后台（WebUI）的「主页」会显示一个较为显眼的更新按钮，可以直接点击按钮更新。

你还可以使用命令更新：执行 .master checkupdate，此指令需要 Master 权限，具体请看 Master 管理。

如果你采用了任何自动拉起进程的手段，包括但不限于 Linux 系统的 systemd 等，切勿使用自动更新。请稳妥地停止进程后进行手动替换更新。

手动更新 ​

从海豹官网下载全新的安装包，解压后请勿运行，直接覆盖替换旧版本海豹，然后启动海豹即可。

上传固件 v1.4.0 ​

从 v1.4.0 起，海豹支持后台固件升级功能，你可以在「综合设置」-「基本设置」-「海豹」找到这项功能。

你可以使用指定的压缩包对当前海豹进行覆盖，上传完成后会自动重启海豹。

安卓豹更新 ​

安卓端海豹核心无法使用以上方法进行更新，你可以直接下载新版本海豹进行安装，会自动替换旧版本海豹核心。

更新前请「导出数据」以备份数据。