SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

如何在 VPS 安裝 Cloudron?完整設定指南

在全新的 Ubuntu VPS 安裝 Cloudron:先設定 wildcard DNS,再執行安裝指令碼並完成首次啟動,了解 2 至 10 個應用程式的規格、郵件、憑證與備份設定。

VPS 安裝 Cloudron:精簡版

若要在 VPS 上安裝 Cloudron,您需要全新的 Ubuntu 伺服器、至少 2 GB RAM,以及一個可以編輯 DNS 記錄的網域。安裝本身只需執行 3 個命令並重新開機 1 次。大多數問題都發生在這個步驟之前(基礎映像檔錯誤、虛擬化類型錯誤),或完成安裝之後(DNS、郵件、備份)。

wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setup

Cloudron 會為自架應用程式安裝、更新及備份,並簽發 TLS(傳輸層安全性)憑證。每個應用程式都在 Docker 中執行,nginx 位於所有應用程式前方,而每個應用程式都會使用您網域的獨立子網域。正因如此,DNS 設定必須先處理。

為何 Cloudron 對基礎作業系統有嚴格要求

安裝腳本會在安裝任何軟體前檢查伺服器,若檢查失敗,請直接申請一台新的伺服器。請在選擇映像檔前先閱讀這些要求。本節引用的安裝檢查標準截至 2026 年 10 月 13 日;目前的安裝文件要求使用全新的 Ubuntu 26.04 伺服器。

  • 僅限 Ubuntu,且僅支援三個版本。其他系統會觸發 Cloudron requires Ubuntu 22.04, 24.04, 26.04 並終止。Ubuntu 20.04 會被拒絕,目前的安裝文件要求使用全新的 Ubuntu 26.04 伺服器。不支援 Debian、Rocky 與 Alpine。Ubuntu 24.04 需要 Cloudron 8 或更新版本,腳本會自動為您檢查。
  • 僅限 64 位元 Intel 或 AMD 架構:Error: Cloudron only supports amd64/x86_64。ARM 架構的 VPS 無法執行。
  • 僅限完整硬體虛擬化。若在容器化 VPS 上執行,腳本會因偵測到 systemd-detect-virt --container 而以 Error: Cloudron does not support lxc, only runs on bare metal or with full hardware virtualization 終止。KVM 沒問題,但 OpenVZ 與 LXC 不支援。
  • 根檔案系統必須為 ext4 或 xfs。使用其他格式會收到 Error: Cloudron requires '/' to be ext4 or xfs 錯誤,這也是 btrfs 與 zfs 映像檔失敗的原因。
  • 至少需要 941 MB RAM(透過 free -m 測量),以及 18 GB 的 /(以根檔案系統大小計算)。錯誤訊息雖要求 20GB,但檢查機制對 19 GB 的根檔案系統會判定為通過。
  • 必須是全新的伺服器。若已安裝 nginx、docker 或 node,腳本會拒絕安裝並顯示 Error: Some packages like nginx/docker/nodejs are already installed.。

最後一項檢查常引發爭議,原因如下:Cloudron 會安裝指定版本的 Docker、nginx、Node.js 與 MySQL,並為其託管的每個應用程式編寫 nginx 設定檔,同時自行管理 iptables 防火牆規則。您先前自行安裝的 Docker 版本可能不符,因此腳本會在不更動任何設定的情況下退出,並要求您使用全新的 Ubuntu 安裝環境。Cloudron 會接管整台機器,請務必提供專用的 VPS。

還有一項容易被忽略的檢查。在不支援 AVX (advanced vector extensions) 的舊款 CPU 上,腳本會顯示 CPU has no AVX support. MongoDB will be disabled,這將導致所有需要 MongoDB 的應用程式無法安裝。在確認使用前,請先執行 grep -m1 -o avx /proc/cpuinfo 檢查 CPU;若主機支援,該指令會顯示 avx,若為舊款 CPU 則不會有任何輸出。

Cloudron 需要多少 RAM?

