Openship 自架安裝教學：Ubuntu VPS、網域與 HTTPS 設定

安裝前準備#

本文使用 Ubuntu 上的 Docker Compose 模式，需要：

• 可透過 SSH 登入、具備管理權限的 VPS。
• 已啟動的 Docker Engine 與 Docker Compose 外掛。
• 可以修改 DNS 的網域。
• 可供 Openship 使用的 TCP 80、443 連接埠。

以下指令在 VPS 上執行，範例網域 openship.example.com 請換成自己的網域。

1
docker version
2
docker compose version
3
docker ps

1
sudo ss -lntp
2
sudo iptables -L INPUT -n -v --line-numbers

安裝 Openship CLI 與管理後台#

依 Openship 官方安裝文件，先安裝 CLI：

1
curl -fsSL https://get.openship.io | sh

如果安裝後找不到 openship，重新開啟 SSH 工作階段，或載入安裝路徑：

1
export PATH="$HOME/.openship/bin:$PATH"

啟動互動式設定：

1
openship

依精靈提示設定公開入口、管理網域，以及管理員名稱、Email 和密碼。在具備 Docker 的 Linux 上，預設會使用 Compose 模式。

完成後會看到管理入口與服務狀態，輸出格式如下：

1
Openship is live
2

3
URL        https://openship.example.com
4
Dashboard  http://localhost:3001
5
API        http://localhost:4000
6
Login      [email protected] (email + password you set)
7
Status     running · Docker Compose stack (restarts on boot)

用剛才設定的帳號密碼登入管理網域。這裡的 localhost:3001 指的是 VPS 本機，不是你正在操作的電腦。

再檢查平台與容器狀態：

1
openship status
2
docker ps

若容器持續重啟，先查看對應容器的日誌。容器顯示 running，也不代表資料庫已經可以接受連線；這部分可參考 Docker Compose healthcheck 與啟動順序。

後台能開啟後，確認 HTTPS 憑證#

這次設定完成後，曾遇到後台可以開啟、HTTPS 卻看起來尚未生效的狀況。處理時分別檢查後台的 SSL 狀態、VPS 本機憑證和公開網址，才確認連線結果。

1
openssl s_client \
2
  -connect 127.0.0.1:443 \
3
  -servername openship.example.com </dev/null 2>/dev/null \
4
  | openssl x509 -noout -subject -issuer -dates

1
curl -Iv https://openship.example.com

1
SSL certificate verify ok.
2
HTTP/2 307
3
server: cloudflare
4
location: /login?from=%2F

使用 Cloudflare 時，設定 Full (strict)#

VPS 的憑證與路由正常後，可以將 DNS 紀錄切成 Proxied（橘雲），再到 Cloudflare 的 SSL/TLS 加密模式選擇 Full (strict)。

Full (strict)會驗證來源站憑證的有效期、信任來源與網域匹配。此時有兩段 HTTPS：

1
瀏覽器
2
  ↓ HTTPS
3
Cloudflare
4
  ↓ HTTPS
5
VPS 上的 Openship Edge
6
  ↓
7
Dashboard

這次透過公開網域查到的簽發者是 Google Trust Services，VPS 本機則是 Let’s Encrypt。啟用代理後，瀏覽器看到的是 Cloudflare 對訪客提供的憑證，兩端簽發者不同是正常的。

切換後再執行一次 curl -Iv，確認憑證驗證通過、回應仍導向登入頁面。Full (strict) 也要在 Cloudflare 控制台確認，不能只憑公開網址能開啟就推定設定正確。

檢查 Dashboard 與 API 是否直接暴露在公網#

除了管理網域，也要檢查 Dashboard 的 3001 和 API 的 4000：

1
docker ps --format 'table {{.Names}}\t{{.Ports}}'
2
sudo ss -lntp

若看到 0.0.0.0:3001 或 0.0.0.0:4000，表示服務綁定所有 IPv4 介面。依安裝版本限制綁定位置，或使用適合 Docker 的防火牆規則限制來源；變更後確認 Edge 仍能連到後台，再從另一台主機測試對外存取。

Docker 官方防火牆文件指出，bridge 容器發布的連接埠可能在進入 UFW 的 INPUT 規則前就被轉送。因此，不能只看主機的 INPUT 規則，就判定 Docker 連接埠已阻擋。使用 host networking 的 Edge 入口則按主機連線規則處理。

這次的 VPS 資源觀察：1 GB RAM 太小#

安裝後，管理介面顯示以下用量。這是當下整台主機的狀態，不是 Openship 個別容器的用量。

磁碟當下仍有空間，但約 1 GB RAM 留給部署、更新和新增服務的餘裕太少。記憶體使用率 57% 只是單次觀察，不能代表建置尖峰也能承受；CPU 82% 則要配合容器用量與後續觀察，才能找出負載來源。

用以下指令檢查：

1
docker stats --no-stream
2
free -h
3
nproc
4
uptime
5
df -h

先在初始化完成、閒置一段時間後記錄一次，再於部署時觀察尖峰。free -h 的 available 可用來看剩餘記憶體，Load Average 則需要搭配 CPU 核心數判讀。

如果要長期使用，我會先以 2 vCPU、4 GB RAM、40–60 GB SSD 規劃小規模自架環境，再依應用程式與建置負載調整。這是容量規劃起點，不是 Openship 官方最低需求，也不保證能承載固定數量的專案。

這次約 1 GB RAM 的 VPS 能完成安裝，但規格太小，不適合作為長期使用的完整部署平台。 正式搬服務前，先換用記憶體更充足的主機，再用一個可重建的測試服務跑過部署與更新，觀察實際尖峰用量。

參考資料：

Openship 安裝文件

Openship 自訂網域與 HTTPS

Openship 網域、路由與 SSL 排錯

Docker Engine：Ubuntu 安裝

Docker 網路與防火牆

Cloudflare Full (strict)