設定你的中繼

當兩台裝置無法直接連線時,由中繼轉送傳輸。自己執行中繼,這部分流量就留在你自己的基礎架構上。個人使用免費;商業授權可增加多台中繼、不限同時傳輸數量和使用統計。你需要一台有公開 IP 並已安裝 Docker 的伺服器。

安裝

  1. 1

    開放 UDP 49737 連接埠

    在伺服器防火牆和雲端服務供應商的安全群組中都要允許。

    sudo ufw allow 49737/udp
  2. 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. 3

    設定伺服器位址

    Compose 每次執行指令都會讀取 .env,所以請把位址寫在這個檔案裡,不要在命令列中臨時傳入。

    echo 'RELAY_HOST=203.0.113.7' > .env
  4. 4

    啟動中繼

    首次啟動時,它會產生一個永久身分,並儲存在磁碟區中。

    docker compose up -d
  5. 5

    複製中繼代碼

    記錄檔會顯示你的代碼和供手機掃描的 QR 碼;啟動後,每 30 秒還會輸出一行統計資訊。

    docker compose logs relay
    AlterSend 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. 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:7f6f2d059d8a549e30314fa436a98fbe1f62d314a5ec2a2b2be980075ef75226

org 代碼是網路上一筆已簽署記錄的公開金鑰,這筆記錄保存著你的中繼清單,包括位址。裝置從這筆記錄讀取清單,所以更換伺服器永遠不會改變代碼。

執行多台中繼

在每台伺服器上按同樣的步驟安裝,並使用同一個授權,這樣每台都不受限制。取得新中繼的公開金鑰,然後在顯示你 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 是根據連線位址來標示傳輸方式的。

誰可以使用我的中繼?

任何持有你中繼代碼的人。它不是可以更換的共用密鑰,所以請把它當成邀請:只交給你自己的裝置和一起工作的人。無論如何,傳輸始終是端對端加密。