2026 年 10 月 13 日的安裝程式檢查在低於 941 MB 時會拒絕執行,並顯示 Error: Cloudron requires atleast 1GB physical memory;目前的說明文件要求 2 GB RAM 與 20 GB 磁碟空間。這兩個數值皆為平台的最低需求,並不包含您部署的應用程式。Cloudron 會執行 Docker、nginx、其專屬的 box 服務與郵件堆疊,並在部署應用程式時提供共用的資料庫服務。請在全新安裝後執行 docker ps 並計算數量。

應用程式的記憶體限制是在此基礎之上。每個應用程式套件皆預設較低的限制,您可透過應用程式「資源」(Resources)檢視中的滑桿來調高。當應用程式超過限制時,它會重新啟動並向您發送 OOM(記憶體不足)通知,因此若某個應用程式不斷重啟,通常是限制問題而非程式錯誤。

以下是我建議的規格配置。這些建議是為了讓您下個月不必重新建置伺服器,並非精確的基準測試結果。

圖表Cloudron VPS sizing floor by number of apps
此圖表背後的資料
[
  {
    "label": "2 apps (free tier)",
    "vcpu": 2,
    "ram_gb": 4,
    "disk_gb": 60
  },
  {
    "label": "5 apps",
    "vcpu": 4,
    "ram_gb": 8,
    "disk_gb": 120
  },
  {
    "label": "10 apps",
    "vcpu": 6,
    "ram_gb": 16,
    "disk_gb": 240
  }
]

執行兩個應用程式時,4 GB RAM 與 60 GB 磁碟空間已足夠。若要執行約十個應用程式,則建議 16 GB RAM 與 240 GB 磁碟空間,因為平台基礎需求不會縮減,且每個應用程式都會增加 Docker 映像檔、資料庫及其專屬資料。磁碟空間消耗的速度通常比預期快:映像檔、應用程式資料與本機備份會共用同一個磁碟區,直到您將備份移出該伺服器為止。

Cloudron 為每個應用程式提供無限的 swap,因此您設定的記憶體限制僅適用於 RAM。在沒有 swap 檔案的 VPS 映像檔上,swapon --show 將不會顯示任何資訊,記憶體壓力會直接導致 OOM 重啟,而非應用程式變慢。增加 2 GB 的 swap 是低成本的保障,但無法取代實體記憶體。VPS 方案之間的價差,遠小於您花費在調整限制上的時間成本,因此請參考 VPS 的實際成本 並購買高一階的規格。

DNS:讓應用程式子網域運作的萬用字元記錄

Cloudron 將儀表板置於 my.example.com,並讓每個應用程式擁有獨立的子網域,因此 DNS 是必要的前置作業,而非後續步驟。在首次開啟儀表板前,請將以下記錄指向伺服器的公開 IP 位址:

  • my.example.com 設定為 A 記錄。這是儀表板位址。
  • *.example.com 設定為 A 記錄。這是讓應用程式子網域運作的關鍵,確保 wiki.example.com 與 git.example.com 在安裝應用程式時能立即解析。
  • example.com 設定為 A 記錄,僅在您希望於根網域部署應用程式時使用。

萬用字元記錄的優先權低於明確記錄,因此現有指向其他位置的 www.example.com 將維持運作。

在設定過程中,您需選擇 Cloudron 後續處理 DNS 的方式:

  • API 提供者。Cloudron 會儲存 Cloudflare、DigitalOcean、Route53、Hetzner、Porkbun、Linode、deSEC、Gandi、Namecheap、Hostinger DNS、Scaleway DNS 等服務的 Token(共 22 種 API DNS 整合,不含 Wildcard、Manual 與 No-op),並自動寫入所有記錄,包含郵件記錄。
  • Wildcard。您需手動新增 * 記錄,Cloudron 不會寫入任何內容。
  • Manual。Cloudron 會顯示每筆記錄,並在您手動新增後,才繼續進行每個應用程式的安裝。

萬用字元 DNS 記錄不等於萬用字元憑證。 預設的憑證提供者為 Let's Encrypt Prod - Wildcard,其透過 DNS 驗證所有權,因此僅適用於 API 提供者。若使用 Wildcard 或 Manual 後端,Let's Encrypt 會發行透過 HTTP 驗證的個別憑證,這需要開放 80 埠以進行簽發與續期。您也可以停用 Let's Encrypt 整合並上傳自訂的萬用字元憑證,如此一來,憑證驗證便無需長期開放 80 埠。若您的網域註冊商或 DNS 主機商在 API 支援列表中,請務必使用該功能:郵件記錄與憑證管理將不再需要您手動維護。

