寶塔面板Docker安裝指南

本文件提供了使用寶塔面板Docker功能部署88API的圖文教程。

前置要求

• 安裝寶塔面板 9.2.0 及以上版本
• 推薦系統：CentOS 7+、Ubuntu 18.04+、Debian 10+
• 伺服器配置：至少1核2G記憶體

安裝寶塔面板

1. 前往寶塔面板官網下載適合您系統的安裝指令碼
2. 執行安裝指令碼安裝寶塔面板
3. 安裝完成後，使用提供的地址、使用者名稱和密碼登入到寶塔面板

安裝Docker

1. 登入寶塔面板後，在左側選單欄找到並點選 Docker
2. 首次進入會提示安裝Docker服務，點選 立即安裝
3. 按照提示完成Docker服務的安裝

安裝88API

方法一：使用寶塔應用商店（推薦）

1. 在寶塔面板Docker功能中，點選 應用商店
2. 搜尋並找到 88API
3. 點選 安裝
4. 配置以下基本選項：
   • 容器名稱：可自定義，預設為new-api
   • 埠對映：預設為3000:3000
   • 環境變數：根據需要新增（如TZ=Asia/Shanghai等）
   • 目錄對映：確保將/data目錄對映到主機目錄
5. 點選 提交，完成安裝

方法二：使用自定義映象

強烈建議透過“應用商店”安裝並自動完成配置。本節為高階用法，適合明確瞭解Docker與寶塔容器配置的使用者。

1. 在寶塔面板Docker功能中，點選 映象管理
2. 點選 獲取映象 -> 拉取映象
3. 輸入映象名稱：calciumion/new-api:latest
4. 點選 提交，等待映象拉取完成
5. 拉取完成後，進入 容器列表，點選 建立容器
6. 填寫以下資訊：
   • 容器名稱：new-api（可自定義）
   • 映象：選擇剛剛拉取的calciumion/new-api:latest
   • 埠對映：新增3000:3000
   • 目錄對映：新增/your/host/path:/data（替換為您的主機路徑）
   • 環境變數：根據需要新增（如TZ=Asia/Shanghai等）
7. 點選 提交，完成安裝

配置與訪問

安裝完成後，您可以透過以下地址訪問88API：

http://伺服器IP:3000

首次訪問將自動引導到初始化頁面。按照頁面指引設定管理員賬號與密碼（僅首次安裝需要），完成後使用所設定的管理員賬號登入。

常見問題

1. 無法訪問88API介面

• 檢查埠對映是否正確
• 確認伺服器防火牆是否放行3000埠
• 檢視容器是否正常執行

2. 資料無法持久化

• 確認是否正確對映了/data目錄
• 檢查主機目錄許可權是否正確