1. 佈署容器

我們提供了一個 docker-compose 檔案，幫助您部署容器。 首先 download docker-compose.yml，然後將橋接設定寫入與 docker-compose.yml 同目錄的新檔 .env。範本如下：

# 橋接器 Tor 端口。
OR_PORT=X
# 橋接器 obfs4 端口。
PT_PORT=Y
# 電子郵件地址.
EMAIL=Z

將 X 置換為您想要的 OR 端口，將 Y 替換為 obfs4 端口（確認這兩個端口都在防火牆中轉發），並將 Z 改為您的電子郵件地址，這樣如果您的橋接中繼出問題時我們就可以聯繫您 。 橋接設定完成後，可執行下列指令部署容器：

docker-compose up -d obfs4-bridge

此命令將自動載入 docker-compose.yml 文件，同時考慮 .env 中的環境變數。

您現在應看到類似下列的輸出：

Starting docker-obfs4-bridge_obfs4-bridge_1 ... done

完成！您的容器現在正在啟動您的新 obfs4 橋接。

2. 昇級容器

升級到我們映像的最新版本就像拉動執行中的映像的最新版本一樣簡單：

docker-compose pull obfs4-bridge

然後再重啟容器:

docker-compose up -d obfs4-bridge

請注意，網橋的資料目錄（包括其金鑰材料）儲存在 docker 磁碟區中，因此在升級到最新的 docker 映像時不會遺失網橋的身份。 如果您的電腦上執行多個網橋，則需要為每個網橋重複此步驟。 我們將在 tor-dev 郵件清單上宣告新的映像版本。

3. 監看歷程記錄

您可執行下列指令檢視橋接的日誌：

docker logs CONTAINER_ID

要在 Tor 瀏覽器中使用新橋，您需要它的「橋線路」。 以下是獲得橋接線的方法：

docker exec CONTAINER_ID get-bridge-line

這將傳回類似以下的字串：

obfs4 1.2.3.4:1234 B0E566C9031657EA7ED3FC9D248E8AC4F37635A4 cert=OYWq67L7MDApdJCctUAF7rX8LHvMxvIBPHOoAp0+YXzlQdsxhw6EapaMNwbbGICkpY8CPQ iat-mode=0

如果您在設定橋接時遇到問題，請查看 our help section。 如果您的網橋現在正在運行，請查看安裝後註釋。

4. 進階使用

您可以在 .env 檔案中將 OBFS4_ENABLE_ADDITIONAL_VARIABLES 設為 1，並在所需的 torrc 選項前加上 OBFS4V_ 前綴，以設定額外的 torrc 變數。例如，若要設定 AddressDisableIPv6 選項，請在您的 .env 中加入以下幾行：

OBFS4_ENABLE_ADDITIONAL_VARIABLES=1
OBFS4V_AddressDisableIPv6=1

您可以下載我們的範本 .env 作為起點。