設定你的中繼
當兩台裝置無法直接連線時,由中繼轉送傳輸。自己執行中繼,這部分流量就留在你自己的基礎架構上。個人使用免費;商業授權可增加多台中繼、不限同時傳輸數量和使用統計。你需要一台有公開 IP 並已安裝 Docker 的伺服器。
安裝
- 1
開放 UDP 49737 連接埠
在伺服器防火牆和雲端服務供應商的安全群組中都要允許。
sudo ufw allow 49737/udp - 2
建立 docker-compose.yml
services: relay: image: ghcr.io/altersend/relay:latest network_mode: host restart: unless-stopped environment: RELAY_HOST: ${RELAY_HOST:?set RELAY_HOST to this server's public IP} ALTERSEND_LICENSE: ${ALTERSEND_LICENSE:-} volumes: - relay-data:/etc/altersend-relay volumes: relay-data: - 3
設定伺服器位址
Compose 每次執行指令都會讀取 .env,所以請把位址寫在這個檔案裡,不要在命令列中臨時傳入。
echo 'RELAY_HOST=203.0.113.7' > .env - 4
啟動中繼
首次啟動時,它會產生一個永久身分,並儲存在磁碟區中。
docker compose up -d - 5
複製中繼代碼
記錄檔會顯示你的代碼和供手機掃描的 QR 碼;啟動後,每 30 秒還會輸出一行統計資訊。
docker compose logs relayAlterSend relay listening relay public key: 6fad022df811a2bfbc734260df47c55499973409bc34b89f66ad791c24be2197 add this relay in AlterSend — Settings → Connection: relay:6fad022df811a2bfbc734260df47c55499973409bc34b89f66ad791c24be2197@203.0.113.7 [stats] egress 0GB | sessions=0 pairings=0 matched=0 - 6
在 AlterSend 中新增
開啟「設定 → 中繼 → 自架中繼」,貼上代碼後按下傳送按鈕,即可一次完成儲存和連線測試。
只有你自己的裝置需要這個代碼。傳送給別人時,App 會在建立連線時把中繼資訊一併傳給對方。
商業授權
把授權加到 .env 並重新啟動。中繼接著顯示的不再是 relay 代碼,而是 org 代碼。把這一個代碼交給團隊裡的每台裝置;它背後的伺服器集中管理,可以隨時更換,誰都不用重新貼上。
ALTERSEND_LICENSE=<你的授權>
# 選用:每次傳輸只 POST 位元組數和時間戳記,不含其他內容
REPORT_URL=https://example.com/hook
REPORT_TOKEN=<bearer token>[selfhost] licensed to Acme GmbH until 2027-08-27
[selfhost] published org relay record (seq 1)
add this relay in AlterSend — Settings → Connection:
org:7f6f2d059d8a549e30314fa436a98fbe1f62d314a5ec2a2b2be980075ef75226org 代碼是網路上一筆已簽署記錄的公開金鑰,這筆記錄保存著你的中繼清單,包括位址。裝置從這筆記錄讀取清單,所以更換伺服器永遠不會改變代碼。
執行多台中繼
在每台伺服器上按同樣的步驟安裝,並使用同一個授權,這樣每台都不受限制。取得新中繼的公開金鑰,然後在顯示你 org 代碼的那台伺服器上發布完整清單。其他伺服器首次啟動時也會顯示各自的 org 代碼;請忽略它們,始終只發出第一個。
# 在新伺服器上
docker compose exec relay node key.js
# 在顯示你 org 代碼的伺服器上
docker compose exec relay node conf/publish.js \
<key1>@203.0.113.7@-5 \
<key2>@198.51.100.4@8更新與備份
更新會下載新映像檔並重新啟動;身分和設定都保存在磁碟區中,所以代碼依然有效。
docker compose pull
docker compose up -d疑難排解
記錄檔提示缺少變數 RELAY_HOST
Compose 每次執行指令都會讀取 .env,而不只是 up。請確認該檔案與 docker-compose.yml 在同一個目錄,並且包含 RELAY_HOST。
App 顯示無法連上中繼
幾乎都是 UDP 49737 連接埠的問題。請同時檢查伺服器防火牆和雲端服務供應商的安全群組,再用 docker compose ps 確認容器正在執行。
傳輸仍然顯示為直連
這通常是正常的:只有兩台裝置無法直接連線時,中繼才會轉送傳輸,而能直連時直連比較快。如果從未顯示「已透過中繼連線」,請檢查 RELAY_HOST 填的是 IP 而不是網域,因為 App 是根據連線位址來標示傳輸方式的。
誰可以使用我的中繼?
任何持有你中繼代碼的人。它不是可以更換的共用密鑰,所以請把它當成邀請:只交給你自己的裝置和一起工作的人。無論如何,傳輸始終是端對端加密。
