SSH 又稱為安全殼層，是一種可讓你連線至各種服務 (例如網頁伺服器) 的通訊協定。這可讓你連線至我們的伺服器，並透過命令列工具 (例如 WP-CLI) 管理 WordPress.com 網站。
此功能適用於 WordPress.com 商用版或電子商務版方案。
在此指南中
初次存取 SSH 時，你必須建立憑證並啟用 SSH 存取。
- 從網站的 WordPress.com 儀表板前往「設定」→「託管設定」，即可存取網站的 SSH 選項。
- 出現提示時，請按一下「建立憑證」。此步驟只需操作一次，並將為所選的網站產生 SSH 使用者名稱和密碼。此憑證將用於 SFTP 和 SSH 連線。
- 請妥善保管密碼。如果遺失或忘記密碼，可使用「重設密碼」按鈕來產生新密碼。
- 找到「SSH 存取」並切換開啟「為此網站啟用 SSH 存取」選項。
- 一旦啟用「SSH 存取」，連線命令就會出現。你可以複製此命令並貼到終端機應用程式。請參閱我們的「連線至 SSH」操作說明，深入瞭解如何透過 SSH 存取你的網站。
如果遺失或忘記你的 SFTP/SSH 密碼，返回「設定」→「託管設定」即可重設密碼。
在 SFTP/SSH 憑證區段中，請按一下「重設密碼」。
若要透過 SSH 存取你的網站，你會需要 SSH 使用者名稱、密碼和終端程式。下方將說明如何透過一些最常見的程式連線。
- 開啟電腦的終端機應用程式。
- 若為 MacOS，請在電腦上前往「應用程式」→「公用程式」，接著開啟終端機應用程式。
- 若為 Linux，請查閱經銷商提供的文件以深入瞭解如何開啟終端機視窗。某些版本可能會將終端程式稱為殼層、主控台或命令提示字元。
- 從網站的 WordPress.com 儀表板前往「設定」→「託管設定」，即可存取網站的 SSH 選項。
- 在「託管設定」頁面上，確認已啟用 SSH 存取，並複製為網站提供的
ssh命令。例如：ssh example.wordpress.com@sftp.wp.com。
- 將
ssh命令輸入或貼到你的終端機應用程式，接著按下 Enter/Return 鍵。- 初次連線時，終端機可能會提示該命令無法建立主機的真確性。請輸入「yes」並按下 Enter/Return 鍵以繼續操作。
- 你的終端機現在應該會提示你輸入密碼。貼上或輸入建立 SSH 憑證時取得的 SSH 密碼，然後按下 Enter 鍵。
- 請注意，將密碼輸入終端機應用程式時，系統不會在您輸入的同時顯示密碼字元。這是刻意的設計。
- 如果忘記或遺失 SSH 密碼，你可以重設。
- 如果成功，你應該就能連線至 SSH，並可開始執行殼層與 WP-CLI 命令。
Windows 近期版本 (自 Windows 10 起) 已透過適用於 Linux 的 Windows 子系統和 OpenSSH 用戶端新增 SSH 支援。請參閱 Microsoft 的官方文件，瞭解如何使用這些方法。
Windows 現有及較舊版本提供的另一個選項為 PuTTY。
- 下載並安裝免費的 PuTTY 用戶端。
- 啟動 PuTTY 並設定「主機名稱」和「連接埠」設定，接著按一下「開啟」。
- 「主機名稱」應設為
sftp.wp.com - 「連接埠」應設為
22
- 「主機名稱」應設為
- 初次連線時，可能會收到提示你信任 rsa2 指紋和主機的訊息。請按一下「是」。
- PuTTY 會啟動終端機畫面。請輸入你的 SSH 使用者名稱並按下 Enter/Return 鍵。
- 出現提示時，請輸入你的 SSH 密碼。
- 如果成功，你應該就能連線至 SSH，並可開始執行殼層與 WP-CLI 命令。
下方操作說明將引導你新增 SSH 金鑰至你的 WordPress.com 帳號。請留意，你需要先新增 SSH 金鑰至你的帳號，接著才能將 SSH 金鑰附加至任何你想使用的網站。如果電腦上沒有 SSH 金鑰，也可以透過密碼驗證來連線至 SSH。
將 SSH 金鑰新增至你的 WordPress.com 帳號之前，你需要將金鑰複製到剪貼簿。有兩種使用電腦終端機操作的方式：
Mac
pbcopy < ~/.ssh/id_rsa.pubWindows
clip < ~/.ssh/id_rsa.pubLinux
cat ~/.ssh/id_rsa.pub如果你的 SSH 公開金鑰檔使用與上方所列不同的名稱，請編輯代碼以與電腦上的檔案名稱相符。
將 SSH 公開金鑰複製到剪貼簿後，按照下列步驟操作即可將金鑰新增至你的帳號：
- 將你的 SSH 金鑰貼到「公開 SSH 金鑰」欄位中。
- 按一下「儲存 SSH 金鑰」按鈕。
請留意，一旦將 SSH 金鑰新增至 WordPress.com 帳號，接著需要將金鑰附加至你想使用的各個網站。
將 SSH 金鑰新增至你的帳號後，必須將金鑰附加至你想透過 SSH 連線的網站。若要將 SSH 金鑰附加至網站，請按照以下步驟操作：
- 從 WordPress.com 儀表板前往「設定」→「託管設定」。
- 在「SSH 存取」區段下，使用「SSH 金鑰」欄位來選取所需金鑰。
- 按一下「將 SSH 金鑰附加至網站」按鈕。
一旦將 SSH 金鑰附加至網站，即可在透過 SSH 驗證時使用 SSH 金鑰。
如果你不想再使用 SSH 金鑰連線至網站，按照下列步驟操作即可從網站中斷連線金鑰：
- 從 WordPress.com 儀表板前往「設定」→「託管設定」。
- 在「SSH 存取」區段下找到你想移除的 SSH 金鑰。
- 按一下「中斷連結」按鈕即可將金鑰從網站中移除。
除非移除 SSH 金鑰，否則 SSH 金鑰仍將與你的 WordPress.com 帳號相關聯。
請按照下列步驟更新你的公開 SSH 金鑰：
- 從 WordPress.com 儀表板前往「我的個人檔案」。
- 在「我的個人檔案」頁面上按一下「安全性」。
- 按一下「安全性檢查清單」中提供的「SSH 金鑰」選項。
- 在你想更新的金鑰旁按一下「更新 SSH 金鑰」按鈕。
- 將更新後的 SSH 金鑰貼到「新的 SSH 公開金鑰」欄位中。
- 按一下「更新 SSH 金鑰」按鈕以儲存變更。
將 SSH 金鑰從 WordPress.com 帳號中移除，也會將金鑰從與之關聯的各網站中移除。若要從 WordPress.com 帳號中移除現有的 SSH 金鑰，請按照下列步驟操作：
- 從 WordPress.com 儀表板前往「我的個人檔案」。
- 在「我的個人檔案」頁面上按一下「安全性」。
- 按一下「安全性檢查清單」中提供的「SSH 金鑰」選項。
- 按一下現有金鑰旁顯示的「移除 SSH 金鑰」按鈕。
- 畫面會顯示確認訊息。請按一下「確定」按鈕，確認你要移除該金鑰。
⚠️
執行命令時應小心謹慎，以免遺失資料或損壞網站。請務必在充分瞭解命令的功能下執行這些命令。
你可以找到有關如何使用 Linux 命令列的廣泛資源。以下列舉一些熱門的第三方來源：
以下是一些常見的命令。
| 命令 | 說明 |
|---|---|
ls | 顯示目前的目錄內容清單。 |
cd | 變更目錄。 |
mkdir | 建立新資料夾/目錄。 |
touch | 建立檔案。 |
rm | 移除檔案。 |
cat | 顯示檔案內容。 |
cp | 複製。 |
mv | 移動。 |
pwd | 顯示目前的目錄。 |
grep | 在檔案/指令行中搜尋特定字詞。 |
find | 搜尋檔案和目錄。 |
nano | 文字編輯器。 |
history | 顯示過去使用的 50 個指令。 |
clear | 清除終端機畫面。 |
du | 取得檔案大小。 |
rsync | 複製檔案到伺服器或是從伺服器中複製檔案。 |
WP-CLI 已預先安裝在 WordPress.com 上，並可延伸殼層來提供 WordPress 特定的命令列工具。當你連線至 SSH 後，即可開始執行 WP-CLI 命令。
有許多命令和子命令可協助管理及疑難排解你的網站。如需深入瞭解可用的命令與使用方法，你可以參閱我們的 WP-CLI 指南或 WordPress.org 的 WP-CLI 文件。
WP-CLI 可用來管理和疑難排解外掛程式與佈景主題。
| WP-CLI 命令 | 說明 |
|---|---|
wp plugin list | 列出安裝的外掛程式，包含外掛程式的狀態和版本 |
wp theme list | 列出已安裝的佈景主題。 |
wp plugin deactivate plugin-name | 停用外掛程式。請將 plugin-name 替換成透過 wp plugin list 找到的 name 值。可輸入多個外掛程式名稱，以停用超過一個外掛程式。 |
wp plugin deactivate plugin-name | 啟用外掛程式。請將 plugin-name 替換成透過 wp plugin list 找到的 name 值。可輸入多個外掛程式名稱，以啟用超過一個外掛程式。 |
wp theme activate theme-name | 啟用佈景主題。請將 theme-name 替換成透過 wp theme list 找到的 name 值。 |
wp php-errors | 列出系統記錄的近期 PHP 錯誤。此命令有助於識別有問題的外掛程式和佈景主題 (可能需更新或停用)。 |
如果網站遭遇錯誤而無法執行命令，可能需要略過網站啟用的佈景主題和外掛程式程式碼。新增 --skip-themes 和 --skip-plugins 到任何 WP-CLI 命令中即可略過。
| WP-CLI 命令 | 說明 |
|---|---|
wp --skip-plugins --skip-themes plugin deactivate plugin-name | 略過佈景主題和外掛程式程式碼，然後停用外掛程式。請將 plugin-name 替換成透過 wp plugin list 找到的 name 值。 |
wp --skip-plugins --skip-themes theme activate theme-name | 略過佈景主題和外掛程式程式碼，然後停用佈景主題。請將 theme-name 替換成透過 wp theme list 找到的 name 值。 |
wp --skip-plugins --skip-themes php-errors | 略過佈景主題和外掛程式程式碼，然後列出系統記錄的近期 PHP 錯誤。此命令有助於識別有問題的外掛程式和佈景主題 (可能需更新或停用)。 |
如果透過 SSH 進行變更後網站發生問題，你可以從 Jetpack 備份還原網站。
如果執行命令後發生未預期的情況，我們可以協助你將網站還原至更早的時間點 (執行命令之前)。但我們無法協助你偵錯命令，以使其正常運作。
由於 SSH 和 WP-CLI 的特性相當複雜，我們無法針對使用這些工具提供廣泛的支援。Happiness Engineer 可協助你解決透過 SSH 連線的問題，但無法指引你使用命令。
為了提供安全且高效率的環境，WordPress.com 可能會限制或停用特定殼層和 WP-CLI 命令。
系統會自動產生使用者名稱和密碼。每個網站皆有專屬的使用者名稱和密碼。如果你有多個網站，就需使用多個使用者名稱和密碼，每個網站各自不同。
WordPress.com 支援 