Skip to content

建立 2026-09-15 更新 2026-09-15

首次設定

容器起來之後,用瀏覽器走完管理員與環境精靈,這台 Portainer 才算能用。對應文件:Initial setup

憑證警告

位址是 https://...:9443,憑證多半是 Portainer 自簽的。瀏覽器會顯示不安全,選「仍要前往」即可。這只代表憑證不是公開 CA 簽發,連線仍是加密的。之後若要給團隊用,再換成自己的憑證或放在反向代理後面。

不要為了避開警告就把 Portainer 改成對公網開 HTTP。

管理員帳號

第一個使用者是管理員。預設使用者名稱是 admin,可以改。密碼至少 12 個字,並符合畫面上的複雜度要求。

較新的版本在建立帳號前,可能還要 setup token(安裝權杖)。權杖寫在 Server 容器 log 裡,搜尋 setup_token=

docker logs portainer

這是為了避免網路上任何人搶先註冊第一個管理員。家用若暫時找不到權杖說明,以你安裝版本的官方 FAQ 為準。

Edge Compute

精靈會問要不要開 Edge Compute。家用只管本機 Docker,選 Skip 即可。之後若要加 Edge Agent,再在設定裡打開,並填 Server 從遠端看得到的 URL(含埠)。

若現在就開:

  • Portainer API server URL:遠端 Agent 連回來時用的位址,例如 https://portainer.example.com:9443。填錯,Edge Agent 會連不上。
  • Waiting Room:開著則新裝置要管理員核准;關著則第一次連上就自動信任。家用實驗室通常可先關,暴露在網際網路時建議開。

連到本機 Docker

安裝在 Docker 且已掛 socket 時,精靈會偵測到本機環境。選 Get Started 就會連上 local Docker,Home 畫面會出現這個環境。

若還要加其他主機,選 Add Environments,之後的步驟見Agent 與遠端環境。現在只想用本機,按 Get Started 離開精靈即可。

設定完成後先做的兩件事

  1. 點進本機環境,確認看得到剛才的 portainer 容器本身。這表示 socket 掛成功。
  2. 到 Stacks 準備部署第一個應用,見用 Stack 部署

管理員密碼請另外記住或放密碼管理器。忘掉且沒備份 Volume 的話,只能走官方重設管理員的流程(會動到資料庫),比一開始設好密碼麻煩許多。