PandaWikiオープンソース版の10分デプロイガイド

データの自律性とチームの制御の追求のために、ローカル展開のPandaWikiオープンソース版は、最適なソリューションです – 複雑な技術的背景を必要としない、Dockerのコンテナ化技術に依存し、ステップバイステップの操作手順に従って、すぐに独自のインテリジェントな知識ベースを持つことができます。この記事では、デプロイプロセス、環境設定の詳細と一般的な問題のトラブルシューティング、不明瞭な用語なしで全体のプロセスを統合し、ゼロベースで簡単に始めることができます。

一、配備前の準備：環境とリソースを確認する

1.ハードウェア構成要件

• 推奨構成: 2コアCPU + 4GB RAM + 20GB 空きディスク (10名までのチームによる安定した使用をサポート)
• 最小構成: 1コアCPU + 2GB RAM + 5GB 空きディスク (個人的なテストや2-3人での一時的な使用にのみ適しています)
• ストレージの推奨：大量の文書や添付ファイルを保存する必要がある場合は、後の拡張のトラブルを避けるために、50GB以上のディスク容量を確保することをお勧めします。

2.ソフトウェア環境要件

• オペレーティングシステム：Linuxカーネル3.10以上、推奨Ubuntu 20.04+/CentOS 7+ (x86_64アーキテクチャ、ARMアーキテクチャは当面サポートされていません)
• カーネルへの依存: Docker 20.10.x以上 + Docker Compose v2.x以上
• ネットワーク条件: Dockerイメージとプロジェクト依存パッケージをプルするために、サーバがインターネットにアクセスできる必要があります。

3.事前検査ポイント

サーバにログイン後、デプロイの穴を踏まないように、まず以下のコマンドを実行して環境を確認する：

# Dockerのバージョンを確認する(20.10.x以上である必要がある)
docker --バージョン
# Docker Composeのバージョンを確認する (≥v2.x)
docker compose バージョン
# サーバのアーキテクチャを確認する (x86_64を返す必要がある)
uname -m

Dockerがインストールされていないか、バージョンが低すぎる場合は、まず環境設定を完了させる必要がある（詳細なインストール手順は以下に添付）。

ステップバイステップのデプロイプロセス: 環境設定からシステム起動まで

1.DockerとDocker Composeのインストール（初心者は必須）

Ubuntuシステムを例にして、以下のコマンドを実行し、ワンクリック、コピー＆ペーストで環境のインストールを完了します：

# 1.依存関係の衝突を避けるため、システムパッケージを更新する。
sudo apt-get update && sudo apt-get upgrade -y

# 2.必要なDocker依存パッケージをインストールする。
sudo apt-get install -y apt-transport-https ca-certificates curl software-properties-common # 2.必要なDocker依存パッケージをインストールする。

# 3. Dockerの公式GPGキーを追加して、インストールパッケージを安全にします。
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo apt-key add - # 3.

# 4. ダウンロード速度を上げるために国内のDockerリポジトリを追加する
sudo add-apt-repository "deb [arch=amd64] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable"

# Docker Engineのコアコンポーネントをインストールする。
sudo apt-get update && sudo apt-get install -y docker-ce docker-ce-cli containerd.io # 5.

# 6.Dockerサービスを起動し、起動時に開始するように設定する。
sudo systemctl enable --now docker

# 7. ミラーのプーリングが遅い問題を解決するために、国内のミラーアクセラレーションを設定する
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"].
}
EOF
sudo systemctl daemon-reload && sudo systemctl restart docker

# Docker Compose (v2.xバージョン)をインストールする。
sudo curl -L "https://github.com/docker/compose/releases/download/v2.27.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

CentOSユーザーは、対応するyumコマンドを同じコア手順で置き換えることができ、Dockerサービスが正しく起動することを確認することに集中できる。

2. 2つのデプロイ方法：初心者向けワンクリックインストール vs 手動カスタムデプロイ

方法1：ワンクリックインストール（初心者にお勧め、完了まで10分）

手動でファイルを設定する必要はなく、コマンドを実行するだけですべての操作が自動的に完了します：

# root 権限を切り替える (権限不足によるデプロイの失敗を避けるため)
sudo -i

# 公式ワンクリックデプロイスクリプトを実行する
bash -c "$(curl -fsSLk https://release.baizhi.cloud/panda-wiki/manager.sh)"

実行し、ターミナルのプロンプトに従ってください：

1. 1」を入力して「インストール」オプションを選択する；
2. デフォルトのポート（2443）を変更する必要はない；
3. 5～10分（サーバーのネットワーク速度による）待つと、自動的にイメージが取り込まれ、データベースが設定される；
4. SUCCESS（成功）」のプロンプトが表示されたら、つまり配備が完了したら、端末の出力アクセスアドレス、ユーザー名（admin）、デフォルトのパスワードを記録する。

モード 2: 手動展開 (カスタマイズが必要なユーザーに適しています)

ポートの変更やストレージパスのカスタマイズが必要なユーザーに適しています：

# 1.PandaWikiのソースコードをサーバーにクローンします。
git clone https://gitcode.com/gh_mirrors/pa/PandaWiki.git
cd PandaWiki

# 2. docker-compose.yml設定ファイルを作成・編集します。
vim docker-compose.yml

