新增 Container 範本
詳細說明如何在 OOS 設定 Container 範本、外接硬碟掛載、匯入範本、Container Registry 以及 Network Endpoint。
當 App Store 沒有您需要的容器範本時,可在此建立或匯入。Container(容器) 將程式與所需環境包裝在一起;本頁使用 Docker 容器。範本保存安裝設定,建立後還需到 App Store 安裝,才會建立可操作的應用程式。
開始前先確認
請向應用程式提供者取得映像檔名稱、版本標籤、資源需求,以及所需的環境變數、連接埠、儲存路徑與裝置設定。不需要的選用項目不必自行猜值。
- Container Registry:存放容器映像檔的來源;映像檔是用來建立容器的程式與環境檔案。若所需來源尚未設定,先依下方「新增 Container Registry」操作。
- Image Tag:用來指定映像檔版本的標籤,既有預設為
latest;請依應用程式需求確認要用的標籤。 - Network Endpoint:容器使用的網路連線設定。先確認容器需要連到哪裡、允許誰連入,再選擇模式;各模式的限制見下方欄位說明。
新增 Container 範本
- 前往 Application > Template > Container 頁面。
- 點擊 Add Template 圖示。

- 輸入 App Name(應用程式名稱)。
- 選擇 Container Registry。
- 輸入 Image Name(容器映像檔名稱)。
- 輸入 Image Tag(標籤,預設為
latest)。 - 選擇 Network Endpoint。
- 選擇 Resource Limitation(資源限制)。
- 依應用程式需求設定 Environment Variable(環境變數,即傳給程式的設定名稱與值)。
- 點擊 Upload App Icon 上傳應用程式圖示。
- 輸入 App Description(應用程式簡述)。
- (視需要)設定 Port Binding(連接埠對映):根據 Docker 需求新增單一連接埠或範圍,將設備對外的服務入口對應到容器內部的連接埠。
- (視需要)設定 Volumes(儲存區):依 Docker 需求新增用來保存容器資料的儲存路徑。
- (視需要)設定 Labels(識別標籤):依 Docker 需求新增名稱與值,供識別及管理。
- (視需要)設定 Commands(啟動指令):依 Docker 需求填入容器內要執行的指令。
- (視需要)設定 Devices(裝置對映):依 Docker 需求選擇容器要使用的硬體裝置。

注意:「Device」會列出
/dev(系統的裝置路徑)下的所有裝置,包含 USB 與序列埠(serial ports)。請依應用程式需求選用要掛載的裝置。
附圖服務區塊另有 Service Name 欄位,用來識別該服務;請依要建立的服務填寫。
- 若需使用 Docker Compose(以一組設定管理多個容器服務的方式),可新增更多服務,並重複步驟 5 至 16 設定各服務。
- 點擊 Apply 按鈕。
- 到 Application > App Store 確認新範本已出現,再依安裝應用程式安裝。
容器改用外接 USB 硬碟
需要改用外接硬碟儲存時,先確認目標磁碟,再完成裝置對映與手動掛載。掛載是將磁碟接到容器內可存取的路徑;Console 是輸入文字指令的終端機。
- 選擇外接硬碟。
- 點擊 Apply。

- 前往 Application > Information > Container > Action > Console,透過命令列手動掛載該磁碟。
本頁沒有提供適用所有磁碟的掛載指令。若不熟悉命令列,請先向管理員確認磁碟、目標路徑與指令,不要猜測執行。完成後,確認容器能在預定路徑存取該磁碟;只選取磁碟並套用,尚未完成上述手動掛載步驟。
匯入既有範本 (Import Template)
已有 App Template 檔案時,可使用匯入功能;請先準備範本檔案、名稱、描述與圖示。
- 前往 Application > Template > Container > Import Template。
- 輸入 App Name。
- 輸入 App Description。
- 選擇並瀏覽 App Template 檔案。
- 上傳 App Icon。
- 點擊 Apply 按鈕。

匯入後,到 App Store 確認範本名稱與描述,再進行安裝。
新增 Container Registry
要使用尚未登錄的映像檔來源時,先準備 Registry 的伺服器位址;若該來源要求登入,也需取得帳號與密碼或 Token(存取憑證)。
- 前往 Application > Template > Container > Registry。
- 點擊 Add 按鈕新增 Container Registry。

