サーバーのインストール

サーバーには、ドメイン名(例: remote.example.com)と、それを指す DNS の A/AAAA レコードが必要です。1 vCPU、メモリ 1 GB の小さなサーバーから始められます。

パッケージでインストールする(Linux)

サーバーのパッケージをインストールします。設定は /etc/tastedev-remote/、データは /var/lib/tastedev-remote/ に置かれます。
/etc/tastedev-remote/tasteremote-signal.env を記入します。必須の値は次のとおりです。

値	意味
`TURN_SECRET`	coturn と共有する秘密の値(16文字以上)。`openssl rand -hex 32` で作成します。
`RD_SETUP_TOKEN`	最初の管理者アカウントを作成するときに入力するセットアップトークン(32文字以上)。最初のアカウントを作成したあとは削除してかまいません。
`RD_WEB_ORIGIN`	ユーザーが開くアドレス。例: `https://remote.example.com`
`TURN_URLS`	例: `turn:remote.example.com:3478?transport=udp,turn:remote.example.com:3478?transport=tcp`

coturn をインストールし、/etc/turnserver.conf の static-auth-secret を TURN_SECRET と同じ値にします。

sudo apt install coturn

リバースプロキシを設定します。Caddy を使うか、管理画面の サーバーセットアップ ウィザードで nginx または Apache の設定を作成します(下記参照)。
サービスをオンにします。

sudo systemctl enable --now tasteremote-signal tasteremote-web tasteremote-update.timer

ユーザーが取得するホストのインストーラーをダウンロードします。インストーラーがないと /downloads/ は 503 を返し、ダウンロードページに「このサーバーにはまだインストーラーがありません」と表示されます。インターネットに接続できないサーバーでは、インストーラーを downloads/ フォルダに手動で置いてください。

sudo tasteremote-fetch-hosts

Windows サーバーでは、設定は %ProgramData%\tasteremote\config\、データは %ProgramData%\tasteremote\data に置かれ、サービスとして動きます。

サーバーセットアップウィザード(nginx · Apache)

最初の管理者アカウントでログインし、管理 › サーバーセットアップ を開きます。5つのステップで設定ファイルとコマンドを作成し、管理者がそれを SSH で貼り付けて実行します。このページ自体はサーバーで何も実行しません。

Web サーバーを選択: nginx または httpd と、OS(deb または rpm)
アドレス · ポート: ドメイン(IP アドレスは使えません)
プロキシ設定: 設定ファイルとファイアウォールのコマンド
HTTPS 証明書: certbot で証明書を取得し、自動で更新します。
確認: RD_WEB_ORIGIN、RD_COOKIE_SECURE=1、TRUST_PROXY=1 などの値と、確認用のコマンド。/healthz が応答するか、/ws の接続が 101 に切り替わるかを確認します(400 または 426 の場合は、プロキシが WebSocket のヘッダーを落としています)。

Docker Compose でインストールする

Docker Engine 25 以降と Compose v2.24 以降が必要です。

リポジトリの deploy/ フォルダで、.env.example を .env にコピーし、アクセス権を制限します。

cp .env.example .env && chmod 600 .env

.env に DOMAIN、ACME_EMAIL、TURN_SECRET、RD_SETUP_TOKEN、TURN_EXTERNAL_IP などを記入します。
起動します。

docker compose up -d --build

主な設定

値	既定値	意味
`PORT` / `HOST`	8080 / 0.0.0.0	signal が待ち受けるポートとアドレス。パッケージでは 127.0.0.1 に設定されます。
`TRUST_PROXY`	0	前段にあるプロキシの数。プロキシが1つなら 1。間違っていると、すべてのユーザーが同じ IP に見え、まとめて制限にかかります。
`RD_DB_PATH`	`./data/signal.db`	データベース(SQLite)のファイル
`RD_SERVER_KEY_FILE`	`./data/server.key`	サーバーの署名鍵。失うと、すべてのホストを登録し直す必要があります。
`RD_ALLOW_SIGNUP`	オフ	最初のアカウント以降の登録を許可します。管理画面で設定した値が優先されます。
`RD_COOKIE_SECURE`	本番環境ではオン	セッション Cookie の Secure フラグ
`TURN_TTL_SEC`	600	TURN の認証情報の有効期間(秒)
`RD_LICENSE_CLAIM_URL`	TASTEDEV のアドレス	ライセンスのインストールコード交換アドレス。インターネットに接続できないサーバーでは `off`
`RD_HOST_VERSION_CHECK`	`on`	`off` にすると、サーバーと先頭 2 桁のバージョンが異なるホストにも接続できます。
`LOG_LEVEL`	info	`debug` にすると、接続のタイミングをより詳しく記録します。

