SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor · 已更新 2026-10-24

如何在 VPS 架設 .onion 網站

在 Ubuntu 使用 tor 與 nginx 建立 v3 onion service,讓 nginx 僅綁定 loopback,並關閉可能將 .onion 位址連回公開 IP 的資訊外洩。

建置內容

Onion site 是只透過 Tor network 回應的普通 Web server。安裝 tor,將兩行設定加入 /etc/tor/torrc,讀取 tor 寫入的位址,然後讓 nginx 綁定 127.0.0.1,如此一來公開 IP 就不會回應任何請求。安裝約需十分钟。其餘內容都是洩漏檢查清單,因為 onion site 最常見的失效原因,是自身設定直接指回管理者。

Tor 最初稱為「onion router」,而 onion service 是只能透過 Tor 存取的服務。Version 3 位址包含 56 個字元,後接 .onion。這些字元是服務的 ed25519 公開金鑰、checksum 與 version byte,以 base32 編碼而成。Version 2 位址(16 個字元)已於 2021 年從 network 中移除,因此現在產生的位址都是 v3。位址本身就是金鑰,這會帶來兩項結果。連線會在端對端之間加密並驗證,不需要 certificate authority;而遺失金鑰檔案,就會永久失去該位址。

你的 server 永遠不接受入站連線。Tor 會選取數個 relay 作為 introduction point,將簽署的 descriptor 上傳至 directory server,並在訪客選擇的 rendezvous relay 與訪客建立連線。這些連線全部都是從你的主機向外建立。不需要開放任何 port,也不需要發布 DNS record。如果你希望同一台 VPS 也為 network 提供服務,那是不同的工作,架構正好相反,因為 obfs4 bridge 會接收遭審查用戶端的入站連線,並且需要可連線的 port。

從 Tor Project 儲存庫安裝 tor

Ubuntu 在 universe 中提供 tor 套件,也會透過 updates pocket 在發行後更新該套件,但版本通常落後於上游。2026-10-11,noble-updates 提供的版本是 0.4.9.11,而 Tor Project 已經發布 0.4.9.14,並透過自己的儲存庫提供該版本。該儲存庫會隨上游發布目前的穩定版本,這正是負責決定你的位址是否仍由你掌控的軟體所需要的版本。發行版中存在某個套件,並不代表仍有人維護它。對任何自行代管的服務,都值得確認這一點;例如 Searx 自 2023 年起沒有新的程式碼提交,而 SearXNG 仍持續推進該專案。

sudo apt update
sudo apt install -y apt-transport-https gnupg wget
KEYURL=https://deb.torproject.org/torproject.org/A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89.asc
wget -qO- "$KEYURL" | gpg --dearmor | sudo tee /usr/share/keyrings/deb.torproject.org-keyring.gpg >/dev/null

儲存庫項目使用 deb822 格式,而 Suites 必須是你的 Ubuntu 代號。請從 /etc/os-release 讀取代號,不要手動輸入,因為代號錯誤時,儲存庫雖然可以正常解析,卻不會提供適用於你版本的套件。

. /etc/os-release
sudo tee /etc/apt/sources.list.d/tor.sources >/dev/null <<EOF
Types: deb deb-src
URIs: https://deb.torproject.org/torproject.org/
Suites: $VERSION_CODENAME
Components: main
Signed-By: /usr/share/keyrings/deb.torproject.org-keyring.gpg
EOF
sudo apt update
sudo apt install -y tor deb.torproject.org-keyring

deb.torproject.org-keyring 套件會維持簽署金鑰為最新狀態,因此金鑰輪替不會在一年後導致 apt update 失效。確認 tor 已啟動並連上網路:

tor --version
sudo journalctl -u tor@default -n 20

日誌結尾應為 Bootstrapped 100% (done): Done。若 tor 停在 Bootstrapped 10%,表示沒有對外連線路徑。請檢查服務供應商的網路防火牆與你自己的對外連線規則:sudo ufw status verbose 應顯示 allow (outgoing) 為預設值。

接下來有兩個名稱需要記住。套件會以 debian-tor 使用者身分執行 tor,而執行中的 unit 是 tor@default.service,因為 Debian 與 Ubuntu 上的 tor.service 是包裝各 instance 的 wrapper。請使用 instance 名稱查詢狀態與日誌,這樣一定能取得實際程序的資訊。

