跳转到内容

自建 server 总览

真遇的服务端只有一份软件:官方托管是它的第一个部署形态,你也可以把它跑在自己的机器上。自建与官方托管功能完全等价,数据始终在你手里。

  • 单二进制 / 单容器:嵌入式 SQLite 存储,零外部依赖,一台入门 VPS 或树莓派即可运行。
  • 备份即复制文件:数据全部落在一个目录里,停止进程复制走即可。
  • 数据可完整带走:官方托管与自建之间可导出、迁移(见备份与迁移)。

获取软件

服务端软件的公开分发(正式版本、容器镜像与源码仓库)尚未开放。开放后此处会给出下载地址、校验和与许可证信息;在那之前,其余部署与运维指引可先行阅读。

开始之前

  • 一台 Linux 主机(x86_64 或 arm64),能公网访问或仅内网使用。
  • 已安装 Docker,或准备好自行运行二进制 / 配置 systemd。
  • 一个 ed25519 公钥(hex) 作为持有者身份 —— 它是小组的最高权限;如何取得见多实例 / 多小组。
  • (可选)一个域名与 TLS 证书,用于对外提供 HTTPS,见 TLS 与域名。

五步走

  1. 获取软件 —— 容器镜像或二进制(见上,公开发布后回填)。
  2. 写配置 —— 设置 owner_public_key_hex、server_id 等,见配置项。
  3. 启动 —— 用 Docker 或二进制 / systemd 运行。
  4. 启用 TLS —— 对外服务时配置证书与对外地址,见 TLS 与域名。
  5. 邀请成员 —— 生成邀请链接,成员在 App 内加入。

关于注册处

「注册处」是官方提供的身份与目录服务:稳定账号、昵称头像、邮箱找回,以及公开组目录。自建 server 默认指向官方注册处,让成员能用自己的账号加入、并可在公开组目录中被搜到。

如果你完全不需要这些,可以把 registry_url 置空、register=false,server 会以纯内网 / 邀请直连方式运行。多台自建 server 也可以共用一个注册处,见多实例 / 多小组。

下一步