在繼續之前請先驗證。dig +short my.example.com 與 dig +short anything.example.com 應皆顯示您的伺服器 IP 位址。若使用 Wildcard 後端,當萬用字元查詢無法回傳結果時,儀表板雖能正常運作,但後續應用程式將無法安裝。

若網域位於 Cloudflare 後方,請將記錄設為 DNS only。代理模式僅轉發 HTTP 與 HTTPS 流量,會導致郵件埠失效。對於透過代理的網頁應用程式,Cloudron 的 Network 檢視支援信任 Cloudflare 公布的 IP 範圍,以便從轉發標頭中還原訪客的真實 IP 位址。

執行安裝腳本

wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setup

請以 root 權限或透過 sudo 執行,否則程式啟動時會顯示 This script should be run as root.。安裝過程需數分鐘,執行期間不會輸出訊息,因為 apt 輸出與 Docker 拉取紀錄皆導向至日誌檔案。您可開啟另一個 SSH 連線進行監控:

tail -f /var/log/cloudron-setup.log

在 2026 年 10 月 13 日的安裝程式檢查中,系統會顯示 After reboot, visit one of the following URLs and accept the self-signed certificate to finish setup. 並列出伺服器位址,隨後詢問 The server has to be rebooted to apply all the settings. Reboot now ? [Y/n]。請回答 yes。該安裝程式亦提供 --skip-reboot 旗標以延後重新啟動。

首次開機:網域、DNS 後端與管理員帳號

開啟 https://<server-ip> 並接受瀏覽器的警告。由於 Cloudron 尚未得知您的網域,因此無法向憑證授權單位申請憑證,此時使用的是自簽憑證。在 Chrome 中點選 Advanced,接著點選 Proceed to <ip> (unsafe)。在 Firefox 中點選 Advanced,接著點選 Accept the Risk and Continue。

第一個畫面會要求輸入您的網域。輸入 example.com,儀表板將會設定在 my.example.com。您也可以改用子網域,例如 cloudron.example.com,此時儀表板將位於 my.cloudron.example.com。選擇 DNS 後端,若有 API token 請貼上,並使用您確實會收信的電子郵件地址建立管理員帳號:密碼重設與平台通知皆會發送至該信箱。

儲存後,Cloudron 會申請憑證並將儀表板移至 https://my.example.com。此時 IP 位址的 URL 將會失效,請將新的網址加入書籤。

憑證:續期機制與停止運作的原因

憑證續期為自動執行,並遵循憑證授權單位(CA)發布的 ACME Renewal Information (ARI) 排程;實務上,續期會在過期前約一個月進行。若續期失敗,系統會發送電子郵件通知管理員帳號,而過期的憑證將會退回到內建的自簽憑證。這正是為何原本正常的網站突然出現瀏覽器警告的原因。

絕大多數問題源於兩個原因。HTTP 驗證需要開放 inbound port 80,因此若因「反正一切皆為 HTTPS」而關閉 port 80,將導致使用 Let's Encrypt HTTP 驗證的 Wildcard 或手動 DNS 後端應用程式無法續期。DNS 驗證則需要具備寫入權限的 API token,若該 token 被輪替或權限受限,續期將會靜默失敗,直到收到警告郵件為止。

在 Domains 檢視畫面中,有一個 Renew All 按鈕可強制立即嘗試續期,並提供 Let's Encrypt Staging 提供者以供測試。Staging 憑證刻意不被瀏覽器信任,這正是其目的所在:測試時可避免消耗正式環境的速率限制(rate limits)。Staging 本身亦有其限制,包括每個帳號對每個識別碼每小時最多 200 次驗證失敗。

是否應使用內建郵件伺服器?