在 torrc 中設定 onion service

在 /etc/tor/torrc 末尾新增以下兩行:

HiddenServiceDir /var/lib/tor/onion_site/
HiddenServicePort 80 127.0.0.1:8080

HiddenServiceDir 是 tor 保存此服務金鑰與位址的位置。請勿自行建立此目錄。Tor 啟動時會以所需的擁有者與模式建立它;如果您以 root 建立目錄,會導致下方失敗清單中的第一個錯誤。

HiddenServicePort 分為兩個部分,混淆兩者是最常見的第一個錯誤。第一個數字是訪客在 tunnel 內連線的連接埠,因此 80 才是預期值,沒有理由變更。第二個部分是 tor 將該網路流量轉送到的本機位址。單獨指定 HiddenServicePort 80 會轉送到 127.0.0.1:80;明確寫出位址並使用高號連接埠,可讓 onion vhost 避免與已在 80 上監聽的服務衝突。

sudo systemctl restart tor@default
sudo ls -l /var/lib/tor/onion_site/

清單應包含 hostname、hs_ed25519_public_key、hs_ed25519_secret_key,以及空的 authorized_clients 目錄。

讀取您的 .onion 位址

sudo cat /var/lib/tor/onion_site/hostname

輸出會回傳一行內容:56 個 base32 字元與 .onion。這個字串就是網站的完整身分。它不由任何人指派、無法轉移;只要您持有金鑰檔案,任何人都無法將其取走。請現在複製這個字串,因為以下每項設定都需要使用它。本指南其餘內容將其寫為 <your-address>.onion。

讓 nginx 綁定在 127.0.0.1 來提供網站

sudo apt install -y nginx
sudo install -d -m 755 /srv/onion

寫入 /etc/nginx/sites-available/onion:

server {
    listen 127.0.0.1:8080;
    server_name <your-address>.onion;

    root /srv/onion;
    index index.html;

    server_tokens off;
    etag off;
    access_log off;
    error_log /var/log/nginx/onion.error.log error;
}
echo '<h1>hello from the onion</h1>' | sudo tee /srv/onion/index.html
sudo ln -s /etc/nginx/sites-available/onion /etc/nginx/sites-enabled/onion
sudo nginx -t
sudo systemctl reload nginx

現在從伺服器確認兩件事。第一,nginx 會回應 onion 名稱;這就是 tor 會傳送的確切 Host 標頭:

curl -s -H 'Host: <your-address>.onion' http://127.0.0.1:8080/

第二,確認它只在該位址回應,不會在其他位置回應:

sudo ss -tlnp | grep 8080

位址欄必須顯示 127.0.0.1:8080。如果顯示 0.0.0.0:8080 或 *:8080,表示你的 onion 網站也暴露在公開網際網路上,這是洩漏清單中的第一項。不含位址的 listen 8080; 行會綁定所有介面,這是預設行為。

在 Tor Browser 中開啟該位址。第一次載入需要幾秒,因為用戶端必須取得你的描述元並建立 rendezvous circuit。

Tor Project 自己的文件偏好使用 unix socket,而不是 loopback 埠:HiddenServicePort 80 unix:/var/run/tor/onion_site.sock,並讓 nginx 監聽該路徑。即使主機之後增加第二個介面,socket 也完全無法從其他主機連線。代價是檔案權限管理,因為 nginx 會建立 socket,而 tor 會以 debian-tor 身分連線,因此兩個使用者必須對該目錄的權限設定一致。搭配已驗證的 ss 輸出,使用 loopback 較容易設定正確,本指南其餘內容也採用這種方式。

網站使用 loopback 後,主機完全不需要為它設定入站規則。保留 22 供自己使用,並拒絕其餘連線(VPS 上值得設定的 ufw 預設值)。請注意,防火牆無法消除綁定至 0.0.0.0 的服務,只會過濾抵達防火牆的封包。容器會讓這個問題更明顯,因為 發布 Docker 埠會在 ufw 之前寫入 iptables 規則,因此 -p 8080:80 會讓你的 onion 後端服務暴露在公開 IP 上,即使 ufw 仍回報該埠遭到拒絕。請將容器埠發布為 -p 127.0.0.1:8080:80。