以下の基本設定内容を貼り付けます (ポートやストレージパスは必要に応じて変更してください)

バージョン: '3
services.
  api.
    build: .
      /backend: ./バックエンド
      dockerfile: Dockerfile.api
    ports.
      - "2443:8080" # 左側の2443は外部ポートで、カスタマイズ可能。
    ボリューム: .
      - ./data:/app/data # データストアへのパス、デフォルトのままを推奨。
    depends_on: .
      - postgres
    再起動: 常に

  postgres:14
    image: postgres:14
    postgres の再起動: 常に postgres: image: postgres:14
      POSTGRES_USER: panda
      POSTGRES_PASSWORD: panda123
      POSTGRES_DB: panda_wiki
    ボリューム: panda_wiki
      - ./pgdata:/var/lib/postgresql/data
    再起動：常に

設定を保存した後、startコマンドを実行する：

# サービスの構築と起動
docker compose up -d
# スタートアップの状態を確認し、すべてのサービスが稼働していることを確認する
docker compose ps

3.システムへのアクセスと初期化

1. ブラウザを開き、配備完了後に表示されるアクセスアドレスを入力する（形式：http://服务器IP:2443）；
2. 端末に表示されたデフォルトのユーザー名adminとパスワードを入力し、初回ログイン時のパスワードを変更する（セキュリティ強化のため、大文字と小文字、数字を含めることを推奨）；
3. システムに入ったら、まず基本設定を行う：サイト名の設定、ロゴのアップロード、タイムゾーンの設定（デフォルトはUTC、アジア/上海への変更を推奨）。

第三に、配備後に行う必要があります：基本的な設定とセキュリティの強化

1.コア構成の最適化

• ストレージ構成：データ保存経路が正しいかどうかを確認し、容量不足によるサービス異常を回避するため、十分なディスク容量を確保する；
• ポート保護：サーバーが外部ネットワークに露出している場合、ファイアウォールでポート2443へのアクセスを制限し、内部IPアクセスのみを許可することを推奨；
• AI機能の設定：「システム設定」-「AIモデル」を開き、白紫雲や同伊乾乾などの大型モデルのAPIをドッキングさせ、AI作成機能とAI検索機能をアンロックする。

2.セキュリティ設定のポイント

• パスワード変更：弱いパスワードがクラックされるのを防ぐため、初回ログイン後すぐにデフォルトパスワードを変更する；
• 権限管理：スタッフ全員が管理者権限を持つことを避けるため、異なる役割のアカウント（編集者、読者）を作成し、チームのニーズに応じて権限を割り当てる；
• バックアップ戦略：データディレクトリの定期的なバックアップ（./dataと./pgdata)を定期的にバックアップし、データの損失を防ぐために自動的にバックアップするスクリプトを設定することができます。

第四に、一般的な問題：ピットの展開を解決するために

1.展開スクリプトの実行の失敗

• 原因：ネットワークのタイムアウト、または権限不足；
• 解決策：root権限に切り替えてスクリプトを再実行する。 イメージの取得に時間がかかる場合は、Dockerイメージの高速化設定が有効かどうかを確認する。

2.ブラウザがシステムにアクセスできない

• 原因：ポートが開いていないか、サービスが開始されていない；
• 解決方法
  1. docker compose psを実行し、apiサービスが起動しているか確認する；
  2. ポート2443を開く：Ubuntuはsudo ufw allow 2443を実行し、CentOSはsudo firewall-cmd --permanent --add-port=2443/tcp && sudo firewall-cmd --reloadを実行する；
  3. サーバーのセキュリティグループがポート2443を解放しているか確認してください（クラウドサーバーはコンソールで設定する必要があります）。

3.ログイン時のパスワードが間違っている

• 問題原因：デフォルトのパスワードが誤って記録されている；
• 解決策:docker compose logs api を実行してログを表示し、”password” を含む行を見つけて、正しいデフォルトのパスワードを取得する。

4.サービス起動後に頻繁にクラッシュする

• 問題原因：サーバーのメモリ不足（1コア2GB構成でよく見られる）；
• 解決策：サーバーのメモリーを4GB以上にアップグレードするか、メモリーを消費する他のサービスを終了してシステム負荷を軽減します。

V. 日常保守：アップグレードとバックアップガイド

1.バージョンアップ

PandaWikiのオープンソースのバージョンは頻繁に繰り返し、アップグレードの手順は次のとおりです：

# プロジェクトディレクトリに入る
cd PandaWiki
# 最新のソースコードをプルする
git pull
# サービスの再構築と起動
docker compose down && docker compose up -d

2.データのバックアップとリカバリー

• バックアップ：データディレクトリを直接パックするだけで、コマンド：tar -zcvf panda_backup.tar.gz ./data ./pgdata；
• リストア：バックアップファイルを新しいサーバーにアップロードし、PandaWikiディレクトリに解凍し、docker compose up -dを実行します。

上記の手順に従って、PandaWikiオープンソース版を安定的に実行し、AI主導のインテリジェントな知識ベースサービスをお楽しみください。内部システム（NailやFlybookなど）や二次開発をドッキングさせる必要がある場合は、公式ドキュメントを参照して設定を進めてください。