Cloudron 內建完整的郵件堆疊,包含 IMAP 信箱、郵件提交、Sieve 過濾器以及 DKIM (DomainKeys Identified Mail) 簽章。您可在儀表板的 Email 頁面針對各網域啟用此功能。郵件投遞的難點在於外部環境,而非 Cloudron 本身。

  • 多數 VPS 提供商為防範垃圾郵件,預設會封鎖對外的 25 埠。部分業者在提交支援工單後可協助解鎖。請在伺服器上執行 nc -zv aspmx.l.google.com 25 進行測試(若無此指令,請安裝 netcat-openbsd)。若連接埠開啟會顯示 succeeded,若遭封鎖則會因逾時而卡住。
  • PTR 記錄(反向 DNS)由您的 VPS 提供商設定,而非 DNS 代管商;當您直接從伺服器發信時,該記錄必須與郵件主機名稱相符。使用 Smart host 可免除此 PTR 需求。
  • 若使用 API DNS 後端,系統會自動為您寫入 SPF、DKIM 與 DMARC 記錄。若使用 Wildcard 或 Manual 後端,則需手動新增;若缺少 DKIM 記錄,您簽署的每封郵件都將無法驗證。

對多數使用者而言,最穩定的設定方式是使用 Cloudron 接收郵件,並透過 SendGrid、Postmark、Mailgun 或 Amazon SES 等中繼服務(Relay)發送郵件,相關設定可在 Email 頁面完成。中繼服務必須允許以您網域下的任何地址發信,否則來自不同寄件者的應用程式通知將會被拒絕。若架設伺服器的主要目的是處理郵件,建議將 專用郵件伺服器(如 Mailcow) 部署在獨立的機器上,以維護其專屬的 IP 信譽。

若您完全不使用 Cloudron Email 功能,請在提供商的防火牆層級封鎖 25、465、587、993 與 4190 埠。請務必在該處設定,而非在伺服器內操作,因為 Cloudron 會自行管理 iptables 規則並預期擁有完全控制權。這與一般 VPS 的操作方式相反,在一般 VPS 上,您需 自行管理 ufw 規則。

需要時才設定備份目標

備份預設儲存在 /var/backups 的本機檔案系統,與其他資料位於同一顆磁碟。文件明確指出:「備份與平台伺服器位於同一顆實體磁碟上是危險的。」磁碟故障一次就可能同時遺失應用程式與備份。

開啟 Backups,接著選取 Backup Sites,並在第一天就將備份指向其他位置。S3-compatible object storage 通常是首選,例如 Backblaze B2、Wasabi、Cloudflare R2、DigitalOcean Spaces,或第二台伺服器上的 MinIO bucket。此外也支援 SSHFS、NFS、CIFS 及一般檔案系統目標。

以下 3 項設定會決定備份是否真正有用:

  • 格式。tgz 會為每個應用程式寫入一個壓縮封存檔,並在每次執行時重新上傳完整檔案。rsync 只會上傳變更的檔案。對大型 Nextcloud 而言,後者成本低得多,但會對儲存 API 發出更多請求。
  • 加密。可選用 AES-256,同時加密檔案內容與檔名。Cloudron 不會保留密碼副本,因此一旦遺失密碼,任何人都無法解密備份,包括你自己。按下儲存前,請先將密碼存放在自行託管的密碼管理器中。
  • 保留期限。以數量表示,例如每日 7 份、每週 4 份。在 object storage 上保留資料越久,每月費用越高,因此請選擇你願意持續支付費用的數量。

接著測試還原。安裝一個小型應用程式,從儀表板還原它,並確認應用程式及其資料能夠恢復。從未還原過的備份,只能算是一種猜測。

免費方案的限制

截至 October 2026,免費方案最多可安裝 2 個應用程式。其他功能都包含在內:應用程式更新、個別應用程式備份、防火牆、郵件伺服器及單一登入。需要授權的起點是第 3 個應用程式。付費方案會取消應用程式數量限制;較高階的方案則另外提供使用者群組與角色、目錄伺服器,以及多個備份站點。價格會變動,因此請查看Cloudron 價格頁面,不要依據教學中的固定數字。

1 個授權只涵蓋 1 個 Cloudron 安裝,因此 2 台小型伺服器的費用會是 1 台大型伺服器的 2 倍。這種定價會讓多數人選擇單一、規模較大的 VPS,與通常建議將服務分散到多台機器上的做法相反。規劃伺服器規模時,請將這點納入考量,因為日後拆分服務代表需要支付 2 倍費用。

當系統發生故障時

