# よくある質問 > GEO Wiki Pro 使用中に発生する問題をクイックに解決 --- ## 🔧 インストールとデプロイ ### Q: GEO Wiki Pro をインストールするには？ **A:** 2 つのインストール方法があります： **方法 1：Docker デプロイ（推奨）** ```bash # コードをクローン git clone https://github.com/your-org/geo-wiki-pro.git cd geo-wiki-pro # 環境変数を設定 cp .env.example .env # .env を編集し、JWT_SECRET を設定（少なくとも 32 文字） # サービスを起動 docker-compose up -d # 確認 curl http://localhost:3002/api/v1/health ``` **方法 2：ローカル開発** ```bash # 依存関係をインストール npm install # フロントエンドとバックエンドを起動 npm run dev:full ``` ### Q: バオタパネルでデプロイするには？ **A:** [バオタデプロイガイド](/docs/baota-deployment) を参照してください。完全な Nginx 設定とよくある問題の解決策を含んでいます。 ### Q: Docker デプロイ後にアクセスできない？ **A:** 以下を確認してください： 1. **ポートマッピング**：`docker-compose.yml` のポートマッピングが正しいことを確認 2. **.env 設定**：`JWT_SECRET` が設定され、長さ >= 32 であることを確認 3. **ログ確認**：`docker compose logs api` でエラーメッセージを確認 4. **ファイアウォール**：ポートがファイアウォールでブロックされていないことを確認 --- ## 🌐 多言語 ### Q: 新しい言語を追加するには？ **A:** 以下の手順に従ってください： 1. 翻訳ファイル `src/i18n/{lang}.json` を作成 2. `src/utils/i18n.js` で新しい言語を登録 3. `data/docs/{lang}/` ディレクトリにドキュメントを作成 4. CLI を使用：`geo doc create --file doc.md --lang {lang}` ### Q: 異なる言語のドキュメントはどのように同期しますか？ **A:** GEO Wiki Pro はカスケードマージメカニズムを使用： - 中国語 (zh) はベース言語 - 他の言語をクエリする際、まず中国語ドキュメントをベースとして読み込み、ターゲット言語でオーバーレイ - `category`、`tags`、`author`、`sort` は共有フィールドで、すべての言語バージョンに自動同期 - `title`、`description`、`content` は独立フィールドで、言語ごとに異なる --- ## 📝 ドキュメント管理 ### Q: CLI を通じてドキュメントを管理するには？ **A:** `geo` コマンドラインツールを使用： ```bash # インストール npm install -g geowiki-cli # ログイン geo login --url https://geowiki.pro # ドキュメント作成 geo doc create --file article.md --category support --sort 1 # ドキュメント更新 geo doc update --slug my-doc --file updated.md --lang zh # ドキュメント削除 geo doc delete --slug old-doc # ドキュメント一覧 geo doc list --category support ``` ### Q: スラッグとは？どう選びますか？ **A:** スラッグはドキュメントの URL 識別子です。ルール： - 英数字、ハイフン、アンダースコアのみ - 最大 200 文字 - 英語小文字とハイフンを使用することを推奨 - 例：`docker-deployment`、`faq`、`rest-api` --- ## 🎨 Markdown 拡張 ### Q: どのような拡張構文がサポートされていますか？ **A:** GEO Wiki Pro は以下の拡張構文をサポート： | 構文 | 説明 | 例 | |------|------|-----| | `:::video[説明](url)` | 動画埋め込み | `:::video[デモ動画](https://bilibili.com/...)` | | `:::model[タイトル](url)` | 3D モデルカード | `:::model[製品モデル](/media/model.step)` | | `::: note` / `::: tip` / `::: warning` | コールアウト | 情報、ヒップ、警告 | | `::: faq` | FAQ ブロック | Q&A 形式 | | `` | 画像（alt がキャプションに） | `` | | `[名前](url)` | ファイルダウンロードカード | `[ユーザーマニュアル](/media/manual.pdf)` | --- ## 🔒 セキュリティ ### Q: 管理ダッシュボードを保護するには？ **A:** 複数のセキュリティレイヤー： 1. **JWT 認証**：httpOnly cookie、2 時間で期限切れ 2. **CSRF 保護**：Double-submit cookie HMAC 3. **CSP ポリシー**：Helmet nonce ベースの Content Security Policy 4. **レート制限**：グローバル 300/分、認証 10/分 5. **パスワード暗号化**：bcrypt ストレージ 6. **初回ログイン時パスワード変更を強制** --- ## 📡 API ### Q: API 認証はどのように機能しますか？ **A:** JWT cookie 認証： ```bash # ログインしてトークンを取得 curl -X POST "https://geowiki.pro/api/v1/auth/login" \ -H "Content-Type: application/json" \ -d '{"username": "admin", "password": "your-password"}' \ -c cookies.txt # トークンを使用して管理エンドポイントにアクセス curl "https://geowiki.pro/api/v1/admin/docs" \ -b cookies.txt ``` ### Q: 公開エンドポイントには認証が必要ですか？ **A:** いいえ。以下のエンドポイントは完全に公開： - `GET /api/v1/docs` — ドキュメントリスト - `GET /api/v1/docs/:slug` — 単一ドキュメント - `GET /api/v1/docs/search` — 検索 - `GET /api/v1/categories` — カテゴリ - `GET /api/v1/tags` — タグ - `GET /api/v1/config` — サイト設定 - `GET /api/v1/llms.txt` — AI クローラーフィード - `GET /api/v1/geo/sitemap.xml` — サイトマップ --- ## 📚 その他のリソース - [クイックスタート](/docs/cli-quick-reference) - [Docker デプロイ](/docs/docker-deployment) - [REST API ドキュメント](/docs/rest-api) - [Markdown 拡張構文](/docs/markdown-extensions) --- *最終更新: 2026-06-06 | バージョン: v3.0.2*