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