服务器架构

运营者篇面向自行安装和运营 TASTEREMOTE 服务器的管理员。如果不想自己运营服务器，而是使用 TASTEDEV 运营的服务，请参阅远程桌面服务。如需委托安装和搭建服务器，请使用搭建咨询。

组成部分

组成部分	作用	默认地址
信令服务器 (signal)	账号、设备和连接中转（REST `/api`、WebSocket `/ws`、`/healthz`）。软件包安装时，还会在 `/downloads/` 提供主机安装文件，在 `/updates/` 提供主机更新。	127.0.0.1:8080
网页 (web)	浏览器页面（查看器、我的设备、管理）	127.0.0.1:3000
反向代理	接收 HTTPS（80/443）并分发给 signal 和 web。使用 Caddy、nginx 或 Apache httpd 之一。	80、443
TURN (coturn)	主机和查看者无法直接连接时中继视频。	3478
主机	接受连接的电脑上的 TASTEREMOTE 程序	连接到服务器的 `wss://<address>/ws`

代理把 /api/*、/ws、/healthz、/downloads/* 和 /updates/* 发送到 signal，其余全部发送到 web。

不要向外部开放 8080 和 3000。TURN 也可能中继到服务器自身的公网 IP，因此在公网地址上只应让代理、coturn 和 sshd 监听。可以用 sudo ss -lntup 检查。

Docker Compose：用仓库的 deploy/ 文件夹启动一组容器（Caddy、signal、web、coturn）。
软件包（deb · rpm · MSI）：安装服务器软件包，并通过 systemd 运行（Windows 上作为服务运行）。管理页面中的 服务器安装 和更新标签页适用于这种方式。

详细步骤请参阅服务器安装。

组成部分

组成部分	作用	默认地址
信令服务器 (signal)	账号、设备和连接中转（REST `/api`、WebSocket `/ws`、`/healthz`）。软件包安装时，还会在 `/downloads/` 提供主机安装文件，在 `/updates/` 提供主机更新。	127.0.0.1:8080
网页 (web)	浏览器页面（查看器、我的设备、管理）	127.0.0.1:3000
反向代理	接收 HTTPS（80/443）并分发给 signal 和 web。使用 Caddy、nginx 或 Apache httpd 之一。	80、443
TURN (coturn)	主机和查看者无法直接连接时中继视频。	3478
主机	接受连接的电脑上的 TASTEREMOTE 程序	连接到服务器的 `wss://<address>/ws`

代理把 /api/*、/ws、/healthz、/downloads/* 和 /updates/* 发送到 signal，其余全部发送到 web。

通信关系

浏览器 → 代理 → web，同一地址下的 /api → signal

浏览器和主机 → wss://<address>/ws → signal（连接中转）

浏览器 ↔ 主机：通过 WebRTC 直接连接，失败时经由 coturn。

主机 → 服务器的 /downloads/ 或 /updates/（自动更新）

signal → SMTP 服务器（邮件，可选）、社交登录服务商（可选）、许可证安装码兑换地址（可选）

防火墙

不要向外部开放 8080 和 3000。TURN 也可能中继到服务器自身的公网 IP，因此在公网地址上只应让代理、coturn 和 sshd 监听。可以用 sudo ss -lntup 检查。

两种安装方式

Docker Compose：用仓库的 deploy/ 文件夹启动一组容器（Caddy、signal、web、coturn）。

软件包（deb · rpm · MSI）：安装服务器软件包，并通过 systemd 运行（Windows 上作为服务运行）。管理页面中的 服务器安装 和更新标签页适用于这种方式。

详细步骤请参阅服务器安装。