- 輸入 Registry Name。
- 輸入 Server Address(伺服器位址,必填)。Enable insecure HTTP access 是另外的選用開關;只有確認該來源需要使用未加密的 HTTP 存取時才開啟,不要將它當成填寫伺服器位址的必要步驟。
- (視需要)輸入 User Name 與 Password/Token。
- 點擊 Apply 按鈕。

儲存後,回到範本設定,確認 Container Registry 可選到新增的來源,並在安裝時確認映像檔能取得。
新增網路端點 (Network Endpoint)
需要自訂容器網路設定時使用。Network Driver 是建立容器網路的方式;其選項請依網路規劃或管理員提供的設定填寫,不要自行猜測。
- 前往 Application > Template > Container > Network Endpoint。
- 點擊 Add 按鈕新增 Network Endpoint。
- 輸入 Network Name。
- 選擇 Network Driver。
- 新增 Network Driver 選項。
- 點擊 Apply 按鈕。

儲存後,回到範本的 Network Endpoint 確認可選到新項目;安裝後再測試實際需要的連線與限制。
範本設定欄位說明
| 項目 (Item) | 描述 (Description) |
|---|---|
| App Name | 定義應用程式名稱,名稱不可重複。 |
| Container Registry | 存放各種 Docker 映像檔的倉庫,分為公開 (如 Docker Hub) 或私有 Registry。 |
| Image Name | 要使用的 Docker 映像檔名稱;映像檔是建立容器所用的唯讀檔案。請依提供者的名稱填寫。 |
| Image Tag | 協助開發與管理員組織容器映像檔,預設為 latest。 |
| Network Endpoint | 選擇容器網路設定;各模式與存取選項見下表。 |
| Resource Limitation | 容器可使用的 CPU(運算資源)與記憶體上限。規格:Low(0.2 CPU 核心 + 128 MB 記憶體);Medium(0.5 CPU 核心 + 512 MB 記憶體);High(2 CPU 核心 + 2 GB 記憶體)。說明:若選擇 Low 但 Docker 運作需要 High 資源,程式將無法運行,需調整資源限制設定。 |
| Environment Variable | 以名稱與值傳入容器的設定,可包含應用程式或使用者參數;請依應用程式要求填寫。 |
| Port Binding | 根據 Docker 需求,選擇 TCP/UDP 通訊協定並輸入對外 (Public) 與對內 (Private) 連接埠。對外連接埠設為 0 表示使用隨機連接埠。 |
| Volumes | 掛載於 Docker 容器上的檔案系統,用於持久化保存容器運行時產生的資料。 |
| Labels | Key/Value(名稱/值)形式的中繼資料,即附加的識別資訊,供分類與管理使用。 |
| Commands | 在容器內部執行的指令,用於在容器運行時啟動應用程式或執行任務。 |
| Upload App Icon | 上傳圖示圖片後,將顯示於 App Store 頁面上。 |
| App Description | 簡要描述此應用程式的功能。 |
網路模式與存取選項
Bridge(橋接) 是此處預設的容器網路模式;Host(主機) 模式僅供下列指定容器使用。請保留應用程式所需的連線,同時核對允許的存取範圍。
| 模式或選項 | 用途與限制 |
|---|---|
| Host | 僅限 Wireshark 或 IPsec 容器;其餘預設為 Bridge,且無法切換為 Host。 |
| Bridge | 預設網路模式。 |
| Network-restriction(bridge) | 帶有存取規則的 Bridge 模式,依下列選項管理存取。 |
| Allow Internet Access (Select Egress WAN) | 允許連線至網際網路,並選擇對外使用的 WAN(外部網路)出口。若容器有登入連接埠,其頁面存取受限,並透過 Port Mapping(連接埠對映)頁面管理。 |
| Allow Controller Access | 允許 Controller 存取容器。 |
| Allow LAN IP/24 Access | 限制僅允許指定 /24 網段內的 LAN(區域網路)裝置存取。 |
| Allow WAN IP Access | 限制僅允許指定 WAN IP 位址存取。 |
| None | 不套用任何網路限制;請先確認符合您的存取需求。 |