mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-04-21 19:53:42 +08:00
docs: restructure user manual for i18n and add EN/JA translations
Reorganize docs/user-manual/ from flat structure to language subdirectories (zh/, en/, ja/) with shared assets/. Move existing Chinese docs into zh/, fix image paths, add multilingual navigation README, and translate all 23 markdown files (~4500 lines each) to English and Japanese.
This commit is contained in:
Jason
222
docs/user-manual/ja/4-proxy/4.1-service.md
Normal file
222
docs/user-manual/ja/4-proxy/4.1-service.md
Normal file
@@ -0,0 +1,222 @@
|
||||
# 4.1 プロキシサービス
|
||||
|
||||
## 機能説明
|
||||
|
||||
プロキシサービスは、ローカルで HTTP プロキシを起動し、すべての API リクエストをプロキシ経由で転送します。
|
||||
|
||||
**主な用途**：
|
||||
- リクエストログの記録
|
||||
- API 使用量の統計
|
||||
- フェイルオーバーのサポート
|
||||
- 複数アプリのリクエストを一元管理
|
||||
|
||||
## プロキシの起動
|
||||
|
||||
### 方法 1：メイン画面のスイッチ
|
||||
|
||||
メイン画面上部の **プロキシスイッチ** ボタンをクリックします。
|
||||
|
||||
スイッチの状態：
|
||||
- 白：プロキシ停止中
|
||||
- 緑：プロキシ実行中
|
||||
|
||||
|
||||
|
||||
### 方法 2：設定ページ
|
||||
|
||||
1. 「設定 → 詳細 → プロキシサービス」を開く
|
||||
2. 右上のスイッチをクリック
|
||||
|
||||
|
||||
|
||||
## プロキシ設定
|
||||
|
||||
### 基本設定
|
||||
|
||||
| 設定項目 | 説明 | デフォルト値 |
|
||||
|--------|------|--------|
|
||||
| リスニングアドレス | プロキシがバインドする IP アドレス | `127.0.0.1` |
|
||||
| リスニングポート | プロキシがリスニングするポート | `15721` |
|
||||
| ログを有効化 | リクエストログを記録するかどうか | オン |
|
||||
|
||||
### 設定の変更
|
||||
|
||||
1. **プロキシサービスを停止**（先に停止する必要あり）
|
||||
2. リスニングアドレスまたはポートを変更
|
||||
3. 「保存」をクリック
|
||||
4. プロキシを再起動
|
||||
|
||||
> アドレス/ポートの変更には、先にプロキシサービスの停止が必要です
|
||||
|
||||
### リスニングアドレスの説明
|
||||
|
||||
| アドレス | 説明 |
|
||||
|------|------|
|
||||
| `127.0.0.1` | ローカルマシンのみアクセス可能（推奨） |
|
||||
| `0.0.0.0` | LAN からのアクセスを許可 |
|
||||
|
||||
## 実行状態
|
||||
|
||||
プロキシ実行中、パネルには以下の情報が表示されます：
|
||||
|
||||
### サービスアドレス
|
||||
|
||||
```
|
||||
http://127.0.0.1:15721
|
||||
```
|
||||
|
||||
「コピー」ボタンでアドレスをコピーできます。
|
||||
|
||||
### 現在のプロバイダー
|
||||
|
||||
各アプリが現在使用しているプロバイダーを表示：
|
||||
|
||||
```
|
||||
Claude: PackyCode
|
||||
Codex: AIGoCode
|
||||
Gemini: Google 公式
|
||||
```
|
||||
|
||||
### 統計データ
|
||||
|
||||
| 指標 | 説明 |
|
||||
|------|------|
|
||||
| アクティブ接続 | 現在処理中のリクエスト数 |
|
||||
| 総リクエスト数 | 起動以来の総リクエスト数 |
|
||||
| 成功率 | リクエスト成功の割合（>90% 緑、≤90% 黄） |
|
||||
| 実行時間 | プロキシの稼働時間 |
|
||||
|
||||
### フェイルオーバーキュー
|
||||
|
||||
プロキシパネルにはアプリタイプごとにフェイルオーバーキューが表示されます：
|
||||
|
||||
```
|
||||
Claude
|
||||
├── 1. PackyCode [使用中] ●
|
||||
├── 2. AIGoCode ●
|
||||
└── 3. バックアップ ○
|
||||
|
||||
Codex
|
||||
├── 1. AIGoCode [使用中] ●
|
||||
└── 2. バックアップ ●
|
||||
```
|
||||
|
||||
キューの説明：
|
||||
- 数字は優先順位を示す
|
||||
- 「使用中」ラベルは現在使用しているプロバイダーを示す
|
||||
- ヘルスバッジはプロバイダーの状態を示す：
|
||||
- 緑：健康（連続失敗 0 回）
|
||||
- 黄：低下（連続失敗 1-2 回）
|
||||
- 赤：不健康（連続失敗 ≥3 回）
|
||||
|
||||
## 動作原理
|
||||
|
||||
### リクエストフロー
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant CLI as CLI ツール (Claude)
|
||||
participant Proxy as ローカルプロキシ (CC Switch)
|
||||
participant API as API プロバイダー (Anthropic)
|
||||
participant DB as データストレージ (Logger)
|
||||
|
||||
CLI->>Proxy: API リクエストを送信
|
||||
Proxy->>DB: リクエストログの記録/使用量の統計
|
||||
Proxy->>API: リクエストを転送
|
||||
API-->>Proxy: レスポンスを返却
|
||||
Proxy-->>CLI: レスポンスを返却
|
||||
```
|
||||
|
||||
### 設定の変更
|
||||
|
||||
プロキシを起動してアプリケーション接管を有効にすると、CC Switch はアプリの設定を変更します：
|
||||
|
||||
**Claude**：
|
||||
```json
|
||||
{
|
||||
"env": {
|
||||
"ANTHROPIC_BASE_URL": "http://127.0.0.1:15721"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Codex**：
|
||||
```toml
|
||||
base_url = "http://127.0.0.1:15721/v1"
|
||||
```
|
||||
|
||||
**Gemini**：
|
||||
```
|
||||
GOOGLE_GEMINI_BASE_URL=http://127.0.0.1:15721
|
||||
```
|
||||
|
||||
## プロキシの停止
|
||||
|
||||
### 方法 1：メイン画面のスイッチ
|
||||
|
||||
プロキシスイッチボタンをクリックしてオフにします。
|
||||
|
||||
### 方法 2：設定ページ
|
||||
|
||||
プロキシサービスパネルでスイッチをオフにします。
|
||||
|
||||
### 停止後の処理
|
||||
|
||||
プロキシの停止時、CC Switch は以下を実行します：
|
||||
|
||||
1. アプリの設定を元の状態に復元
|
||||
2. リクエストログを保存
|
||||
3. すべての接続を閉じる
|
||||
|
||||
## ログ記録
|
||||
|
||||
### ログの有効化
|
||||
|
||||
プロキシパネルの「ログを有効化」スイッチをオンにします。
|
||||
|
||||
### ログの内容
|
||||
|
||||
各リクエスト記録には以下が含まれます：
|
||||
|
||||
| フィールド | 説明 |
|
||||
|------|------|
|
||||
| 時間 | リクエスト時刻 |
|
||||
| アプリ | Claude / Codex / Gemini |
|
||||
| プロバイダー | 使用されたプロバイダー |
|
||||
| モデル | リクエストされたモデル |
|
||||
| Token | 入力/出力の Token 数 |
|
||||
| レイテンシ | リクエストにかかった時間 |
|
||||
| ステータス | 成功/失敗 |
|
||||
|
||||
### ログの表示
|
||||
|
||||
「設定 → 使用量」タブでリクエストログを表示できます。
|
||||
|
||||
## よくある質問
|
||||
|
||||
### ポートが使用中
|
||||
|
||||
エラーメッセージ：`Address already in use`
|
||||
|
||||
解決方法：
|
||||
1. ポートを変更する（例：5001）
|
||||
2. またはそのポートを使用しているプログラムを終了する
|
||||
|
||||
### プロキシの起動に失敗する
|
||||
|
||||
確認事項：
|
||||
- ポートが使用中でないか
|
||||
- 十分な権限があるか
|
||||
- ファイアウォールがブロックしていないか
|
||||
|
||||
### リクエストがタイムアウトする
|
||||
|
||||
考えられる原因：
|
||||
- ネットワークの問題
|
||||
- プロバイダーのサーバーの問題
|
||||
- プロキシ設定のエラー
|
||||
|
||||
解決方法：
|
||||
- ネットワーク接続を確認
|
||||
- プロバイダーの API に直接アクセスを試みる
|
||||
- プロバイダーの設定を確認
|
||||
Reference in New Issue
Block a user