宝塔パネルへのデプロイ

このドキュメントでは、宝塔パネルのDocker機能を使用してNew APIをデプロイするための図解チュートリアルを提供します。

前提条件

ステップ1：宝塔パネルのインストール

1. 宝塔パネル公式サイトにアクセスし、お使いのシステムに適したインストールスクリプトをダウンロードします
2. インストールスクリプトを実行して宝塔パネルをインストールします
3. インストール完了後、提供されたアドレス、ユーザー名、パスワードを使用して宝塔パネルにログインします

ステップ2：Dockerのインストール

1. 宝塔パネルにログイン後、左側のメニューバーで Docker を見つけてクリックします
2. 初めてアクセスするとDockerサービスのインストールを促されるので、今すぐインストール をクリックします
3. プロンプトに従ってDockerサービスのインストールを完了します

ステップ3：New APIのインストール

方法一：宝塔アプリストアを使用（推奨）

1. 宝塔パネルのDocker機能で、アプリストア をクリックします
2. New-API を検索して見つけます
3. インストール をクリックします
4. 以下の基本オプションを設定します：
   • コンテナ名：カスタマイズ可能、デフォルトは new-api
   • ポートマッピング：デフォルトは 3000:3000
   • 環境変数：
     • SESSION_SECRET：セッションシークレット（必須、マルチノードデプロイ時は統一必須）
     • CRYPTO_SECRET：暗号化シークレット（Redis使用時に必須）
   • ディレクトリマッピング：/dataディレクトリをホストディレクトリにマッピング
5. 確認 をクリックしてインストールを開始します
6. インストール完了後、http://サーバーIP:3000 にアクセスします

方法二：Docker Composeを使用

より多くのカスタム設定が必要なシナリオに適しています。

1. 宝塔パネルでウェブサイトディレクトリを作成します（例：/www/wwwroot/new-api）
2. docker-compose.ymlファイルを作成します：

version: '3'
services:
  new-api:
    image: calciumion/new-api:latest
    container_name: new-api
    restart: always
    ports:
      - "3000:3000"
    volumes:
      - ./data:/data
    environment:
      - SESSION_SECRET=your_session_secret_here  # ランダム文字列に変更してください
      - TZ=Asia/Shanghai

3. SSHターミナルでディレクトリに移動し、起動します：

cd /www/wwwroot/new-api
docker-compose up -d

方法三：カスタムイメージを使用

1. 宝塔パネルのDocker機能で、イメージ管理 をクリックします
2. イメージ取得 → イメージプル をクリックします
3. イメージ名を入力：calciumion/new-api:latest
4. 送信 をクリックし、イメージのプルが完了するまで待ちます
5. プル完了後、コンテナリスト に入り、コンテナ作成 をクリックします
6. 以下の情報を入力します：
   • コンテナ名：new-api（カスタマイズ可能）
   • イメージ：プルした calciumion/new-api:latest を選択
   • ポートマッピング：3000:3000 を追加
   • ディレクトリマッピング：/your/host/path:/data を追加（ホストパスに置き換え）
   • 環境変数：必要に応じて追加
7. 送信 をクリックしてインストールを完了します

環境変数の設定

必須環境変数

ランダムシークレットの生成

# SESSION_SECRETの生成
openssl rand -hex 16

# またはLinuxコマンドを使用
head -c 16 /dev/urandom | xxd -p

アクセスと初期化

インストール完了後、http://サーバーIP:3000 にアクセスします

初回アクセス時に初期化ページが自動的に表示されます。画面の指示に従って管理者アカウントとパスワードを設定します。

よくある問題

3000ポートにアクセスできない

1. サーバーのファイアウォールが3000ポートを許可しているか確認
2. 宝塔パネルのセキュリティで3000ポートを開放
3. クラウドサーバーのセキュリティグループがポートを開放しているか確認

ログイン後にセッションが無効になる

SESSION_SECRET環境変数が設定され、空でないことを確認してください。

データを永続化する方法

Dockerボリュームマッピングを使用してデータディレクトリを永続化します：

volumes:
  - ./data:/data

バージョンを更新する方法

# 最新イメージをプル
docker pull calciumion/new-api:latest

# Docker Composeで再起動
docker-compose down && docker-compose up -d

# または宝塔コンテナ管理でコンテナを再起動

関連リンク

• 環境変数設定
• Docker Composeデプロイ
• FAQ
• GitHubリポジトリ