透過 Tor onion service 執行 SSH,不開放任何埠
將 sshd 放在 Tor onion service 後方,讓 VPS 不接受任何入站埠。涵蓋設定、v3 客戶端授權,以及避免鎖死自己的正確操作順序。
透過 Tor onion service 執行 SSH 的變更
透過 Tor onion service 執行 SSH,讓您能管理一台在任何埠皆不接受外部連線的 VPS。伺服器會主動撥號至 Tor 網路並保持連線開啟。您的 SSH 連線會經由該通道傳回,因此伺服器無須在公開 IP 位址上監聽任何埠。
對日誌的影響立竿見影。一台開放公開 SSH 埠的伺服器,每天會收集數千次來自掃描器的失敗密碼嘗試。將 sshd 移至 onion service 後方並在防火牆阻擋所有入站流量,/var/log/auth.log 便只會記錄您親自發起的連線。
其代價是 tor 必須存在於每個管理連線的路徑中。它是一個使用者空間(userspace)的 daemon,每次重新開機後都必須啟動並完成引導,您才能登入。在關閉埠之前請務必規劃好,因為此處的失敗模式是導致您無法存取實體無法觸及的機器。
在進行任何變更前先建立復原路徑
在擁有不依賴 SSH 的復原路徑之前,請勿開始操作。
現在請開啟服務供應商的控制台(例如 VNC 或序列埠控制台),並透過該介面登入。若不清楚 root 密碼,請先 從控制台重設 root 密碼 並確認可成功登入。未經測試的控制台無法作為有效的復原路徑。
下列步驟順序至關重要。每個步驟在執行下一步前都必須經過驗證,且在 Onion 路由運作正常前,請保持 22 埠開啟。
- 安裝 tor 並確認其完成啟動程序(bootstrap)。
- 定義 Onion 服務並讀取其位址。
- 在 22 埠仍開啟的狀態下,透過 Onion 位址進行連線。
- 新增客戶端授權(client authorisation),然後再次連線。
- 將
sshd綁定至 loopback 介面,並關閉 22 埠。 - 重新開機,然後再次透過 Onion 位址連線。
請在整個過程中保持目前的 SSH 連線開啟。已建立的連線在防火牆變更後仍能維持,這將是您的第一道救援防線。
在伺服器上安裝 tor
Ubuntu 在自己的套件庫中提供 tor,但其中的版本通常較舊。Tor Project 的套件庫提供其文件所說明的版本。請依照其 apt 套件庫指南 中的命令加入套件庫。
sudo apt update
sudo apt install -y apt-transport-https wget gpg
wget -qO- https://deb.torproject.org/torproject.org/A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89.asc | gpg --dearmor | sudo tee /usr/share/keyrings/deb.torproject.org-keyring.gpg >/dev/null寫入 /etc/apt/sources.list.d/tor.sources。Suites 會取得您的版本代號,而 lsb_release -cs 會輸出該代號(Ubuntu 24.04 的輸出為 noble)。
Types: deb deb-src
URIs: https://deb.torproject.org/torproject.org/
Suites: noble
Components: main
Signed-By: /usr/share/keyrings/deb.torproject.org-keyring.gpgsudo apt update
sudo apt install -y tor deb.torproject.org-keyring
sudo journalctl -u tor@default -n 20 --no-pager日誌最後應為 Bootstrapped 100% (done)。如果停在這之前,表示 tor 無法連線到網路;幾乎一定是對外防火牆規則或系統時間嚴重錯誤所致。
服務單元名稱容易誤導。 即使一切正常,systemctl status tor 仍會回報 Active: active (exited),因為 Debian 和 Ubuntu 將 tor 封裝為多執行個體的主服務單元,其唯一工作是載入真正的執行個體。daemon 本身以 tor@default.service 執行。請在 status 和 journalctl 中使用該名稱。對 tor 執行啟動、停止和重新載入仍會連到該執行個體,因此 sudo systemctl reload tor 會如預期運作。
定義連接埠 22 的 onion 服務
在 /etc/tor/torrc 中加入兩行設定。
HiddenServiceDir /var/lib/tor/ssh/
HiddenServicePort 22 127.0.0.1:22第二行指令告知 tor 接受 onion 位址上的虛擬連接埠 22,並連線至本機的 127.0.0.1:22。Tor 透過 loopback 介面存取 sshd,這正是為何後續能讓 sshd 停止監聽公開位址的原因。若將該行指向 127.0.0.1:80 的網頁伺服器,同樣的兩行指令即可 發布 onion 位址上的網站,這是安裝 tor 後實用的第二項服務。
sudo systemctl reload tor
sudo cat /var/lib/tor/ssh/hostname該指令會輸出 56 個 base32 字元,後接 .onion。這些字元即為該服務的編碼公開金鑰。此過程不涉及憑證授權中心,亦無須進行任何名稱註冊。
讓 tor 自行建立 /var/lib/tor/ssh/。若手動建立且擁有者錯誤,或權限設定鬆散於 0700,tor 將拒絕使用,並在日誌中回報該目錄權限過於寬鬆。目錄內的檔案即為服務識別碼:hs_ed25519_secret_key 即是該位址。請以 600 權限備份該目錄並存放於伺服器之外,因為一旦遺失,將導致位址變更,且必須修改所有客戶端的設定。
從工作站連線
您的工作站需要一個 Tor 客戶端,且完全無需進行任何設定。在 Debian 或 Ubuntu 上,請安裝 sudo apt install -y tor netcat-openbsd。安裝後,Tor 會在 127.0.0.1:9050 監聽 SOCKS5 代理。SOCKS 是一種通用的代理協定,第 5 版支援傳輸主機名稱而非 IP 位址,這正是此處的關鍵。
OpenSSH 本身沒有 SOCKS 客戶端,因此需要透過輔助程式來建立連線。請將以下內容加入 ~/.ssh/config。
Host myvps
HostName xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.onion
User admin
ProxyCommand /usr/bin/nc -X 5 -x 127.0.0.1:9050 %h %p
ServerAliveInterval 30-X 5 用於選擇 SOCKS5,-x 127.0.0.1:9050 則指向本機的 Tor。%h 會將 .onion 名稱傳遞給 Tor,讓 Tor 在其網路內部進行解析。此處必須使用 OpenBSD 版本的 netcat。GNU netcat 沒有 -X 選項,執行時會出現 nc: invalid option -- 'X' 錯誤並終止。
ssh myvps首次連線速度較慢,因為 Tor 必須先建立電路才能進行後續操作。請依照一般方式接受主機金鑰指紋。此後,常見的 SSH 金鑰處理方式 均適用。傳輸層已變更,但驗證方式維持不變。
若僅需臨時連線,可跳過設定檔步驟:直接執行 torsocks ssh admin@xxxxx.onion 即可達到相同效果。
新增 v3 用戶端授權
目前任何得知該位址的人,都能連到您的 SSH banner 並開始嘗試猜測。Onion 位址無法從目錄系統列舉,因此該位址如同秘密,但仍可能以一般方式外洩,例如 shell 歷程記錄,或提交至 git repository 的設定檔。用戶端授權可補上這項缺口。服務會將 descriptor 加密後發布給用戶端金鑰,因此只有位址但沒有金鑰的人,甚至無法定位該服務。
在用戶端產生 x25519 金鑰組。以下是 Tor Project 用戶端授權指南中的 pipeline,但有一項變更。
openssl genpkey -algorithm x25519 -out /tmp/k1.prv.pem
grep -v " PRIVATE KEY" /tmp/k1.prv.pem | base64 -d | tail --bytes=32 | base32 | sed 's/=//g' > /tmp/k1.prv.key
openssl pkey -in /tmp/k1.prv.pem -pubout | grep -v " PUBLIC KEY" | base64 -d | tail --bytes=32 | base32 | sed 's/=//g' > /tmp/k1.pub.key這些命令的已發布版本使用 base64pem -d,但標準 Ubuntu 安裝沒有提供該工具。接著命令會因 base64pem: command not found 而停止。GNU base64 -d 能解碼相同的 PEM 內容,因此改用它。
在伺服器上安裝公開金鑰。
sudo install -d -m 700 -o debian-tor -g debian-tor /var/lib/tor/ssh/authorized_clients
echo "descriptor:x25519:PASTE_PUBLIC_KEY_HERE" | sudo tee /var/lib/tor/ssh/authorized_clients/laptop.auth >/dev/null
sudo chown debian-tor:debian-tor /var/lib/tor/ssh/authorized_clients/laptop.auth
sudo systemctl reload tor只有以 .auth 結尾的檔案才會被讀取。請將檔案儲存為 laptop.auth.txt,否則 tor 會略過該檔案,只在日誌中留下檔案「必須以 .auth 結尾」的警告。除非您讀取 journal,否則不會注意到這項問題,而服務仍會對任何持有該位址的人開放。
在用戶端安裝私密金鑰。在 Ubuntu 上,tor daemon 以 debian-tor 使用者身分執行,無法讀取 home directory 中的檔案,因此請將目錄放在該使用者可存取的位置。
sudo install -d -m 700 -o debian-tor -g debian-tor /var/lib/tor/onion_auth
echo "ADDRESS_WITHOUT_DOT_ONION:descriptor:x25519:PASTE_PRIVATE_KEY_HERE" | sudo tee /var/lib/tor/onion_auth/myvps.auth_private >/dev/null
sudo chown debian-tor:debian-tor /var/lib/tor/onion_auth/myvps.auth_private
sudo chmod 600 /var/lib/tor/onion_auth/myvps.auth_private將 ClientOnionAuthDir /var/lib/tor/onion_auth 加入用戶端的 /etc/tor/torrc,然後重新載入 tor。如果您改用自己的使用者身分執行 tor,例如 macOS 上的 Homebrew build,請將 ClientOnionAuthDir 指向 ~/.tor/onion_auth,並將模式設為 0700。
該檔案中的位址是 56 個字元,不含 .onion 後綴。完成後刪除 /tmp/k1.prv.pem 和 /tmp/k1.prv.key。
現在測試兩個方向。ssh myvps 應仍能連線。從未持有金鑰的機器連線時,相同位址應會失敗。這項失敗即可證明授權已啟用。
關閉 port 22,請依照此順序操作
先設定安全措施。若你被鎖在系統外,這個單一指令會在十五分鐘後復原下方兩項變更。
sudo systemd-run --on-active=15m --unit=ssh-rescue \
/bin/sh -c 'ufw allow 22/tcp; rm -f /etc/systemd/system/ssh.socket.d/override.conf; systemctl daemon-reload; systemctl restart ssh.socket'確認 onion 路由仍可運作後,使用 sudo systemctl stop ssh-rescue.timer 取消它。
接著,停止 sshd 在公開位址上監聽。Ubuntu 24.04 預設會透過 socket unit 啟用 SSH,因此由 ssh.socket 持有監聽 socket,而不是 sshd。ListenAddress 在 sshd_config 中仍然有效:Ubuntu 的 openssh 套件會隨附 systemd generator,讀取 sshd_config,並依其內容寫入 socket 的監聽位址。這只有在 systemd 重新執行 generator 時才會發生,因此 ListenAddress 的變更會在執行 sudo systemctl daemon-reload 和 sudo systemctl restart ssh.socket 後生效,而不是重新啟動 sshd 後生效。下列步驟會直接設定 socket,因此上方的復原計時器只需刪除一個檔案即可復原變更。請先確認你屬於哪種情況。
systemctl is-enabled ssh.socket如果輸出 enabled,請執行 sudo systemctl edit ssh.socket 並加入以下內容。
[Socket]
ListenStream=
ListenStream=127.0.0.1:22空白的 ListenStream= 會清除從套件提供的 unit 繼承而來的值。若省略該行,就會在保留公開監聽器的同時新增第二個監聽器。這是此步驟最常見的無提示失敗原因。
sudo systemctl daemon-reload
sudo systemctl restart ssh.socket
ss -tlnp | grep ':22'ss 應顯示 127.0.0.1:22,且 0.0.0.0:22 不應有任何內容。如果 ssh.socket 已停用,請將 ListenAddress 127.0.0.1 放入 /etc/ssh/sshd_config.d/10-onion.conf,執行 sudo systemctl restart ssh,再使用相同的 ss 行確認。無論哪種情況,該輸出都是驗證結果。
接著設定防火牆。這是 VPS 上一般的 ufw 規則管理。先執行 sudo ufw status numbered,然後刪除其中列出的 SSH 規則。
sudo ufw status numbered
sudo ufw delete allow OpenSSH
sudo ufw default allow outgoing
sudo ufw default deny incoming
sudo ufw status verbose請保留允許輸出的流量。Tor 會連出至 443 和 9001 等連接埠上的 relay,因此輸出流量預設拒絕會阻止 tor 完成 bootstrap,並同時移除你唯一剩下的登入途徑。多數供應商也會在控制面板中提供獨立的網路防火牆。請一併在該處關閉 22,否則無論 ufw 顯示什麼結果,該連接埠仍可能可連線。
如果這台主機執行 Docker,請在完成前檢查其 published ports。Docker 會將自己的規則寫入相同的 tables,並直接繞過 ufw 發布容器連接埠,因此 ufw 的 deny policy 並不能完整反映實際狀態。
重開機以驗證服務狀態
systemctl is-enabled tor@default
sudo reboot若第一個指令未顯示該服務已啟用,請在重開機前執行 sudo systemctl enable tor@default。等待兩分鐘後,執行 ssh myvps。Tor 在開機後需要時間進行 bootstrap,因此 onion 位址會在機器啟動後一段時間才開始回應。
若服務無法恢復,請開啟主控台並讀取 sudo journalctl -u tor@default -b。該處會顯示 torrc 語法錯誤或目錄權限問題。您也可以在套用前先檢查 torrc 的編輯內容。
sudo -u debian-tor tor --verify-config與 WireGuard 通道相比的成本
與 自行架設 VPS 上的 WireGuard VPN 相比,Onion service 的速度較慢且較不穩定。在投入使用前,請務必誠實評估此取捨。
延遲。 客戶端電路包含三個中繼站,服務端則增加另外三個,因此您的按鍵輸入大約會經過全球隨機挑選的六台機器。互動式輸入會有明顯延遲,檔案傳輸速度也較慢。WireGuard 僅增加一個節點。請使用 time ssh myvps 'echo ok' 測量您的實際情況,因為數值取決於 tor 當下建立的電路,且會在 tor 重新建立電路時改變。
關鍵路徑上的使用者空間 daemon。 WireGuard 位於核心層,隨網路啟動。Tor 則是一個必須啟動、引導並連接到 guard relay 才能運作的行程。當它失敗時,您必須透過服務供應商的控制台進行排解。
時鐘準確度。 Onion service 的描述檔是依據時間週期發布的,因此若系統時鐘嚴重偏差,將導致位址查詢失敗,且不會有任何明確的錯誤訊息。timedatectl 應回報 System clock synchronized: yes。
您獲得的回報是無需再依賴防火牆規則正確性的暴露防護。沒有可掃描的連接埠,也沒有可獲取的 banner,且位址本身就是公開金鑰,因此端點在 SSH 啟動前即已驗證其身分。
實務上的建議通常是兩者並用。將 WireGuard 作為日常連線路徑,並保留 Onion service 作為 WireGuard 設定錯誤時的備援路徑。這樣只需開啟一個 UDP 連接埠,而非公開 SSH 連接埠。這些措施都無法取代 強化 sshd 本身:僅限金鑰驗證與非 root 登入仍然至關重要,因為 Onion service 僅保護網路路徑,並不涵蓋路徑之後的任何層面。
失敗情況與會看到的錯誤
Tor 永遠無法通過 Bootstrapped 0%。 對外流量遭到封鎖,或系統時間嚴重不正確。使用 sudo ufw status verbose 檢查對外連線政策,然後執行 timedatectl。
systemctl status tor 顯示 active (exited)。 這在 Debian 和 Ubuntu 上屬於正常情況。請改讀 tor@default。
找不到 descriptor。 Tor 傳回 SOCKS 延伸錯誤 F0:「找不到 Onion Service Descriptor」。可能是 descriptor 尚未發布;重新載入後需要短暫等待,也可能是伺服器上的 tor 尚未執行。
F4,「缺少 Onion Service 用戶端授權」。 用戶端沒有符合條件的 .auth_private 可供 tor 使用。確認 torrc 中有 ClientOnionAuthDir、目錄權限為 0700、檔名以 .auth_private 結尾,且 debian-tor 有權讀取該檔案。格式錯誤的金鑰也會造成此錯誤:base32 字串末尾多出的 =,或字串內的多餘換行,會讓 tor 載入檔案時拒絕該檔案;用戶端日誌會顯示 base32 私密金鑰長度無效,或無法解碼該金鑰。
F5,「錯誤的 Onion Service 用戶端授權」。 Tor 已載入格式正確的私密金鑰,但該金鑰與伺服器上的 .auth 檔案不相符,因此無法解密 descriptor。常見原因是使用了不同配對中的金鑰,或是在設定用戶端後,伺服器上的 .auth 檔案遭到替換。
nc: invalid option -- 'X'。 系統安裝的是 GNU netcat,而不是 OpenBSD 版本。請執行 sudo apt install -y netcat-openbsd。
Could not resolve hostname。 ssh 嘗試使用一般 DNS 查詢,但該查詢沒有回傳 .onion 的結果,因此 ProxyCommand 從未執行。~/.ssh/config 中的 Host 模式與您輸入的名稱不相符。
Permission denied (publickey)。 通道運作正常,tor 的工作已完成。請將此視為一般的 permission denied publickey 問題,不要將問題歸咎於 tor。
FAQ
使用 onion service 是否代表我的 VPS 上沒有開啟任何連接埠?
是的,只要將 sshd 綁定至 127.0.0.1 且防火牆阻擋所有入站流量即可。Tor 會建立連往中繼站(relay)的出站 TCP 連線,您的連線會透過該路徑傳回,因此伺服器上不會有任何服務在公用位址上監聽連線。您可以透過在伺服器執行 ss -tlnp 並從外部進行連接埠掃描來驗證。請勿忽略雲端供應商控制台中的網路防火牆,該防火牆與 ufw 是分開的,必須一併關閉。
單憑 .onion 位址對 SSH 來說足夠安全嗎?
不足夠。該位址長度為 56 個字元,無法透過目錄系統猜測或枚舉,因此具有秘密的特性,但它可能會透過 shell 歷史紀錄與設定檔洩漏。請加入 v3 用戶端授權(client authorisation)。啟用後,服務描述檔會使用您的用戶端金鑰加密,因此僅持有位址的人只會收到擴充錯誤 F4,完全無法觸及 sshd。
如果 Tor 在重新開機後無法啟動該怎麼辦?
您將完全失去 SSH 存取權,因為 onion 位址是唯一的進入途徑。這就是為什麼在關閉 22 埠之前,必須先測試供應商提供的控制台功能。此外,Tor 在開機後需要時間進行引導(bootstrap),因此該位址回應的時間會比機器回應 ping 的時間晚。如果它始終沒有回應,請透過控制台登入並讀取 sudo journalctl -u tor@default -b,通常會顯示 torrc 語法錯誤或 /var/lib/tor/ssh 的權限問題。
SSH over Tor 是否比 WireGuard 慢?
是的,差距很大。連線至 onion service 會隨機經過約六個中繼站,而 WireGuard 則是直接連往伺服器的一次加密跳躍。操作時會有延遲感,傳輸速度也較慢。常見的配置是將 WireGuard 用於日常工作,並將 onion service 保留為當 VPN 設定損毀時的緊急備援路徑。