使 onion site 去匿名化的資訊洩漏

Tor 會隱藏伺服器的位置,但不會隱藏伺服器傳送的內容。以下每一項,都是你自己的技術堆疊所公開的資訊。閱讀任何隱私工具時,都應確認其實際防護邊界,而不是只看其聲譽。這與了解自架 SearXNG 能隱藏什麼是相同的習慣:它只能向搜尋引擎隱藏你的 IP,僅此而已。

公開 IP 回應相同的 site

這是最容易讓人洩漏的項目。掃描器會持續索引每個可路由位址的 HTTP 回應,而這些結果公開且可搜尋。如果公開 IP 和 onion 位址提供相同頁面,只需一次查詢即可將兩者關聯:相同的標題、相同的 favicon hash、相同的 ETag,以及相同的標頭順序。上方的 listen 127.0.0.1:8080; 行就是修正方式。請從另一台電腦驗證,不要在伺服器本機驗證:

curl -sv --max-time 5 http://<your-public-ip>:8080/

正確結果應為 Connection refused 或逾時。任何 HTML 都表示該 site 已公開。如果該主機也執行 clearnet site,請為該 vhost 指定專用 root,並在公開 listener 上保留明確的 default_server 區塊。如此一來,未符合的 Host 標頭就不會落入 onion vhost。

版本橫幅

curl -sI http://127.0.0.1:8080/ | grep -i '^server'

預設的 nginx 會回應 Server: nginx/1.24.0。該版本字串連同其他標頭的確切順序,會形成可識別的指紋,讓人能將你的 onion site 與 clearnet 主機比對。server_tokens off; 會將其縮減為 Server: nginx。它不會移除標頭,而 nginx 也沒有可執行此操作的內建指令。因此,如果要完全移除該標頭,通常會使用 headers-more module。PHP 會加入 X-Powered-By,直到你設定 expose_php = Off 為止。etag off; 也應列入相同清單,因為 nginx 會根據檔案的修改時間和大小建立 ETag。因此,將相同檔案複製到兩台伺服器後,兩者會提供相同的 ETag。

指向 clearnet domain 的絕對 URL

一個 rel="canonical" 標籤、一個 Open Graph og:url、RSS feed、sitemap、密碼重設 email,或硬編碼的 logo URL,都可能在透過 onion 提供的頁面中指向 clearnet site。請使用 /static/logo.svg 等 root-relative path,並讓應用程式從 request host 讀取 base URL,而不是使用固定值。Redirect 也有相同問題,只是出現在其他位置:catch-all block 中的 return 301 https://example.com$request_uri; 會將 onion 訪客導向你的實際 domain,而 Location 標頭會直接提供該答案。

與 clearnet site 共用的 TLS certificate

onion address 會自行驗證,因為該位址就是 public key。因此,onion connection 上的 http:// 已經是端對端加密,Tor Browser 也會將其視為 secure context。在 onion vhost 上安裝現有 certificate,會公開兩者之間的關聯,因為每張受公開信任的 certificate 都會記錄在 Certificate Transparency logs 中,而這些 logs 公開、永久保存,且可依名稱搜尋。請將Let's Encrypt certificates 保留在 clearnet vhost,並讓 onion vhost 使用 plain HTTP。

第三方 fonts 與 analytics

來自 CDN(content delivery network)的 font,或 analytics script,都會由訪客的 browser 直接擷取。因此,第三方會知道有人載入了你的頁面,通常也會知道載入的是哪個頁面。此外,Tor Browser 較嚴格的 security level 可能會封鎖這些請求,導致版面破損。請自行託管頁面所需的所有 asset。

Host header 不相符

如果 server_name 不符合 tor 傳送的 Host header,nginx 會針對該 listen address 回退到 default server。在只有一個 vhost 的主機上,這個問題不容易察覺,因為唯一的 server block 同時也是 default。之後若新增 clearnet vhost,onion requests 可能會開始落到該 vhost,並一併套用其 canonical tags 和 redirects。每次修改 nginx 後,都要重新執行 curl -H 'Host: ...' 檢查,並以 grep 搜尋結果中的實際 domain:

curl -s -H 'Host: <your-address>.onion' http://127.0.0.1:8080/ | grep -o 'https\?://[^"]*' | sort -u

了解哪個 process 擁有哪個 socket,是這項工作的主要部分(Linux 上的連接埠與 listening socket 如何運作)。

Logs 中留下的內容

每個 request 都會從 127.0.0.1 抵達,因此 nginx 沒有訪客位址可記錄,而 access_log off; 不會造成任何成本。其上的應用程式則不同,訂單、email address 或上傳檔案的 metadata 都需要由你負責處理。你自己的操作習慣也很重要:透過未強化的 login 管理主機,不在 Tor 的保護範圍內。因此,請將同一台 VPS 上的 SSH hardening視為此建置的一部分。

備份私密金鑰,因為它就是該位址

/var/lib/tor/onion_site/hs_ed25519_secret_key 是服務本身。這裡沒有註冊商,也沒有復原機制。遺失私密金鑰,位址就會消失。複製私密金鑰後,任何持有副本的人都能在你的位址提供自己的內容,而你無法撤銷任何權限。

sudo systemctl stop tor@default
sudo tar -C /var/lib/tor -czf onion-keys.tgz onion_site
sudo chmod 600 onion-keys.tgz
sudo systemctl start tor@default

將該封存檔加密(gpg -c onion-keys.tgz),並移出伺服器保存。在新的 VPS 上還原時,只需要該封存檔,以及 ownership tor 預期的內容:

sudo systemctl stop tor@default
sudo tar -C /var/lib/tor -xzf onion-keys.tgz
sudo chown -R debian-tor:debian-tor /var/lib/tor/onion_site
sudo chmod 700 /var/lib/tor/onion_site
sudo systemctl start tor@default
sudo cat /var/lib/tor/onion_site/hostname

tor 重新發布 descriptor 後約 1 到 2 分鐘,相同位址就會在新硬體上恢復。整個遷移過程不需要變更 DNS,也不需要重新簽發憑證。

若網站也提供一般網路版本,設定 Onion-Location

如果 onion site 是為了便利而非保密,請從一般網路的 vhost 公開宣告:

add_header Onion-Location http://<your-address>.onion$request_uri;

接著,Tor Browser 會在網址列顯示 .onion available 按鈕,並提供切換選項。只有在一般網路頁面透過 HTTPS 提供,且該值為有效的 onion URL 時,瀏覽器才會接受這個標頭。

這裡有一項 nginx 規則需要注意。只有在 location 區塊未自行宣告任何 add_header 指令時,才會繼承這些指令。因此,具有自身 add_header 的 location 會悄悄捨棄 Onion-Location。請在該區塊重複設定,或將所有回應標頭集中在同一處。刻意發布這個標頭會明確建立兩個網站之間的關聯;這對鏡像網站是正確做法,但對任何必須保持無關聯的網站則不適用。

自訂地址

mkp224o會持續產生金鑰組,直到其中一組產生的地址以您指定的前綴開頭。這是暴力搜尋,因此除了前綴,以及您願意等待多久之外,沒有其他需要設定的項目。

sudo apt install -y git gcc libc6-dev libsodium-dev make autoconf
git clone https://github.com/cathugger/mkp224o
cd mkp224o
./autogen.sh
./configure --enable-amd64-51-30k
make
./mkp224o -d onionkeys blog

每次找到符合項目時,onionkeys/<address>.onion/會將其存放在包含hostname與hs_ed25519_secret_key的目錄中。安裝時先停止 tor,將該目錄複製到您的HiddenServiceDir,然後套用上述還原程序使用的相同chown與chmod 700。

前綴長度決定全部成本。地址採用 base32,因此每增加1個字元,預期所需的金鑰數量就會乘以32。短前綴可在筆記型電腦上完成。長前綴則無法在您擁有的任何設備上完成。自訂前綴也會讓讀者習慣只辨識地址開頭的幾個字元,而不是完整地址;釣魚網站仿冒 onion site 正是利用這種習慣建立的。

失效情況,以及你會看到的訊息

