164 lines
3.2 KiB
Markdown
164 lines
3.2 KiB
Markdown
# 🏠 ローカルホストデプロイメント
|
|
|
|
開発と個人利用のため、ローカルマシンで9Routerを実行。
|
|
|
|
---
|
|
|
|
## 📦 インストール
|
|
|
|
npm経由で9Routerをグローバルインストール:
|
|
|
|
```bash
|
|
npm install -g 9router
|
|
```
|
|
|
|
**要件:**
|
|
- Node.js 20以上
|
|
- npm 9以上
|
|
|
|
---
|
|
|
|
## 🚀 サーバーの起動
|
|
|
|
一つのコマンドで9Routerを起動:
|
|
|
|
```bash
|
|
9router
|
|
```
|
|
|
|
ダッシュボードが自動的にブラウザで `http://localhost:3000` に開きます。
|
|
|
|
**デフォルト設定:**
|
|
- **ダッシュボード**: `http://localhost:3000`
|
|
- **APIエンドポイント**: `http://localhost:20128/v1`
|
|
- **データディレクトリ**: `~/.9router`
|
|
|
|
---
|
|
|
|
## 🔧 設定
|
|
|
|
### カスタムデータディレクトリ
|
|
|
|
環境変数を使ってカスタムデータディレクトリを設定:
|
|
|
|
```bash
|
|
DATA_DIR=/path/to/data 9router
|
|
```
|
|
|
|
### カスタムポート
|
|
|
|
APIポート(20128)とダッシュボードポート(3000)はアプリケーションで設定されています。変更するにはソースコードを修正するか、サポートされている場合は環境変数を使用してください。
|
|
|
|
---
|
|
|
|
## 🛑 サーバーの停止
|
|
|
|
9Routerが実行されているターミナルで `Ctrl+C` を押します。
|
|
|
|
```bash
|
|
# 9routerを実行しているターミナル
|
|
^C # Ctrl+Cを押す
|
|
```
|
|
|
|
サーバーはグレースフルにシャットダウンし、すべてのデータを保存します。
|
|
|
|
---
|
|
|
|
## 🔄 サーバーの再起動
|
|
|
|
起動コマンドを再度実行するだけです:
|
|
|
|
```bash
|
|
9router
|
|
```
|
|
|
|
すべての設定、APIキー、コンボはデータディレクトリに保持されます。
|
|
|
|
---
|
|
|
|
## 📊 9Routerの更新
|
|
|
|
最新バージョンに更新:
|
|
|
|
```bash
|
|
npm update -g 9router
|
|
```
|
|
|
|
現在のバージョンを確認:
|
|
|
|
```bash
|
|
npm list -g 9router
|
|
```
|
|
|
|
---
|
|
|
|
## 🔍 トラブルシューティング
|
|
|
|
### ポートがすでに使用されている
|
|
|
|
ポート20128または3000がすでに使用されている場合:
|
|
|
|
```bash
|
|
# ポートを使用しているプロセスを検索 (macOS/Linux)
|
|
lsof -i :20128
|
|
lsof -i :3000
|
|
|
|
# プロセスを終了
|
|
kill -9 <PID>
|
|
```
|
|
|
|
### 権限エラー
|
|
|
|
インストール中に権限エラーが発生した場合:
|
|
|
|
```bash
|
|
# sudoを使用 (非推奨)
|
|
sudo npm install -g 9router
|
|
|
|
# またはnpm権限を修正 (推奨)
|
|
mkdir ~/.npm-global
|
|
npm config set prefix '~/.npm-global'
|
|
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
|
|
source ~/.bashrc
|
|
```
|
|
|
|
### データディレクトリの問題
|
|
|
|
データディレクトリにアクセスできない場合:
|
|
|
|
```bash
|
|
# 権限を確認
|
|
ls -la ~/.9router
|
|
|
|
# 権限を修正
|
|
chmod 755 ~/.9router
|
|
```
|
|
|
|
---
|
|
|
|
## 📁 データディレクトリ構造
|
|
|
|
```
|
|
~/.9router/
|
|
├── db.json # メインデータベース (プロバイダー、コンボ、設定)
|
|
├── logs/ # アプリケーションログ
|
|
└── cache/ # 一時キャッシュファイル
|
|
```
|
|
|
|
**データのバックアップ:**
|
|
|
|
```bash
|
|
# バックアップ
|
|
cp -r ~/.9router ~/.9router.backup
|
|
|
|
# 復元
|
|
cp -r ~/.9router.backup ~/.9router
|
|
```
|
|
|
|
---
|
|
|
|
## 🔗 次のステップ
|
|
|
|
- [プロバイダーを接続](/providers/subscription.md)
|
|
- [コンボを作成](/features/combos.md)
|
|
- [CLIツールとの統合](/integration/cursor.md)
|