請先從內建的檢查工具開始。它會依序檢查 DNS、憑證、磁碟、記憶體以及各項服務,並指出哪一項測試失敗:

sudo cloudron-support --troubleshoot

完成後,請使用標準的 systemd (系統與服務管理器) 工具。systemctl status box 可回報 Cloudron 服務本身的狀態,journalctl -u box -n 100 可提供近期的日誌,journalctl -u docker 則涵蓋底層的容器執行環境。安裝期間發生的任何錯誤都會記錄在 /var/log/cloudron-setup.log 中。

若儀表板無法載入,通常是 DNS 或供應商防火牆的問題,而非 Cloudron 本身。請從您的筆記型電腦執行 dig +short my.example.com,並確認供應商網路防火牆已開啟 80 與 443 埠;此防火牆設定與伺服器本身的規則是分開管理的。在 2026 年 10 月 13 日的安裝程式檢查中,若第二次執行被拒絕並顯示 Error: Cloudron is already installed. To reinstall, start afresh,最乾淨的解決方式是重建伺服器。

Cloudron 不適合的情況

如果您想管理應用程式,而不是基礎架構,Cloudron 就很適合。若您想依自己的方式執行容器,Cloudron 就不太適合,因為它會管理 nginx、Docker 和防火牆,並覆寫您在其中的設定。如果您的規劃是使用一組 compose 檔案,在自有 Docker Compose stack 前方配置 Traefik,即可在沒有上層平台的情況下,提供相同的自動 TLS 與子網域路由功能。如果您尚未決定,比較 Cloudron、CasaOS 與 Coolify會將它們並列比較,而較完整的自架服務清單比安裝指南更適合作為起點。

FAQ

Cloudron 在 VPS 上需要多少 RAM?

2026 年 10 月 13 日的安裝程式檢查在低於 941 MB 時會拒絕執行;目前的說明文件要求 2 GB,但這僅是平台在未安裝任何應用程式時的最低需求。Cloudron 會執行 Docker、nginx、其自身的 box 服務以及郵件堆疊,並在部署應用程式時提供共享資料庫服務。請為兩個應用程式預留 4 GB,為約十個應用程式預留 16 GB,並務必新增 swap 檔案;因為 Cloudron 會給予應用程式無限的 swap 空間,若伺服器沒有 swap,記憶體壓力將導致應用程式重啟。

我可以在 Debian 或已安裝 Docker 的伺服器上安裝 Cloudron 嗎?

兩者皆不可行。在 2026 年 10 月 13 日的安裝程式檢查中,腳本會在不支援的發行版上以 Cloudron requires Ubuntu 22.04, 24.04, 26.04 停止執行,並拒絕已存在 nginx、docker 或 node 的伺服器。目前的安裝說明文件要求使用全新的 Ubuntu 映像檔,且不支援 Debian、Rocky 與 Alpine。請從 KVM VPS 上的全新 Ubuntu 映像檔開始安裝。

為什麼我的應用程式子網域無法運作,但儀表板卻正常?

在使用 Wildcard 後端時,請檢查萬用字元 DNS 記錄。安裝過程會建立或要求 my.example.com 的 A 記錄,因此儀表板可以解析,但 wiki.example.com 會回傳 NXDOMAIN,導致瀏覽器回報找不到網站。請新增指向伺服器 IP 的 *.example.com A 記錄,並在安裝應用程式前使用 dig +short wiki.example.com 進行確認。

我一定要使用 Cloudron 的郵件伺服器嗎?

不需要。您可以關閉接收郵件功能,並透過外部轉送服務(如 Postmark、Mailgun 或 Amazon SES)寄送郵件;當您的供應商封鎖對外 25 埠,或 IP 位址沒有郵件信譽時,這是更安全的選擇。若您完全不使用 Cloudron Email,請在供應商的防火牆層級關閉 25、465、587、993 與 4190 埠,而非在伺服器上關閉。

當我在免費方案達到兩個應用程式的限制時會發生什麼事?

您需要付費訂閱才能安裝第三個應用程式。您已在執行的應用程式不會受到影響:它們會持續更新、持續備份並保留憑證。新增訂閱即可解除限制,無須重新安裝任何東西,因此免費方案是先在真實網域上測試平台的合理方式。

這篇文章對您有幫助嗎?