重新啟動後沒有 hostname 檔案。 Tor 未啟動,或拒絕使用該目錄。sudo journalctl -u tor@default -n 50 會指出其位置:

/var/lib/tor/onion_site/ is not owned by this user (debian-tor, 108) but by root (0). Perhaps you are running Tor as the wrong user?

這就是手動建立的目錄外觀。修正擁有者與模式,或刪除該目錄,讓 tor 自行建立。

Tor Browser 顯示 Onionsite Not Found (0xF0)。 用戶端無法取得描述元,因此就網路而言,該位址沒有發布任何內容。確認 tor 正在執行且已完成 bootstrap,然後檢查時鐘。Tor 需要準確的時間來發布及驗證描述元,而 timedatectl 應回報 System clock synchronized: yes。位址拼寫錯誤很少是這個問題的原因。v3 位址包含兩位元組的 checksum,因此拼錯的位址幾乎總是無法通過該檢查,而 Tor Browser 會改為顯示 Invalid Onionsite Address (0xF6)。如果看到這個訊息,請從 sudo cat /var/lib/tor/onion_site/hostname 重新複製位址。

位址可解析,但頁面始終無法載入。 Tor 已完成 rendezvous,接著在最後一跳失敗,也就是從 tor 到 nginx 的連線失敗;由於這一跳是本機連線,tor 日誌不會留下相關訊息。在伺服器上執行 curl -sI http://127.0.0.1:8080/。Connection refused 表示 nginx 已停止,或正在 HiddenServicePort 指向的其他位址上監聽。

頁面可載入,但每個連結都指向你的實際網域。 範本中使用了絕對 URL。執行上方的 grep -o 'https\?://[^"]*' 檢查,並在將位址分享給任何人之前,修正檢查結果所指出的問題。

原本正常運作,但重新啟動後停止。 在依賴該網站之前,先刻意重新啟動伺服器一次,然後執行 sudo systemctl status tor@default 和 sudo systemctl status nginx。有人手動啟動的服務,在機器重新啟動前,看起來與已啟用的服務完全相同。

FAQ

是否需要在防火牆開啟 Tor onion service 使用的連接埠?

不需要。tor daemon 只會對 directory server、introduction point 及各個 rendezvous relay 建立對外連線,因此不需要任何入站規則,Web server 本身則監聽 127.0.0.1。將 ufw 的入站流量維持為預設拒絕,只允許 SSH。相同特性也表示 onion service 可在完全沒有 public IP 的 NAT(network address translation)後方主機上運作。

為什麼我無法在 Tor Browser 開啟 .onion 位址?

請從 server 端開始逐步排查。sudo journalctl -u tor@default -n 50 應顯示 Bootstrapped 100% (done): Done,接著在 server 上執行 curl -sI http://127.0.0.1:8080/ 應回傳狀態列。錯誤輸入的位址幾乎不會連到其他服務,因為 v3 位址包含 checksum,因此 Tor Browser 會將其拒絕為 Invalid Onionsite Address (0xF6);請從 hostname 檔案重新複製位址。Onionsite Not Found (0xF0) 表示找不到該位址的 descriptor,通常代表 tor 未執行,或系統時鐘錯誤。

可以將 onion site 搬到新 server 並保留相同位址嗎?

可以。該位址衍生自 hs_ed25519_secret_key,因此請將完整的 HiddenServiceDir 複製到新主機,將其擁有者與模式設為 debian-tor 及 700,然後啟動 tor。descriptor 重新發布後,該位址就會恢復運作,而且不需要更新 DNS 記錄。若遺失該檔案,位址便無法復原,因此請在建立當天將其加密備份到 server 外部。

onion site 需要 HTTPS 憑證嗎?

不需要。這個 56 字元的位址就是該服務的 public key,因此連線已在端對端加密並完成驗證;Tor Browser 也會將 http:// 位於 .onion 名稱上視為安全內容。將 clearnet 憑證重複用於 onion vhost,比完全不使用憑證更糟,因為 Certificate Transparency 日誌是公開的,且會永久記錄哪些名稱共用同一張憑證。為 .onion 名稱購買憑證的唯一理由,是取得簽發此類憑證之 CA 提供的品牌信任,而該對應關係本來就是公開的。

這篇文章對您有幫助嗎?