# CLI インストールとログイン GEO Wiki Pro はコマンドラインツール `geo` を提供し、ナレッジベースのドキュメント、カテゴリ、タグ、ユーザーなどを管理します。このドキュメントではインストールとログイン方法を説明します。 ## インストール ### 必要要件 - Node.js >= 18 - npm >= 9 ### グローバルインストール ```bash npm install -g geowiki-cli ``` インストール完了後に確認： ```bash geo --version geo --help ``` ### 権限問題 権限エラーが発生した場合は、次の方法で解決： ```bash # 方法 1：sudo を使用 sudo npm install -g geowiki-cli # 方法 2：npm グローバルディレクトリを変更 mkdir ~/.npm-global npm config set prefix '~/.npm-global' export PATH=~/.npm-global/bin:$PATH npm install -g geowiki-cli ``` ## ログイン CLI は 2つのログイン方法をサポート：トークンログイン（推奨）とパスワードログイン。 ### トークンログイン（推奨） ```bash geo login --url https://geowiki.pro --token geo_xxxxx ``` | パラメータ | 短縮形 | 説明 | 必須 | |-----------|--------|------|------| | `--url` | `-u` | サーバーアドレス | はい | | `--token` | `-t` | API トークン | はい | ::: tip トークンログインはキャプチャ不要で、CLI や自動化スクリプトに適しています。トークンの有効期限は 90 日で、管理パネルの「設定 -> API トークン」で生成できます。 ::: ### パスワードログイン ```bash geo login --url https://geowiki.pro --user admin --pass your-password ``` | パラメータ | 短縮形 | 説明 | 必須 | |-----------|--------|------|------| | `--url` | `-u` | サーバーアドレス | はい | | `--user` | `-U` | ユーザー名 | はい | | `--pass` | `-p` | パスワード | はい | ::: warning パスワードログインにはキャプチャ認証が必要で、ブラウザシナリオに適しています。トークンログインを推奨します。 ::: ## ログインステータス 現在の接続ステータスを表示： ```bash geo status ``` ログイン成功後、トークンは自動的にローカル設定ファイル（`~/.geowiki/config.json`）に保存され、後続のコマンドは自動的に認証情報を含みます。 ローカル資格情報をクリアしてログアウト： ```bash geo logout ``` ## よくある問題 ::: faq **Q: インストール後に `geo` コマンドが見つからない？** npm グローバル bin ディレクトリがシステム PATH に含まれていることを確認してください。`npm config get prefix` を実行してグローバルディレクトリパスを確認できます。 **Q: トークンが期限切れになった場合は？** 管理パネルの「設定 -> API トークン」で新しいトークンを生成し、`geo login --url ... --token <new-token>` を実行して再ログインしてください。 **Q: 現在ログインしているユーザーを確認するには？** `geo status` を実行して、現在のサーバー接続情報とユーザー情報を確認できます。 ::: ## 次のステップ インストールとログイン完成后，请参照： - [CLI クイックリファレンス](/docs/cli-quick-reference) — よく使うコマンドをクイックにマスター - [CLI コマンドリファレンス](/docs/cli-reference) — すべてのコマンドパラメータの詳細