メール(SMTP)とソーシャルログインは、設定ファイルではなく管理画面で設定します。

次のステップは初期設定です。

TASTEREMOTE ガイド

サーバーのインストール

パッケージでインストールする(Linux)

サーバーのパッケージをインストールします。設定は /etc/tastedev-remote/、データは /var/lib/tastedev-remote/ に置かれます。
/etc/tastedev-remote/tasteremote-signal.env を記入します。必須の値は次のとおりです。

値	意味
`TURN_SECRET`	coturn と共有する秘密の値(16文字以上)。`openssl rand -hex 32` で作成します。
`RD_SETUP_TOKEN`	最初の管理者アカウントを作成するときに入力するセットアップトークン(32文字以上)。最初のアカウントを作成したあとは削除してかまいません。
`RD_WEB_ORIGIN`	ユーザーが開くアドレス。例: `https://remote.example.com`
`TURN_URLS`	例: `turn:remote.example.com:3478?transport=udp,turn:remote.example.com:3478?transport=tcp`

coturn をインストールし、/etc/turnserver.conf の static-auth-secret を TURN_SECRET と同じ値にします。

sudo apt install coturn

リバースプロキシを設定します。Caddy を使うか、管理画面の サーバーセットアップ ウィザードで nginx または Apache の設定を作成します(下記参照)。
サービスをオンにします。

sudo systemctl enable --now tasteremote-signal tasteremote-web tasteremote-update.timer

ユーザーが取得するホストのインストーラーをダウンロードします。インストーラーがないと /downloads/ は 503 を返し、ダウンロードページに「このサーバーにはまだインストーラーがありません」と表示されます。インターネットに接続できないサーバーでは、インストーラーを downloads/ フォルダに手動で置いてください。

sudo tasteremote-fetch-hosts

Windows サーバーでは、設定は %ProgramData%\tasteremote\config\、データは %ProgramData%\tasteremote\data に置かれ、サービスとして動きます。

サーバーセットアップウィザード(nginx · Apache)

Web サーバーを選択: nginx または httpd と、OS(deb または rpm)
アドレス · ポート: ドメイン(IP アドレスは使えません)
プロキシ設定: 設定ファイルとファイアウォールのコマンド
HTTPS 証明書: certbot で証明書を取得し、自動で更新します。
確認: RD_WEB_ORIGIN、RD_COOKIE_SECURE=1、TRUST_PROXY=1 などの値と、確認用のコマンド。/healthz が応答するか、/ws の接続が 101 に切り替わるかを確認します(400 または 426 の場合は、プロキシが WebSocket のヘッダーを落としています)。

Docker Compose でインストールする

Docker Engine 25 以降と Compose v2.24 以降が必要です。

リポジトリの deploy/ フォルダで、.env.example を .env にコピーし、アクセス権を制限します。

cp .env.example .env && chmod 600 .env

.env に DOMAIN、ACME_EMAIL、TURN_SECRET、RD_SETUP_TOKEN、TURN_EXTERNAL_IP などを記入します。
起動します。

docker compose up -d --build

主な設定

値	既定値	意味
`PORT` / `HOST`	8080 / 0.0.0.0	signal が待ち受けるポートとアドレス。パッケージでは 127.0.0.1 に設定されます。
`TRUST_PROXY`	0	前段にあるプロキシの数。プロキシが1つなら 1。間違っていると、すべてのユーザーが同じ IP に見え、まとめて制限にかかります。
`RD_DB_PATH`	`./data/signal.db`	データベース(SQLite)のファイル
`RD_SERVER_KEY_FILE`	`./data/server.key`	サーバーの署名鍵。失うと、すべてのホストを登録し直す必要があります。
`RD_ALLOW_SIGNUP`	オフ	最初のアカウント以降の登録を許可します。管理画面で設定した値が優先されます。
`RD_COOKIE_SECURE`	本番環境ではオン	セッション Cookie の Secure フラグ
`TURN_TTL_SEC`	600	TURN の認証情報の有効期間(秒)
`RD_LICENSE_CLAIM_URL`	TASTEDEV のアドレス	ライセンスのインストールコード交換アドレス。インターネットに接続できないサーバーでは `off`
`RD_HOST_VERSION_CHECK`	`on`	`off` にすると、サーバーと先頭 2 桁のバージョンが異なるホストにも接続できます。
`LOG_LEVEL`	info	`debug` にすると、接続のタイミングをより詳しく記録します。

メール(SMTP)とソーシャルログインは、設定ファイルではなく管理画面で設定します。

次のステップは初期設定です。