MochiuWiki : SUSE, EC, PCB - 利用者の投稿記録 [ja]

インストール - Bun

2026-04-11T15:18:33Z

Wiki: /* 任意のディレクトリへのインストール */

== 概要 ==
Bunは、Oven Inc.のJarred Sumnerによって開発された、高速なJavaScript / TypeScriptランタイムである。 
Zig言語で記述されており、JavaScriptCore (Safariのエンジン) を採用することにより、V8ベースのNode.jsより大幅に速い起動時間と低いメモリ使用量を実現している。 
 
Bunの最大の特徴は、ランタイム・パッケージマネージャー・バンドラー・テストランナーの4つの機能を単一バイナリに統合している点である。 
従来のJavaScriptエコシステムで必要だったNode.js + npm / Yarn + webpack / esbuild + Jestという複数ツールの組み合わせを、Bun単体で置き換えることができる。 
 
Node.jsとの互換性を設計目標としており、fs、path、http 等の組み込みモジュールやnpmレジストリからのパッケージをそのまま利用できる。 
TypeScriptおよびJSX / TSXはネイティブにサポートされており、追加のトランスパイラ設定なしで直接実行可能である。 
 
プロジェクトの要件、チームの慣習、パフォーマンスの要求に応じて、npm・Yarn・pnpmとの使い分けを検討することが重要である。 
 

== Bun ==
Bunは公式インストールスクリプトによりひとつのコマンドでセットアップできる。 
Linux上ではGLIBC 2.17以上の環境 (glibcビルド) と musl libc環境 (Alpine等) 向けに別のビルドが提供されている。 
 
==== Bunのインストール ====
Bunには以下のインストール方法が存在する。 
* 公式インストールスクリプトを使用したインストール (推奨)
*: 最も簡単な方法であり、システムを自動検出して適切なバイナリをダウンロードする。
*: 
* 任意のディレクトリへのインストール
*: 環境変数 <code>BUN_INSTALL</code> を指定することで、インストール先を自由に変更できる。
 
環境や要件に応じて、適切なインストール方法を選択する。 
 
===== 前提条件の確認 =====
インストールの前に、Linuxカーネルのバージョンとゲプロセッサーの機能拡張を確認する。 
 
カーネルバージョンを確認する。 
uname -r
 
カーネルバージョン5.6以上を推奨する。(最低要件は5.1) 
5.1未満の環境ではBunは動作しない。 
 
CPUのAVX2サポートを確認する。 
grep -o 'avx2' /proc/cpuinfo | head -1
 
確認結果の解釈は以下の通りである。 
* avx2 と表示される場合
*: 標準ビルドを使用できる。
*: 
* 何も表示されない場合
*: SSE4.2のみを必要とするベースラインビルドを使用する。
===== 依存パッケージのインストール =====
インストールスクリプトの実行には unzip と curl が必要である。 
 
# RHEL
sudo dnf install unzip curl

# SUSE
sudo zypper install unzip curl
 
===== 公式インストールスクリプトを使用したインストール =====
公式のcurlスクリプトを使用する方法が推奨される。 
このスクリプトはシステムを自動検出して適切なバイナリをダウンロードし、デフォルトでは ~/.bun/ ディレクトリ内に配置する。 
 
インストールスクリプトを実行する。 
curl -fsSL https://bun.com/install | bash
 
インストール後のディレクトリ構成は以下の通りである。 
~/.bun/
├── bin/
│ └── bun # 実行バイナリ
└── install/
└── cache/ # パッケージキャッシュ
 
CPUがAVX2に対応していない場合、"Illegal Instruction" エラーが発生することがある。 
その場合は以下に示すコマンドを実行して、ベースラインビルドをインストールする。 
curl -fsSL https://bun.com/install | bash -s -- --baseline
 
===== 任意のディレクトリへのインストール =====
インストール先ディレクトリを変更したい場合は、環境変数 <code>BUN_INSTALL</code> を事前に設定することで実現できる。 
この方法は公式インストールスクリプトが正式にサポートしている。 
 
<code>BUN_INSTALL</code> に指定したパスの下に bin/ サブディレクトリが作成され、bunバイナリが配置される。 
 
任意のディレクトリを指定してインストールスクリプトを実行する。 
<syntaxhighlight lang="sh">
# 任意のディレクトリを指定して実行
export BUN_INSTALL="/opt/bun"
curl -fsSL https://bun.com/install | bash

# または1行で実行する場合
BUN_INSTALL="/opt/bun" curl -fsSL https://bun.com/install | bash
</syntaxhighlight>
 
以下に代表的なインストール先の例を示す。 
<syntaxhighlight lang="sh">
# ユーザ専用ディレクトリへのインストール例
BUN_INSTALL="$HOME/.local/bun" curl -fsSL https://bun.com/install | bash

# システム共有ディレクトリへのインストール例 (root権限が必要)
sudo BUN_INSTALL="/usr/local/bun" curl -fsSL https://bun.com/install | bash
</syntaxhighlight>
 
<code>BUN_INSTALL</code> はインストール時のみ参照される環境変数であり、インストール完了後はPATHの設定で同じディレクトリを指定することが必要である。 
 

===== PATHの設定 =====
インストールスクリプトは自動でPATHを追記するが、反映されない場合は手動で設定する。 
 
<syntaxhighlight lang="sh">
# ~/.profileファイル等

# デフォルトディレクトリの場合
export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"

# 任意のディレクトリ (例：/opt/bun) を指定した場合
export BUN_INSTALL="/opt/bun"
export PATH="$BUN_INSTALL/bin:$PATH"
</syntaxhighlight>
 
===== RHELでの注意 =====
RHELでは、シェル設定の管理に ~/.bashrc.d/ ディレクトリが活用されている。 
インストールスクリプトが ~/.bashrc を直接書き換えた場合、PATH設定が重複することがある。 
 
そのため、設定を分離して管理することを推奨する。 
 
# .bashrc.d ディレクトリを作成 (存在しない場合)
mkdir -p ~/.bashrc.d
 
<syntaxhighlight lang="sh">
# ~/.bashrc.d/bun.sh ファイルを作成する

export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"
</syntaxhighlight>
 
インストールが正常に完了したことを確認する。 
# バージョン番号を表示
bun --version

# 詳細なビルドリビジョンを表示
bun --revision
 
==== Bunの使用方法 ====
Bunのコマンド構文はnpmやYarnと高い互換性を持ち、既存の package.json ファイルをそのまま利用できる。 
 
新しいプロジェクトを初期化する時は、以下に示すコマンドを実行する。 
# 対話形式でpackage.jsonを作成
bun init

# デフォルト設定で初期化
bun init -y
 
package.json ファイルに記述された全ての依存関係をインストールする場合は、以下に示すコマンドを使用する。 
# 全ての依存関係をインストール
bun install
## または
bun i
 
新しいパッケージを追加する場合は、以下に示すコマンドを使用する。 
# 本番環境で必要な依存関係として追加
bun add <パッケージ名>

# 開発環境でのみ必要な依存関係として追加
bun add --dev <パッケージ名>
## または
bun add -D <パッケージ名>

# 特定のバージョンを指定して追加
bun add <パッケージ名>@<バージョン>

# グローバルにインストール
bun add -g <パッケージ名>
 
インストールされているパッケージを更新する。 
# 全てのパッケージを更新
bun update

# 特定のパッケージを更新
bun update <パッケージ名>
 
パッケージを削除する。 
bun remove <パッケージ名>
 
package.json ファイルに定義されているスクリプトを実行する。 
bun run <スクリプト名>

# 例: テストスクリプトを実行
bun test

# 例: ビルドスクリプトを実行
bun run build
 
==== bun.lockbファイル ====
Bunは、bun.lockb ファイルというバイナリ形式のロックファイルを使用して依存関係のバージョンを固定する。 
このファイルはnpmの package-lock.json や Yarnの yarn.lock に相当し、チーム全体で一貫した依存関係を保証するために重要である。 
 
bun.lockb ファイルの特徴を以下に示す。 
* インストールされた全てのパッケージの正確なバージョンを記録する。
* バイナリ形式のため、テキスト形式のロックファイルよりも解析が高速である。
* 異なる環境で同一の依存関係ツリーを再現できる。
 
bun.lockbファイルは自動生成されるため手動編集は不要であり、バージョン管理システムにコミットすることが推奨される。 
 
テキスト形式で内容を確認する場合は以下のコマンドを使用する。 
bun bun.lockb
 
==== Bunのキャッシュ管理 ====
Bunは、ダウンロードしたパッケージをグローバルキャッシュに保存することにより、インストール速度を向上させている。 
 
デフォルトのキャッシュパスは ~/.bun/install/cache であり、環境変数 <code>BUN_INSTALL_CACHE_DIR</code> で変更可能である。 
 
キャッシュに関連する操作を以下に示す。 
# キャッシュのパスを確認
echo $BUN_INSTALL_CACHE_DIR

# キャッシュをクリア
rm -rf ~/.bun/install/cache
 
bunfig.toml ファイルにキャッシュディレクトリを設定することもできる。 
<syntaxhighlight lang="toml">
# bunfig.toml

[install.cache]
# キャッシュディレクトリのパス
dir = "~/.bun/install/cache"
# trueの場合、グローバルキャッシュを使用しない
disable = false
# trueの場合、常にレジストリから最新バージョンを解決する
disableManifest = false
</syntaxhighlight>
 
==== Bunのアップデート ====
Bunは自身のコマンドでアップデートできる。 
 
# 安定版の最新リリースへアップデート
bun upgrade

# canary (開発最新) ビルドへアップデート
bun upgrade --canary

# canaryから安定版に戻す
bun upgrade --stable

# 特定のバージョンを指定してインストール
curl -fsSL https://bun.com/install | bash -s "bun-v1.x.y"
 
==== Bunのアンインストール ====
Bunはシステムへの影響が最小限であり、インストールディレクトリを削除するだけで完全にアンインストールできる。 
 
# デフォルトインストールの場合
rm -rf ~/.bun

# 任意ディレクトリへインストールした場合 (例：/opt/bun)
rm -rf /opt/bun
 
合わせて、~/.profile、~/.bashrc.d/bun.sh、~/.zprofile 等に追記したPATH設定の行を手動で削除する。 
 

== パッケージマネージャーの比較 ==
==== npm ====
npmは、Node.jsに標準で付属しており、追加のインストールが不要であることがメリットである。 
また、最も広く使用されているため、ドキュメントとコミュニティサポートが充実している。 
 
npm 7以降では、パフォーマンスが大幅に改善されており、ワークスペース機能もサポートされている。 
 
==== Yarn ====
Yarnは、並列インストールによる高速化と、yarn.lock ファイルによる確実な依存関係の固定が特徴である。 
Yarn Classicは、安定性と互換性を重視する場合に適している。 
 
Yarn Berryは、Plug'n'Play機能により、高速化とディスク効率の向上が図られている。 
 
ワークスペース機能がネイティブにサポートされており、モノレポ構成に適している。 
 
==== pnpm ====
pnpmは、コンテンツアドレサブルストレージとハードリンクを使用することで、ディスク使用量を大幅に削減できる点が最大の特徴である。 
また、厳密な依存関係の管理により、ゴーストディペンデンシーの問題を防ぐことができる。 
 
ワークスペース機能も優れており、モノレポ構成の管理が効率的に行える。 
 
==== Bun ====
Bunは、パッケージマネージャーとしても最速クラスの性能を発揮し、npmの最大30倍速いインストール速度が計測されている。 
ランタイム・バンドラー・テストランナーを一体化しているため、ツールチェーンを大幅に簡素化できる。 
 
Node.jsとの高い互換性を持つが、一部のネイティブアドオンパッケージでは互換性の問題が生じる場合があるため、事前の検証を推奨する。 
 
一般的に、Bunが最も高速なインストール速度を提供して、次いでpnpm、Yarn、npmの順となる。 
 
==== 移行時の注意 ====
既存プロジェクトのパッケージマネージャーを変更する場合は、以下に示す事柄に注意する。 
 
* ロックファイルの違い
*: npmは package-lock.json、Yarnは yarn.lock、pnpmは pnpm-lock.yaml、Bunは bun.lockb を使用する。
*: パッケージマネージャーを変更する場合は、古いロックファイルを削除して、新しいロックファイルを生成する必要がある。
*: 
* 統一されたツールを使用すること
*: 異なるパッケージマネージャーを混在させると、ロックファイルの不整合が発生する可能性がある。
*: package.json の <code>packageManager</code> フィールドに使用するツールを明記することを推奨する。
*: 
* CI/CD環境の設定を更新する
*: 各パッケージマネージャーに応じて、インストールコマンドとキャッシュの設定を適切に構成する必要がある。
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Bun,JavaScript,TypeScript,Runtime,Package Manager,RHEL,SUSE,Linux,Node.js,npm,Yarn,pnpm
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:PinePhone]][[カテゴリ:Web]]

OpenCodeの設定 - エージェントチーム

2026-04-10T11:09:56Z

Wiki: /* oh-my-opencodeのインストール */

== 概要 ==
OpenCodeは、Go言語で開発されたオープンソースのターミナルベースAIコーディングアシスタントツールである。 
Bubble Teaフレームワークによるターミナルユーザインターフェース (TUI) を実装しており、75以上のAIモデルをサポートする。 
 
OpenCodeには、プライマリエージェントとサブエージェントによる強力なエージェント機能が搭載されている。 
プライマリエージェントはタスクの種類に応じて[Tab]キーで切り替え、サブエージェントは <code>@メンション</code> で呼び出すことができる。 
 
oh-my-opencodeは、OpenCodeの機能を大幅に拡張するプラグインである。 
the best agent harness として設計されており、11個の専門化されたエージェント、44個のライフサイクルフック、26以上の組み込みツールを提供する。 
 
下表に、oh-my-opencodeが提供するエージェントチームの主な特徴を示す。 
 
<center>
{| class="wikitable"
|+ 組み込みワークフローエージェント一覧
|-
! エージェント名 !! 説明
|-
| Sisyphus || メイン調整役・オーケストレーター タスク完了まで実行継続し、中断後の自動再開をサポート
|-
| Hephaestus || ゴール指定での自律的な深掘り作業 コードベース全体をエンドツーエンドで完了
|-
| Prometheus || インタビューモードで十分なコンテキストを収集した上で専門エージェントに委譲
|-
| Librarian || ドキュメント管理とコード例・パターン発見に特化
|-
| Explore || 大規模コードベースのナビゲーションと依存関係分析に特化
|-
| Oracle || コンテキスト認識型の質問応答とトラブルシューティングに特化
|}
</center>
 

== OpenCodeのエージェント機能 ==
OpenCodeは、プライマリエージェントとサブエージェントの2種類のエージェントを提供する。 
 
==== プライマリエージェント ====
プライマリエージェントはOpenCodeの主要な動作モードを制御する。 
 
[Tab]キーで切り替えることができる。 
 
<center>
{| class="wikitable"
|+ エージェントモード一覧
|-
! エージェント名 !! 説明
|-
| rowspan="2" | build || デフォルトのエージェント 開発作業向けのフルツールアクセスが可能
|-
| コード編集、ファイル操作、コマンド実行など全ての操作を実行できる。
|-
| rowspan="2" | plan || 読み取り専用エージェント コード修正を行わずに分析・コード探索を行う。
|-
| コードベースの構造理解や実装方針の検討に使用する。
|}
</center>
 
==== サブエージェント ====
サブエージェントは、<code>@メンション</code> で呼び出すことができる。 
 
<center>
{| class="wikitable"
|+ サブエージェント一覧
|-
! エージェント名 !! 説明
|-
| general || 複雑な調査やマルチステップタスクを担当する汎用サブエージェント
|-
| explore || コードベース探索用の読み取り専用サブエージェント
|}
</center>
 
==== カスタムエージェントの定義 ====
カスタムエージェントは、opencode.json または ~/.config/opencode/agents/ 内のMarkdownファイルで定義できる。 
 
opencode.json ファイルによるカスタムエージェント定義の例を以下に示す。 
 
<syntaxhighlight lang="json">
{
"agents": {
"custom-agent": {
"mode": "subagent",
"model": "anthropic/claude-opus-4",
"tools": {
"edit": true,
"bash": false,
"view": true
},
"permission": {
"edit": "ask",
"bash": "deny"
},
"temperature": 0.7,
"prompt": "You are a specialized code reviewer focused on security."
}
}
}
</syntaxhighlight>
 
カスタムエージェントの管理には以下のコマンドを使用する。 
 
opencode agent create <エージェント名>
opencode agent list
 

== oh-my-opencodeのインストール ==
==== 前提条件 ====
oh-my-opencodeのインストールに必要な前提条件を以下に示す。 
 
* OpenCode 1.0.133以降
*: 以前のバージョンでは動作しない場合がある。
* Node.js最新バージョン
*: <code>bunx</code> または <code>npx</code> コマンドが利用可能であること
 
対応プラットフォームを以下に示す。 
 
* MacOS (ARM64, x64)
* Linux (x64, ARM64, Alpine/musl)
* Windows (x64)
 
==== インストール手順 ====
oh-my-opencodeのインストール手順を以下に示す。 
 
# OpenCodeをインストールする。
#: OpenCodeのインストールは、[[インストール - OpenCode]]のページを参照すること。
# oh-my-opencodeをインストールする。
#: <pre>bunx oh-my-opencode install</pre>
# OpenCodeを起動する。
#: <pre>opencode</pre>
 
oh-my-opencodeはシェルエイリアスやPATHではなく、OpenCodeのプラグインシステムとして動作している。 
 
oh-my-opencodeはOpenCodeのプラグインであり、単独のCLIではない。 
インストール時はplugin配列に追加され、設定ファイルが作成される。 
 
==== インストールオプション ====
<code>bunx oh-my-opencode install</code> には、各種AIプロバイダーの設定を同時に行うオプションが用意されている。 
 
bunx oh-my-opencode install --no-tui --claude=<yes|no|max20> --gemini=<yes|no> --copilot=<yes|no> --openai=<yes|no>
 
下表に、利用可能なオプションを示す。 
 
<center>
{| class="wikitable"
|+ インストールスクリプトのオプション一覧
|-
! オプション !! 説明
|-
| <code><nowiki>--claude=yes|no|max20</nowiki></code> || Claudeの認証設定を行う。 <code>max20</code> は、Claude Max (月20ドルプラン) を指定する。
|-
| <code><nowiki>--openai=yes|no</nowiki></code> || OpenAIの認証設定を行う。
|-
| <code><nowiki>--gemini=yes|no</nowiki></code> || Google Geminiの認証設定を行う。
|-
| <code><nowiki>--copilot=yes|no</nowiki></code> || GitHub Copilotの認証設定を行う。
|-
| <code><nowiki>--opencode-zen=yes|no</nowiki></code> || OpenCode Zenの設定を行う。
|-
| <code><nowiki>--zai-coding-plan=yes|no</nowiki></code> || Z.AIコーディングプランの設定を行う。
|-
| <code>--no-tui</code> || TUIを使用せず、対話なしでインストールを実行する。
|}
</center>
 
代替インストール方法を以下に示す。 
 
npm install -g oh-my-opencode
bun install -g oh-my-opencode
yarn global add oh-my-opencode
pnpm add -g oh-my-opencode
 

== oh-my-opencodeのアンインストール ==
==== OpenCodeの設定ファイルからプラグインを削除 ====
OpenCodeの設定ファイルを編集して、プラグインエントリを削除する。 
 
* 設定ファイルの場所
** MacOS / Linux
**: ~/.config/opencode/opencode.json
**: または
**: opencode.jsonc
** Windows
**: %USERPROFILE%\.config\opencode\opencode.json
**: または
**: opencode.jsonc
 
<center>
{| class="wikitable"
|+ 削除対象ファイル一覧
! 場所 !! ファイル !! 用途
|-
|OpenCode設定 || ~/.config/opencode/opencode.json または /<プロジェクトルート>/opencode.jsonc || plugin配列からエントリ削除
|-
|ユーザ設定 || ~/.config/opencode/oh-my-openagent.json[c] || ユーザプラグイン設定 (新名称)
|-
|ユーザ設定 || ~/.config/opencode/oh-my-opencode.json[c] || ユーザプラグイン設定 (旧名称)
|-
|プロジェクト設定 || .opencode/oh-my-openagent.json[c] || プロジェクトプラグイン設定 (新名称)
|-
|プロジェクト設定 || .opencode/oh-my-opencode.json[c] || プロジェクトプラグイン設定 (旧名称)
|}
</center>
 
設定ファイル内のplugin配列から oh-my-openagent または oh-my-opencode のエントリを削除する。 
 
==== 設定ファイルを削除 ====
プラグイン固有の設定ファイルを削除する。 
 
* ユーザ全体の設定ファイル
*: <syntaxhighlight lang="text">
# プラグイン設定ファイルを削除
rm -f ~/.config/opencode/oh-my-openagent.jsonc ~/.config/opencode/oh-my-openagent.json \
~/.config/opencode/oh-my-opencode.jsonc ~/.config/opencode/oh-my-opencode.json
</syntaxhighlight>
*: 
* プロジェクト固有の設定ファイル (プロジェクト内に存在する場合)
*: <syntaxhighlight lang="text">
# プロジェクト設定ファイルを削除（各プロジェクトディレクトリで実行）
rm -f .opencode/oh-my-openagent.jsonc .opencode/oh-my-openagent.json \
.opencode/oh-my-opencode.jsonc .opencode/oh-my-opencode.json
</syntaxhighlight>
 
==== 削除の確認 ====
OpenCodeのバージョンコマンドを実行して、プラグインが表示されないことを確認する。 
 
opencode --version
 

== oh-my-opencodeの設定 ==
==== 設定ファイルの場所 ====
oh-my-opencodeの設定ファイルの場所を以下に示す。 
優先度が高い設定が低い設定を上書きする。 
 
* プロジェクト固有設定 (最優先)
*: .opencode/oh-my-opencode.json
* ユーザ全体設定
*: ~/.config/opencode/oh-my-opencode.json
 
==== エージェント設定 ====
各エージェントの有効 / 無効を設定できる。 
 
<syntaxhighlight lang="json">
{
"agents": {
"planner-sisyphus": {"enabled": true, "replace_plan": true},
"hephaestus": {"enabled": false},
"prometheus": {"enabled": false},
"librarian": {"enabled": false},
"explore": {"enabled": false},
"oracle": {"enabled": false}
}
}
</syntaxhighlight>
 
<center>
{| class="wikitable"
|+ カスタムエージェントの設定項目
|-
! 設定項目 !! 説明
|-
| <code>enabled</code> || true でエージェントを有効化、false で無効化する。
|-
| <code>replace_plan</code> || true に設定すると、デフォルトのplanエージェントをこのエージェントで置き換える。
|}
</center>
 
==== フック設定 ====
不要なライフサイクルフックを無効化できる。 
 
<syntaxhighlight lang="json">
{
"disabled_hooks": ["comment-checker", "agent-usage-reminder"]
}
</syntaxhighlight>
 
<code>disabled_hooks</code> に無効化するフック名を配列で指定する。 
 
==== MCP設定 ====
不要なMCPサーバを無効化できる。 
 
<syntaxhighlight lang="json">
{
"disabled_mcps": ["context7", "grep_app"]
}
</syntaxhighlight>
 
<code>disabled_mcps</code> に無効化するMCP名を配列で指定する。 
 

== エージェントチーム ==
oh-my-opencodeが提供するエージェントチームの各メンバーについて説明する。 
 
==== Sisyphus ====
Sisyphusは、oh-my-opencodeのデフォルトエージェントであり、メインの調整役・オーケストレーターとして機能する。 
ギリシャ神話のシジフォスから命名されており、タスクが完了するまで粘り強く実行し続けることを表している。 
 
下表に、主な特徴を示す。 
 
<center>
{| class="wikitable"
|+ Sisyphusの特徴
|-
! 項目 !! 説明
|-
| 役割 || メイン調整役・オーケストレーター 計画、委譲、並列実行管理を担当する。
|-
| todo-driven workflow || タスクリストを管理しながら順序立てて実行する。
|-
| extended thinking || 複雑な問題に対して深く考察してから行動する。
|-
| 自動再開 || 中断後もタスクを自動的に再開できる。
|-
| 推奨モデル || Claude Pro/Maxサブスクリプションを推奨
|}
</center>
 
Sisyphusは <code>replace_plan: true</code> を設定することにより、デフォルトのplanエージェントを置き換えることができる。 
 
==== Hephaestus ====
Hephaestusは、ゴールを指定するだけで自律的に深く作業を進めるエージェントである。 
ギリシャ神話の鍛冶の神ヘパイストスから命名されており、ツールや技術の精通を象徴する。 
 
下表に、主な特徴を示す。 
 
<center>
{| class="wikitable"
|+ Hephaestus の主な特徴
|-
! 項目 !! 説明
|-
| 役割 || 自律的な深い作業者 ゴール指定での独立実行が得意。
|-
| コードベースパターン探索 || プロジェクト全体のパターンを自ら探索・理解する。
|-
| エンドツーエンド完了 || タスク開始から完了まで自律的に実行する。
|-
| Sisyphusとの違い || 他のエージェントへの委譲ではなく、自ら深掘りして作業を完遂する。
|}
</center>
 
==== Prometheus ====
Prometheusは、十分なコンテキストを収集した上で専門エージェントに委譲する戦略的プランナーエージェントである。 
ギリシャ神話のプロメテウスから命名されており、先見性と戦略的思考を象徴する。 
 
下表に、主な特徴を示す。 
 
<center>
{| class="wikitable"
|+ Prometheusの特徴
|-
! 項目 !! 説明
|-
| 役割 || 戦略的プランナー 委譲ベースの実行を担当する。
|-
| インタビューモード || 作業開始前に十分なコンテキストを収集するための質問を行う。
|-
| 要求分類 || ユーザの要求をリファクタリングと新機能開発に分類し、適切な専門エージェントに委譲する。
|-
| 直接実行との違い || 自ら直接実行するのではなく、適切な専門家に委ねる。
|}
</center>
 
==== Librarian ====
Librarianは、ドキュメント管理とコード例・パターン発見に特化したエージェントである。 
 
下表に、主な特徴を示す。 
 
<center>
{| class="wikitable"
|+ Librarianの特徴
|-
! 項目 !! 説明
|-
| 役割 || ドキュメント・コード探索専門 ドキュメント管理、コード例・パターンの発見を担当する。
|-
| コードベース構造理解 || プロジェクトのファイル構成や依存関係を把握する。
|-
| Context7 MCP との連携 || Context7 MCPと組み合わせて使用することで効果的に機能する。
|}
</center>
 
==== Explore ====
Exploreは、大規模コードベースのナビゲーションに特化したエージェントである。 
 
下表に、主な特徴を示す。 
 
<center>
{| class="wikitable"
|+ Exploreの特徴
|-
! 項目 !! 説明
|-
| 役割 || コード探索専門 大規模コードベースのナビゲーションを担当する。
|-
| 素早いコード移動 || 関連するコード間を効率的に移動できる。
|-
| パターン検出 || コードベース内のパターンを素早く見つける。
|-
| 依存関係分析 || モジュール間の依存関係を分析する。
|-
| 用途 || 未知のコードベースへの入門や、既存コードの把握に適している。
|}
</center>
 
==== Oracle ====
Oracleは、コンテキストを理解した上で質問に答えることに特化したエージェントである。 
 
下表に、主な特徴を示す。 
 
<center>
{| class="wikitable"
|+ Oracleの特徴
|-
! 項目 !! 説明
|-
| 役割 || Q&A 特化型。コンテキスト認識型の質問応答を担当する。
|-
| コード動作原理説明 || なぜそのコードがそのように動作するかを説明する。
|-
| ベストプラクティス提示 || 特定の問題に対する推奨されるアプローチを示す。
|-
| トラブルシューティング || 問題の原因と解決策を分析する。
|}
</center>
 
==== エージェントの比較 ====
下表に、各エージェントの特性を示す。 
 
<center>
{| class="wikitable"
|+ oh-my-opencode エージェント比較
! エージェント !! 主な役割 !! 特性 !! 推奨用途
|-
| Sisyphus || オーケストレーター || todo-driven、委譲、並列実行 || 複雑なマルチステップタスク全般
|-
| Hephaestus || 自律実行者 || 深掘り、エンドツーエンド完了 || 単一ゴールの自律的な実装
|-
| Prometheus || 戦略プランナー || インタビュー、分類、委譲 || 要件が不明確な大きなタスク
|-
| Librarian || ドキュメント探索 || コードパターン発見 || ドキュメント作成・コード調査
|-
| Explore || コード探索 || ナビゲーション、依存関係分析 || 未知コードベースへの入門
|-
| Oracle || Q&A || コンテキスト認識型回答 || 技術的な質問・トラブルシューティング
|}
</center>
 

== エージェントの使用方法 ==
==== 基本的な使い方 ====
各エージェントの呼び出し方法を以下に示す。 
 
* プライマリエージェントの切り替え
*: [Tab]キーを押下することにより、build と plan エージェントを切り替える。
* サブエージェントの呼び出し
*: チャット入力欄で <code>@</code> に続けてエージェント名を入力する。
 
サブエージェントの呼び出し例を以下に示す。 
 
@Librarian このプロジェクトの認証モジュールの構造を教えて

@Oracle このエラーの原因と解決策を教えて

@Explore このファイルに依存しているモジュールを全て教えて
 
==== ultraworkコマンド ====
oh-my-opencodeが提供する <code>ultrawork</code> コマンド (短縮形: <code>ulw</code>) を使用することにより、エージェントがプロジェクトの探索から実装・検証・完了まで自動的に実行する。 
 
ultraworkコマンドの使用例を以下に示す。 
 
opencode "ultrawork: Refactor user authentication module, add OAuth2 support"
 
ultraworkコマンドの実行フローを以下に示す。 
 
# プロジェクト探索
#: コードベース全体の構造を把握する。
# パターン研究
#: 既存のコードパターンやアーキテクチャを理解する。
# 実装
#: タスクを実行する。
# 検証
#: 実装結果を確認・テストする。
# 完了
#: タスクを完了して結果を報告する。
 
<code>auto_resume</code> 機能を有効化することにより、中断後も自動的にタスクを再開できる。 
設定方法を以下に示す。 
 
<syntaxhighlight lang="json">
{
"experimental": {
"auto_resume": true
}
}
</syntaxhighlight>
 

== 認証設定 ==
==== Claude (Anthropic) ====
Anthropic Claudeの認証設定手順を以下に示す。 
 
# 以下に示すコマンドを実行する。
#: <pre>opencode auth login</pre>
#: 
# 表示された一覧から[Anthropic]を選択する。
# <code>Claude Pro/Max</code> を選択する。
# Webブラウザが開くので、OAuthで認証する。
 
Sisyphusエージェントを最大限活用するには、Claude Maxサブスクリプションを推奨する。 
 
==== Google Gemini ====
Google Geminiの認証には、opencode-antigravity-auth プラグインを使用する。 
 
# ~/.config/opencode/opencode.json にプラグインを追加する。
#: <syntaxhighlight lang="json">
{
"plugin": ["oh-my-opencode", "opencode-antigravity-auth@latest"]
}
</syntaxhighlight>
#: 
# 以下に示すコマンドを実行する。
#: <pre>opencode auth login</pre>
# 表示された一覧から[Google]を選択し、OAuth (Antigravity) で認証する。
 
==== GLM 5 (Z.AI) ====
GLM-5は、智谱AI (Zhipu AI / Z.AI) が開発した大規模言語モデルである。 
744億パラメータのMoEアーキテクチャを採用し、アクティブパラメータは約40億、コンテキスト長は200,000トークンに対応する。 
 
認証手順を以下に示す。 
 
# <code>opencode auth login</code> を実行して、[Z.AI]を選択する。
# [https://z.ai/ Z.AI Open Platform]にアクセスして、APIキーを取得する。
# APIキーを入力する。 APIキーの形式は {API Key ID}.{secret} である。
 
* opencode.json ファイルに記述するカスタムプロバイダー設定を以下に示す。
*: <syntaxhighlight lang="json">
{
"provider": {
"zai": {
"npm": "@ai-sdk/openai-compatible",
"name": "Z.AI",
"options": {
"baseURL": "https://api.z.ai/api/paas/v4/",
"apiKey": "{env:ZAI_API_KEY}"
},
"models": {
"glm-5": {
"name": "GLM-5"
}
}
}
},
"model": "zai/glm-5"
}
</syntaxhighlight>
*: 
* コーディング専用エンドポイントを使用する場合の設定を以下に示す。
*: <syntaxhighlight lang="json">
{
"provider": {
"zai-coding": {
"npm": "@ai-sdk/openai-compatible",
"name": "Z.AI Coding",
"options": {
"baseURL": "https://api.z.ai/api/coding/paas/v4/",
"apiKey": "{env:ZAI_API_KEY}"
},
"models": {
"glm-5": {
"name": "GLM-5 Coding"
}
}
}
},
"model": "zai-coding/glm-5"
}
</syntaxhighlight>
*: 
* 環境変数を使用してAPIキーを設定する場合は、以下に示すコマンドを実行する。
*: <syntaxhighlight lang="sh">
export ZAI_API_KEY=<APIキー>
</syntaxhighlight>
 
==== GitHub Copilot ====
GitHub Copilotの認証設定手順を以下に示す。 
 
# 以下に示すコマンドを実行する。
#: <pre>opencode auth login</pre>
#: 
# 表示された一覧から[GitHub]を選択する。
# Webブラウザが開くので、OAuthで認証する。
 

== トラブルシューティング ==
下表に、oh-my-opencodeのインストールおよび動作に関する問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ トラブルシューティング一覧
! 問題 !! 対処法
|-
| インストールが失敗する || Node.jsの最新バージョンがインストールされているか確認する。 OpenCode 1.0.133以降を使用しているか確認する。
|-
| JSONの設定が反映されない || 設定ファイルの内容が有効なJSON形式であるか確認する。
|-
| <code>bunx</code> コマンドが見つからない || <code>npx oh-my-opencode install</code> を使用する。
|-
| npmキャッシュの問題 || 以下に示すコマンドでキャッシュをクリアする。 <code>npm cache clean --force</code>
|-
| Snapでインストールしたbunの問題 || npxを使用する、または、OpenCodeのオフィシャルインストーラーを再利用する。
|-
| エージェントが起動しない || oh-my-opencode.json の <code>enabled</code> が true になっているか確認する。
|-
| インストール後にエージェントが表示されない || 異なるパッケージマネージャー (npm, bun, yarn, pnpm) でのインストールを試みる。
|}
</center>
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,OpenCode,oh-my-opencode,AI,エージェント,Agent,LLM,GLM-5,Claude,Gemini,GitHub Copilot,TUI,ターミナル
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

MCPサーバ - Draw.io

2026-04-09T15:18:21Z

Wiki: /* 設定とカスタマイズ */

== 概要 ==
Draw.io MCP Server は、AI システムがDraw.io ダイアグラムをプログラマティックに制御・検査できるようにするMCP (Model Context Protocol) サーバである。 
このMCPを使用することにより、Claude等のLLMがDraw.io上でフローチャート、シーケンス図、アーキテクチャ図、ネットワーク図等の様々なダイアグラムを自動的に作成・編集することができる。 
 
Draw.io MCP Serverは、以下に示すような機能を提供する。 
* ダイアグラムの検査機能 (選択セル取得、シェイプカテゴリ列挙、ページモデル取得)
* ダイアグラムの編集機能 (矩形追加、エッジ追加、カスタムシェイプ追加、セル削除)
* セルのプロパティ編集とスタイル適用
* カスタム属性の保存と管理
 
Draw.io MCP Serverは、WebSocket (デフォルトポート: 3333) を使用してブラウザ拡張機能経由でDraw.ioと通信する。 
これにより、Claude Desktop、oterm、Zed等のMCPクライアントと統合することができる。 
 
Draw.io MCP Serverの最大の特徴は、Webブラウザ拡張機能を介してリアルタイムにDraw.ioダイアグラムを操作できることである。 
全てのダイアグラム処理機能は、TypeScriptで実装されており、Node.js 20以上で動作する。 
 

== Draw.io MCP Serverの機能 ==
==== ダイアグラム検査機能 ====
* 選択されたセルの取得 (get-selected-cells)
* シェイプカテゴリの列挙 (get-shape-categories)
* 特定のシェイプ情報の取得 (get-specific-shapes)
* ページ分割されたダイアグラムモデルの取得 (list-paged-model)
 
==== ダイアグラム編集機能 ====
* 矩形の追加 (add-rectangle)
* エッジ (接続線) の追加 (add-edge)
* カスタムシェイプの追加 (add-custom-shape)
* セルの削除 (delete-cell)
* セルのプロパティ編集 (edit-cell)
 
==== スタイルとデータ管理 ====
* ライブラリスタイルの適用 (apply-library-style)
* カスタム属性の保存 (set-cell-data)
* シェイプのプロパティ変更
 

== 対応ダイアグラムタイプ ==
Draw.io MCP Serverは、Draw.ioで作成可能なすべてのダイアグラムタイプをサポートしている。 
 
<center>
{| class="wikitable"
|+ 対応ダイアグラムタイプ
|-
! タイプ !! 説明
|-
| フローチャート || プロセスフローと意思決定を視覚化
|-
| シーケンス図 || システムコンポーネント間の相互作用を時系列で表現
|-
| アーキテクチャ図 || システムアーキテクチャとコンポーネント構成を記述
|-
| ネットワーク図 || ネットワークトポロジーとデバイス接続を表現
|-
| データベース設計図 || データベーススキーマとER図を記述
|-
| UML図 || クラス図、アクティビティ図、ユースケース図等
|-
| マインドマップ || アイデアと概念の階層構造を視覚化
|-
| 組織図 || 組織構造と報告関係を表現
|-
| Ganttチャート || プロジェクトタイムラインとタスク管理
|}
</center>
 

== 動作要件 ==
==== システム要件 ====
* Node.js 20以上
* Draw.io MCP Browser Extension (Chrome または Firefox)
* MCPクライアント (Claude Desktop、oterm、Zed等)
 
==== 必須コンポーネント ====
* Draw.io MCP Server (TypeScript実装)
* Draw.io MCP Extension (ブラウザ拡張機能)
* app.diagrams.net へのアクセス
 
==== ネットワーク要件 ====
* WebSocketポート (デフォルト: 3333) の利用可能性
* ファイアウォールでの指定ポートの開放
* ブラウザ拡張機能とサーバ間の通信許可
 

== インストール ==
==== Draw.io MCP Serverのインストール ====
Draw.io MCP Serverは、MCPクライアントの設定ファイルを編集することにより、自動的にインストールされる。 
以下に示す設定例を参照すること。 
 
==== Claude Desktopでの設定 ====
Claude Desktopの設定ファイルを編集する。 
 
設定ファイルの場所は、以下の通りである。 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
npmを使用する場合の設定を以下に示す。 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio": {
"command": "npx",
"args": ["-y", "drawio-mcp-server"]
}
}
}
</syntaxhighlight>
 
pnpmを使用する場合の設定を以下に示す。 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio": {
"command": "pnpm",
"args": ["dlx", "drawio-mcp-server"]
}
}
}
</syntaxhighlight>
 
yarnを使用する場合の設定を以下に示す。 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio": {
"command": "yarn",
"args": ["dlx", "drawio-mcp-server"]
}
}
}
</syntaxhighlight>
 
Claude Desktopを再起動して、Draw.io MCP Serverが利用可能であることを確認する。 
 
==== Claude Codeでの設定 ====
Claude Code (CLI) でも、Claude Desktopと同様の設定ファイルを使用してDraw.io MCP Serverを利用できる。 
 
設定ファイルの場所は、以下の通りである。 
* Linux
*: ~/.config/claude/config.json
* Windows
*: %APPDATA%\claude\config.json
 
設定内容は、Claude Desktopと同じである。 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio": {
"command": "npx",
"args": ["-y", "drawio-mcp-server"]
}
}
}
</syntaxhighlight>
 
==== ブラウザ拡張機能のインストール ====
Draw.io MCP Extensionをブラウザにインストールする必要がある。 
 
===== Google Chromeの場合 =====
# Chrome Web Storeから「Draw.io MCP Extension」を検索
# [追加] ボタンをクリックしてインストール
# 拡張機能がアクティブであることを確認
 
===== Mozilla Firefoxの場合 =====
# Firefox Add-onsから "Draw.io MCP Extension" を検索する。
# [Firefoxに追加]ボタンを押下してインストールする。
# 拡張機能がアクティブであることを確認する。
 
==== app.diagrams.netへのアクセス ====
# Webブラウザで https://app.diagrams.net を開く。
# Draw.io MCP Serverは、このページ上でダイアグラムを操作する。
 

== 設定とカスタマイズ ==
==== ポート設定 ====
Draw.io MCP Serverは、デフォルトでWebSocketポート3333を使用してブラウザ拡張機能と通信する。 
このポート番号は、カスタマイズすることができる。 
 
※注意 
各MCPサーバインスタンスが独自のWebSocketサーバを起動しようとするため、同じポートを使う複数のインスタンスは共存できない。 
例えば、複数のClaude CodeおよびClaude Desktopを起動してDraw.io MCP Serverを使用する場合、同じポート番号を使用するとエラーになる。 
そのため、異なるポート番号を指定する必要がある。 
 
カスタムポートの設定例を以下に示す。 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio": {
"command": "npx",
"args": ["-y", "drawio-mcp-server", "--extension-port", "4000"]
}
}
}
</syntaxhighlight>
 
この設定により、ポート4000でWebSocket通信を行う。 
 
また、ブラウザ拡張機能側も同じポート番号を設定する必要がある。 
* ブラウザ拡張機能のポート設定
*# ブラウザ拡張機能のアイコンをクリックする。
*# 設定画面が表示される。
*# WebSocketポート番号を4000に変更する。
*# 保存して拡張機能を再読み込みする。
 
 

==== HTTPトランスポートの使用 ====
リモートアクセス用にHTTPトランスポートを有効化することができる。 
デフォルトポートは3000である。 
 
HTTPトランスポートの有効化例を以下に示す。 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio": {
"command": "npx",
"args": ["-y", "drawio-mcp-server", "--transport", "http"]
}
}
}
</syntaxhighlight>
 
この設定により、HTTP経由でMCPサーバにアクセスできる。 
 

== 利用可能なツール ==
==== get-selected-cells ====
選択されたセルの情報を取得する。 
 
* 機能
*: ダイアグラム上で選択されているセル (シェイプ、エッジ) の詳細情報を取得する
*: セルID、スタイル、位置、サイズ等の属性を返す
 
# 使用例 :

選択されているセルの情報を取得してください。
 
==== get-shape-categories ====
利用可能なシェイプカテゴリの一覧を取得する。 
 
* 機能
*: Draw.ioライブラリで利用可能なシェイプカテゴリを列挙する
*: 各カテゴリに含まれるシェイプタイプを確認できる
 
# 使用例 :

利用可能なシェイプカテゴリを一覧表示してください。
 
==== get-specific-shapes ====
特定のシェイプ情報を取得する。 
 
* 機能
*: 指定されたシェイプタイプの詳細情報を取得する
*: スタイルプロパティ、デフォルト設定、カスタマイズオプションを確認できる
 
# 使用例 :

矩形シェイプの詳細情報を取得してください。
 
==== list-paged-model ====
ページ分割されたダイアグラムモデルを取得する。 
 
* 機能
*: 複数ページを持つダイアグラムの構造を取得する
*: 各ページのセル、階層、接続関係を確認できる
 
# 使用例 :

ダイアグラムの全ページモデルを取得してください。
 
==== add-rectangle ====
ダイアグラムに矩形を追加する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| x || number || X座標位置
|-
| y || number || Y座標位置
|-
| width || number || 矩形の幅
|-
| height || number || 矩形の高さ
|-
| style || string || スタイル設定 (オプション)
|-
| value || string || 表示テキスト (オプション)
|}
</center>
 
# 使用例 :

座標 (100, 100) に幅200、高さ100の矩形を追加してください。
 
==== add-edge ====
2つのセルを接続するエッジ (接続線) を追加する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| source || string || 接続元のセルID
|-
| target || string || 接続先のセルID
|-
| style || string || エッジのスタイル設定 (オプション)
|-
| value || string || エッジのラベル (オプション)
|}
</center>
 
# 使用例 :

セルAとセルBを矢印で接続してください。
 
==== add-custom-shape ====
カスタムシェイプを追加する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| shapeType || string || シェイプタイプ (円、菱形、楕円等)
|-
| x || number || X座標位置
|-
| y || number || Y座標位置
|-
| width || number || シェイプの幅
|-
| height || number || シェイプの高さ
|-
| style || string || スタイル設定 (オプション)
|-
| value || string || 表示テキスト (オプション)
|}
</center>
 
# 使用例 :

座標 (200, 200) に円形シェイプを追加してください。
 
==== delete-cell ====
指定されたセルを削除する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| cellId || string || 削除するセルのID
|}
</center>
 
# 使用例 :

セルID「cell-123」を削除してください。
 
==== edit-cell ====
既存のセルのプロパティを編集する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| cellId || string || 編集するセルのID
|-
| style || string || 新しいスタイル設定 (オプション)
|-
| value || string || 新しい表示テキスト (オプション)
|-
| geometry || object || 新しい位置・サイズ情報 (オプション)
|}
</center>
 
# 使用例 :

セルID「cell-123」のテキストを「データベース」に変更してください。
 
==== apply-library-style ====
ライブラリで定義されたスタイルをセルに適用する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| cellId || string || スタイルを適用するセルのID
|-
| libraryName || string || ライブラリ名
|-
| styleName || string || スタイル名
|}
</center>
 
# 使用例 :

セルID「cell-123」にAWSライブラリのEC2スタイルを適用してください。
 
==== set-cell-data ====
セルにカスタム属性データを保存する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| cellId || string || データを保存するセルのID
|-
| key || string || 属性のキー
|-
| value || string || 属性の値
|}
</center>
 
# 使用例 :

セルID「cell-123」にカスタム属性「type=server」を保存してください。
 

== 使用方法 ==
==== プロンプトの基本形式 ====
Claude DesktopでDraw.io MCP Serverを使用する際は、自然言語でダイアグラムの作成を依頼できる。 
 
# 基本形式 :

@Draw.io MCP Server <指示内容>
 
プロンプト内で、作成するダイアグラムの種類、含めるべき要素、レイアウト、スタイル等を指定する。 
Claude AIが自動的に適切なツールを選択して実行する。 
 
==== シンプルなフローチャートの作成 ====
# プロンプト例 :

@Draw.io MCP Server フローチャートを作成してください。
スタートノード、処理ステップ3つ、判定ノード1つ、終了ノードを含めてください。
 
==== アーキテクチャ図の作成 ====
# プロンプト例 :

@Draw.io MCP Server データベースアーキテクチャ図を作成してください。
ユーザサーバ、アプリケーションサーバ、データベースサーバを矩形で表現し、矢印で接続関係を示してください。
 
==== マイクロサービス図の作成 ====
# プロンプト例 :

@Draw.io MCP Server マイクロサービスのシステムアーキテクチャを描画してください。
各サービスを異なる色の矩形で表現し、それぞれの通信プロトコルをラベル付きの矢印で示してください。
 
==== スタイル指定を含む作成 ====
# プロンプト例 :

@Draw.io MCP Server ネットワーク図を作成してください。
ルータ、スイッチ、サーバを適切なアイコンで表現し、VLANごとに異なる背景色を使用してください。
 
==== 複数ページのダイアグラム ====
# プロンプト例 :

@Draw.io MCP Server システム設計書を作成してください。
ページ1に概要図、ページ2に詳細アーキテクチャ、ページ3にデータフロー図を配置してください。
 

== システムアーキテクチャ ==
Draw.io MCP Serverは、3層アーキテクチャで構成されている。 
 
==== アーキテクチャ概要 ====
コンポーネント構成 
* MCPクライアント層
*: Claude Desktop、oterm、Zed 等
* Draw.io MCP Server層
*: Node.jsベースのTypeScript実装
* ブラウザ拡張機能層
*: Draw.io MCP Extension (Chrome / Firefox)
* Draw.io層
*: app.diagrams.net のWebアプリケーション
 
通信フロー 
# Claude DesktopからDraw.io MCP Serverにツール呼び出しを送信する。
# Draw.io MCP ServerがWebSocket (ポート3333) 経由でブラウザ拡張機能に接続する。
# ブラウザ拡張機能がDraw.io APIを使用してダイアグラムを操作する。
# 結果がサーバ経由でClaudeに返却される。
 
データフロー 
# プロンプトを入力する。(Claude Desktop)
# MCPツールを呼び出す。(Claude → Draw.io MCP Server)
# WebSocket通信を開始する。(Draw.io MCP Server → ブラウザ拡張機能)
# ダイアグラム操作 (ブラウザ拡張機能 → Draw.io)
# 結果が返却 (逆方向)
 

== トラブルシューティング ==
==== サーバに接続できない ====
以下の項目を確認する。 
* ブラウザ拡張機能がインストールされているか確認
*: Chrome Web StoreまたはFirefox Add-onsから正しくインストールされていることを確認
* ブラウザ拡張機能がアクティブであるか確認
*: 拡張機能のアイコンが表示され、有効化されていることを確認
* Claude Desktopが再起動されているか確認
*: 設定ファイル編集後、必ずClaude Desktopを再起動する
* デフォルトポート3333が使用可能か確認
*: 他のアプリケーションがポート3333を使用していないか確認
*: ファイアウォールでポート3333が開放されているか確認
 
==== ダイアグラムが更新されない ====
以下の項目を確認する。 
* app.diagrams.netがブラウザで開かれているか確認
*: ブラウザで app.diagrams.net が開かれていることが必須
* WebSocket接続が確立されているか確認
*: ブラウザの開発者ツールでWebSocket接続状態を確認
* ペイロードサイズを確認
*: 大規模なダイアグラム操作の場合、処理に時間がかかる可能性がある
 
==== ツール呼び出しエラーが発生する ====
以下の項目を確認する。 
* Node.jsのバージョンの確認
*: Node.js 20以上がインストールされていることを確認する。
*: <code>node --version</code> コマンドでバージョンを確認する。
* MCP Server設定ファイルの確認
*: claude_desktop_config.jsonファイルの設定が正しいかどうかを確認する。
*: JSON形式のエラーがないかどうかを確認する。
* サーバログの確認
*: Claude Desktopのデバッグコンソールでエラーログを確認する。
*: View > Toggle Developer Tools でコンソールを開く。
 
==== Firefox拡張機能が動作しない ====
以下の項目を確認する。 
* 拡張機能のバージョンの確認
*: バージョン1.3.0以降を使用していることを確認する。
* 拡張機能の権限の確認
*: app.diagrams.net へのアクセス権限が付与されているか確認する。
 

== Draw.io MCP Extension ==
==== ブラウザ拡張機能の役割 ====
Draw.io MCP Extensionは、Draw.io MCP ServerとDraw.io間の橋渡しを行うコンポーネントである。 
 
主要機能は以下の通りである。 
* WebSocket経由でDraw.io MCP Serverと通信
* Draw.io APIを使用してダイアグラムを操作
* セル選択、シェイプ追加、エッジ追加、セル削除等の操作を実行
* ダイアグラムの状態をサーバに返却
 
==== 拡張機能のインストール場所 ====
* Google Chrome
** Chrome Web Store から「Draw.io MCP Extension」を検索してインストール
** URL: chrome.google.com/webstore (検索キーワード: Draw.io MCP Extension)
*: 
* Mozilla Firefox
** Firefox Add-onsから Draw.io MCP Extension を検索してインストール
** URL: addons.mozilla.org (検索キーワード: Draw.io MCP Extension)
 

== 関連リソース ==
* [https://github.com/lgazo/drawio-mcp-server Draw.io MCP ServerのGitHub]
* [https://glama.ai/mcp/servers/@lgazo/drawio-mcp-server Draw.io MCP Server on GLAMA]
* [https://modelcontextprotocol.io/ Model Context Protocol公式サイト]
* [https://app.diagrams.net/ Draw.io公式サイト]
 

== Draw.io MCP Server (jgraph/drawio-mcp) ==
JGraph Ltd (Draw.ioの開発元) が公式に提供するMCPサーバである。 
npmパッケージ名は @drawio/mcp であり、Apache 2.0ライセンスで配布されている。 
 
前述の@lgazo/drawio-mcp-serverがブラウザ拡張機能経由でリアルタイムにDraw.ioを操作するのに対し、jgraph版はブラウザ拡張機能を必要としない。 
 
代わりに、以下に示す4つの統合アプローチを提供する。 
 
<center>
{| class="wikitable"
|+ Draw.io 統合方式の一覧
! 方式 !! 説明
|-
| MCP App Server || チャット内にインラインでダイアグラムを表示する方式 インストール不要で、公式ホストエンドポイント (https://mcp.draw.io/mcp) を使用する。
|-
| MCP Tool Server || WebブラウザでDraw.ioエディタを開いてダイアグラムを表示する方式 @drawio/mcp パッケージをnpxで実行する。
|-
| Skill + CLI || <code>.drawio</code> ファイルを生成し、draw.io DesktopアプリでPNG / SVG / PDFにエクスポートする方式 draw.io Desktopアプリのインストールが必要
|-
| Project Instructions || インストール不要で、Pythonスクリプトを使用してDraw.ioのURLを生成する方式
|}
</center>
 
対応する入力フォーマットは、XML、CSV、Mermaid.jsの3種類である。 
Node.js 18.0.0以上が必要である (MCP Tool ServerおよびSkill + CLI使用時)。 
 
対応するMCPクライアントは以下の通りである。 
* Claude Desktop
* Claude Code (CLI)
* Cursor
* Windsurf
* その他のMCP対応クライアント
 

== jgraph版 : 4つの統合アプローチ ==
jgraph版Draw.io MCPは、4つの異なる統合アプローチを提供している。 
用途に応じて適切なアプローチを選択する。 
 
<center>
{| class="wikitable"
|+ 4つの統合アプローチの比較
! アプローチ !! 動作方法 !! 出力形式 !! インストール !! 対応フォーマット !! 対応クライアント !! ベストユースケース
|-
| MCP App Server || チャット内にインライン表示 || インラインダイアグラム || 不要 (公式ホスト使用) || XML, CSV, Mermaid || Claude Desktop || チャット内でダイアグラムを確認したい場合
|-
| MCP Tool Server || ブラウザでDraw.ioエディタを開く || ブラウザ表示 || npxで実行 || XML, CSV, Mermaid || Claude Desktop, Cursor, Windsurf等 || ダイアグラムをDraw.ioエディタで編集したい場合
|-
| Skill + CLI || .drawioファイル生成 + エクスポート || .drawio, PNG, SVG, PDF || npm install + draw.io Desktop || XML || Claude Code || ファイルとして保存・エクスポートしたい場合
|-
| Project Instructions || PythonでURL生成 || ブラウザ表示 || 不要 (Pythonのみ) || XML || 全クライアント || インストールなしでダイアグラムを生成したい場合
|}
</center>
 

== jgraph版 : 動作要件 ==
==== 共通要件 ====
* インターネット接続
*: Draw.ioのWebアプリケーション (https://app.diagrams.net) へのアクセスが必要
* MCPクライアント
*: Claude Desktop、Claude Code、Cursor、Windsurf等のMCP対応クライアント
 
==== MCP Tool Serverの要件 ====
* Node.js 18.0.0以上
* npm (npxコマンドが利用可能であること)
 
==== Skill + CLIの要件 ====
* Node.js 18.0.0以上
* npm または pnpm
* draw.io Desktopアプリ
*: エクスポート機能 (PNG / SVG / PDF) を使用する場合に必要
 
==== MCP App Serverの要件 ====
* 追加のインストールは不要
* 公式ホストエンドポイント (https://mcp.draw.io/mcp) を使用
 
==== Project Instructionsの要件 ====
* Python 3の実行環境
* 追加のパッケージインストールは不要
 

== jgraph版 : MCP Tool Serverのインストール ==
==== npxでの実行 (推奨) ====
グローバルインストール不要で、常に最新バージョンを使用できる。 
 
npx @drawio/mcp
 
==== グローバルインストール ====
npmでグローバルにインストールする場合は、以下のコマンドを実行する。 
 
npm install -g @drawio/mcp
 
インストール後、以下のコマンドで実行する。 
 
drawio-mcp
 
==== ソースからのインストール ====
GitHubリポジトリからソースコードを取得してビルドする場合は、以下のコマンドを実行する。 
 
git clone https://github.com/jgraph/drawio-mcp.git
cd drawio-mcp
npm install
npm run build
 
ビルド後、以下のコマンドで実行する。 
 
node dist/tool-server.js
 
==== Claude Desktopでの設定 ====
Claude Desktopの設定ファイルを編集して、MCP Tool Serverを登録する。 
 
設定ファイルの場所は、以下の通りである。 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* MacOS
*: ~/Library/Application Support/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
設定内容を以下に示す。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio-mcp": {
"command": "npx",
"args": ["-y", "@drawio/mcp"]
}
}
}
</syntaxhighlight>
 
Claude Desktopを再起動して設定を反映する。 
 
==== Claude Codeでの設定 ====
Claude Codeで使用する場合は、以下のコマンドを実行する。 
 
claude mcp add drawio-mcp -- npx -y @drawio/mcp
 
または、設定ファイルを直接編集する。 
 
設定ファイルの場所は、以下の通りである。 
* MacOS / Linux
*: ~/.config/claude/config.json
* Windows
*: %APPDATA%\claude\config.json
 
設定内容は、Claude Desktopと同じJSONフォーマットを使用する。 
 
==== その他のMCPクライアントでの設定 ====
Cursor、Windsurf等の他のMCPクライアントでも使用できる。 
各クライアントの設定方法に従い、以下の情報を設定する。 
* コマンド
*: <code>npx</code>
* 引数
*: <code>-y</code>, <code>@drawio/mcp</code>
 

== jgraph版 : MCP App Serverの設定 ==
MCP App Serverは、チャット内にダイアグラムをインラインで表示する方式である。 
インストール不要で、公式ホストのエンドポイントを使用する。 
 
==== 公式ホストエンドポイント ====
JGraphが提供する公式エンドポイントを使用する。 
* https://mcp.draw.io/mcp
 
Claude Desktopの設定で、上記URLをMCP App Serverとして登録する。 
 
==== セルフホスト (Node.js) ====
MCP App Serverをセルフホストする場合は、以下のコマンドを実行する。 
 
npx @drawio/mcp --app-server
 
デフォルトでは、ポート3000でHTTPサーバが起動する。 
 
==== Claude Desktopでの設定 (stdio) ====
stdioトランスポートを使用してMCP App Serverを起動する場合は、以下の設定を使用する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio-app": {
"command": "npx",
"args": ["-y", "@drawio/mcp", "--app-server"]
}
}
}
</syntaxhighlight>
 
==== Cloudflare Workersへのデプロイ ====
MCP App ServerをCloudflare Workersにデプロイすることも可能である。 
 
リポジトリのクローンとデプロイは以下のコマンドで実行する。 
 
git clone https://github.com/jgraph/drawio-mcp.git
cd drawio-mcp
npm install
npx wrangler deploy
 
デプロイ後、Cloudflare WorkersのURLをMCPクライアントに設定する。 
 

== jgraph版 : Skill + CLIの設定 ==
Skill + CLIは、<code>.drawio</code>ファイルを生成し、draw.io DesktopアプリでPNG / SVG / PDFにエクスポートする方式である。 
 
==== 前提条件 ====
* Node.js 18.0.0以上
* draw.io Desktopアプリ
*: エクスポート機能を使用するために必要
*: [https://github.com/jgraph/drawio-desktop/releases draw.io Desktop公式リリースページ] からダウンロード可能
 
==== インストール ====
グローバルにインストールする場合は、以下のコマンドを実行する。 
 
npm install -g @drawio/mcp
 
プロジェクト単位でインストールする場合は、以下のコマンドを実行する。 
 
npm install @drawio/mcp
 
==== draw.io CLIの場所 ====
draw.io Desktopアプリのコマンドライン実行ファイルの場所は、OSにより異なる。 
 
* MacOS
*: <code>/Applications/draw.io.app/Contents/MacOS/draw.io</code>
* Linux
*: <code>drawio</code> (PATHに含まれている場合)
*: または、AppImageの場所を直接指定する
* Windows
*: <code>C:\Program Files\draw.io\draw.io.exe</code>
 
==== エクスポートフォーマット ====
Skill + CLIで対応しているエクスポートフォーマットを以下に示す。 
 
<center>
{| class="wikitable"
|+ エクスポートフォーマット
! フォーマット !! 拡張子 !! 説明
|-
| Draw.io || .drawio || Draw.ioネイティブ形式 (XML)
|-
| PNG || .png || ラスター画像形式
|-
| SVG || .svg || ベクター画像形式
|-
| PDF || .pdf || PDF文書形式
|}
</center>
 

== jgraph版 : Project Instructionsの設定 ==
Project Instructionsは、インストール不要でダイアグラムを生成する方式である。 
Pythonスクリプトを使用してDraw.ioのURLを生成し、ブラウザで開く。 
 
==== 概要 ====
MCPサーバのインストールが不要であり、全てのMCPクライアントで動作する。 
プロジェクトの指示ファイル (CLAUDE.mdやcursor rules等) にDraw.io URLの生成方法を記述することで、LLMがPythonスクリプトを実行してダイアグラムを生成する。 
 
==== セットアップ方法 ====
プロジェクトの指示ファイルに以下の内容を追記する。 
 
<syntaxhighlight lang="text">
When generating diagrams, create a draw.io compatible XML representation
and then generate a URL using the following Python code:

import zlib, base64
xml = '<your draw.io XML>'
compressed = zlib.compress(xml.encode('utf-8'), 9)[2:-4]
encoded = base64.urlsafe_b64encode(compressed).decode('utf-8')
url = f'https://app.diagrams.net/#create={encoded}'
</syntaxhighlight>
 
==== 動作の仕組み ====
# LLMがDraw.io互換のXMLを生成する。
# Pythonのzlibで圧縮 (deflateRaw) を行う。
# base64でURLセーフエンコードを行う。
# https://app.diagrams.net/#create= の後にエンコード済みデータを付加してURLを生成する。
# 生成されたURLをWebブラウザで開くと、Draw.ioエディタにダイアグラムが表示される。
 

== jgraph版 : MCP Tool Serverのツール ==
MCP Tool Serverは、3つのツールを提供する。 
各ツールは、異なる入力フォーマットに対応している。 
 
==== open_drawio_xml ====
Draw.io XML形式のダイアグラムをブラウザで開く。 
 
<center>
{| class="wikitable"
|+ open_drawio_xmlのパラメータ
! パラメータ !! 型 !! 必須 !! 説明
|-
| content || string || はい || Draw.io XML形式のダイアグラムデータ
|-
| lightbox || boolean || いいえ || 読み取り専用のライトボックスモードで開く。(デフォルト: false)
|-
| dark || boolean || いいえ || ダークモードで表示する。(デフォルト: false)
|}
</center>
 
==== open_drawio_csv ====
CSV形式のデータからダイアグラムをWebブラウザで開く。 
 
<center>
{| class="wikitable"
|+ open_drawio_csvのパラメータ
! パラメータ !! 型 !! 必須 !! 説明
|-
| content || string || はい || CSV形式のダイアグラムデータ
|-
| lightbox || boolean || いいえ || 読み取り専用のライトボックスモードで開く。(デフォルト: false)
|-
| dark || boolean || いいえ || ダークモードで表示する。(デフォルト: false)
|}
</center>
 
==== open_drawio_mermaid ====
Mermaid.js形式のダイアグラムをブラウザで開く。 
 
<center>
{| class="wikitable"
|+ open_drawio_mermaidのパラメータ
! パラメータ !! 型 !! 必須 !! 説明
|-
| content || string || はい || Mermaid.js形式のダイアグラムデータ
|-
| lightbox || boolean || いいえ || 読み取り専用のライトボックスモードで開く。(デフォルト: false)
|-
| dark || boolean || いいえ || ダークモードで表示する。(デフォルト: false)
|}
</center>
 

== jgraph版 : 使用方法 ==
==== MCP Tool Serverでの使用例 ====
MCP Tool Serverを使用する場合のプロンプト例を以下に示す。 
 
* Mermaidダイアグラムの場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

以下のMermaid形式でシーケンス図をDraw.ioで作成してください。
sequenceDiagram
Client->>Server: HTTPリクエスト
Server->>Database: クエリ実行
Database-->>Server: 結果返却
Server-->>Client: HTTPレスポンス
</syntaxhighlight>
*: 
* CSVデータからダイアグラムを作成する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

以下の組織データからCSV形式で組織図をDraw.ioで作成してください。
CEO配下にCTO、CFO、COOの3つのポジションがあります。
</syntaxhighlight>
*: 
* XMLダイアグラムの場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

Webアプリケーションの3層アーキテクチャ図をDraw.io XMLで作成してください。
フロントエンド、バックエンド、データベースの3層を含めてください。
</syntaxhighlight>
 
==== Skill + CLIでの使用例 ====
Claude Code (CLI) でSkill + CLIを使用する場合は、<code>/drawio</code> コマンドを使用する。 
 
# 使用例 :

/drawio マイクロサービスのアーキテクチャ図を作成してください。
各サービス間の通信方式も記載してください。
 
エクスポートを含む使用例を以下に示す。 
# 使用例 :

/drawio ネットワーク構成図を作成して、PNGファイルとしてエクスポートしてください。
 
==== Project Instructionsでの使用例 ====
Project Instructionsを使用する場合のプロンプト例を以下に示す。 
 
# プロンプト例 :

システムのデプロイメントフロー図を作成して、Draw.ioで開けるURLを生成してください。
 

== jgraph版 : 動作の仕組み ==
==== MCP Tool Serverの処理フロー ====
MCP Tool Serverは、以下の手順でダイアグラムを表示する。 
 
# MCPクライアントからダイアグラムデータ (XML / CSV / Mermaid) を受信する。
# pakoライブラリを使用して、データをdeflateRaw圧縮する。
# 圧縮データをBase64エンコードする。
# https://app.diagrams.net/#create= の後にエンコード済みデータを付加したURLを生成する。
# 生成されたURLをWebブラウザで開き、Draw.ioエディタにダイアグラムを表示する。
 
==== MCP App Serverの処理フロー ====
MCP App Serverは、以下の手順でダイアグラムを表示する。 
 
# MCPクライアントからダイアグラムデータを受信する。
# サーバ側でダイアグラムデータを処理する。
# チャットインターフェース内にダイアグラムをインラインで描画する。
# ユーザはチャット内で直接ダイアグラムを確認できる。
 
==== URLの安全性 ====
MCP Tool ServerおよびProject Instructionsで生成されるURLは、ハッシュフラグメント方式 (<code>#create=</code>) を使用している。 
 
* ハッシュフラグメント (<code>#</code> 以降のデータ) は、Webブラウザからサーバに送信されない
*: そのため、ダイアグラムデータがDraw.ioのサーバに送信されることはない
* 全てのデータ処理はブラウザ内で完結する
* 機密性の高いダイアグラムデータも安全に扱うことができる
 

== jgraph版 : トラブルシューティング ==
==== npxが見つからない場合 ====
以下の項目を確認する。 
 
* Node.jsのバージョン確認
*: Node.js 18.0.0以上がインストールされていることを確認する。
*: <code>node --version</code> コマンドでバージョンを確認する。
* npxの確認
*: <code>npx --version</code> コマンドでnpxが利用可能であることを確認する。
*: npxが見つからない場合は、Node.jsを再インストールする。
 
==== ダイアグラムが開かない場合 ====
以下の項目を確認する。 
 
* インターネット接続の確認
*: https://app.diagrams.net にアクセスできることを確認する。
* Webブラウザの確認
*: デフォルトブラウザが設定されていることを確認する。
*: ポップアップブロッカーがURLの展開を妨げていないか確認する。
* URLの長さ制限
*: 非常に大きなダイアグラムの場合、URLの長さがブラウザの制限を超える可能性がある。
*: その場合は、Skill + CLIアプローチを使用してファイルとして生成することを推奨する。
 
==== draw.io CLIでのエクスポートが失敗する場合 ====
以下の項目を確認する。 
 
* draw.io Desktopの確認
*: draw.io Desktopアプリがインストールされていることを確認する。
*: CLIコマンドがPATHに含まれていることを確認する。
* ディスプレイ環境の確認 (Linux)
*: LinuxでGUIなし環境の場合、<code>xvfb-run</code> が必要になることがある。
*: <code>xvfb-run drawio --export --format png diagram.drawio</code>
 
==== Claude Desktopで認識されない場合 ====
以下の項目を確認する。 
 
* 設定ファイルの確認
*: claude_desktop_config.jsonファイル のJSON形式が正しいことを確認する。
*: <code>mcpServers</code> キーの下に正しく設定されていることを確認する。
* Claude Desktopの再起動
*: 設定ファイル編集後、Claude Desktopを再起動する。
* ログの確認
*: Claude Desktopのデバッグコンソール ([View] - [Toggle Developer Tools]) でエラーログを確認する。
 

{{#seo:
|title={{PAGENAME}} : Draw.io MCP Server | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,MCP,Model Context Protocol,Draw.io,Diagram,Flowchart,Architecture,UML,Sequence Diagram,Network Diagram,Claude,AI,Machine Learning,Node.js,TypeScript,Browser Extension,WebSocket,Visualization,jgraph,@drawio/mcp,MCP App Server,Mermaid,CSV,Skill,CLI
|description={{PAGENAME}} - Draw.io MCP Serverに関する包括的なガイド、コミュニティ版とJGraph公式版の両方を網羅したAIアシスタントによるダイアグラム作成と編集の自動化 | This page is {{PAGENAME}} in our wiki about Draw.io MCP servers and AI-powered diagram creation
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

MCPサーバ - Draw.io

2026-04-09T15:17:11Z

Wiki: /* app.diagrams.netへのアクセス */

== 概要 ==
Draw.io MCP Server は、AI システムがDraw.io ダイアグラムをプログラマティックに制御・検査できるようにするMCP (Model Context Protocol) サーバである。 
このMCPを使用することにより、Claude等のLLMがDraw.io上でフローチャート、シーケンス図、アーキテクチャ図、ネットワーク図等の様々なダイアグラムを自動的に作成・編集することができる。 
 
Draw.io MCP Serverは、以下に示すような機能を提供する。 
* ダイアグラムの検査機能 (選択セル取得、シェイプカテゴリ列挙、ページモデル取得)
* ダイアグラムの編集機能 (矩形追加、エッジ追加、カスタムシェイプ追加、セル削除)
* セルのプロパティ編集とスタイル適用
* カスタム属性の保存と管理
 
Draw.io MCP Serverは、WebSocket (デフォルトポート: 3333) を使用してブラウザ拡張機能経由でDraw.ioと通信する。 
これにより、Claude Desktop、oterm、Zed等のMCPクライアントと統合することができる。 
 
Draw.io MCP Serverの最大の特徴は、Webブラウザ拡張機能を介してリアルタイムにDraw.ioダイアグラムを操作できることである。 
全てのダイアグラム処理機能は、TypeScriptで実装されており、Node.js 20以上で動作する。 
 

== Draw.io MCP Serverの機能 ==
==== ダイアグラム検査機能 ====
* 選択されたセルの取得 (get-selected-cells)
* シェイプカテゴリの列挙 (get-shape-categories)
* 特定のシェイプ情報の取得 (get-specific-shapes)
* ページ分割されたダイアグラムモデルの取得 (list-paged-model)
 
==== ダイアグラム編集機能 ====
* 矩形の追加 (add-rectangle)
* エッジ (接続線) の追加 (add-edge)
* カスタムシェイプの追加 (add-custom-shape)
* セルの削除 (delete-cell)
* セルのプロパティ編集 (edit-cell)
 
==== スタイルとデータ管理 ====
* ライブラリスタイルの適用 (apply-library-style)
* カスタム属性の保存 (set-cell-data)
* シェイプのプロパティ変更
 

== 対応ダイアグラムタイプ ==
Draw.io MCP Serverは、Draw.ioで作成可能なすべてのダイアグラムタイプをサポートしている。 
 
<center>
{| class="wikitable"
|+ 対応ダイアグラムタイプ
|-
! タイプ !! 説明
|-
| フローチャート || プロセスフローと意思決定を視覚化
|-
| シーケンス図 || システムコンポーネント間の相互作用を時系列で表現
|-
| アーキテクチャ図 || システムアーキテクチャとコンポーネント構成を記述
|-
| ネットワーク図 || ネットワークトポロジーとデバイス接続を表現
|-
| データベース設計図 || データベーススキーマとER図を記述
|-
| UML図 || クラス図、アクティビティ図、ユースケース図等
|-
| マインドマップ || アイデアと概念の階層構造を視覚化
|-
| 組織図 || 組織構造と報告関係を表現
|-
| Ganttチャート || プロジェクトタイムラインとタスク管理
|}
</center>
 

== 動作要件 ==
==== システム要件 ====
* Node.js 20以上
* Draw.io MCP Browser Extension (Chrome または Firefox)
* MCPクライアント (Claude Desktop、oterm、Zed等)
 
==== 必須コンポーネント ====
* Draw.io MCP Server (TypeScript実装)
* Draw.io MCP Extension (ブラウザ拡張機能)
* app.diagrams.net へのアクセス
 
==== ネットワーク要件 ====
* WebSocketポート (デフォルト: 3333) の利用可能性
* ファイアウォールでの指定ポートの開放
* ブラウザ拡張機能とサーバ間の通信許可
 

== インストール ==
==== Draw.io MCP Serverのインストール ====
Draw.io MCP Serverは、MCPクライアントの設定ファイルを編集することにより、自動的にインストールされる。 
以下に示す設定例を参照すること。 
 
==== Claude Desktopでの設定 ====
Claude Desktopの設定ファイルを編集する。 
 
設定ファイルの場所は、以下の通りである。 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
npmを使用する場合の設定を以下に示す。 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio": {
"command": "npx",
"args": ["-y", "drawio-mcp-server"]
}
}
}
</syntaxhighlight>
 
pnpmを使用する場合の設定を以下に示す。 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio": {
"command": "pnpm",
"args": ["dlx", "drawio-mcp-server"]
}
}
}
</syntaxhighlight>
 
yarnを使用する場合の設定を以下に示す。 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio": {
"command": "yarn",
"args": ["dlx", "drawio-mcp-server"]
}
}
}
</syntaxhighlight>
 
Claude Desktopを再起動して、Draw.io MCP Serverが利用可能であることを確認する。 
 
==== Claude Codeでの設定 ====
Claude Code (CLI) でも、Claude Desktopと同様の設定ファイルを使用してDraw.io MCP Serverを利用できる。 
 
設定ファイルの場所は、以下の通りである。 
* Linux
*: ~/.config/claude/config.json
* Windows
*: %APPDATA%\claude\config.json
 
設定内容は、Claude Desktopと同じである。 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio": {
"command": "npx",
"args": ["-y", "drawio-mcp-server"]
}
}
}
</syntaxhighlight>
 
==== ブラウザ拡張機能のインストール ====
Draw.io MCP Extensionをブラウザにインストールする必要がある。 
 
===== Google Chromeの場合 =====
# Chrome Web Storeから「Draw.io MCP Extension」を検索
# [追加] ボタンをクリックしてインストール
# 拡張機能がアクティブであることを確認
 
===== Mozilla Firefoxの場合 =====
# Firefox Add-onsから "Draw.io MCP Extension" を検索する。
# [Firefoxに追加]ボタンを押下してインストールする。
# 拡張機能がアクティブであることを確認する。
 
==== app.diagrams.netへのアクセス ====
# Webブラウザで https://app.diagrams.net を開く。
# Draw.io MCP Serverは、このページ上でダイアグラムを操作する。
 

== 設定とカスタマイズ ==
==== ポート設定 ====
Draw.io MCP Serverは、デフォルトでWebSocketポート3333を使用してブラウザ拡張機能と通信する。 
このポート番号は、カスタマイズすることができる。 
 
※注意 
各MCPサーバインスタンスが独自のWebSocketサーバを起動しようとするため、同じポートを使う複数のインスタンスは共存できない。 
例えば、複数のClaude CodeおよびClaude Desktopを起動してDraw.io MCP Serverを使用する場合、同じポート番号を使用するとエラーになる。 
そのため、異なるポート番号を指定する必要がある。 
 
カスタムポートの設定例を以下に示す。 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio": {
"command": "npx",
"args": ["@lgazo/drawio-mcp-server", "--extension-port", "4000"]
}
}
}
</syntaxhighlight>
 
この設定により、ポート4000でWebSocket通信を行う。 
 
また、ブラウザ拡張機能側も同じポート番号を設定する必要がある。 
* ブラウザ拡張機能のポート設定
*# ブラウザ拡張機能のアイコンをクリックする。
*# 設定画面が表示される。
*# WebSocketポート番号を4000に変更する。
*# 保存して拡張機能を再読み込みする。
 
 

==== HTTPトランスポートの使用 ====
リモートアクセス用にHTTPトランスポートを有効化することができる。 
デフォルトポートは3000である。 
 
HTTPトランスポートの有効化例を以下に示す。 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio": {
"command": "npx",
"args": ["@lgazo/drawio-mcp-server", "--transport", "http"]
}
}
}
</syntaxhighlight>
 
この設定により、HTTP経由でMCPサーバにアクセスできる。 
 

== 利用可能なツール ==
==== get-selected-cells ====
選択されたセルの情報を取得する。 
 
* 機能
*: ダイアグラム上で選択されているセル (シェイプ、エッジ) の詳細情報を取得する
*: セルID、スタイル、位置、サイズ等の属性を返す
 
# 使用例 :

選択されているセルの情報を取得してください。
 
==== get-shape-categories ====
利用可能なシェイプカテゴリの一覧を取得する。 
 
* 機能
*: Draw.ioライブラリで利用可能なシェイプカテゴリを列挙する
*: 各カテゴリに含まれるシェイプタイプを確認できる
 
# 使用例 :

利用可能なシェイプカテゴリを一覧表示してください。
 
==== get-specific-shapes ====
特定のシェイプ情報を取得する。 
 
* 機能
*: 指定されたシェイプタイプの詳細情報を取得する
*: スタイルプロパティ、デフォルト設定、カスタマイズオプションを確認できる
 
# 使用例 :

矩形シェイプの詳細情報を取得してください。
 
==== list-paged-model ====
ページ分割されたダイアグラムモデルを取得する。 
 
* 機能
*: 複数ページを持つダイアグラムの構造を取得する
*: 各ページのセル、階層、接続関係を確認できる
 
# 使用例 :

ダイアグラムの全ページモデルを取得してください。
 
==== add-rectangle ====
ダイアグラムに矩形を追加する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| x || number || X座標位置
|-
| y || number || Y座標位置
|-
| width || number || 矩形の幅
|-
| height || number || 矩形の高さ
|-
| style || string || スタイル設定 (オプション)
|-
| value || string || 表示テキスト (オプション)
|}
</center>
 
# 使用例 :

座標 (100, 100) に幅200、高さ100の矩形を追加してください。
 
==== add-edge ====
2つのセルを接続するエッジ (接続線) を追加する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| source || string || 接続元のセルID
|-
| target || string || 接続先のセルID
|-
| style || string || エッジのスタイル設定 (オプション)
|-
| value || string || エッジのラベル (オプション)
|}
</center>
 
# 使用例 :

セルAとセルBを矢印で接続してください。
 
==== add-custom-shape ====
カスタムシェイプを追加する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| shapeType || string || シェイプタイプ (円、菱形、楕円等)
|-
| x || number || X座標位置
|-
| y || number || Y座標位置
|-
| width || number || シェイプの幅
|-
| height || number || シェイプの高さ
|-
| style || string || スタイル設定 (オプション)
|-
| value || string || 表示テキスト (オプション)
|}
</center>
 
# 使用例 :

座標 (200, 200) に円形シェイプを追加してください。
 
==== delete-cell ====
指定されたセルを削除する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| cellId || string || 削除するセルのID
|}
</center>
 
# 使用例 :

セルID「cell-123」を削除してください。
 
==== edit-cell ====
既存のセルのプロパティを編集する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| cellId || string || 編集するセルのID
|-
| style || string || 新しいスタイル設定 (オプション)
|-
| value || string || 新しい表示テキスト (オプション)
|-
| geometry || object || 新しい位置・サイズ情報 (オプション)
|}
</center>
 
# 使用例 :

セルID「cell-123」のテキストを「データベース」に変更してください。
 
==== apply-library-style ====
ライブラリで定義されたスタイルをセルに適用する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| cellId || string || スタイルを適用するセルのID
|-
| libraryName || string || ライブラリ名
|-
| styleName || string || スタイル名
|}
</center>
 
# 使用例 :

セルID「cell-123」にAWSライブラリのEC2スタイルを適用してください。
 
==== set-cell-data ====
セルにカスタム属性データを保存する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| cellId || string || データを保存するセルのID
|-
| key || string || 属性のキー
|-
| value || string || 属性の値
|}
</center>
 
# 使用例 :

セルID「cell-123」にカスタム属性「type=server」を保存してください。
 

== 使用方法 ==
==== プロンプトの基本形式 ====
Claude DesktopでDraw.io MCP Serverを使用する際は、自然言語でダイアグラムの作成を依頼できる。 
 
# 基本形式 :

@Draw.io MCP Server <指示内容>
 
プロンプト内で、作成するダイアグラムの種類、含めるべき要素、レイアウト、スタイル等を指定する。 
Claude AIが自動的に適切なツールを選択して実行する。 
 
==== シンプルなフローチャートの作成 ====
# プロンプト例 :

@Draw.io MCP Server フローチャートを作成してください。
スタートノード、処理ステップ3つ、判定ノード1つ、終了ノードを含めてください。
 
==== アーキテクチャ図の作成 ====
# プロンプト例 :

@Draw.io MCP Server データベースアーキテクチャ図を作成してください。
ユーザサーバ、アプリケーションサーバ、データベースサーバを矩形で表現し、矢印で接続関係を示してください。
 
==== マイクロサービス図の作成 ====
# プロンプト例 :

@Draw.io MCP Server マイクロサービスのシステムアーキテクチャを描画してください。
各サービスを異なる色の矩形で表現し、それぞれの通信プロトコルをラベル付きの矢印で示してください。
 
==== スタイル指定を含む作成 ====
# プロンプト例 :

@Draw.io MCP Server ネットワーク図を作成してください。
ルータ、スイッチ、サーバを適切なアイコンで表現し、VLANごとに異なる背景色を使用してください。
 
==== 複数ページのダイアグラム ====
# プロンプト例 :

@Draw.io MCP Server システム設計書を作成してください。
ページ1に概要図、ページ2に詳細アーキテクチャ、ページ3にデータフロー図を配置してください。
 

== システムアーキテクチャ ==
Draw.io MCP Serverは、3層アーキテクチャで構成されている。 
 
==== アーキテクチャ概要 ====
コンポーネント構成 
* MCPクライアント層
*: Claude Desktop、oterm、Zed 等
* Draw.io MCP Server層
*: Node.jsベースのTypeScript実装
* ブラウザ拡張機能層
*: Draw.io MCP Extension (Chrome / Firefox)
* Draw.io層
*: app.diagrams.net のWebアプリケーション
 
通信フロー 
# Claude DesktopからDraw.io MCP Serverにツール呼び出しを送信する。
# Draw.io MCP ServerがWebSocket (ポート3333) 経由でブラウザ拡張機能に接続する。
# ブラウザ拡張機能がDraw.io APIを使用してダイアグラムを操作する。
# 結果がサーバ経由でClaudeに返却される。
 
データフロー 
# プロンプトを入力する。(Claude Desktop)
# MCPツールを呼び出す。(Claude → Draw.io MCP Server)
# WebSocket通信を開始する。(Draw.io MCP Server → ブラウザ拡張機能)
# ダイアグラム操作 (ブラウザ拡張機能 → Draw.io)
# 結果が返却 (逆方向)
 

== トラブルシューティング ==
==== サーバに接続できない ====
以下の項目を確認する。 
* ブラウザ拡張機能がインストールされているか確認
*: Chrome Web StoreまたはFirefox Add-onsから正しくインストールされていることを確認
* ブラウザ拡張機能がアクティブであるか確認
*: 拡張機能のアイコンが表示され、有効化されていることを確認
* Claude Desktopが再起動されているか確認
*: 設定ファイル編集後、必ずClaude Desktopを再起動する
* デフォルトポート3333が使用可能か確認
*: 他のアプリケーションがポート3333を使用していないか確認
*: ファイアウォールでポート3333が開放されているか確認
 
==== ダイアグラムが更新されない ====
以下の項目を確認する。 
* app.diagrams.netがブラウザで開かれているか確認
*: ブラウザで app.diagrams.net が開かれていることが必須
* WebSocket接続が確立されているか確認
*: ブラウザの開発者ツールでWebSocket接続状態を確認
* ペイロードサイズを確認
*: 大規模なダイアグラム操作の場合、処理に時間がかかる可能性がある
 
==== ツール呼び出しエラーが発生する ====
以下の項目を確認する。 
* Node.jsのバージョンの確認
*: Node.js 20以上がインストールされていることを確認する。
*: <code>node --version</code> コマンドでバージョンを確認する。
* MCP Server設定ファイルの確認
*: claude_desktop_config.jsonファイルの設定が正しいかどうかを確認する。
*: JSON形式のエラーがないかどうかを確認する。
* サーバログの確認
*: Claude Desktopのデバッグコンソールでエラーログを確認する。
*: View > Toggle Developer Tools でコンソールを開く。
 
==== Firefox拡張機能が動作しない ====
以下の項目を確認する。 
* 拡張機能のバージョンの確認
*: バージョン1.3.0以降を使用していることを確認する。
* 拡張機能の権限の確認
*: app.diagrams.net へのアクセス権限が付与されているか確認する。
 

== Draw.io MCP Extension ==
==== ブラウザ拡張機能の役割 ====
Draw.io MCP Extensionは、Draw.io MCP ServerとDraw.io間の橋渡しを行うコンポーネントである。 
 
主要機能は以下の通りである。 
* WebSocket経由でDraw.io MCP Serverと通信
* Draw.io APIを使用してダイアグラムを操作
* セル選択、シェイプ追加、エッジ追加、セル削除等の操作を実行
* ダイアグラムの状態をサーバに返却
 
==== 拡張機能のインストール場所 ====
* Google Chrome
** Chrome Web Store から「Draw.io MCP Extension」を検索してインストール
** URL: chrome.google.com/webstore (検索キーワード: Draw.io MCP Extension)
*: 
* Mozilla Firefox
** Firefox Add-onsから Draw.io MCP Extension を検索してインストール
** URL: addons.mozilla.org (検索キーワード: Draw.io MCP Extension)
 

== 関連リソース ==
* [https://github.com/lgazo/drawio-mcp-server Draw.io MCP ServerのGitHub]
* [https://glama.ai/mcp/servers/@lgazo/drawio-mcp-server Draw.io MCP Server on GLAMA]
* [https://modelcontextprotocol.io/ Model Context Protocol公式サイト]
* [https://app.diagrams.net/ Draw.io公式サイト]
 

== Draw.io MCP Server (jgraph/drawio-mcp) ==
JGraph Ltd (Draw.ioの開発元) が公式に提供するMCPサーバである。 
npmパッケージ名は @drawio/mcp であり、Apache 2.0ライセンスで配布されている。 
 
前述の@lgazo/drawio-mcp-serverがブラウザ拡張機能経由でリアルタイムにDraw.ioを操作するのに対し、jgraph版はブラウザ拡張機能を必要としない。 
 
代わりに、以下に示す4つの統合アプローチを提供する。 
 
<center>
{| class="wikitable"
|+ Draw.io 統合方式の一覧
! 方式 !! 説明
|-
| MCP App Server || チャット内にインラインでダイアグラムを表示する方式 インストール不要で、公式ホストエンドポイント (https://mcp.draw.io/mcp) を使用する。
|-
| MCP Tool Server || WebブラウザでDraw.ioエディタを開いてダイアグラムを表示する方式 @drawio/mcp パッケージをnpxで実行する。
|-
| Skill + CLI || <code>.drawio</code> ファイルを生成し、draw.io DesktopアプリでPNG / SVG / PDFにエクスポートする方式 draw.io Desktopアプリのインストールが必要
|-
| Project Instructions || インストール不要で、Pythonスクリプトを使用してDraw.ioのURLを生成する方式
|}
</center>
 
対応する入力フォーマットは、XML、CSV、Mermaid.jsの3種類である。 
Node.js 18.0.0以上が必要である (MCP Tool ServerおよびSkill + CLI使用時)。 
 
対応するMCPクライアントは以下の通りである。 
* Claude Desktop
* Claude Code (CLI)
* Cursor
* Windsurf
* その他のMCP対応クライアント
 

== jgraph版 : 4つの統合アプローチ ==
jgraph版Draw.io MCPは、4つの異なる統合アプローチを提供している。 
用途に応じて適切なアプローチを選択する。 
 
<center>
{| class="wikitable"
|+ 4つの統合アプローチの比較
! アプローチ !! 動作方法 !! 出力形式 !! インストール !! 対応フォーマット !! 対応クライアント !! ベストユースケース
|-
| MCP App Server || チャット内にインライン表示 || インラインダイアグラム || 不要 (公式ホスト使用) || XML, CSV, Mermaid || Claude Desktop || チャット内でダイアグラムを確認したい場合
|-
| MCP Tool Server || ブラウザでDraw.ioエディタを開く || ブラウザ表示 || npxで実行 || XML, CSV, Mermaid || Claude Desktop, Cursor, Windsurf等 || ダイアグラムをDraw.ioエディタで編集したい場合
|-
| Skill + CLI || .drawioファイル生成 + エクスポート || .drawio, PNG, SVG, PDF || npm install + draw.io Desktop || XML || Claude Code || ファイルとして保存・エクスポートしたい場合
|-
| Project Instructions || PythonでURL生成 || ブラウザ表示 || 不要 (Pythonのみ) || XML || 全クライアント || インストールなしでダイアグラムを生成したい場合
|}
</center>
 

== jgraph版 : 動作要件 ==
==== 共通要件 ====
* インターネット接続
*: Draw.ioのWebアプリケーション (https://app.diagrams.net) へのアクセスが必要
* MCPクライアント
*: Claude Desktop、Claude Code、Cursor、Windsurf等のMCP対応クライアント
 
==== MCP Tool Serverの要件 ====
* Node.js 18.0.0以上
* npm (npxコマンドが利用可能であること)
 
==== Skill + CLIの要件 ====
* Node.js 18.0.0以上
* npm または pnpm
* draw.io Desktopアプリ
*: エクスポート機能 (PNG / SVG / PDF) を使用する場合に必要
 
==== MCP App Serverの要件 ====
* 追加のインストールは不要
* 公式ホストエンドポイント (https://mcp.draw.io/mcp) を使用
 
==== Project Instructionsの要件 ====
* Python 3の実行環境
* 追加のパッケージインストールは不要
 

== jgraph版 : MCP Tool Serverのインストール ==
==== npxでの実行 (推奨) ====
グローバルインストール不要で、常に最新バージョンを使用できる。 
 
npx @drawio/mcp
 
==== グローバルインストール ====
npmでグローバルにインストールする場合は、以下のコマンドを実行する。 
 
npm install -g @drawio/mcp
 
インストール後、以下のコマンドで実行する。 
 
drawio-mcp
 
==== ソースからのインストール ====
GitHubリポジトリからソースコードを取得してビルドする場合は、以下のコマンドを実行する。 
 
git clone https://github.com/jgraph/drawio-mcp.git
cd drawio-mcp
npm install
npm run build
 
ビルド後、以下のコマンドで実行する。 
 
node dist/tool-server.js
 
==== Claude Desktopでの設定 ====
Claude Desktopの設定ファイルを編集して、MCP Tool Serverを登録する。 
 
設定ファイルの場所は、以下の通りである。 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* MacOS
*: ~/Library/Application Support/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
設定内容を以下に示す。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio-mcp": {
"command": "npx",
"args": ["-y", "@drawio/mcp"]
}
}
}
</syntaxhighlight>
 
Claude Desktopを再起動して設定を反映する。 
 
==== Claude Codeでの設定 ====
Claude Codeで使用する場合は、以下のコマンドを実行する。 
 
claude mcp add drawio-mcp -- npx -y @drawio/mcp
 
または、設定ファイルを直接編集する。 
 
設定ファイルの場所は、以下の通りである。 
* MacOS / Linux
*: ~/.config/claude/config.json
* Windows
*: %APPDATA%\claude\config.json
 
設定内容は、Claude Desktopと同じJSONフォーマットを使用する。 
 
==== その他のMCPクライアントでの設定 ====
Cursor、Windsurf等の他のMCPクライアントでも使用できる。 
各クライアントの設定方法に従い、以下の情報を設定する。 
* コマンド
*: <code>npx</code>
* 引数
*: <code>-y</code>, <code>@drawio/mcp</code>
 

== jgraph版 : MCP App Serverの設定 ==
MCP App Serverは、チャット内にダイアグラムをインラインで表示する方式である。 
インストール不要で、公式ホストのエンドポイントを使用する。 
 
==== 公式ホストエンドポイント ====
JGraphが提供する公式エンドポイントを使用する。 
* https://mcp.draw.io/mcp
 
Claude Desktopの設定で、上記URLをMCP App Serverとして登録する。 
 
==== セルフホスト (Node.js) ====
MCP App Serverをセルフホストする場合は、以下のコマンドを実行する。 
 
npx @drawio/mcp --app-server
 
デフォルトでは、ポート3000でHTTPサーバが起動する。 
 
==== Claude Desktopでの設定 (stdio) ====
stdioトランスポートを使用してMCP App Serverを起動する場合は、以下の設定を使用する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio-app": {
"command": "npx",
"args": ["-y", "@drawio/mcp", "--app-server"]
}
}
}
</syntaxhighlight>
 
==== Cloudflare Workersへのデプロイ ====
MCP App ServerをCloudflare Workersにデプロイすることも可能である。 
 
リポジトリのクローンとデプロイは以下のコマンドで実行する。 
 
git clone https://github.com/jgraph/drawio-mcp.git
cd drawio-mcp
npm install
npx wrangler deploy
 
デプロイ後、Cloudflare WorkersのURLをMCPクライアントに設定する。 
 

== jgraph版 : Skill + CLIの設定 ==
Skill + CLIは、<code>.drawio</code>ファイルを生成し、draw.io DesktopアプリでPNG / SVG / PDFにエクスポートする方式である。 
 
==== 前提条件 ====
* Node.js 18.0.0以上
* draw.io Desktopアプリ
*: エクスポート機能を使用するために必要
*: [https://github.com/jgraph/drawio-desktop/releases draw.io Desktop公式リリースページ] からダウンロード可能
 
==== インストール ====
グローバルにインストールする場合は、以下のコマンドを実行する。 
 
npm install -g @drawio/mcp
 
プロジェクト単位でインストールする場合は、以下のコマンドを実行する。 
 
npm install @drawio/mcp
 
==== draw.io CLIの場所 ====
draw.io Desktopアプリのコマンドライン実行ファイルの場所は、OSにより異なる。 
 
* MacOS
*: <code>/Applications/draw.io.app/Contents/MacOS/draw.io</code>
* Linux
*: <code>drawio</code> (PATHに含まれている場合)
*: または、AppImageの場所を直接指定する
* Windows
*: <code>C:\Program Files\draw.io\draw.io.exe</code>
 
==== エクスポートフォーマット ====
Skill + CLIで対応しているエクスポートフォーマットを以下に示す。 
 
<center>
{| class="wikitable"
|+ エクスポートフォーマット
! フォーマット !! 拡張子 !! 説明
|-
| Draw.io || .drawio || Draw.ioネイティブ形式 (XML)
|-
| PNG || .png || ラスター画像形式
|-
| SVG || .svg || ベクター画像形式
|-
| PDF || .pdf || PDF文書形式
|}
</center>
 

== jgraph版 : Project Instructionsの設定 ==
Project Instructionsは、インストール不要でダイアグラムを生成する方式である。 
Pythonスクリプトを使用してDraw.ioのURLを生成し、ブラウザで開く。 
 
==== 概要 ====
MCPサーバのインストールが不要であり、全てのMCPクライアントで動作する。 
プロジェクトの指示ファイル (CLAUDE.mdやcursor rules等) にDraw.io URLの生成方法を記述することで、LLMがPythonスクリプトを実行してダイアグラムを生成する。 
 
==== セットアップ方法 ====
プロジェクトの指示ファイルに以下の内容を追記する。 
 
<syntaxhighlight lang="text">
When generating diagrams, create a draw.io compatible XML representation
and then generate a URL using the following Python code:

import zlib, base64
xml = '<your draw.io XML>'
compressed = zlib.compress(xml.encode('utf-8'), 9)[2:-4]
encoded = base64.urlsafe_b64encode(compressed).decode('utf-8')
url = f'https://app.diagrams.net/#create={encoded}'
</syntaxhighlight>
 
==== 動作の仕組み ====
# LLMがDraw.io互換のXMLを生成する。
# Pythonのzlibで圧縮 (deflateRaw) を行う。
# base64でURLセーフエンコードを行う。
# https://app.diagrams.net/#create= の後にエンコード済みデータを付加してURLを生成する。
# 生成されたURLをWebブラウザで開くと、Draw.ioエディタにダイアグラムが表示される。
 

== jgraph版 : MCP Tool Serverのツール ==
MCP Tool Serverは、3つのツールを提供する。 
各ツールは、異なる入力フォーマットに対応している。 
 
==== open_drawio_xml ====
Draw.io XML形式のダイアグラムをブラウザで開く。 
 
<center>
{| class="wikitable"
|+ open_drawio_xmlのパラメータ
! パラメータ !! 型 !! 必須 !! 説明
|-
| content || string || はい || Draw.io XML形式のダイアグラムデータ
|-
| lightbox || boolean || いいえ || 読み取り専用のライトボックスモードで開く。(デフォルト: false)
|-
| dark || boolean || いいえ || ダークモードで表示する。(デフォルト: false)
|}
</center>
 
==== open_drawio_csv ====
CSV形式のデータからダイアグラムをWebブラウザで開く。 
 
<center>
{| class="wikitable"
|+ open_drawio_csvのパラメータ
! パラメータ !! 型 !! 必須 !! 説明
|-
| content || string || はい || CSV形式のダイアグラムデータ
|-
| lightbox || boolean || いいえ || 読み取り専用のライトボックスモードで開く。(デフォルト: false)
|-
| dark || boolean || いいえ || ダークモードで表示する。(デフォルト: false)
|}
</center>
 
==== open_drawio_mermaid ====
Mermaid.js形式のダイアグラムをブラウザで開く。 
 
<center>
{| class="wikitable"
|+ open_drawio_mermaidのパラメータ
! パラメータ !! 型 !! 必須 !! 説明
|-
| content || string || はい || Mermaid.js形式のダイアグラムデータ
|-
| lightbox || boolean || いいえ || 読み取り専用のライトボックスモードで開く。(デフォルト: false)
|-
| dark || boolean || いいえ || ダークモードで表示する。(デフォルト: false)
|}
</center>
 

== jgraph版 : 使用方法 ==
==== MCP Tool Serverでの使用例 ====
MCP Tool Serverを使用する場合のプロンプト例を以下に示す。 
 
* Mermaidダイアグラムの場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

以下のMermaid形式でシーケンス図をDraw.ioで作成してください。
sequenceDiagram
Client->>Server: HTTPリクエスト
Server->>Database: クエリ実行
Database-->>Server: 結果返却
Server-->>Client: HTTPレスポンス
</syntaxhighlight>
*: 
* CSVデータからダイアグラムを作成する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

以下の組織データからCSV形式で組織図をDraw.ioで作成してください。
CEO配下にCTO、CFO、COOの3つのポジションがあります。
</syntaxhighlight>
*: 
* XMLダイアグラムの場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

Webアプリケーションの3層アーキテクチャ図をDraw.io XMLで作成してください。
フロントエンド、バックエンド、データベースの3層を含めてください。
</syntaxhighlight>
 
==== Skill + CLIでの使用例 ====
Claude Code (CLI) でSkill + CLIを使用する場合は、<code>/drawio</code> コマンドを使用する。 
 
# 使用例 :

/drawio マイクロサービスのアーキテクチャ図を作成してください。
各サービス間の通信方式も記載してください。
 
エクスポートを含む使用例を以下に示す。 
# 使用例 :

/drawio ネットワーク構成図を作成して、PNGファイルとしてエクスポートしてください。
 
==== Project Instructionsでの使用例 ====
Project Instructionsを使用する場合のプロンプト例を以下に示す。 
 
# プロンプト例 :

システムのデプロイメントフロー図を作成して、Draw.ioで開けるURLを生成してください。
 

== jgraph版 : 動作の仕組み ==
==== MCP Tool Serverの処理フロー ====
MCP Tool Serverは、以下の手順でダイアグラムを表示する。 
 
# MCPクライアントからダイアグラムデータ (XML / CSV / Mermaid) を受信する。
# pakoライブラリを使用して、データをdeflateRaw圧縮する。
# 圧縮データをBase64エンコードする。
# https://app.diagrams.net/#create= の後にエンコード済みデータを付加したURLを生成する。
# 生成されたURLをWebブラウザで開き、Draw.ioエディタにダイアグラムを表示する。
 
==== MCP App Serverの処理フロー ====
MCP App Serverは、以下の手順でダイアグラムを表示する。 
 
# MCPクライアントからダイアグラムデータを受信する。
# サーバ側でダイアグラムデータを処理する。
# チャットインターフェース内にダイアグラムをインラインで描画する。
# ユーザはチャット内で直接ダイアグラムを確認できる。
 
==== URLの安全性 ====
MCP Tool ServerおよびProject Instructionsで生成されるURLは、ハッシュフラグメント方式 (<code>#create=</code>) を使用している。 
 
* ハッシュフラグメント (<code>#</code> 以降のデータ) は、Webブラウザからサーバに送信されない
*: そのため、ダイアグラムデータがDraw.ioのサーバに送信されることはない
* 全てのデータ処理はブラウザ内で完結する
* 機密性の高いダイアグラムデータも安全に扱うことができる
 

== jgraph版 : トラブルシューティング ==
==== npxが見つからない場合 ====
以下の項目を確認する。 
 
* Node.jsのバージョン確認
*: Node.js 18.0.0以上がインストールされていることを確認する。
*: <code>node --version</code> コマンドでバージョンを確認する。
* npxの確認
*: <code>npx --version</code> コマンドでnpxが利用可能であることを確認する。
*: npxが見つからない場合は、Node.jsを再インストールする。
 
==== ダイアグラムが開かない場合 ====
以下の項目を確認する。 
 
* インターネット接続の確認
*: https://app.diagrams.net にアクセスできることを確認する。
* Webブラウザの確認
*: デフォルトブラウザが設定されていることを確認する。
*: ポップアップブロッカーがURLの展開を妨げていないか確認する。
* URLの長さ制限
*: 非常に大きなダイアグラムの場合、URLの長さがブラウザの制限を超える可能性がある。
*: その場合は、Skill + CLIアプローチを使用してファイルとして生成することを推奨する。
 
==== draw.io CLIでのエクスポートが失敗する場合 ====
以下の項目を確認する。 
 
* draw.io Desktopの確認
*: draw.io Desktopアプリがインストールされていることを確認する。
*: CLIコマンドがPATHに含まれていることを確認する。
* ディスプレイ環境の確認 (Linux)
*: LinuxでGUIなし環境の場合、<code>xvfb-run</code> が必要になることがある。
*: <code>xvfb-run drawio --export --format png diagram.drawio</code>
 
==== Claude Desktopで認識されない場合 ====
以下の項目を確認する。 
 
* 設定ファイルの確認
*: claude_desktop_config.jsonファイル のJSON形式が正しいことを確認する。
*: <code>mcpServers</code> キーの下に正しく設定されていることを確認する。
* Claude Desktopの再起動
*: 設定ファイル編集後、Claude Desktopを再起動する。
* ログの確認
*: Claude Desktopのデバッグコンソール ([View] - [Toggle Developer Tools]) でエラーログを確認する。
 

{{#seo:
|title={{PAGENAME}} : Draw.io MCP Server | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,MCP,Model Context Protocol,Draw.io,Diagram,Flowchart,Architecture,UML,Sequence Diagram,Network Diagram,Claude,AI,Machine Learning,Node.js,TypeScript,Browser Extension,WebSocket,Visualization,jgraph,@drawio/mcp,MCP App Server,Mermaid,CSV,Skill,CLI
|description={{PAGENAME}} - Draw.io MCP Serverに関する包括的なガイド、コミュニティ版とJGraph公式版の両方を網羅したAIアシスタントによるダイアグラム作成と編集の自動化 | This page is {{PAGENAME}} in our wiki about Draw.io MCP servers and AI-powered diagram creation
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

MCPサーバ - Draw.io

2026-04-09T15:16:45Z

Wiki: /* インストール */

== 概要 ==
Draw.io MCP Server は、AI システムがDraw.io ダイアグラムをプログラマティックに制御・検査できるようにするMCP (Model Context Protocol) サーバである。 
このMCPを使用することにより、Claude等のLLMがDraw.io上でフローチャート、シーケンス図、アーキテクチャ図、ネットワーク図等の様々なダイアグラムを自動的に作成・編集することができる。 
 
Draw.io MCP Serverは、以下に示すような機能を提供する。 
* ダイアグラムの検査機能 (選択セル取得、シェイプカテゴリ列挙、ページモデル取得)
* ダイアグラムの編集機能 (矩形追加、エッジ追加、カスタムシェイプ追加、セル削除)
* セルのプロパティ編集とスタイル適用
* カスタム属性の保存と管理
 
Draw.io MCP Serverは、WebSocket (デフォルトポート: 3333) を使用してブラウザ拡張機能経由でDraw.ioと通信する。 
これにより、Claude Desktop、oterm、Zed等のMCPクライアントと統合することができる。 
 
Draw.io MCP Serverの最大の特徴は、Webブラウザ拡張機能を介してリアルタイムにDraw.ioダイアグラムを操作できることである。 
全てのダイアグラム処理機能は、TypeScriptで実装されており、Node.js 20以上で動作する。 
 

== Draw.io MCP Serverの機能 ==
==== ダイアグラム検査機能 ====
* 選択されたセルの取得 (get-selected-cells)
* シェイプカテゴリの列挙 (get-shape-categories)
* 特定のシェイプ情報の取得 (get-specific-shapes)
* ページ分割されたダイアグラムモデルの取得 (list-paged-model)
 
==== ダイアグラム編集機能 ====
* 矩形の追加 (add-rectangle)
* エッジ (接続線) の追加 (add-edge)
* カスタムシェイプの追加 (add-custom-shape)
* セルの削除 (delete-cell)
* セルのプロパティ編集 (edit-cell)
 
==== スタイルとデータ管理 ====
* ライブラリスタイルの適用 (apply-library-style)
* カスタム属性の保存 (set-cell-data)
* シェイプのプロパティ変更
 

== 対応ダイアグラムタイプ ==
Draw.io MCP Serverは、Draw.ioで作成可能なすべてのダイアグラムタイプをサポートしている。 
 
<center>
{| class="wikitable"
|+ 対応ダイアグラムタイプ
|-
! タイプ !! 説明
|-
| フローチャート || プロセスフローと意思決定を視覚化
|-
| シーケンス図 || システムコンポーネント間の相互作用を時系列で表現
|-
| アーキテクチャ図 || システムアーキテクチャとコンポーネント構成を記述
|-
| ネットワーク図 || ネットワークトポロジーとデバイス接続を表現
|-
| データベース設計図 || データベーススキーマとER図を記述
|-
| UML図 || クラス図、アクティビティ図、ユースケース図等
|-
| マインドマップ || アイデアと概念の階層構造を視覚化
|-
| 組織図 || 組織構造と報告関係を表現
|-
| Ganttチャート || プロジェクトタイムラインとタスク管理
|}
</center>
 

== 動作要件 ==
==== システム要件 ====
* Node.js 20以上
* Draw.io MCP Browser Extension (Chrome または Firefox)
* MCPクライアント (Claude Desktop、oterm、Zed等)
 
==== 必須コンポーネント ====
* Draw.io MCP Server (TypeScript実装)
* Draw.io MCP Extension (ブラウザ拡張機能)
* app.diagrams.net へのアクセス
 
==== ネットワーク要件 ====
* WebSocketポート (デフォルト: 3333) の利用可能性
* ファイアウォールでの指定ポートの開放
* ブラウザ拡張機能とサーバ間の通信許可
 

== インストール ==
==== Draw.io MCP Serverのインストール ====
Draw.io MCP Serverは、MCPクライアントの設定ファイルを編集することにより、自動的にインストールされる。 
以下に示す設定例を参照すること。 
 
==== Claude Desktopでの設定 ====
Claude Desktopの設定ファイルを編集する。 
 
設定ファイルの場所は、以下の通りである。 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
npmを使用する場合の設定を以下に示す。 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio": {
"command": "npx",
"args": ["-y", "drawio-mcp-server"]
}
}
}
</syntaxhighlight>
 
pnpmを使用する場合の設定を以下に示す。 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio": {
"command": "pnpm",
"args": ["dlx", "drawio-mcp-server"]
}
}
}
</syntaxhighlight>
 
yarnを使用する場合の設定を以下に示す。 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio": {
"command": "yarn",
"args": ["dlx", "drawio-mcp-server"]
}
}
}
</syntaxhighlight>
 
Claude Desktopを再起動して、Draw.io MCP Serverが利用可能であることを確認する。 
 
==== Claude Codeでの設定 ====
Claude Code (CLI) でも、Claude Desktopと同様の設定ファイルを使用してDraw.io MCP Serverを利用できる。 
 
設定ファイルの場所は、以下の通りである。 
* Linux
*: ~/.config/claude/config.json
* Windows
*: %APPDATA%\claude\config.json
 
設定内容は、Claude Desktopと同じである。 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio": {
"command": "npx",
"args": ["-y", "drawio-mcp-server"]
}
}
}
</syntaxhighlight>
 
==== ブラウザ拡張機能のインストール ====
Draw.io MCP Extensionをブラウザにインストールする必要がある。 
 
===== Google Chromeの場合 =====
# Chrome Web Storeから「Draw.io MCP Extension」を検索
# [追加] ボタンをクリックしてインストール
# 拡張機能がアクティブであることを確認
 
===== Mozilla Firefoxの場合 =====
# Firefox Add-onsから "Draw.io MCP Extension" を検索する。
# [Firefoxに追加]ボタンを押下してインストールする。
# 拡張機能がアクティブであることを確認する。
 
==== app.diagrams.netへのアクセス ====
# Webブラウザで app.diagrams.net を開く。
# Draw.io MCP Serverは、このページ上でダイアグラムを操作する。
 

== 設定とカスタマイズ ==
==== ポート設定 ====
Draw.io MCP Serverは、デフォルトでWebSocketポート3333を使用してブラウザ拡張機能と通信する。 
このポート番号は、カスタマイズすることができる。 
 
※注意 
各MCPサーバインスタンスが独自のWebSocketサーバを起動しようとするため、同じポートを使う複数のインスタンスは共存できない。 
例えば、複数のClaude CodeおよびClaude Desktopを起動してDraw.io MCP Serverを使用する場合、同じポート番号を使用するとエラーになる。 
そのため、異なるポート番号を指定する必要がある。 
 
カスタムポートの設定例を以下に示す。 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio": {
"command": "npx",
"args": ["@lgazo/drawio-mcp-server", "--extension-port", "4000"]
}
}
}
</syntaxhighlight>
 
この設定により、ポート4000でWebSocket通信を行う。 
 
また、ブラウザ拡張機能側も同じポート番号を設定する必要がある。 
* ブラウザ拡張機能のポート設定
*# ブラウザ拡張機能のアイコンをクリックする。
*# 設定画面が表示される。
*# WebSocketポート番号を4000に変更する。
*# 保存して拡張機能を再読み込みする。
 
 

==== HTTPトランスポートの使用 ====
リモートアクセス用にHTTPトランスポートを有効化することができる。 
デフォルトポートは3000である。 
 
HTTPトランスポートの有効化例を以下に示す。 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio": {
"command": "npx",
"args": ["@lgazo/drawio-mcp-server", "--transport", "http"]
}
}
}
</syntaxhighlight>
 
この設定により、HTTP経由でMCPサーバにアクセスできる。 
 

== 利用可能なツール ==
==== get-selected-cells ====
選択されたセルの情報を取得する。 
 
* 機能
*: ダイアグラム上で選択されているセル (シェイプ、エッジ) の詳細情報を取得する
*: セルID、スタイル、位置、サイズ等の属性を返す
 
# 使用例 :

選択されているセルの情報を取得してください。
 
==== get-shape-categories ====
利用可能なシェイプカテゴリの一覧を取得する。 
 
* 機能
*: Draw.ioライブラリで利用可能なシェイプカテゴリを列挙する
*: 各カテゴリに含まれるシェイプタイプを確認できる
 
# 使用例 :

利用可能なシェイプカテゴリを一覧表示してください。
 
==== get-specific-shapes ====
特定のシェイプ情報を取得する。 
 
* 機能
*: 指定されたシェイプタイプの詳細情報を取得する
*: スタイルプロパティ、デフォルト設定、カスタマイズオプションを確認できる
 
# 使用例 :

矩形シェイプの詳細情報を取得してください。
 
==== list-paged-model ====
ページ分割されたダイアグラムモデルを取得する。 
 
* 機能
*: 複数ページを持つダイアグラムの構造を取得する
*: 各ページのセル、階層、接続関係を確認できる
 
# 使用例 :

ダイアグラムの全ページモデルを取得してください。
 
==== add-rectangle ====
ダイアグラムに矩形を追加する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| x || number || X座標位置
|-
| y || number || Y座標位置
|-
| width || number || 矩形の幅
|-
| height || number || 矩形の高さ
|-
| style || string || スタイル設定 (オプション)
|-
| value || string || 表示テキスト (オプション)
|}
</center>
 
# 使用例 :

座標 (100, 100) に幅200、高さ100の矩形を追加してください。
 
==== add-edge ====
2つのセルを接続するエッジ (接続線) を追加する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| source || string || 接続元のセルID
|-
| target || string || 接続先のセルID
|-
| style || string || エッジのスタイル設定 (オプション)
|-
| value || string || エッジのラベル (オプション)
|}
</center>
 
# 使用例 :

セルAとセルBを矢印で接続してください。
 
==== add-custom-shape ====
カスタムシェイプを追加する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| shapeType || string || シェイプタイプ (円、菱形、楕円等)
|-
| x || number || X座標位置
|-
| y || number || Y座標位置
|-
| width || number || シェイプの幅
|-
| height || number || シェイプの高さ
|-
| style || string || スタイル設定 (オプション)
|-
| value || string || 表示テキスト (オプション)
|}
</center>
 
# 使用例 :

座標 (200, 200) に円形シェイプを追加してください。
 
==== delete-cell ====
指定されたセルを削除する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| cellId || string || 削除するセルのID
|}
</center>
 
# 使用例 :

セルID「cell-123」を削除してください。
 
==== edit-cell ====
既存のセルのプロパティを編集する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| cellId || string || 編集するセルのID
|-
| style || string || 新しいスタイル設定 (オプション)
|-
| value || string || 新しい表示テキスト (オプション)
|-
| geometry || object || 新しい位置・サイズ情報 (オプション)
|}
</center>
 
# 使用例 :

セルID「cell-123」のテキストを「データベース」に変更してください。
 
==== apply-library-style ====
ライブラリで定義されたスタイルをセルに適用する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| cellId || string || スタイルを適用するセルのID
|-
| libraryName || string || ライブラリ名
|-
| styleName || string || スタイル名
|}
</center>
 
# 使用例 :

セルID「cell-123」にAWSライブラリのEC2スタイルを適用してください。
 
==== set-cell-data ====
セルにカスタム属性データを保存する。 
 
<center>
{| class="wikitable"
|+ パラメータ
|-
! パラメータ !! 型 !! 説明
|-
| cellId || string || データを保存するセルのID
|-
| key || string || 属性のキー
|-
| value || string || 属性の値
|}
</center>
 
# 使用例 :

セルID「cell-123」にカスタム属性「type=server」を保存してください。
 

== 使用方法 ==
==== プロンプトの基本形式 ====
Claude DesktopでDraw.io MCP Serverを使用する際は、自然言語でダイアグラムの作成を依頼できる。 
 
# 基本形式 :

@Draw.io MCP Server <指示内容>
 
プロンプト内で、作成するダイアグラムの種類、含めるべき要素、レイアウト、スタイル等を指定する。 
Claude AIが自動的に適切なツールを選択して実行する。 
 
==== シンプルなフローチャートの作成 ====
# プロンプト例 :

@Draw.io MCP Server フローチャートを作成してください。
スタートノード、処理ステップ3つ、判定ノード1つ、終了ノードを含めてください。
 
==== アーキテクチャ図の作成 ====
# プロンプト例 :

@Draw.io MCP Server データベースアーキテクチャ図を作成してください。
ユーザサーバ、アプリケーションサーバ、データベースサーバを矩形で表現し、矢印で接続関係を示してください。
 
==== マイクロサービス図の作成 ====
# プロンプト例 :

@Draw.io MCP Server マイクロサービスのシステムアーキテクチャを描画してください。
各サービスを異なる色の矩形で表現し、それぞれの通信プロトコルをラベル付きの矢印で示してください。
 
==== スタイル指定を含む作成 ====
# プロンプト例 :

@Draw.io MCP Server ネットワーク図を作成してください。
ルータ、スイッチ、サーバを適切なアイコンで表現し、VLANごとに異なる背景色を使用してください。
 
==== 複数ページのダイアグラム ====
# プロンプト例 :

@Draw.io MCP Server システム設計書を作成してください。
ページ1に概要図、ページ2に詳細アーキテクチャ、ページ3にデータフロー図を配置してください。
 

== システムアーキテクチャ ==
Draw.io MCP Serverは、3層アーキテクチャで構成されている。 
 
==== アーキテクチャ概要 ====
コンポーネント構成 
* MCPクライアント層
*: Claude Desktop、oterm、Zed 等
* Draw.io MCP Server層
*: Node.jsベースのTypeScript実装
* ブラウザ拡張機能層
*: Draw.io MCP Extension (Chrome / Firefox)
* Draw.io層
*: app.diagrams.net のWebアプリケーション
 
通信フロー 
# Claude DesktopからDraw.io MCP Serverにツール呼び出しを送信する。
# Draw.io MCP ServerがWebSocket (ポート3333) 経由でブラウザ拡張機能に接続する。
# ブラウザ拡張機能がDraw.io APIを使用してダイアグラムを操作する。
# 結果がサーバ経由でClaudeに返却される。
 
データフロー 
# プロンプトを入力する。(Claude Desktop)
# MCPツールを呼び出す。(Claude → Draw.io MCP Server)
# WebSocket通信を開始する。(Draw.io MCP Server → ブラウザ拡張機能)
# ダイアグラム操作 (ブラウザ拡張機能 → Draw.io)
# 結果が返却 (逆方向)
 

== トラブルシューティング ==
==== サーバに接続できない ====
以下の項目を確認する。 
* ブラウザ拡張機能がインストールされているか確認
*: Chrome Web StoreまたはFirefox Add-onsから正しくインストールされていることを確認
* ブラウザ拡張機能がアクティブであるか確認
*: 拡張機能のアイコンが表示され、有効化されていることを確認
* Claude Desktopが再起動されているか確認
*: 設定ファイル編集後、必ずClaude Desktopを再起動する
* デフォルトポート3333が使用可能か確認
*: 他のアプリケーションがポート3333を使用していないか確認
*: ファイアウォールでポート3333が開放されているか確認
 
==== ダイアグラムが更新されない ====
以下の項目を確認する。 
* app.diagrams.netがブラウザで開かれているか確認
*: ブラウザで app.diagrams.net が開かれていることが必須
* WebSocket接続が確立されているか確認
*: ブラウザの開発者ツールでWebSocket接続状態を確認
* ペイロードサイズを確認
*: 大規模なダイアグラム操作の場合、処理に時間がかかる可能性がある
 
==== ツール呼び出しエラーが発生する ====
以下の項目を確認する。 
* Node.jsのバージョンの確認
*: Node.js 20以上がインストールされていることを確認する。
*: <code>node --version</code> コマンドでバージョンを確認する。
* MCP Server設定ファイルの確認
*: claude_desktop_config.jsonファイルの設定が正しいかどうかを確認する。
*: JSON形式のエラーがないかどうかを確認する。
* サーバログの確認
*: Claude Desktopのデバッグコンソールでエラーログを確認する。
*: View > Toggle Developer Tools でコンソールを開く。
 
==== Firefox拡張機能が動作しない ====
以下の項目を確認する。 
* 拡張機能のバージョンの確認
*: バージョン1.3.0以降を使用していることを確認する。
* 拡張機能の権限の確認
*: app.diagrams.net へのアクセス権限が付与されているか確認する。
 

== Draw.io MCP Extension ==
==== ブラウザ拡張機能の役割 ====
Draw.io MCP Extensionは、Draw.io MCP ServerとDraw.io間の橋渡しを行うコンポーネントである。 
 
主要機能は以下の通りである。 
* WebSocket経由でDraw.io MCP Serverと通信
* Draw.io APIを使用してダイアグラムを操作
* セル選択、シェイプ追加、エッジ追加、セル削除等の操作を実行
* ダイアグラムの状態をサーバに返却
 
==== 拡張機能のインストール場所 ====
* Google Chrome
** Chrome Web Store から「Draw.io MCP Extension」を検索してインストール
** URL: chrome.google.com/webstore (検索キーワード: Draw.io MCP Extension)
*: 
* Mozilla Firefox
** Firefox Add-onsから Draw.io MCP Extension を検索してインストール
** URL: addons.mozilla.org (検索キーワード: Draw.io MCP Extension)
 

== 関連リソース ==
* [https://github.com/lgazo/drawio-mcp-server Draw.io MCP ServerのGitHub]
* [https://glama.ai/mcp/servers/@lgazo/drawio-mcp-server Draw.io MCP Server on GLAMA]
* [https://modelcontextprotocol.io/ Model Context Protocol公式サイト]
* [https://app.diagrams.net/ Draw.io公式サイト]
 

== Draw.io MCP Server (jgraph/drawio-mcp) ==
JGraph Ltd (Draw.ioの開発元) が公式に提供するMCPサーバである。 
npmパッケージ名は @drawio/mcp であり、Apache 2.0ライセンスで配布されている。 
 
前述の@lgazo/drawio-mcp-serverがブラウザ拡張機能経由でリアルタイムにDraw.ioを操作するのに対し、jgraph版はブラウザ拡張機能を必要としない。 
 
代わりに、以下に示す4つの統合アプローチを提供する。 
 
<center>
{| class="wikitable"
|+ Draw.io 統合方式の一覧
! 方式 !! 説明
|-
| MCP App Server || チャット内にインラインでダイアグラムを表示する方式 インストール不要で、公式ホストエンドポイント (https://mcp.draw.io/mcp) を使用する。
|-
| MCP Tool Server || WebブラウザでDraw.ioエディタを開いてダイアグラムを表示する方式 @drawio/mcp パッケージをnpxで実行する。
|-
| Skill + CLI || <code>.drawio</code> ファイルを生成し、draw.io DesktopアプリでPNG / SVG / PDFにエクスポートする方式 draw.io Desktopアプリのインストールが必要
|-
| Project Instructions || インストール不要で、Pythonスクリプトを使用してDraw.ioのURLを生成する方式
|}
</center>
 
対応する入力フォーマットは、XML、CSV、Mermaid.jsの3種類である。 
Node.js 18.0.0以上が必要である (MCP Tool ServerおよびSkill + CLI使用時)。 
 
対応するMCPクライアントは以下の通りである。 
* Claude Desktop
* Claude Code (CLI)
* Cursor
* Windsurf
* その他のMCP対応クライアント
 

== jgraph版 : 4つの統合アプローチ ==
jgraph版Draw.io MCPは、4つの異なる統合アプローチを提供している。 
用途に応じて適切なアプローチを選択する。 
 
<center>
{| class="wikitable"
|+ 4つの統合アプローチの比較
! アプローチ !! 動作方法 !! 出力形式 !! インストール !! 対応フォーマット !! 対応クライアント !! ベストユースケース
|-
| MCP App Server || チャット内にインライン表示 || インラインダイアグラム || 不要 (公式ホスト使用) || XML, CSV, Mermaid || Claude Desktop || チャット内でダイアグラムを確認したい場合
|-
| MCP Tool Server || ブラウザでDraw.ioエディタを開く || ブラウザ表示 || npxで実行 || XML, CSV, Mermaid || Claude Desktop, Cursor, Windsurf等 || ダイアグラムをDraw.ioエディタで編集したい場合
|-
| Skill + CLI || .drawioファイル生成 + エクスポート || .drawio, PNG, SVG, PDF || npm install + draw.io Desktop || XML || Claude Code || ファイルとして保存・エクスポートしたい場合
|-
| Project Instructions || PythonでURL生成 || ブラウザ表示 || 不要 (Pythonのみ) || XML || 全クライアント || インストールなしでダイアグラムを生成したい場合
|}
</center>
 

== jgraph版 : 動作要件 ==
==== 共通要件 ====
* インターネット接続
*: Draw.ioのWebアプリケーション (https://app.diagrams.net) へのアクセスが必要
* MCPクライアント
*: Claude Desktop、Claude Code、Cursor、Windsurf等のMCP対応クライアント
 
==== MCP Tool Serverの要件 ====
* Node.js 18.0.0以上
* npm (npxコマンドが利用可能であること)
 
==== Skill + CLIの要件 ====
* Node.js 18.0.0以上
* npm または pnpm
* draw.io Desktopアプリ
*: エクスポート機能 (PNG / SVG / PDF) を使用する場合に必要
 
==== MCP App Serverの要件 ====
* 追加のインストールは不要
* 公式ホストエンドポイント (https://mcp.draw.io/mcp) を使用
 
==== Project Instructionsの要件 ====
* Python 3の実行環境
* 追加のパッケージインストールは不要
 

== jgraph版 : MCP Tool Serverのインストール ==
==== npxでの実行 (推奨) ====
グローバルインストール不要で、常に最新バージョンを使用できる。 
 
npx @drawio/mcp
 
==== グローバルインストール ====
npmでグローバルにインストールする場合は、以下のコマンドを実行する。 
 
npm install -g @drawio/mcp
 
インストール後、以下のコマンドで実行する。 
 
drawio-mcp
 
==== ソースからのインストール ====
GitHubリポジトリからソースコードを取得してビルドする場合は、以下のコマンドを実行する。 
 
git clone https://github.com/jgraph/drawio-mcp.git
cd drawio-mcp
npm install
npm run build
 
ビルド後、以下のコマンドで実行する。 
 
node dist/tool-server.js
 
==== Claude Desktopでの設定 ====
Claude Desktopの設定ファイルを編集して、MCP Tool Serverを登録する。 
 
設定ファイルの場所は、以下の通りである。 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* MacOS
*: ~/Library/Application Support/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
設定内容を以下に示す。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio-mcp": {
"command": "npx",
"args": ["-y", "@drawio/mcp"]
}
}
}
</syntaxhighlight>
 
Claude Desktopを再起動して設定を反映する。 
 
==== Claude Codeでの設定 ====
Claude Codeで使用する場合は、以下のコマンドを実行する。 
 
claude mcp add drawio-mcp -- npx -y @drawio/mcp
 
または、設定ファイルを直接編集する。 
 
設定ファイルの場所は、以下の通りである。 
* MacOS / Linux
*: ~/.config/claude/config.json
* Windows
*: %APPDATA%\claude\config.json
 
設定内容は、Claude Desktopと同じJSONフォーマットを使用する。 
 
==== その他のMCPクライアントでの設定 ====
Cursor、Windsurf等の他のMCPクライアントでも使用できる。 
各クライアントの設定方法に従い、以下の情報を設定する。 
* コマンド
*: <code>npx</code>
* 引数
*: <code>-y</code>, <code>@drawio/mcp</code>
 

== jgraph版 : MCP App Serverの設定 ==
MCP App Serverは、チャット内にダイアグラムをインラインで表示する方式である。 
インストール不要で、公式ホストのエンドポイントを使用する。 
 
==== 公式ホストエンドポイント ====
JGraphが提供する公式エンドポイントを使用する。 
* https://mcp.draw.io/mcp
 
Claude Desktopの設定で、上記URLをMCP App Serverとして登録する。 
 
==== セルフホスト (Node.js) ====
MCP App Serverをセルフホストする場合は、以下のコマンドを実行する。 
 
npx @drawio/mcp --app-server
 
デフォルトでは、ポート3000でHTTPサーバが起動する。 
 
==== Claude Desktopでの設定 (stdio) ====
stdioトランスポートを使用してMCP App Serverを起動する場合は、以下の設定を使用する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"drawio-app": {
"command": "npx",
"args": ["-y", "@drawio/mcp", "--app-server"]
}
}
}
</syntaxhighlight>
 
==== Cloudflare Workersへのデプロイ ====
MCP App ServerをCloudflare Workersにデプロイすることも可能である。 
 
リポジトリのクローンとデプロイは以下のコマンドで実行する。 
 
git clone https://github.com/jgraph/drawio-mcp.git
cd drawio-mcp
npm install
npx wrangler deploy
 
デプロイ後、Cloudflare WorkersのURLをMCPクライアントに設定する。 
 

== jgraph版 : Skill + CLIの設定 ==
Skill + CLIは、<code>.drawio</code>ファイルを生成し、draw.io DesktopアプリでPNG / SVG / PDFにエクスポートする方式である。 
 
==== 前提条件 ====
* Node.js 18.0.0以上
* draw.io Desktopアプリ
*: エクスポート機能を使用するために必要
*: [https://github.com/jgraph/drawio-desktop/releases draw.io Desktop公式リリースページ] からダウンロード可能
 
==== インストール ====
グローバルにインストールする場合は、以下のコマンドを実行する。 
 
npm install -g @drawio/mcp
 
プロジェクト単位でインストールする場合は、以下のコマンドを実行する。 
 
npm install @drawio/mcp
 
==== draw.io CLIの場所 ====
draw.io Desktopアプリのコマンドライン実行ファイルの場所は、OSにより異なる。 
 
* MacOS
*: <code>/Applications/draw.io.app/Contents/MacOS/draw.io</code>
* Linux
*: <code>drawio</code> (PATHに含まれている場合)
*: または、AppImageの場所を直接指定する
* Windows
*: <code>C:\Program Files\draw.io\draw.io.exe</code>
 
==== エクスポートフォーマット ====
Skill + CLIで対応しているエクスポートフォーマットを以下に示す。 
 
<center>
{| class="wikitable"
|+ エクスポートフォーマット
! フォーマット !! 拡張子 !! 説明
|-
| Draw.io || .drawio || Draw.ioネイティブ形式 (XML)
|-
| PNG || .png || ラスター画像形式
|-
| SVG || .svg || ベクター画像形式
|-
| PDF || .pdf || PDF文書形式
|}
</center>
 

== jgraph版 : Project Instructionsの設定 ==
Project Instructionsは、インストール不要でダイアグラムを生成する方式である。 
Pythonスクリプトを使用してDraw.ioのURLを生成し、ブラウザで開く。 
 
==== 概要 ====
MCPサーバのインストールが不要であり、全てのMCPクライアントで動作する。 
プロジェクトの指示ファイル (CLAUDE.mdやcursor rules等) にDraw.io URLの生成方法を記述することで、LLMがPythonスクリプトを実行してダイアグラムを生成する。 
 
==== セットアップ方法 ====
プロジェクトの指示ファイルに以下の内容を追記する。 
 
<syntaxhighlight lang="text">
When generating diagrams, create a draw.io compatible XML representation
and then generate a URL using the following Python code:

import zlib, base64
xml = '<your draw.io XML>'
compressed = zlib.compress(xml.encode('utf-8'), 9)[2:-4]
encoded = base64.urlsafe_b64encode(compressed).decode('utf-8')
url = f'https://app.diagrams.net/#create={encoded}'
</syntaxhighlight>
 
==== 動作の仕組み ====
# LLMがDraw.io互換のXMLを生成する。
# Pythonのzlibで圧縮 (deflateRaw) を行う。
# base64でURLセーフエンコードを行う。
# https://app.diagrams.net/#create= の後にエンコード済みデータを付加してURLを生成する。
# 生成されたURLをWebブラウザで開くと、Draw.ioエディタにダイアグラムが表示される。
 

== jgraph版 : MCP Tool Serverのツール ==
MCP Tool Serverは、3つのツールを提供する。 
各ツールは、異なる入力フォーマットに対応している。 
 
==== open_drawio_xml ====
Draw.io XML形式のダイアグラムをブラウザで開く。 
 
<center>
{| class="wikitable"
|+ open_drawio_xmlのパラメータ
! パラメータ !! 型 !! 必須 !! 説明
|-
| content || string || はい || Draw.io XML形式のダイアグラムデータ
|-
| lightbox || boolean || いいえ || 読み取り専用のライトボックスモードで開く。(デフォルト: false)
|-
| dark || boolean || いいえ || ダークモードで表示する。(デフォルト: false)
|}
</center>
 
==== open_drawio_csv ====
CSV形式のデータからダイアグラムをWebブラウザで開く。 
 
<center>
{| class="wikitable"
|+ open_drawio_csvのパラメータ
! パラメータ !! 型 !! 必須 !! 説明
|-
| content || string || はい || CSV形式のダイアグラムデータ
|-
| lightbox || boolean || いいえ || 読み取り専用のライトボックスモードで開く。(デフォルト: false)
|-
| dark || boolean || いいえ || ダークモードで表示する。(デフォルト: false)
|}
</center>
 
==== open_drawio_mermaid ====
Mermaid.js形式のダイアグラムをブラウザで開く。 
 
<center>
{| class="wikitable"
|+ open_drawio_mermaidのパラメータ
! パラメータ !! 型 !! 必須 !! 説明
|-
| content || string || はい || Mermaid.js形式のダイアグラムデータ
|-
| lightbox || boolean || いいえ || 読み取り専用のライトボックスモードで開く。(デフォルト: false)
|-
| dark || boolean || いいえ || ダークモードで表示する。(デフォルト: false)
|}
</center>
 

== jgraph版 : 使用方法 ==
==== MCP Tool Serverでの使用例 ====
MCP Tool Serverを使用する場合のプロンプト例を以下に示す。 
 
* Mermaidダイアグラムの場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

以下のMermaid形式でシーケンス図をDraw.ioで作成してください。
sequenceDiagram
Client->>Server: HTTPリクエスト
Server->>Database: クエリ実行
Database-->>Server: 結果返却
Server-->>Client: HTTPレスポンス
</syntaxhighlight>
*: 
* CSVデータからダイアグラムを作成する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

以下の組織データからCSV形式で組織図をDraw.ioで作成してください。
CEO配下にCTO、CFO、COOの3つのポジションがあります。
</syntaxhighlight>
*: 
* XMLダイアグラムの場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

Webアプリケーションの3層アーキテクチャ図をDraw.io XMLで作成してください。
フロントエンド、バックエンド、データベースの3層を含めてください。
</syntaxhighlight>
 
==== Skill + CLIでの使用例 ====
Claude Code (CLI) でSkill + CLIを使用する場合は、<code>/drawio</code> コマンドを使用する。 
 
# 使用例 :

/drawio マイクロサービスのアーキテクチャ図を作成してください。
各サービス間の通信方式も記載してください。
 
エクスポートを含む使用例を以下に示す。 
# 使用例 :

/drawio ネットワーク構成図を作成して、PNGファイルとしてエクスポートしてください。
 
==== Project Instructionsでの使用例 ====
Project Instructionsを使用する場合のプロンプト例を以下に示す。 
 
# プロンプト例 :

システムのデプロイメントフロー図を作成して、Draw.ioで開けるURLを生成してください。
 

== jgraph版 : 動作の仕組み ==
==== MCP Tool Serverの処理フロー ====
MCP Tool Serverは、以下の手順でダイアグラムを表示する。 
 
# MCPクライアントからダイアグラムデータ (XML / CSV / Mermaid) を受信する。
# pakoライブラリを使用して、データをdeflateRaw圧縮する。
# 圧縮データをBase64エンコードする。
# https://app.diagrams.net/#create= の後にエンコード済みデータを付加したURLを生成する。
# 生成されたURLをWebブラウザで開き、Draw.ioエディタにダイアグラムを表示する。
 
==== MCP App Serverの処理フロー ====
MCP App Serverは、以下の手順でダイアグラムを表示する。 
 
# MCPクライアントからダイアグラムデータを受信する。
# サーバ側でダイアグラムデータを処理する。
# チャットインターフェース内にダイアグラムをインラインで描画する。
# ユーザはチャット内で直接ダイアグラムを確認できる。
 
==== URLの安全性 ====
MCP Tool ServerおよびProject Instructionsで生成されるURLは、ハッシュフラグメント方式 (<code>#create=</code>) を使用している。 
 
* ハッシュフラグメント (<code>#</code> 以降のデータ) は、Webブラウザからサーバに送信されない
*: そのため、ダイアグラムデータがDraw.ioのサーバに送信されることはない
* 全てのデータ処理はブラウザ内で完結する
* 機密性の高いダイアグラムデータも安全に扱うことができる
 

== jgraph版 : トラブルシューティング ==
==== npxが見つからない場合 ====
以下の項目を確認する。 
 
* Node.jsのバージョン確認
*: Node.js 18.0.0以上がインストールされていることを確認する。
*: <code>node --version</code> コマンドでバージョンを確認する。
* npxの確認
*: <code>npx --version</code> コマンドでnpxが利用可能であることを確認する。
*: npxが見つからない場合は、Node.jsを再インストールする。
 
==== ダイアグラムが開かない場合 ====
以下の項目を確認する。 
 
* インターネット接続の確認
*: https://app.diagrams.net にアクセスできることを確認する。
* Webブラウザの確認
*: デフォルトブラウザが設定されていることを確認する。
*: ポップアップブロッカーがURLの展開を妨げていないか確認する。
* URLの長さ制限
*: 非常に大きなダイアグラムの場合、URLの長さがブラウザの制限を超える可能性がある。
*: その場合は、Skill + CLIアプローチを使用してファイルとして生成することを推奨する。
 
==== draw.io CLIでのエクスポートが失敗する場合 ====
以下の項目を確認する。 
 
* draw.io Desktopの確認
*: draw.io Desktopアプリがインストールされていることを確認する。
*: CLIコマンドがPATHに含まれていることを確認する。
* ディスプレイ環境の確認 (Linux)
*: LinuxでGUIなし環境の場合、<code>xvfb-run</code> が必要になることがある。
*: <code>xvfb-run drawio --export --format png diagram.drawio</code>
 
==== Claude Desktopで認識されない場合 ====
以下の項目を確認する。 
 
* 設定ファイルの確認
*: claude_desktop_config.jsonファイル のJSON形式が正しいことを確認する。
*: <code>mcpServers</code> キーの下に正しく設定されていることを確認する。
* Claude Desktopの再起動
*: 設定ファイル編集後、Claude Desktopを再起動する。
* ログの確認
*: Claude Desktopのデバッグコンソール ([View] - [Toggle Developer Tools]) でエラーログを確認する。
 

{{#seo:
|title={{PAGENAME}} : Draw.io MCP Server | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,MCP,Model Context Protocol,Draw.io,Diagram,Flowchart,Architecture,UML,Sequence Diagram,Network Diagram,Claude,AI,Machine Learning,Node.js,TypeScript,Browser Extension,WebSocket,Visualization,jgraph,@drawio/mcp,MCP App Server,Mermaid,CSV,Skill,CLI
|description={{PAGENAME}} - Draw.io MCP Serverに関する包括的なガイド、コミュニティ版とJGraph公式版の両方を網羅したAIアシスタントによるダイアグラム作成と編集の自動化 | This page is {{PAGENAME}} in our wiki about Draw.io MCP servers and AI-powered diagram creation
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

MCPサーバ - zai-mcp-server

2026-04-09T12:22:03Z

Wiki: /* 設定方法 */

== 概要 ==
zai-mcp-serverは、GLM-5モデルを活用した画像・動画分析機能を提供するMCP (Model Context Protocol) サーバである。 
 
OpenCode環境において、このサーバを導入することで、単純な画像説明から高度な技術図面の理解、エラー診断、UIデザインからのコード生成まで、幅広い視覚分析タスクを実行できる。 
 
OpenCodeには標準で look_at という画像分析ツールが搭載されているが、zai-mcp-serverはより特化した機能を提供する。 
例えば、スクリーンショットからのテキスト抽出 (OCR)、エラー画面の診断、UIスクリーンショットからのコード生成等、特定のタスクに最適化された専用ツールが用意されている。 
 
これらのツールは、ローカルファイルパスまたはURLを指定して使用できる。 
各ツールには <code>prompt</code> パラメータがあり、分析の指示を詳細に記述することにより、より精度の高い結果が得られる。 
 
設定は、opencode.json ファイルにMCPサーバ設定を追加するだけで完了する。 
APIキーは z.ai から取得できる。 
 

== ツール一覧 ==
zai-mcp-serverが提供するツールの一覧を以下に示す。 
 
<center>
{| class="wikitable"
|+ zai-mcp-server ツール一覧
! ツール名 !! 用途
|-
| ui_to_artifact || UIスクリーンショットからコード、プロンプト、仕様、説明を生成する。
|-
| extract_text_from_screenshot || スクリーンショットからテキストを抽出する (OCR)。
|-
| diagnose_error_screenshot || エラー画面やスタックトレースを診断する。
|-
| understand_technical_diagram || 技術図面 (アーキテクチャ図、UML、ER図、フローチャート) を理解する。
|-
| analyze_data_visualization || チャート、グラフ、ダッシュボードを分析する。
|-
| ui_diff_check || 2つのUIスクリーンショットを比較する。
|-
| analyze_image || 汎用的な画像分析を行う (他の特化ツールが合わない場合のフォールバック)。
|-
| analyze_video || 動画の内容を分析する。
|}
</center>
 

== look_at との使い分け ==
OpenCodeには look_at というビルトインの画像分析ツールが存在する。 
 
zai-mcp-serverツールと look_at の使い分けの基準を以下に示す。 
 
==== look_atを使用する場合 ====
* PDF、画像、図の一般的な分析・要約
*: ドキュメントからの情報抽出
*: 「この画像は何？」というシンプルな質問
 
==== zai-mcp-serverツールを使用する場合 ====
* 特化したタスク (OCR、UIからコード生成、エラー診断等)
*: より精度の高い分析が必要な場合
*: 動画の分析が必要な場合
 

== 共通パラメータ ==
全てのツールで共通するパラメータを以下に示す。 
 
<center>
{| class="wikitable"
|+ 共通パラメータ
! パラメータ !! 必須 !! 説明
|-
| <code>image_source</code> || ○ || 画像のローカルパスまたは URL
|-
| <code>prompt</code> || ○ || 何をしてほしいかの指示を記述する。
|}
</center>
 
動画分析ツール (analyze_video) の場合は、<code>image_source</code> の代わりに <code>video_source</code> を使用する。 
 

== 各ツールの詳細 ==
==== ui_to_artifact ====
UIスクリーンショットからコード、プロンプト、仕様書、または説明文を生成するツールである。 
 
===== パラメータ =====
<center>
{| class="wikitable"
|+ ui_to_artifact パラメータ
! パラメータ !! 値 !! 説明
|-
| <code>image_source</code> || 画像パス or URL || UIスクリーンショットの画像を指定する。
|-
| <code>output_type</code> || <code>code</code> || フロントエンドコードを生成する。
|-
| || <code>prompt</code> || AIプロンプトを生成する。
|-
| || <code>spec</code> || デザイン仕様書を生成する。
|-
| || <code>description</code> || 自然言語による説明を生成する。
|-
| <code>prompt</code> || 文字列 || 生成に関する詳細な指示を記述する。
|}
</center>
 
===== 使用例 =====
image_source: "/home/user/ui-mockup.png"
output_type: "code"
prompt: "Reactコンポーネントとして実装してください。Tailwind CSSを使用。"
 
このツールはUIデザインのモックアップ画像から実装コードを生成する場合に使用する。 
 
==== extract_text_from_screenshot ====
スクリーンショットからテキストを抽出するOCRツールである。 
 
===== パラメータ =====
<center>
{| class="wikitable"
|+ extract_text_from_screenshot パラメータ
! パラメータ !! 説明
|-
| <code>image_source</code> || スクリーンショットの画像パス or URL
|-
| <code>prompt</code> || テキスト抽出の指示を記述する。
|-
| <code>programming_language</code> || (任意) コードが含まれる場合、プログラミング言語を指定する。 例: <code>python</code>、<code>javascript</code>、<code>java</code> 空欄の場合は自動検出される。
|}
</center>
 
===== 使用例 =====
image_source: "/home/user/terminal-output.png"
prompt: "ターミナル出力のテキストを抽出してください。"
programming_language: ""
 
このツールはターミナル出力、ドキュメント、コードのスクリーンショットからテキストを抽出する場合に使用する。 
 
==== diagnose_error_screenshot ====
エラー画面やスタックトレースを診断し、解決策を提案するツールである。 
 
===== パラメータ =====
<center>
{| class="wikitable"
|+ diagnose_error_screenshot パラメータ
! パラメータ !! 説明
|-
| <code>image_source</code> || エラー画面の画像パス or URL
|-
| <code>prompt</code> || エラーに関する質問や診断の指示を記述する。
|-
| <code>context</code> || (任意) エラーが発生した状況の追加情報を記述する。 例: 「npm install実行時に発生」
|}
</center>
 
===== 使用例 =====
image_source: "/home/user/error-stacktrace.png"
prompt: "このエラーの原因と解決策を教えてください。"
context: "npm install 実行時に発生しました。"
 
このツールはエラーメッセージやスタックトレースの画像から原因を特定し、解決策を得る場合に使用する。 
 
==== understand_technical_diagram ====
技術図面 (アーキテクチャ図、UML、ER図、フローチャート等) を理解・説明するツールである。 
 
===== パラメータ =====
<center>
{| class="wikitable"
|+ understand_technical_diagram パラメータ
! パラメータ !! 説明
|-
| <code>image_source</code> || 技術図面の画像パス or URL
|-
| <code>prompt</code> || 図面から何を理解したいかの指示を記述する。
|-
| <code>diagram_type</code> || (任意) 図面の種類を指定する。 <code>architecture</code> / <code>flowchart</code> / <code>uml</code> / <code>er-diagram</code> / <code>sequence</code> 空欄の場合は自動検出される。
|}
</center>
 
===== 使用例 =====
image_source: "/home/user/system-architecture.png"
prompt: "各コンポーネントの役割とデータフローを説明してください。"
diagram_type: "architecture"
 
このツールはシステム構成図、データベース設計図、シーケンス図等の技術図面を理解する場合に使用する。 
 
==== analyze_data_visualization ====
チャート、グラフ、ダッシュボード等のデータ可視化を分析するツールである。 
 
===== パラメータ =====
<center>
{| class="wikitable"
|+ analyze_data_visualization パラメータ
! パラメータ !! 説明
|-
| <code>image_source</code> || データ可視化の画像パス or URL
|-
| <code>prompt</code> || 何を抽出・分析したいかの指示を記述する。
|-
| <code>analysis_focus</code> || (任意) 分析の焦点を指定する。 <code>trends</code> (傾向) / <code>anomalies</code> (異常値) / <code>comparisons</code> (比較) / <code>performance metrics</code> (パフォーマンス指標) 空欄の場合は包括的な分析が行われる。
|}
</center>
 
===== 使用例 =====
image_source: "/home/user/sales-chart.png"
prompt: "売上の傾向と異常値を分析してください。"
analysis_focus: "trends"
 
このツールは売上グラフ、パフォーマンスダッシュボード、統計チャート等のデータ可視化を分析する場合に使用する。 
 
==== ui_diff_check ====
2つのUIスクリーンショットを比較し、視覚的な差異を特定するツールである。 
 
===== パラメータ =====
<center>
{| class="wikitable"
|+ ui_diff_check パラメータ
! パラメータ !! 説明
|-
| <code>expected_image_source</code> || 期待値 (基準) となるUI画像のパス or URL
|-
| <code>actual_image_source</code> || 実装されたUI画像のパス or URL
|-
| <code>prompt</code> || 比較の観点や注目点の指示を記述する。
|}
</center>
 
===== 使用例 =====
expected_image_source: "/home/user/design-mockup.png"
actual_image_source: "/home/user/implementation-screenshot.png"
prompt: "デザインとの差異を具体的に指摘してください。"
 
このツールはデザインモックアップと実装の比較、UIのリグレッションテストに使用する。 
 
==== analyze_image ====
汎用的な画像分析ツールである。 
他の特化ツールが適合しない場合のフォールバックとして使用する。 
 
===== パラメータ =====
<center>
{| class="wikitable"
|+ analyze_image パラメータ
! パラメータ !! 説明
|-
| <code>image_source</code> || 画像のパス or URL
|-
| <code>prompt</code> || 分析の指示を詳細に記述する。
|}
</center>
 
===== 使用例 =====
image_source: "/home/user/photo.jpg"
prompt: "この画像に写っているものを詳しく説明してください。"
 
このツールは一般的な画像の説明、写真の分析等に使用する。 
 
==== analyze_video ====
動画の内容を分析するツールである。 
 
===== パラメータ =====
<center>
{| class="wikitable"
|+ analyze_video パラメータ
! パラメータ !! 説明
|-
| <code>video_source</code> || 動画のパス or URL 対応形式: MP4、MOV、M4V 最大ファイルサイズ: 8[MB]
|-
| <code>prompt</code> || 何を分析・理解したいかの指示を記述する。
|}
</center>
 
===== 使用例 =====
video_source: "/home/user/demo.mp4"
prompt: "動画内で行われている操作手順をステップごとに説明してください。"
 
このツールはデモ動画の分析、操作手順の抽出、シーンの理解等に使用する。 
 

== クイックリファレンス ==
タスク別の推奨ツールを以下に示す。 
 
<center>
{| class="wikitable"
|+ タスク別推奨ツール
! やりたいこと !! 推奨ツール
|-
| UIデザインからコード生成 || ui_to_artifact (<code>output_type: "code"</code>)
|-
| エラー画面の原因を知りたい || diagnose_error_screenshot
|-
| 画像からテキストを抽出 || extract_text_from_screenshot
|-
| システム図を理解したい || understand_technical_diagram
|-
| グラフからトレンドを読む || analyze_data_visualization
|-
| デザインと実装を比較 || ui_diff_check
|-
| 動画の内容を理解 || analyze_video
|-
| その他の画像分析 || analyze_image または look_at
|}
</center>
 

== 設定方法 ==
==== opencode.jsonへの追加 ====
zai-mcp-serverを使用するには、opencode.jsonファイル の <code>mcp</code> フィールドに設定を追加する。 
 
<syntaxhighlight lang="json">
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"zai-mcp-server": {
"type": "local",
"command": ["npx", "-y", "@z_ai/mcp-server"],
"environment": {
"Z_AI_API_KEY": "<Z.AIのAPIキー>",
"Z_AI_MODE": "ZAI"
}
}
}
}
</syntaxhighlight>
 
Node.js v22以降が必要となる。 
また、キャッシュされた古いバージョンが使用される場合があるため、挙動がおかしい時は <code>@z_ai/mcp-server@latest</code> を指定、または、npxキャッシュを削除する。 
 
# npxキャッシュの削除方法

npx clear-npx-cache

または

## キャッシュの場所を確認
## 一般的に、~/.npm/_npx に npxキャッシュが存在する
npm config get cache
rm -rf ~/.npm/_npx

## キャッシュを削除した後、最新バージョンが取得する
npx -y @z_ai/mcp-server
 
==== APIキーの取得 ====
APIキーは [https://z.ai z.ai] から取得できる。 
 
==== 設定の確認 ====
設定が正しく追加されている場合、OpenCode起動時にzai-mcp-serverが読み込まれ、ツール一覧に <code>zai-mcp-server_*</code> 形式のツールが表示される。 
 

== 注意事項 ==
* 動画ファイルは最大8[MB]まで対応している。 
*: 大きなファイルは事前に圧縮または分割することを推奨する。
*: 
* 各ツールは特定の用途に最適化されている。 
*: 適切なツールを選択することで、より精度の高い結果が得られる。
*: 
* <code>prompt</code> パラメータは詳細に記述するほど、期待通りの結果が得やすくなる。 
*: 具体的な指示を含めることを推奨する。
 

== 関連情報 ==
* [https://z.ai Z.AIの公式サイト]
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,zai-mcp-server,GLM-5,画像分析,OCR,UI分析,動画分析,AI,OpenCode,MCP
|description={{PAGENAME}} - GLM-5モデルを使用した画像・動画分析ツールの使い方と設定方法 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

インストール - OpenCode

2026-04-09T11:26:29Z

Wiki: /* Step 6 : Tauriビルドの実行 */

== 概要 ==
OpenCodeは、オープンソースのAIコーディングエージェントである。 
ターミナルベースのTUI (ターミナルユーザーインターフェース) を提供し、75以上のLLMプロバイダに対応している。 
 
主要な特徴として、以下が挙げられる。 
* Anthropic (Claude)、OpenAI (GPT)、Google (Gemini)、GitHub Copilot、Ollama等のモデルの主要プロバイダをサポート
* 2026年1月にGitHub Copilotとの公式パートナーシップを発表
* プライバシー重視の設計
*: コードは送信されず、ローカルでの処理を優先
* CLI、TUI、Desktop アプリ、IDE拡張機能、Webインターフェースを提供
* MCP (Model Context Protocol) とLSP (Language Server Protocol) をサポート
* 組み込みエージェント
** build (開発用)
** plan (読み取り専用分析)
 
OpenCodeは、Go言語でBubble Tea TUIフレームワークを使用して実装されている。 
セッション管理、マルチセッション対応を備え、会話履歴の保存、復元、エクスポートが可能である。 
 
Desktop アプリはTauri v2ベースのネイティブアプリケーションとして実装されており、TypeScriptで実装された内部CLI、Rust + SolidJSで構築されたフロントエンドを組み合わせている。 
 

== 主な機能 ==
OpenCodeは、多様な機能を提供する包括的なAIコーディングツールである。 
 
<center>
{| class="wikitable"
|+ 主要機能一覧
! 機能 !! 説明
|-
| TUI (Bubble Tea) || ターミナルベースの対話型インターフェース
|-
| マルチプロバイダ対応 || 75以上のLLMプロバイダをサポート
|-
| セッション管理 || 会話履歴の保存、復元、エクスポート
|-
| ツール統合 || ファイル操作、Bash実行、テスト実行等
|-
| MCP (Model Context Protocol) || 外部ツールとの統合プロトコル
|-
| LSP (Language Server Protocol) || 25以上の組み込みLSPサーバーによる言語サーバーとの連携
|-
| 組み込みエージェント || build (開発用) plan (読み取り専用分析) general (調査用) explore (コード探索用)
|-
| Desktop アプリ || Tauri v2ベースのネイティブアプリ
|-
| IDE拡張機能 || VS Code、JetBrains等のIDE拡張
|-
| カスタムコマンド || .opencode/commands/ ディレクトリ内でユーザ定義コマンド作成
|-
| Git統合 || <code>/undo</code>、<code>/redo</code> コマンドでGitバック付きの変更管理
|}
</center>
 

== 対応AIプロバイダとモデル ==
OpenCodeは、75以上のLLMプロバイダに対応している。 
 
==== 主要プロバイダ一覧 ====
<center>
{| class="wikitable"
|+ 主要プロバイダ一覧
! プロバイダ !! 認証方法 !! 備考
|-
| Anthropic || APIキー (<code>ANTHROPIC_API_KEY</code>) || Claude 4.x系をサポート
|-
| OpenAI || APIキー (<code>OPENAI_API_KEY</code>) || GPT-4o、o3等をサポート
|-
| Google || APIキー (<code>GOOGLE_API_KEY</code>) || Gemini 3等をサポート
|-
| GitHub Copilot || GitHub認証 (OAuth) || <code>/connect</code> コマンドで認証
|-
| Z.AI || APIキー || GLM-5、GLM-4.7等をサポート GLM Coding Plan対応
|-
| AWS Bedrock || AWS認証情報 || Anthropicモデルのホスティング
|-
| Azure OpenAI || Azureエンドポイント || OpenAIモデルのホスティング
|-
| Ollama || ローカル実行 (認証不要) || ローカルモデルの実行
|-
| OpenRouter || APIキー || 複数プロバイダのルーティング
|-
| Groq || APIキー || 高速推論
|-
| Together AI || APIキー || オープンソースモデル
|-
| Fireworks AI || APIキー || 高速推論
|}
</center>
 
==== 推奨モデル ====
<center>
{| class="wikitable"
|+ 用途別推奨モデル
! 用途 !! 推奨モデル
|-
| 高精度コーディング || Claude Sonnet 4.5、GPT-4o
|-
| 高速処理 || Claude Haiku 4.5、Gemini 2.5 Flash
|-
| 複雑な推論 || Claude Opus 4.6、o3
|-
| ローカル実行 || Qwen 2.5 Coder (Ollama)
|-
| コスト効率重視 || GLM-4.7、GLM-5 (Z.AI Coding Plan)
|}
</center>
 
==== ローカルモデル (Ollama) ====
Ollamaを使用することで、ローカル環境でモデルを実行できる。 
 
===== Ollamaのインストール =====
Ollamaの公式サイトからインストールスクリプトをダウンロードして実行する。 
curl -fsSL https://ollama.com/install.sh | bash
 
===== モデルのダウンロード =====
Ollamaでモデルをダウンロードする。 
ollama pull qwen2.5-coder
 
===== OpenCodeでの設定 =====
<code>opencode.json</code> でOllamaプロバイダを設定する。 
<syntaxhighlight lang="json">
{
"$schema": "https://opencode.ai/config.json",
"model": "ollama/qwen2.5-coder"
}
</syntaxhighlight>
 

== 前提条件 ==
OpenCodeをインストールするには、以下の前提条件を満たす必要がある。 
 
==== 標準インストール時の前提条件 ====
<center>
{| class="wikitable"
|+ 標準インストール時の前提条件
! 要件 !! 詳細
|-
| OS || Linux、MacOS、Windows
|-
| Node.js || npm経由のインストールに必要 (Node.js 18以上)
|-
| ネットワーク || AIプロバイダへの接続に必要
|-
| AIプロバイダのAPIキー || 使用するプロバイダのAPIキーまたは認証情報
|}
</center>
 

== インストール ==
OpenCodeのインストール方法を以下に示す。 
 
==== クイックインストール (Linux) ====
公式のインストールスクリプトを使用してインストールする。 
curl -fsSL https://opencode.ai/install | bash
 
==== Homebrew (MacOS) ====
Homebrewを使用してインストールできる。 
brew install opencode
 
==== npm (全プラットフォーム) ====
npmを使用してグローバルインストールする。 
npm install -g opencode
 
==== Windows (Scoop / Chocolatey) ====
Windowsでは、ScoopまたはChocolateyを使用してインストールできる。 
 
===== Scoopでのインストール =====
scoop install opencode
 
===== Chocolateyでのインストール =====
choco install opencode
 
==== デスクトップアプリケーション ====
[https://opencode.ai/download OpenCodeの公式Webサイト]にアクセスして、デスクトップアプリケーションをダウンロードする。 
 
対応プラットフォーム: 
* Linux (deb、rpm)
* MacOS (dmg)
* Windows (exe)
 
==== バージョン確認 ====
インストール後、バージョンを確認する。 
opencode --version
 

== 初期設定 ==
OpenCodeの初期設定を以下に示す。 
 
==== プロバイダの認証 ====
OpenCodeの初回起動時に、<code>/connect</code> コマンドまたは <code>opencode auth login</code> コマンドでAIプロバイダとの認証を設定する。 
 
===== GitHub Copilotとの連携 =====
OpenCodeはGitHub Copilotの公式パートナーであり、<code>/connect</code> コマンドで認証を設定できる。 
 
OpenCodeを起動する。 
opencode
 
認証を設定する。 
/connect
 
例えば、GitHub Copilotを選択する。 
Webブラウザが開き、GitHub認証ページが表示される。 
 
認証を完了すると、OpenCodeでGitHub Copilotが使用可能になる。 
 
===== APIキーによる認証 =====
環境変数でAPIキーを設定する方法もある。 
<syntaxhighlight lang="sh">
export ANTHROPIC_API_KEY="sk-..."
export OPENAI_API_KEY="sk-..."
export GOOGLE_API_KEY="..."
</syntaxhighlight>
 
環境変数を永続化する場合は、~/.profileファイル等に環境変数 <code>ANTHROPIC_API_KEY</code> を設定する。 
<syntaxhighlight lang="sh">
export ANTHROPIC_API_KEY="sk-..."
</syntaxhighlight>
 
===== Z.AI (GLM) との連携 =====
Z.AIのGLMモデル (GLM-5、GLM-4.7等) をOpenCodeで使用するには、[https://z.ai/subscribe Z.AI GLM または GLM Coding Plan]のサブスクリプション契約およびAPIキーが必要である。 
 
====== GLM / GLM Coding Planの概要 ======
GLM / GLM Coding Planは、Z.AIが提供するAIコーディング向けのサブスクリプションプランである。 
 
<center>
{| class="wikitable"
|+ GLM Coding Plan
! プラン !! 月額 !! GLM-5対応 !! 5時間あたりの目安
|-
| Lite || $10 || 対応 || 約80プロンプト
|-
| Pro || $30 || 対応 || 約400プロンプト
|-
| Max || $120 || 対応 || 約1,600プロンプト
|}
</center>
 
使用可能なモデルは以下の通りである。 
* GLM-5 (ProプランおよびMaxプランのみ)
* GLM-4.7
* GLM-4.6
* GLM-4.5
* GLM-4.5-Air
 
GLM-5はピーク時 (日本時間 15:00〜19:00) に3倍、オフピーク時に2倍のクォータを消費する。 
日常的なタスクにはGLM-4.7を使用し、複雑なタスクにのみGLM-5を使用することが推奨される。 
 

====== 認証の設定手順 ======
Z.AIの[https://z.ai/manage-apikey/apikey-list APIコンソール]にアクセスして、APIキーを取得する。 
 
<code>opencode auth login</code> コマンドを実行して、プロバイダ選択で Z.AI Coding Plan を選択する。 
 
<syntaxhighlight lang="sh">
opencode auth login
</syntaxhighlight>
 
┌ Add credential
│
◆ Select provider
│ ● Z.AI Coding Plan
│ ...
└
 
Z.AIのAPIキーを入力する。 
┌ Add credential
│
◇ Select provider
│ Z.AI Coding Plan
│
◇ Enter your API key
│ <Z.AIのAPIキーを入力>
└
 
OpenCodeを起動して、<code>/models</code> コマンドでGLM-5 / GLM-4.7等のモデルを選択する。 
opencode
 
/models
 
====== トラブルシューティング : Insufficient balance ======
GLMモデルの使用時に、以下に示すエラーメッセージが表示される場合がある。 
Insufficient balance or no resource package. Please recharge.
 
このエラーは、OpenCodeのプロバイダ設定がGLM Coding Plan専用のエンドポイントに接続されていない場合に発生する。 
 
GLM Coding Planでは、専用のAPIエンドポイント (https://api.z.ai/api/coding/paas/v4) を使用する必要がある。 
プロバイダ選択で Z.AI (通常のAPI) を選択した場合、標準エンドポイント (https://api.z.ai/api/paas/v4) に接続されるため、Coding Planの残高が認識されず、上記のエラーが発生する。 
 
<center>
{| class="wikitable"
|+ Z.AI APIエンドポイントの違い
! エンドポイント !! URL !! 用途
|-
| 標準 (通常API) || https://api.z.ai/api/paas/v4 || 従量課金のAPI利用
|-
| Coding Plan専用 || https://api.z.ai/api/coding/paas/v4 || GLM Coding Planサブスクリプション利用
|}
</center>
 
対処方法として、一旦Z.AIの認証情報をログアウトしてから、Z.AI Coding Plan で再度ログインする。 
 
Z.AIの認証情報をログアウトする。 
<syntaxhighlight lang="sh">
opencode auth logout
</syntaxhighlight>
 
再度ログインして、プロバイダ選択で Z.AI Coding Plan を選択する。 
<syntaxhighlight lang="sh">
opencode auth login
</syntaxhighlight>
 
┌ Add credential
│
◆ Select provider
│ ● Z.AI Coding Plan ← Z.AI ではなく、Z.AI Coding Planを選択すること
│ ...
└
 
APIキーを入力して認証を完了した後、OpenCodeを起動して正常にGLMモデルが使用できることを確認する。 
 
==== 設定ファイル ====
OpenCodeの設定ファイルは、プロジェクトルート または ホームディレクトリ に配置する。 
 
===== 設定ファイルの場所 =====
設定ファイルは以下の順序で検索される。 
* プロジェクトルート
*: opencode.json
* ホームディレクトリ
*: ~/.opencode/config.json
 
===== 設定ファイルの例 =====
<syntaxhighlight lang="json">
{
"$schema": "https://opencode.ai/config.json",
"model": "anthropic/claude-sonnet-4-5-20250929",
"small_model": "anthropic/claude-haiku-4-5-20251001",
"keybinds": {
"leader": "ctrl+x"
}
}
</syntaxhighlight>
 
設定可能な項目を以下に示す。 
* <code>model</code>
*: 使用するモデル名 (プロバイダ/モデル名形式)
*: 例: <code>anthropic/claude-sonnet-4-5-20250929</code>、<code>openai/gpt-4o</code>
* <code>small_model</code>
*: 軽量タスク用のモデル (コスト削減に有効)
*: 例: <code>anthropic/claude-haiku-4-5-20251001</code>
* <code>keybinds.leader</code>
*: リーダーキーの設定
*: デフォルト : <code>ctrl+x</code>
 

== CLIコマンド ==
OpenCodeは、CLIモードと対話モードの両方で使用できる。 
 
==== 主要コマンド ====
<center>
{| class="wikitable"
|+ 主要コマンド一覧
! コマンド !! 説明
|-
| <code>opencode</code> || TUIを起動
|-
| <code>opencode run "プロンプト"</code> || 非対話モードでプロンプトを実行
|-
| <code>opencode --model プロバイダ/モデル名</code> || モデルを指定して起動
|-
| <code>opencode --continue</code> || 前回のセッションを継続して起動
|-
| <code>opencode auth login</code> || プロバイダの認証を設定
|-
| <code>opencode auth logout</code> || 認証情報を削除
|-
| <code>opencode models</code> || 使用可能なモデル一覧を表示
|-
| <code>opencode mcp list</code> || MCPサーバ一覧を表示
|-
| <code>opencode mcp add サーバー名</code> || MCPサーバを追加
|-
| <code>opencode serve</code> || ヘッドレスバックエンドサーバを起動
|-
| <code>opencode --version</code> || バージョンを表示
|-
| <code>opencode --help</code> || ヘルプを表示
|}
</center>
 
==== 非対話モード ====
非対話モードでは、プロンプトをコマンドライン引数として渡すことができる。 
 
===== 使用例 =====
プロジェクトの概要を説明する。 
opencode run "このプロジェクトの概要を説明して"
 
モデルを指定してテストを実行する。 
opencode run "テストを実行して" --model anthropic/claude-sonnet-4-5-20250929
 

== TUI (ターミナルユーザーインターフェース) ==
OpenCodeのTUIは、ターミナルベースの対話型インターフェースである。 
 
==== スラッシュコマンド ====
TUI内でスラッシュコマンドを使用して、様々な操作を実行できる。 
 
<center>
{| class="wikitable"
|+ スラッシュコマンド一覧
! コマンド !! 説明
|-
| <code>/new</code> || 新しいセッションを開始
|-
| <code>/init</code> || プロジェクト構造を分析
|-
| <code>/undo</code> || 直前の変更を元に戻す (Git連携)
|-
| <code>/redo</code> || 元に戻した変更をやり直す
|-
| <code>/compact</code> || 会話を要約して圧縮
|-
| <code>/share</code> || 会話の共有リンクを生成
|-
| <code>/export</code> || 会話をMarkdownでエクスポート
|-
| <code>/sessions</code> || 過去のセッション一覧を表示
|-
| <code>/models</code> || 使用可能なモデル一覧を表示
|-
| <code>/agents</code> || エージェント一覧を表示
|-
| <code>/connect</code> || プロバイダ認証を設定
|-
| <code>/status</code> || 現在のステータスを表示
|-
| <code>/mcp</code> || MCPサーバ一覧を表示
|-
| <code>/theme</code> || テーマを変更
|-
| <code>/editor</code> || 外部エディタで入力
|-
| <code>/help</code> || ヘルプを表示
|-
| <code>/commands</code> || コマンド一覧を表示
|-
| <code>/exit</code> || OpenCodeを終了
|}
</center>
 
==== キーバインド ====
OpenCodeのリーダーキーのデフォルトは、[Ctrl] + [X]キーである。 
リーダーキーを押した後に各キーを入力する。 
 
<center>
{| class="wikitable"
|+ キーバインド一覧
! キー !! 説明
|-
| [Ctrl] + [X] -> [N] || 新しいセッション
|-
| [Ctrl] + [X] -> [L] || セッション一覧
|-
| [Ctrl] + [X] -> [T] || タイムライン
|-
| [Ctrl] + [X] -> [M] || モデル選択ダイアログ
|-
| [Ctrl] + [X] -> [C] || コンパクト表示
|-
| [Ctrl] + [P] || コマンドパレット
|-
| [Tab] || Plan/Buildエージェント切替
|-
| [Page Up] / [Page Down] || スクロール
|-
| [Shift] + [Enter] || 改行入力
|}
</center>
 
==== ファイル参照とBashコマンド ====
TUI内でファイル参照とBashコマンドの実行ができる。 
 
===== ファイル参照 =====
<code>@</code> でファイルをファジー検索して参照を追加する。 
@filename
 
===== Bashコマンドの実行 =====
<code>!</code> をプレフィックスとしてBashコマンドを実行する。 
!ls -la
!git status
 

== CLIバイナリのビルド (SUSE) ==
OpenCode CLIバイナリをSUSE環境でソースコードからビルドすることができる。 
 
==== ビルドの前提条件 ====
<center>
{| class="wikitable"
|+ ビルドの前提条件
! 項目 !! 要件
|-
| OS ||
* RHEL 9 / 10
* SUSE 15 / 16
|-
| Bun || 1.3.x (package.json 内の <code>packageManager</code> で <code>bun@1.3.9</code> を指定)
|-
| git || ブランチ名取得に使用 (Gitリポジトリでない場合は環境変数で回避可能)
|-
| ネットワーク || ビルド時に https://models.dev/api.json からモデルデータを取得
|}
</center>
 
===== 前提条件の確認コマンド =====
# Bunバージョン確認 (1.3.9が必要)
bun --version

# ネットワーク接続の確認
curl -s https://models.dev/api.json | head -c 100
 

==== ビルド方式の説明 ====
<center>
{| class="wikitable"
|+ ビルド方式の説明
! 項目 !! 内容
|-
| 言語 || TypeScript (Bun ランタイム)
|-
| ビルド方式 || <code>Bun.build()</code> の <code>compile: true</code> でスタンドアロン実行ファイルを生成
|-
| ビルドスクリプト || packages/opencode/script/build.ts
|-
| 出力 || Bunランタイムを内蔵した単一バイナリ (<code>opencode</code>)
|}
</center>
 
==== 環境変数の設定 ====
ソースディレクトリがGitリポジトリでない場合、<code>git branch --show-current</code> が失敗するため、環境変数を設定する。 
<syntaxhighlight lang="sh">
export OPENCODE_VERSION=<バージョン例 : 1.2.14>
export OPENCODE_CHANNEL=latest
</syntaxhighlight>
 

==== 依存パッケージのインストール ====
プロジェクトディレクトリに移動して、依存パッケージをインストールする。 
cd /path/to/opencode-<バージョン>
bun install
 
このプロジェクトはBunワークスペース構成のモノレポである。 
<code>bun install</code> コマンドを実行して、ルートおよび全パッケージの依存関係がインストールされる。 
 

==== ビルドの実行 ====
ビルドスクリプトを実行する。 
./packages/opencode/script/build.ts --single
 
<code>--single</code> フラグは現在のプラットフォーム向けのみビルドする。(例: linux-x64) 
フラグなしで実行すると全11プラットフォーム分のクロスコンパイルを試みる。 
 
ビルドスクリプトの処理内容: 
* <code>models.dev</code> からモデルデータを取得し、TypeScript スナップショットを生成
* <code>@opentui/core</code> と <code>@parcel/watcher</code> のネイティブバインディングをインストール
* <code>Bun.build()</code> で TypeScript をスタンドアロンバイナリにコンパイル
* <code>packages/opencode/dist/opencode-linux-x64/bin/opencode</code> に出力
 
==== 動作確認 ====
ビルドが完了したら、バイナリが生成されたか確認する。 
# バイナリが生成されたか確認
ls -la packages/opencode/dist/opencode-linux-x64/bin/opencode

# バージョン表示で動作確認
./packages/opencode/dist/opencode-linux-x64/bin/opencode --help
 
==== トラブルシューティング ====
<center>
{| class="wikitable"
|+ トラブルシューティング
! 問題 !! 原因 !! 対策
|-
| <code>git branch --show-current</code> 失敗 || ソースがGitリポジトリではない || 下記の環境変数を設定する。 OPENCODE_VERSION=<バージョン例: 1.1.53> OPENCODE_CHANNEL=latest
|-
| <code>models.dev</code> に接続できない || ネットワーク制限 || 事前に api.json をダウンロードして、<code>MODELS_DEV_API_JSON=/path/to/api.json</code> で指定する。
|-
| GLIBCバージョン不足 || SUSEのGLIBCのバージョンが古い || <code>--single</code> に加えて <code>--baseline</code> フラグを追加 または、muslビルドを検討する。
|-
| native module のビルド失敗 || C / C++ コンパイラ不足 || ビルドツールをインストールする。
<pre>sudo zypper install gcc gcc-c++ make</pre>
|}
</center>
 
===== オフライン環境でのビルド =====
ネットワークに接続できない場合、モデルデータを事前にダウンロードしておく必要がある。 
# オンライン環境で事前にダウンロード
curl -o api.json https://models.dev/api.json

# ビルド時にローカルファイルを指定
export MODELS_DEV_API_JSON=/path/to/api.json
./packages/opencode/script/build.ts --single
 
===== baselineビルド =====
CPUがAVX2命令セットをサポートしていない場合、<code>--baseline</code> フラグを追加する。 
./packages/opencode/script/build.ts --single --baseline
 

== デスクトップアプリケーションのビルド ==
OpenCode Desktopは、Tauri v2ベースのデスクトップアプリケーションである。 
 
==== デスクトップアプリケーションの構成 ====
<center>
{| class="wikitable"
|+ Desktop アプリの構成
! 項目 !! 内容
|-
| フロントエンド || SolidJS + Vite (TypeScript)
|-
| バックエンド || Rust (Tauri v2 シェル)
|-
| サイドカー || OpenCode CLI バイナリ (CLIバイナリのビルドで作成したもの)
|-
| ビルドスクリプト || packages/desktop/ 配下
|-
| 出力形式 (Linux) || debパッケージ、rpmパッケージ
|-
| ソースディレクトリ || packages/desktop/ (フロントエンド) packages/desktop/src-tauri/ (Rust)
|}
</center>
 
==== ビルドの前提条件 ====
===== OpenCode CLIバイナリのビルド =====
デスクトップアプリケーションでは、OpenCode CLIバイナリをサイドカーとしてバンドルする。 
そのため、まず、OpenCode CLIバイナリのビルドを完了させること。 
 
===== Rustツールチェーン =====
Tauri v2 のビルドには、Rustが必要である。 
 
# Rustのインストール (未インストールの場合)
curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh

# 環境変数の設定を反映
source "$HOME/.cargo/env"

# バージョン確認
rustc --version
cargo --version
 
===== 依存ライブラリのインストール =====
Tauri v2公式ドキュメントに基づく依存関係のライブラリをインストールする。 
sudo zypper install -t pattern devel_basis
sudo zypper install curl wget file webkit2gtk3-devel libopenssl-devel libappindicator3-1 librsvg-devel
 
===== ソースコードのダウンロード =====
[https://github.com/anomalyco/opencode/releases OpenCodeのGithub]にアクセスして、ソースコードをダウンロードする。 
ダウンロードしたファイルを解凍する。 
tar xf opencode-<バージョン>.tar.gz
cd opencode-<バージョン>
 

==== デスクトップアプリケーションのビルド ====
===== Step 1 : 環境変数の設定 =====
環境変数を設定する。 
<syntaxhighlight lang="sh">
export OPENCODE_VERSION=<バージョン例 : 1.2.4>
export OPENCODE_CHANNEL=latest
</syntaxhighlight>
 
===== Step 2 : 依存パッケージのインストール =====
プロジェクトディレクトリに移動して、依存パッケージをインストールする。 
cd /path/to/opencode-<バージョン>
bun install
 
もし、bun installに失敗する場合は、node-gypをインストールする。 
bun add node-gyp -D
# または
npm install -g node-gyp
 
===== Step 2.5 : OpenCode Desktopの最大化に関する不具合 =====
OpenCode Desktopにおいて、前回終了したウィンドウサイズで起動できるようにする場合は、以下に示すファイルの60行目をコメントアウトする。 
 
vi /path/to/opencode-<バージョン>/packages/desktop/src-tauri/src/windows.rs
 
<syntaxhighlight lang="rust">
// /path/to/opencode-<バージョン>/packages/desktop/src-tauri/src/windows.rsファイル

// 編集前
.maximized(true)

// 編集後
//.maximized(true)
</syntaxhighlight>
 
===== Step 3 : CLIバイナリのビルド (未完了の場合) =====
サイドカーとなるOpenCode CLIバイナリが必要である。 
CLIバイナリのビルド手順を完了していない場合は、OpenCode CLIバイナリをインストールする。 
./packages/opencode/script/build.ts --single
 
下記のエラーが表示される場合がある。
| // relax version requirement
| const expectedBunVersionRange = `^${expectedBunVersion}`
|
| if (!semver.satisfies(process.versions.bun, expectedBunVersionRange)) {
| throw new Error(`This script requires bun@${expectedBunVersionRange}, but you are using bun@${process.versions.bun}`)

error: This script requires bun@^X.X.X, but you are using bun@X.X.X
at /path/to/opencode-X.X.XX/packages/script/src/index.ts:16:13
 
この時、bunをアップデートする。 
bun upgrade
 

===== Step 4 : サイドカーの配置 =====
OpenCode CLIバイナリを、Tauriが期待するサイドカーディレクトリにコピーする。 
mkdir -p packages/desktop/src-tauri/sidecars
cp packages/opencode/dist/opencode-linux-x64/bin/opencode \
packages/desktop/src-tauri/sidecars/opencode-cli-x86_64-unknown-linux-gnu
 
tauri.conf.json ファイル内の <code>externalBin</code> に sidecars/opencode-cli が指定されており、Tauriがターゲットトリプル (<code>x86_64-unknown-linux-gnu</code>) を付与して検索する。 
 
===== Step 5 : フロントエンドのビルド確認 (任意) =====
Viteビルドは、<code>tauri build</code> コマンドの <code>beforeBuildCommand</code> で自動実行されるが、事前に確認する場合は以下に示すコマンドを実行する。 
bun run --cwd packages/desktop build
 
===== Step 6 : Tauriビルドの実行 =====
Tauriビルドを実行する。 
bun run --cwd packages/desktop tauri build
 
上記のコマンドは、以下に示す事柄を実行する。 
* <code>beforeBuildCommand</code> (<code>bun run build</code>) でフロントエンドをビルドする。
* Cargo (Rust) でネイティブバイナリをコンパイルする。
* サイドカー (OpenCode CLIバイナリ) をバンドルに含める。
* deb / rpmパッケージを生成する。
 
Cargo.toml ファイルにgitパッチ依存 (specta、tauri 本体) があるため、ネットワーク接続が必須である。 
 
以下に示すエラーが出力される場合がある。 
 
$ tauri build
thread '<unnamed>' panicked at crates/tauri-cli/src/interface/rust.rs:146:8:
called `Result::unwrap()` on an `Err` value: Error { kind: Io(Os { code: 24, kind: Uncategorized, message: "Too many open files" }), paths: [] }
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace
error: script "tauri" was terminated by signal SIGABRT (Abort)
 
これは、Tauriのビルドプロセス (Rustコンパイル含む) が、現在のシェルセッションで許可されているオープンファイル数の上限を超えているため、表示される。 
これを解決するには、オープンファイル数の上限を引き上げる。 
 
ulimit -n 1048576
 
もし、<code>ulimit -n 1048576</code> コマンドを実行して、Operation not permitted エラーが出力される場合は、システム側のハードリミットも引き上げる必要がある。 
 
sudo vi /etc/security/limits.conf
 
# /etc/security/limits.confファイル

<ユーザ名> soft nofile 1048576
<ユーザ名> hard nofile 1048576
 
編集した後、再ログインまたはPCを再起動する。 
 
再ログイン後または再起動後、Tauriをビルドする。 
cd /path/to/opencode-<バージョン>

ulimit -n 1048576
bun run --cwd packages/desktop tauri build
 

===== 生成されたファイルの確認 =====
以下に示すディレクトリにファイルが生成される。 
# RPMパッケージ
ls -la packages/desktop/src-tauri/target/release/bundle/rpm/*.rpm

# debパッケージ
ls -la packages/desktop/src-tauri/target/release/bundle/deb/*.deb

# 実行バイナリ (直接実行も可能)
ls -la packages/desktop/src-tauri/target/release/OpenCode
 

==== 動作確認 ====
RPMパッケージをインストールして確認する。 
# RPMパッケージをインストールして確認
sudo zypper install ./packages/desktop/src-tauri/target/release/bundle/rpm/*.rpm

## または

# 実行バイナリを直接起動
./packages/desktop/src-tauri/target/release/OpenCode
 
==== トラブルシューティング ====
<center>
{| class="wikitable"
|+ トラブルシューティング
! 問題 !! 原因 !! 対策
|-
| cargo buildコマンド実行時に、git依存の取得に失敗 || ネットワーク接続なし / プロキシ || Cargo.tomlファイルにgit パッチ依存あり、ネットワーク接続が必須
|-
| opencode-cli-x86_64-unknown-linux-gnu not found || サイドカーが配置されていない || サイドカーの配置手順を実行して、OpenCode CLIバイナリをコピーする。
|-
| 画面が真っ白 / WebView 描画されない || Wayland環境の問題 || 環境変数 <code>OC_ALLOW_WAYLAND=1</code> でWaylandを強制する。
|-
| RPMパッケージが生成されない || tauri.conf.jsonファイルのtargets設定 || deb、rpmが設定されていることを確認する。
|}
</center>
 
===== 特定パッケージ形式のみビルド =====
全形式をビルドする必要がない場合、<code>--bundles</code> フラグで指定できる。 
# RPMのみ
bun run --cwd packages/desktop tauri build --bundles rpm

# debのみ
bun run --cwd packages/desktop tauri build --bundles deb
 
===== デバッグビルド =====
問題の調査が必要な場合、デバッグビルドを実行できる。 
bun run --cwd packages/desktop tauri build --debug
 
デバッグビルドではDevToolsが有効になり、アプリケーション内で右クリック -> [Inspect Element]が利用できる。 
 

== Oh my OpenCode ==
Oh my OpenCodeは、OpenCode用のマルチエージェントオーケストレーションプラグインである。 
フック、MCPサーバ、スキル、専門エージェントを活用してOpenCodeの機能を拡張する。 
 
* GitHubリポジトリ
*: https://github.com/code-yeongyu/oh-my-opencode oh-my-opencode
 
==== 主な機能 ====
Oh my OpenCodeは以下に示す機能を提供する。 
 
<center>
{| class="wikitable"
|+ Oh my OpenCode 機能一覧
! 機能 !! 説明
|-
| ultrawork || 複雑なタスクを専門エージェントに自動分割して並列処理するマジックワード
|-
| フック統合 || ツール実行前後に自動実行されるフック (コード品質チェック、テスト自動実行等)
|-
| MCP統合 || Context7 (ライブラリドキュメント取得)、Sequential Thinking (構造的推論)
|-
| LSP/AST解析 || Language Server ProtocolとAST解析による高精度なコード理解
|-
| スキルシステム || 再利用可能なプロンプトテンプレート 例: <code>/ultra</code>
|}
</center>
 
==== 専門エージェント ====
Oh my OpenCodeは以下の専門エージェントを提供する。 
 
<center>
{| class="wikitable"
|+ 専門エージェント一覧
! エージェント名 !! 役割
|-
| Sisyphus || プランニングと実装を担当するメインエージェント タスク分割、実装、テスト、反復改善を行う。
|-
| Oracle || コードベース全体の調査・分析を担当 プロジェクト構造の把握、依存関係の追跡を行う。
|-
| Frontend Engineer || フロントエンド開発を担当 React / Next.js等のUI実装、アクセシビリティ対応を行う。
|-
| Librarian || ドキュメント管理を担当 README、API仕様書、変更履歴の作成・更新を行う。
|-
| Explorer || 未知のコードベースの探索を担当 新しいプロジェクトの構造理解や技術スタックの調査を行う。
|}
</center>
 
==== インストール ====
インストールの前提条件は以下の通りである。 
 
* OpenCode v1.0.150以上
* Node.js または Bun
 
Oh my OpenCodeをインストールする。 
bunx oh-my-opencode@latest
# または
npx oh-my-opencode@latest
 
非対話モードでインストールする場合は以下のコマンドを実行する。 
bunx oh-my-opencode@latest --non-interactive
 
==== 設定 ====
設定ファイルは以下の場所に配置する。 
 
* プロジェクト単位
*: .opencode/oh-my-opencode.json
* グローバル
*: ~/.config/opencode/oh-my-opencode.json
 
設定ファイルはJSONC (コメント付きJSON) 形式で記述する。 
以下に設定ファイルの例を示す。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"context7": true,
"thinking": true
},
"agents": {
"sisyphus": true,
"oracle": true,
"frontend": true,
"librarian": true,
"explorer": true
},
"hooks": {
"afterEdit": true,
"afterWrite": true
},
"skills": {
"ultra": true
}
}
</syntaxhighlight>
 
下表に、各設定項目の説明を示す。 
 
<center>
{| class="wikitable"
|+ 設定項目一覧
! カテゴリ !! 設定項目 !! 説明
|-
| rowspan="3" | mcpServers || - || MCPサーバの有効 / 無効を設定する。
|-
| context7 || ライブラリドキュメント取得サーバ
|-
| thinking || 構造的推論サーバ
|-
| rowspan="6" | agents || - || 専門エージェントの有効/無効を設定する。
|-
| sisyphus || 個別に制御可能
|-
| oracle || 個別に制御可能
|-
| frontend || 個別に制御可能
|-
| librarian || 個別に制御可能
|-
| explorer || 個別に制御可能
|-
| rowspan="3" | hooks || - || フックの有効 / 無効を設定する。
|-
| afterEdit || ファイル編集後に自動チェックを実行する。
|-
| afterWrite || ファイル作成後に自動チェックを実行する。
|-
| rowspan="2" | skills || - || スキルの有効 / 無効を設定する。
|-
| ultra || ultraworkスキルを有効化する。
|}
</center>
 
==== 使用方法 ====
プロンプトに ultrawork というキーワードを含めるだけで、複雑なタスクを専門エージェントに自動分割して並列処理する。 
 
使用例を以下に示す。 
 
* 大規模リファクタリング
*: <pre>ultrawork このプロジェクトの認証システムをリファクタリングして</pre>
* 新機能実装
*: <pre>ultrawork ユーザ管理機能を実装して</pre>
* ドキュメント調査
*: <pre>ultrawork このコードベースを分析してドキュメントを作成して</pre>
 
==== アンインストール ====
プロジェクト単位の設定ファイルを削除する。 
rm -rf .opencode/agents \
.opencode/hooks \
.opencode/skills \
.opencode/mcp.json \
.opencode/oh-my-opencode.json
 
グローバル設定を削除する。 
rm -rf ~/.config/opencode/oh-my-opencode.json
 
==== 注意事項 ====
Oh my OpenCodeを使用する際は以下の点に注意すること。 
 
* AnthropicモデルのOpenCode対応はコミュニティ主導の取り組みであり、Anthropicの公式サポート対象外である。
* フック機能により外部コマンドが自動実行されるため、設定内容を事前に確認すること。
* MCPサーバはネットワークアクセスを行う場合があるため、セキュリティポリシーに準じて使用すること。
 

== 注意事項 ==
==== プライバシーとデータ取り扱い ====
OpenCodeはオープンソースであり、コードの透明性を確保している。 
* ローカルでの処理を優先、コードの送信は最小限に抑制する。
* 使用するAIプロバイダのプライバシーポリシーを確認すること。
* GitHubリポジトリで実装を検証可能
 
==== 生成コードの検証 ====
AIが生成したコードは必ずレビューして検証する。 
* コードの動作を確認
* セキュリティ上の問題がないか確認
* ライセンス上の問題がないか確認
* コーディング規約に準拠しているか確認
 
==== セキュリティ ====
APIキーやパスワード等の機密情報をコードに含めないように注意する。 
* APIキー、パスワード等の機密情報をコードに含めない。
* 環境変数や設定ファイルで管理する。
* .gitignore ファイルで機密情報を含むファイルを除外する。
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]]

インストール - OpenCode

2026-04-09T11:25:25Z

Wiki: /* Step 6 : Tauriビルドの実行 */

== 概要 ==
OpenCodeは、オープンソースのAIコーディングエージェントである。 
ターミナルベースのTUI (ターミナルユーザーインターフェース) を提供し、75以上のLLMプロバイダに対応している。 
 
主要な特徴として、以下が挙げられる。 
* Anthropic (Claude)、OpenAI (GPT)、Google (Gemini)、GitHub Copilot、Ollama等のモデルの主要プロバイダをサポート
* 2026年1月にGitHub Copilotとの公式パートナーシップを発表
* プライバシー重視の設計
*: コードは送信されず、ローカルでの処理を優先
* CLI、TUI、Desktop アプリ、IDE拡張機能、Webインターフェースを提供
* MCP (Model Context Protocol) とLSP (Language Server Protocol) をサポート
* 組み込みエージェント
** build (開発用)
** plan (読み取り専用分析)
 
OpenCodeは、Go言語でBubble Tea TUIフレームワークを使用して実装されている。 
セッション管理、マルチセッション対応を備え、会話履歴の保存、復元、エクスポートが可能である。 
 
Desktop アプリはTauri v2ベースのネイティブアプリケーションとして実装されており、TypeScriptで実装された内部CLI、Rust + SolidJSで構築されたフロントエンドを組み合わせている。 
 

== 主な機能 ==
OpenCodeは、多様な機能を提供する包括的なAIコーディングツールである。 
 
<center>
{| class="wikitable"
|+ 主要機能一覧
! 機能 !! 説明
|-
| TUI (Bubble Tea) || ターミナルベースの対話型インターフェース
|-
| マルチプロバイダ対応 || 75以上のLLMプロバイダをサポート
|-
| セッション管理 || 会話履歴の保存、復元、エクスポート
|-
| ツール統合 || ファイル操作、Bash実行、テスト実行等
|-
| MCP (Model Context Protocol) || 外部ツールとの統合プロトコル
|-
| LSP (Language Server Protocol) || 25以上の組み込みLSPサーバーによる言語サーバーとの連携
|-
| 組み込みエージェント || build (開発用) plan (読み取り専用分析) general (調査用) explore (コード探索用)
|-
| Desktop アプリ || Tauri v2ベースのネイティブアプリ
|-
| IDE拡張機能 || VS Code、JetBrains等のIDE拡張
|-
| カスタムコマンド || .opencode/commands/ ディレクトリ内でユーザ定義コマンド作成
|-
| Git統合 || <code>/undo</code>、<code>/redo</code> コマンドでGitバック付きの変更管理
|}
</center>
 

== 対応AIプロバイダとモデル ==
OpenCodeは、75以上のLLMプロバイダに対応している。 
 
==== 主要プロバイダ一覧 ====
<center>
{| class="wikitable"
|+ 主要プロバイダ一覧
! プロバイダ !! 認証方法 !! 備考
|-
| Anthropic || APIキー (<code>ANTHROPIC_API_KEY</code>) || Claude 4.x系をサポート
|-
| OpenAI || APIキー (<code>OPENAI_API_KEY</code>) || GPT-4o、o3等をサポート
|-
| Google || APIキー (<code>GOOGLE_API_KEY</code>) || Gemini 3等をサポート
|-
| GitHub Copilot || GitHub認証 (OAuth) || <code>/connect</code> コマンドで認証
|-
| Z.AI || APIキー || GLM-5、GLM-4.7等をサポート GLM Coding Plan対応
|-
| AWS Bedrock || AWS認証情報 || Anthropicモデルのホスティング
|-
| Azure OpenAI || Azureエンドポイント || OpenAIモデルのホスティング
|-
| Ollama || ローカル実行 (認証不要) || ローカルモデルの実行
|-
| OpenRouter || APIキー || 複数プロバイダのルーティング
|-
| Groq || APIキー || 高速推論
|-
| Together AI || APIキー || オープンソースモデル
|-
| Fireworks AI || APIキー || 高速推論
|}
</center>
 
==== 推奨モデル ====
<center>
{| class="wikitable"
|+ 用途別推奨モデル
! 用途 !! 推奨モデル
|-
| 高精度コーディング || Claude Sonnet 4.5、GPT-4o
|-
| 高速処理 || Claude Haiku 4.5、Gemini 2.5 Flash
|-
| 複雑な推論 || Claude Opus 4.6、o3
|-
| ローカル実行 || Qwen 2.5 Coder (Ollama)
|-
| コスト効率重視 || GLM-4.7、GLM-5 (Z.AI Coding Plan)
|}
</center>
 
==== ローカルモデル (Ollama) ====
Ollamaを使用することで、ローカル環境でモデルを実行できる。 
 
===== Ollamaのインストール =====
Ollamaの公式サイトからインストールスクリプトをダウンロードして実行する。 
curl -fsSL https://ollama.com/install.sh | bash
 
===== モデルのダウンロード =====
Ollamaでモデルをダウンロードする。 
ollama pull qwen2.5-coder
 
===== OpenCodeでの設定 =====
<code>opencode.json</code> でOllamaプロバイダを設定する。 
<syntaxhighlight lang="json">
{
"$schema": "https://opencode.ai/config.json",
"model": "ollama/qwen2.5-coder"
}
</syntaxhighlight>
 

== 前提条件 ==
OpenCodeをインストールするには、以下の前提条件を満たす必要がある。 
 
==== 標準インストール時の前提条件 ====
<center>
{| class="wikitable"
|+ 標準インストール時の前提条件
! 要件 !! 詳細
|-
| OS || Linux、MacOS、Windows
|-
| Node.js || npm経由のインストールに必要 (Node.js 18以上)
|-
| ネットワーク || AIプロバイダへの接続に必要
|-
| AIプロバイダのAPIキー || 使用するプロバイダのAPIキーまたは認証情報
|}
</center>
 

== インストール ==
OpenCodeのインストール方法を以下に示す。 
 
==== クイックインストール (Linux) ====
公式のインストールスクリプトを使用してインストールする。 
curl -fsSL https://opencode.ai/install | bash
 
==== Homebrew (MacOS) ====
Homebrewを使用してインストールできる。 
brew install opencode
 
==== npm (全プラットフォーム) ====
npmを使用してグローバルインストールする。 
npm install -g opencode
 
==== Windows (Scoop / Chocolatey) ====
Windowsでは、ScoopまたはChocolateyを使用してインストールできる。 
 
===== Scoopでのインストール =====
scoop install opencode
 
===== Chocolateyでのインストール =====
choco install opencode
 
==== デスクトップアプリケーション ====
[https://opencode.ai/download OpenCodeの公式Webサイト]にアクセスして、デスクトップアプリケーションをダウンロードする。 
 
対応プラットフォーム: 
* Linux (deb、rpm)
* MacOS (dmg)
* Windows (exe)
 
==== バージョン確認 ====
インストール後、バージョンを確認する。 
opencode --version
 

== 初期設定 ==
OpenCodeの初期設定を以下に示す。 
 
==== プロバイダの認証 ====
OpenCodeの初回起動時に、<code>/connect</code> コマンドまたは <code>opencode auth login</code> コマンドでAIプロバイダとの認証を設定する。 
 
===== GitHub Copilotとの連携 =====
OpenCodeはGitHub Copilotの公式パートナーであり、<code>/connect</code> コマンドで認証を設定できる。 
 
OpenCodeを起動する。 
opencode
 
認証を設定する。 
/connect
 
例えば、GitHub Copilotを選択する。 
Webブラウザが開き、GitHub認証ページが表示される。 
 
認証を完了すると、OpenCodeでGitHub Copilotが使用可能になる。 
 
===== APIキーによる認証 =====
環境変数でAPIキーを設定する方法もある。 
<syntaxhighlight lang="sh">
export ANTHROPIC_API_KEY="sk-..."
export OPENAI_API_KEY="sk-..."
export GOOGLE_API_KEY="..."
</syntaxhighlight>
 
環境変数を永続化する場合は、~/.profileファイル等に環境変数 <code>ANTHROPIC_API_KEY</code> を設定する。 
<syntaxhighlight lang="sh">
export ANTHROPIC_API_KEY="sk-..."
</syntaxhighlight>
 
===== Z.AI (GLM) との連携 =====
Z.AIのGLMモデル (GLM-5、GLM-4.7等) をOpenCodeで使用するには、[https://z.ai/subscribe Z.AI GLM または GLM Coding Plan]のサブスクリプション契約およびAPIキーが必要である。 
 
====== GLM / GLM Coding Planの概要 ======
GLM / GLM Coding Planは、Z.AIが提供するAIコーディング向けのサブスクリプションプランである。 
 
<center>
{| class="wikitable"
|+ GLM Coding Plan
! プラン !! 月額 !! GLM-5対応 !! 5時間あたりの目安
|-
| Lite || $10 || 対応 || 約80プロンプト
|-
| Pro || $30 || 対応 || 約400プロンプト
|-
| Max || $120 || 対応 || 約1,600プロンプト
|}
</center>
 
使用可能なモデルは以下の通りである。 
* GLM-5 (ProプランおよびMaxプランのみ)
* GLM-4.7
* GLM-4.6
* GLM-4.5
* GLM-4.5-Air
 
GLM-5はピーク時 (日本時間 15:00〜19:00) に3倍、オフピーク時に2倍のクォータを消費する。 
日常的なタスクにはGLM-4.7を使用し、複雑なタスクにのみGLM-5を使用することが推奨される。 
 

====== 認証の設定手順 ======
Z.AIの[https://z.ai/manage-apikey/apikey-list APIコンソール]にアクセスして、APIキーを取得する。 
 
<code>opencode auth login</code> コマンドを実行して、プロバイダ選択で Z.AI Coding Plan を選択する。 
 
<syntaxhighlight lang="sh">
opencode auth login
</syntaxhighlight>
 
┌ Add credential
│
◆ Select provider
│ ● Z.AI Coding Plan
│ ...
└
 
Z.AIのAPIキーを入力する。 
┌ Add credential
│
◇ Select provider
│ Z.AI Coding Plan
│
◇ Enter your API key
│ <Z.AIのAPIキーを入力>
└
 
OpenCodeを起動して、<code>/models</code> コマンドでGLM-5 / GLM-4.7等のモデルを選択する。 
opencode
 
/models
 
====== トラブルシューティング : Insufficient balance ======
GLMモデルの使用時に、以下に示すエラーメッセージが表示される場合がある。 
Insufficient balance or no resource package. Please recharge.
 
このエラーは、OpenCodeのプロバイダ設定がGLM Coding Plan専用のエンドポイントに接続されていない場合に発生する。 
 
GLM Coding Planでは、専用のAPIエンドポイント (https://api.z.ai/api/coding/paas/v4) を使用する必要がある。 
プロバイダ選択で Z.AI (通常のAPI) を選択した場合、標準エンドポイント (https://api.z.ai/api/paas/v4) に接続されるため、Coding Planの残高が認識されず、上記のエラーが発生する。 
 
<center>
{| class="wikitable"
|+ Z.AI APIエンドポイントの違い
! エンドポイント !! URL !! 用途
|-
| 標準 (通常API) || https://api.z.ai/api/paas/v4 || 従量課金のAPI利用
|-
| Coding Plan専用 || https://api.z.ai/api/coding/paas/v4 || GLM Coding Planサブスクリプション利用
|}
</center>
 
対処方法として、一旦Z.AIの認証情報をログアウトしてから、Z.AI Coding Plan で再度ログインする。 
 
Z.AIの認証情報をログアウトする。 
<syntaxhighlight lang="sh">
opencode auth logout
</syntaxhighlight>
 
再度ログインして、プロバイダ選択で Z.AI Coding Plan を選択する。 
<syntaxhighlight lang="sh">
opencode auth login
</syntaxhighlight>
 
┌ Add credential
│
◆ Select provider
│ ● Z.AI Coding Plan ← Z.AI ではなく、Z.AI Coding Planを選択すること
│ ...
└
 
APIキーを入力して認証を完了した後、OpenCodeを起動して正常にGLMモデルが使用できることを確認する。 
 
==== 設定ファイル ====
OpenCodeの設定ファイルは、プロジェクトルート または ホームディレクトリ に配置する。 
 
===== 設定ファイルの場所 =====
設定ファイルは以下の順序で検索される。 
* プロジェクトルート
*: opencode.json
* ホームディレクトリ
*: ~/.opencode/config.json
 
===== 設定ファイルの例 =====
<syntaxhighlight lang="json">
{
"$schema": "https://opencode.ai/config.json",
"model": "anthropic/claude-sonnet-4-5-20250929",
"small_model": "anthropic/claude-haiku-4-5-20251001",
"keybinds": {
"leader": "ctrl+x"
}
}
</syntaxhighlight>
 
設定可能な項目を以下に示す。 
* <code>model</code>
*: 使用するモデル名 (プロバイダ/モデル名形式)
*: 例: <code>anthropic/claude-sonnet-4-5-20250929</code>、<code>openai/gpt-4o</code>
* <code>small_model</code>
*: 軽量タスク用のモデル (コスト削減に有効)
*: 例: <code>anthropic/claude-haiku-4-5-20251001</code>
* <code>keybinds.leader</code>
*: リーダーキーの設定
*: デフォルト : <code>ctrl+x</code>
 

== CLIコマンド ==
OpenCodeは、CLIモードと対話モードの両方で使用できる。 
 
==== 主要コマンド ====
<center>
{| class="wikitable"
|+ 主要コマンド一覧
! コマンド !! 説明
|-
| <code>opencode</code> || TUIを起動
|-
| <code>opencode run "プロンプト"</code> || 非対話モードでプロンプトを実行
|-
| <code>opencode --model プロバイダ/モデル名</code> || モデルを指定して起動
|-
| <code>opencode --continue</code> || 前回のセッションを継続して起動
|-
| <code>opencode auth login</code> || プロバイダの認証を設定
|-
| <code>opencode auth logout</code> || 認証情報を削除
|-
| <code>opencode models</code> || 使用可能なモデル一覧を表示
|-
| <code>opencode mcp list</code> || MCPサーバ一覧を表示
|-
| <code>opencode mcp add サーバー名</code> || MCPサーバを追加
|-
| <code>opencode serve</code> || ヘッドレスバックエンドサーバを起動
|-
| <code>opencode --version</code> || バージョンを表示
|-
| <code>opencode --help</code> || ヘルプを表示
|}
</center>
 
==== 非対話モード ====
非対話モードでは、プロンプトをコマンドライン引数として渡すことができる。 
 
===== 使用例 =====
プロジェクトの概要を説明する。 
opencode run "このプロジェクトの概要を説明して"
 
モデルを指定してテストを実行する。 
opencode run "テストを実行して" --model anthropic/claude-sonnet-4-5-20250929
 

== TUI (ターミナルユーザーインターフェース) ==
OpenCodeのTUIは、ターミナルベースの対話型インターフェースである。 
 
==== スラッシュコマンド ====
TUI内でスラッシュコマンドを使用して、様々な操作を実行できる。 
 
<center>
{| class="wikitable"
|+ スラッシュコマンド一覧
! コマンド !! 説明
|-
| <code>/new</code> || 新しいセッションを開始
|-
| <code>/init</code> || プロジェクト構造を分析
|-
| <code>/undo</code> || 直前の変更を元に戻す (Git連携)
|-
| <code>/redo</code> || 元に戻した変更をやり直す
|-
| <code>/compact</code> || 会話を要約して圧縮
|-
| <code>/share</code> || 会話の共有リンクを生成
|-
| <code>/export</code> || 会話をMarkdownでエクスポート
|-
| <code>/sessions</code> || 過去のセッション一覧を表示
|-
| <code>/models</code> || 使用可能なモデル一覧を表示
|-
| <code>/agents</code> || エージェント一覧を表示
|-
| <code>/connect</code> || プロバイダ認証を設定
|-
| <code>/status</code> || 現在のステータスを表示
|-
| <code>/mcp</code> || MCPサーバ一覧を表示
|-
| <code>/theme</code> || テーマを変更
|-
| <code>/editor</code> || 外部エディタで入力
|-
| <code>/help</code> || ヘルプを表示
|-
| <code>/commands</code> || コマンド一覧を表示
|-
| <code>/exit</code> || OpenCodeを終了
|}
</center>
 
==== キーバインド ====
OpenCodeのリーダーキーのデフォルトは、[Ctrl] + [X]キーである。 
リーダーキーを押した後に各キーを入力する。 
 
<center>
{| class="wikitable"
|+ キーバインド一覧
! キー !! 説明
|-
| [Ctrl] + [X] -> [N] || 新しいセッション
|-
| [Ctrl] + [X] -> [L] || セッション一覧
|-
| [Ctrl] + [X] -> [T] || タイムライン
|-
| [Ctrl] + [X] -> [M] || モデル選択ダイアログ
|-
| [Ctrl] + [X] -> [C] || コンパクト表示
|-
| [Ctrl] + [P] || コマンドパレット
|-
| [Tab] || Plan/Buildエージェント切替
|-
| [Page Up] / [Page Down] || スクロール
|-
| [Shift] + [Enter] || 改行入力
|}
</center>
 
==== ファイル参照とBashコマンド ====
TUI内でファイル参照とBashコマンドの実行ができる。 
 
===== ファイル参照 =====
<code>@</code> でファイルをファジー検索して参照を追加する。 
@filename
 
===== Bashコマンドの実行 =====
<code>!</code> をプレフィックスとしてBashコマンドを実行する。 
!ls -la
!git status
 

== CLIバイナリのビルド (SUSE) ==
OpenCode CLIバイナリをSUSE環境でソースコードからビルドすることができる。 
 
==== ビルドの前提条件 ====
<center>
{| class="wikitable"
|+ ビルドの前提条件
! 項目 !! 要件
|-
| OS ||
* RHEL 9 / 10
* SUSE 15 / 16
|-
| Bun || 1.3.x (package.json 内の <code>packageManager</code> で <code>bun@1.3.9</code> を指定)
|-
| git || ブランチ名取得に使用 (Gitリポジトリでない場合は環境変数で回避可能)
|-
| ネットワーク || ビルド時に https://models.dev/api.json からモデルデータを取得
|}
</center>
 
===== 前提条件の確認コマンド =====
# Bunバージョン確認 (1.3.9が必要)
bun --version

# ネットワーク接続の確認
curl -s https://models.dev/api.json | head -c 100
 

==== ビルド方式の説明 ====
<center>
{| class="wikitable"
|+ ビルド方式の説明
! 項目 !! 内容
|-
| 言語 || TypeScript (Bun ランタイム)
|-
| ビルド方式 || <code>Bun.build()</code> の <code>compile: true</code> でスタンドアロン実行ファイルを生成
|-
| ビルドスクリプト || packages/opencode/script/build.ts
|-
| 出力 || Bunランタイムを内蔵した単一バイナリ (<code>opencode</code>)
|}
</center>
 
==== 環境変数の設定 ====
ソースディレクトリがGitリポジトリでない場合、<code>git branch --show-current</code> が失敗するため、環境変数を設定する。 
<syntaxhighlight lang="sh">
export OPENCODE_VERSION=<バージョン例 : 1.2.14>
export OPENCODE_CHANNEL=latest
</syntaxhighlight>
 

==== 依存パッケージのインストール ====
プロジェクトディレクトリに移動して、依存パッケージをインストールする。 
cd /path/to/opencode-<バージョン>
bun install
 
このプロジェクトはBunワークスペース構成のモノレポである。 
<code>bun install</code> コマンドを実行して、ルートおよび全パッケージの依存関係がインストールされる。 
 

==== ビルドの実行 ====
ビルドスクリプトを実行する。 
./packages/opencode/script/build.ts --single
 
<code>--single</code> フラグは現在のプラットフォーム向けのみビルドする。(例: linux-x64) 
フラグなしで実行すると全11プラットフォーム分のクロスコンパイルを試みる。 
 
ビルドスクリプトの処理内容: 
* <code>models.dev</code> からモデルデータを取得し、TypeScript スナップショットを生成
* <code>@opentui/core</code> と <code>@parcel/watcher</code> のネイティブバインディングをインストール
* <code>Bun.build()</code> で TypeScript をスタンドアロンバイナリにコンパイル
* <code>packages/opencode/dist/opencode-linux-x64/bin/opencode</code> に出力
 
==== 動作確認 ====
ビルドが完了したら、バイナリが生成されたか確認する。 
# バイナリが生成されたか確認
ls -la packages/opencode/dist/opencode-linux-x64/bin/opencode

# バージョン表示で動作確認
./packages/opencode/dist/opencode-linux-x64/bin/opencode --help
 
==== トラブルシューティング ====
<center>
{| class="wikitable"
|+ トラブルシューティング
! 問題 !! 原因 !! 対策
|-
| <code>git branch --show-current</code> 失敗 || ソースがGitリポジトリではない || 下記の環境変数を設定する。 OPENCODE_VERSION=<バージョン例: 1.1.53> OPENCODE_CHANNEL=latest
|-
| <code>models.dev</code> に接続できない || ネットワーク制限 || 事前に api.json をダウンロードして、<code>MODELS_DEV_API_JSON=/path/to/api.json</code> で指定する。
|-
| GLIBCバージョン不足 || SUSEのGLIBCのバージョンが古い || <code>--single</code> に加えて <code>--baseline</code> フラグを追加 または、muslビルドを検討する。
|-
| native module のビルド失敗 || C / C++ コンパイラ不足 || ビルドツールをインストールする。
<pre>sudo zypper install gcc gcc-c++ make</pre>
|}
</center>
 
===== オフライン環境でのビルド =====
ネットワークに接続できない場合、モデルデータを事前にダウンロードしておく必要がある。 
# オンライン環境で事前にダウンロード
curl -o api.json https://models.dev/api.json

# ビルド時にローカルファイルを指定
export MODELS_DEV_API_JSON=/path/to/api.json
./packages/opencode/script/build.ts --single
 
===== baselineビルド =====
CPUがAVX2命令セットをサポートしていない場合、<code>--baseline</code> フラグを追加する。 
./packages/opencode/script/build.ts --single --baseline
 

== デスクトップアプリケーションのビルド ==
OpenCode Desktopは、Tauri v2ベースのデスクトップアプリケーションである。 
 
==== デスクトップアプリケーションの構成 ====
<center>
{| class="wikitable"
|+ Desktop アプリの構成
! 項目 !! 内容
|-
| フロントエンド || SolidJS + Vite (TypeScript)
|-
| バックエンド || Rust (Tauri v2 シェル)
|-
| サイドカー || OpenCode CLI バイナリ (CLIバイナリのビルドで作成したもの)
|-
| ビルドスクリプト || packages/desktop/ 配下
|-
| 出力形式 (Linux) || debパッケージ、rpmパッケージ
|-
| ソースディレクトリ || packages/desktop/ (フロントエンド) packages/desktop/src-tauri/ (Rust)
|}
</center>
 
==== ビルドの前提条件 ====
===== OpenCode CLIバイナリのビルド =====
デスクトップアプリケーションでは、OpenCode CLIバイナリをサイドカーとしてバンドルする。 
そのため、まず、OpenCode CLIバイナリのビルドを完了させること。 
 
===== Rustツールチェーン =====
Tauri v2 のビルドには、Rustが必要である。 
 
# Rustのインストール (未インストールの場合)
curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh

# 環境変数の設定を反映
source "$HOME/.cargo/env"

# バージョン確認
rustc --version
cargo --version
 
===== 依存ライブラリのインストール =====
Tauri v2公式ドキュメントに基づく依存関係のライブラリをインストールする。 
sudo zypper install -t pattern devel_basis
sudo zypper install curl wget file webkit2gtk3-devel libopenssl-devel libappindicator3-1 librsvg-devel
 
===== ソースコードのダウンロード =====
[https://github.com/anomalyco/opencode/releases OpenCodeのGithub]にアクセスして、ソースコードをダウンロードする。 
ダウンロードしたファイルを解凍する。 
tar xf opencode-<バージョン>.tar.gz
cd opencode-<バージョン>
 

==== デスクトップアプリケーションのビルド ====
===== Step 1 : 環境変数の設定 =====
環境変数を設定する。 
<syntaxhighlight lang="sh">
export OPENCODE_VERSION=<バージョン例 : 1.2.4>
export OPENCODE_CHANNEL=latest
</syntaxhighlight>
 
===== Step 2 : 依存パッケージのインストール =====
プロジェクトディレクトリに移動して、依存パッケージをインストールする。 
cd /path/to/opencode-<バージョン>
bun install
 
もし、bun installに失敗する場合は、node-gypをインストールする。 
bun add node-gyp -D
# または
npm install -g node-gyp
 
===== Step 2.5 : OpenCode Desktopの最大化に関する不具合 =====
OpenCode Desktopにおいて、前回終了したウィンドウサイズで起動できるようにする場合は、以下に示すファイルの60行目をコメントアウトする。 
 
vi /path/to/opencode-<バージョン>/packages/desktop/src-tauri/src/windows.rs
 
<syntaxhighlight lang="rust">
// /path/to/opencode-<バージョン>/packages/desktop/src-tauri/src/windows.rsファイル

// 編集前
.maximized(true)

// 編集後
//.maximized(true)
</syntaxhighlight>
 
===== Step 3 : CLIバイナリのビルド (未完了の場合) =====
サイドカーとなるOpenCode CLIバイナリが必要である。 
CLIバイナリのビルド手順を完了していない場合は、OpenCode CLIバイナリをインストールする。 
./packages/opencode/script/build.ts --single
 
下記のエラーが表示される場合がある。
| // relax version requirement
| const expectedBunVersionRange = `^${expectedBunVersion}`
|
| if (!semver.satisfies(process.versions.bun, expectedBunVersionRange)) {
| throw new Error(`This script requires bun@${expectedBunVersionRange}, but you are using bun@${process.versions.bun}`)

error: This script requires bun@^X.X.X, but you are using bun@X.X.X
at /path/to/opencode-X.X.XX/packages/script/src/index.ts:16:13
 
この時、bunをアップデートする。 
bun upgrade
 

===== Step 4 : サイドカーの配置 =====
OpenCode CLIバイナリを、Tauriが期待するサイドカーディレクトリにコピーする。 
mkdir -p packages/desktop/src-tauri/sidecars
cp packages/opencode/dist/opencode-linux-x64/bin/opencode \
packages/desktop/src-tauri/sidecars/opencode-cli-x86_64-unknown-linux-gnu
 
tauri.conf.json ファイル内の <code>externalBin</code> に sidecars/opencode-cli が指定されており、Tauriがターゲットトリプル (<code>x86_64-unknown-linux-gnu</code>) を付与して検索する。 
 
===== Step 5 : フロントエンドのビルド確認 (任意) =====
Viteビルドは、<code>tauri build</code> コマンドの <code>beforeBuildCommand</code> で自動実行されるが、事前に確認する場合は以下に示すコマンドを実行する。 
bun run --cwd packages/desktop build
 
===== Step 6 : Tauriビルドの実行 =====
Tauriビルドを実行する。 
bun run --cwd packages/desktop tauri build
 
上記のコマンドは、以下に示す事柄を実行する。 
* <code>beforeBuildCommand</code> (<code>bun run build</code>) でフロントエンドをビルドする。
* Cargo (Rust) でネイティブバイナリをコンパイルする。
* サイドカー (OpenCode CLIバイナリ) をバンドルに含める。
* deb / rpmパッケージを生成する。
 
Cargo.toml ファイルにgitパッチ依存 (specta、tauri 本体) があるため、ネットワーク接続が必須である。 
 
以下に示すエラーが出力される場合がある。 
 
$ tauri build
thread '<unnamed>' panicked at crates/tauri-cli/src/interface/rust.rs:146:8:
called `Result::unwrap()` on an `Err` value: Error { kind: Io(Os { code: 24, kind: Uncategorized, message: "Too many open files" }), paths: [] }
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace
error: script "tauri" was terminated by signal SIGABRT (Abort)
 
これは、Tauriのビルドプロセス (Rustコンパイル含む) が、現在のシェルセッションで許可されているオープンファイル数の上限を超えているため、表示される。 
これを解決するには、オープンファイル数の上限を引き上げる。 
 
ulimit -n 1048576
 
もし、<code>ulimit -n 1048576</code> コマンドを実行して、Operation not permitted エラーが出力される場合は、システム側のハードリミットも引き上げる必要がある。 
 
sudo vi /etc/security/limits.conf
 
# /etc/security/limits.confファイル

sudo sh -c 'echo "<ユーザ名> soft nofile 1048576" >> /etc/security/limits.conf'; \
sudo sh -c 'echo "<ユーザ名> hard nofile 1048576" >> /etc/security/limits.conf'; \
 
編集した後、再ログインまたはPCを再起動する。 
 
再ログイン後または再起動後、Tauriをビルドする。 
cd /path/to/opencode-<バージョン>

ulimit -n 1048576
bun run --cwd packages/desktop tauri build
 

===== 生成されたファイルの確認 =====
以下に示すディレクトリにファイルが生成される。 
# RPMパッケージ
ls -la packages/desktop/src-tauri/target/release/bundle/rpm/*.rpm

# debパッケージ
ls -la packages/desktop/src-tauri/target/release/bundle/deb/*.deb

# 実行バイナリ (直接実行も可能)
ls -la packages/desktop/src-tauri/target/release/OpenCode
 

==== 動作確認 ====
RPMパッケージをインストールして確認する。 
# RPMパッケージをインストールして確認
sudo zypper install ./packages/desktop/src-tauri/target/release/bundle/rpm/*.rpm

## または

# 実行バイナリを直接起動
./packages/desktop/src-tauri/target/release/OpenCode
 
==== トラブルシューティング ====
<center>
{| class="wikitable"
|+ トラブルシューティング
! 問題 !! 原因 !! 対策
|-
| cargo buildコマンド実行時に、git依存の取得に失敗 || ネットワーク接続なし / プロキシ || Cargo.tomlファイルにgit パッチ依存あり、ネットワーク接続が必須
|-
| opencode-cli-x86_64-unknown-linux-gnu not found || サイドカーが配置されていない || サイドカーの配置手順を実行して、OpenCode CLIバイナリをコピーする。
|-
| 画面が真っ白 / WebView 描画されない || Wayland環境の問題 || 環境変数 <code>OC_ALLOW_WAYLAND=1</code> でWaylandを強制する。
|-
| RPMパッケージが生成されない || tauri.conf.jsonファイルのtargets設定 || deb、rpmが設定されていることを確認する。
|}
</center>
 
===== 特定パッケージ形式のみビルド =====
全形式をビルドする必要がない場合、<code>--bundles</code> フラグで指定できる。 
# RPMのみ
bun run --cwd packages/desktop tauri build --bundles rpm

# debのみ
bun run --cwd packages/desktop tauri build --bundles deb
 
===== デバッグビルド =====
問題の調査が必要な場合、デバッグビルドを実行できる。 
bun run --cwd packages/desktop tauri build --debug
 
デバッグビルドではDevToolsが有効になり、アプリケーション内で右クリック -> [Inspect Element]が利用できる。 
 

== Oh my OpenCode ==
Oh my OpenCodeは、OpenCode用のマルチエージェントオーケストレーションプラグインである。 
フック、MCPサーバ、スキル、専門エージェントを活用してOpenCodeの機能を拡張する。 
 
* GitHubリポジトリ
*: https://github.com/code-yeongyu/oh-my-opencode oh-my-opencode
 
==== 主な機能 ====
Oh my OpenCodeは以下に示す機能を提供する。 
 
<center>
{| class="wikitable"
|+ Oh my OpenCode 機能一覧
! 機能 !! 説明
|-
| ultrawork || 複雑なタスクを専門エージェントに自動分割して並列処理するマジックワード
|-
| フック統合 || ツール実行前後に自動実行されるフック (コード品質チェック、テスト自動実行等)
|-
| MCP統合 || Context7 (ライブラリドキュメント取得)、Sequential Thinking (構造的推論)
|-
| LSP/AST解析 || Language Server ProtocolとAST解析による高精度なコード理解
|-
| スキルシステム || 再利用可能なプロンプトテンプレート 例: <code>/ultra</code>
|}
</center>
 
==== 専門エージェント ====
Oh my OpenCodeは以下の専門エージェントを提供する。 
 
<center>
{| class="wikitable"
|+ 専門エージェント一覧
! エージェント名 !! 役割
|-
| Sisyphus || プランニングと実装を担当するメインエージェント タスク分割、実装、テスト、反復改善を行う。
|-
| Oracle || コードベース全体の調査・分析を担当 プロジェクト構造の把握、依存関係の追跡を行う。
|-
| Frontend Engineer || フロントエンド開発を担当 React / Next.js等のUI実装、アクセシビリティ対応を行う。
|-
| Librarian || ドキュメント管理を担当 README、API仕様書、変更履歴の作成・更新を行う。
|-
| Explorer || 未知のコードベースの探索を担当 新しいプロジェクトの構造理解や技術スタックの調査を行う。
|}
</center>
 
==== インストール ====
インストールの前提条件は以下の通りである。 
 
* OpenCode v1.0.150以上
* Node.js または Bun
 
Oh my OpenCodeをインストールする。 
bunx oh-my-opencode@latest
# または
npx oh-my-opencode@latest
 
非対話モードでインストールする場合は以下のコマンドを実行する。 
bunx oh-my-opencode@latest --non-interactive
 
==== 設定 ====
設定ファイルは以下の場所に配置する。 
 
* プロジェクト単位
*: .opencode/oh-my-opencode.json
* グローバル
*: ~/.config/opencode/oh-my-opencode.json
 
設定ファイルはJSONC (コメント付きJSON) 形式で記述する。 
以下に設定ファイルの例を示す。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"context7": true,
"thinking": true
},
"agents": {
"sisyphus": true,
"oracle": true,
"frontend": true,
"librarian": true,
"explorer": true
},
"hooks": {
"afterEdit": true,
"afterWrite": true
},
"skills": {
"ultra": true
}
}
</syntaxhighlight>
 
下表に、各設定項目の説明を示す。 
 
<center>
{| class="wikitable"
|+ 設定項目一覧
! カテゴリ !! 設定項目 !! 説明
|-
| rowspan="3" | mcpServers || - || MCPサーバの有効 / 無効を設定する。
|-
| context7 || ライブラリドキュメント取得サーバ
|-
| thinking || 構造的推論サーバ
|-
| rowspan="6" | agents || - || 専門エージェントの有効/無効を設定する。
|-
| sisyphus || 個別に制御可能
|-
| oracle || 個別に制御可能
|-
| frontend || 個別に制御可能
|-
| librarian || 個別に制御可能
|-
| explorer || 個別に制御可能
|-
| rowspan="3" | hooks || - || フックの有効 / 無効を設定する。
|-
| afterEdit || ファイル編集後に自動チェックを実行する。
|-
| afterWrite || ファイル作成後に自動チェックを実行する。
|-
| rowspan="2" | skills || - || スキルの有効 / 無効を設定する。
|-
| ultra || ultraworkスキルを有効化する。
|}
</center>
 
==== 使用方法 ====
プロンプトに ultrawork というキーワードを含めるだけで、複雑なタスクを専門エージェントに自動分割して並列処理する。 
 
使用例を以下に示す。 
 
* 大規模リファクタリング
*: <pre>ultrawork このプロジェクトの認証システムをリファクタリングして</pre>
* 新機能実装
*: <pre>ultrawork ユーザ管理機能を実装して</pre>
* ドキュメント調査
*: <pre>ultrawork このコードベースを分析してドキュメントを作成して</pre>
 
==== アンインストール ====
プロジェクト単位の設定ファイルを削除する。 
rm -rf .opencode/agents \
.opencode/hooks \
.opencode/skills \
.opencode/mcp.json \
.opencode/oh-my-opencode.json
 
グローバル設定を削除する。 
rm -rf ~/.config/opencode/oh-my-opencode.json
 
==== 注意事項 ====
Oh my OpenCodeを使用する際は以下の点に注意すること。 
 
* AnthropicモデルのOpenCode対応はコミュニティ主導の取り組みであり、Anthropicの公式サポート対象外である。
* フック機能により外部コマンドが自動実行されるため、設定内容を事前に確認すること。
* MCPサーバはネットワークアクセスを行う場合があるため、セキュリティポリシーに準じて使用すること。
 

== 注意事項 ==
==== プライバシーとデータ取り扱い ====
OpenCodeはオープンソースであり、コードの透明性を確保している。 
* ローカルでの処理を優先、コードの送信は最小限に抑制する。
* 使用するAIプロバイダのプライバシーポリシーを確認すること。
* GitHubリポジトリで実装を検証可能
 
==== 生成コードの検証 ====
AIが生成したコードは必ずレビューして検証する。 
* コードの動作を確認
* セキュリティ上の問題がないか確認
* ライセンス上の問題がないか確認
* コーディング規約に準拠しているか確認
 
==== セキュリティ ====
APIキーやパスワード等の機密情報をコードに含めないように注意する。 
* APIキー、パスワード等の機密情報をコードに含めない。
* 環境変数や設定ファイルで管理する。
* .gitignore ファイルで機密情報を含むファイルを除外する。
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]]

インストール - OpenCode

2026-04-09T11:11:53Z

Wiki: /* Step 6 : Tauriビルドの実行 */

== 概要 ==
OpenCodeは、オープンソースのAIコーディングエージェントである。 
ターミナルベースのTUI (ターミナルユーザーインターフェース) を提供し、75以上のLLMプロバイダに対応している。 
 
主要な特徴として、以下が挙げられる。 
* Anthropic (Claude)、OpenAI (GPT)、Google (Gemini)、GitHub Copilot、Ollama等のモデルの主要プロバイダをサポート
* 2026年1月にGitHub Copilotとの公式パートナーシップを発表
* プライバシー重視の設計
*: コードは送信されず、ローカルでの処理を優先
* CLI、TUI、Desktop アプリ、IDE拡張機能、Webインターフェースを提供
* MCP (Model Context Protocol) とLSP (Language Server Protocol) をサポート
* 組み込みエージェント
** build (開発用)
** plan (読み取り専用分析)
 
OpenCodeは、Go言語でBubble Tea TUIフレームワークを使用して実装されている。 
セッション管理、マルチセッション対応を備え、会話履歴の保存、復元、エクスポートが可能である。 
 
Desktop アプリはTauri v2ベースのネイティブアプリケーションとして実装されており、TypeScriptで実装された内部CLI、Rust + SolidJSで構築されたフロントエンドを組み合わせている。 
 

== 主な機能 ==
OpenCodeは、多様な機能を提供する包括的なAIコーディングツールである。 
 
<center>
{| class="wikitable"
|+ 主要機能一覧
! 機能 !! 説明
|-
| TUI (Bubble Tea) || ターミナルベースの対話型インターフェース
|-
| マルチプロバイダ対応 || 75以上のLLMプロバイダをサポート
|-
| セッション管理 || 会話履歴の保存、復元、エクスポート
|-
| ツール統合 || ファイル操作、Bash実行、テスト実行等
|-
| MCP (Model Context Protocol) || 外部ツールとの統合プロトコル
|-
| LSP (Language Server Protocol) || 25以上の組み込みLSPサーバーによる言語サーバーとの連携
|-
| 組み込みエージェント || build (開発用) plan (読み取り専用分析) general (調査用) explore (コード探索用)
|-
| Desktop アプリ || Tauri v2ベースのネイティブアプリ
|-
| IDE拡張機能 || VS Code、JetBrains等のIDE拡張
|-
| カスタムコマンド || .opencode/commands/ ディレクトリ内でユーザ定義コマンド作成
|-
| Git統合 || <code>/undo</code>、<code>/redo</code> コマンドでGitバック付きの変更管理
|}
</center>
 

== 対応AIプロバイダとモデル ==
OpenCodeは、75以上のLLMプロバイダに対応している。 
 
==== 主要プロバイダ一覧 ====
<center>
{| class="wikitable"
|+ 主要プロバイダ一覧
! プロバイダ !! 認証方法 !! 備考
|-
| Anthropic || APIキー (<code>ANTHROPIC_API_KEY</code>) || Claude 4.x系をサポート
|-
| OpenAI || APIキー (<code>OPENAI_API_KEY</code>) || GPT-4o、o3等をサポート
|-
| Google || APIキー (<code>GOOGLE_API_KEY</code>) || Gemini 3等をサポート
|-
| GitHub Copilot || GitHub認証 (OAuth) || <code>/connect</code> コマンドで認証
|-
| Z.AI || APIキー || GLM-5、GLM-4.7等をサポート GLM Coding Plan対応
|-
| AWS Bedrock || AWS認証情報 || Anthropicモデルのホスティング
|-
| Azure OpenAI || Azureエンドポイント || OpenAIモデルのホスティング
|-
| Ollama || ローカル実行 (認証不要) || ローカルモデルの実行
|-
| OpenRouter || APIキー || 複数プロバイダのルーティング
|-
| Groq || APIキー || 高速推論
|-
| Together AI || APIキー || オープンソースモデル
|-
| Fireworks AI || APIキー || 高速推論
|}
</center>
 
==== 推奨モデル ====
<center>
{| class="wikitable"
|+ 用途別推奨モデル
! 用途 !! 推奨モデル
|-
| 高精度コーディング || Claude Sonnet 4.5、GPT-4o
|-
| 高速処理 || Claude Haiku 4.5、Gemini 2.5 Flash
|-
| 複雑な推論 || Claude Opus 4.6、o3
|-
| ローカル実行 || Qwen 2.5 Coder (Ollama)
|-
| コスト効率重視 || GLM-4.7、GLM-5 (Z.AI Coding Plan)
|}
</center>
 
==== ローカルモデル (Ollama) ====
Ollamaを使用することで、ローカル環境でモデルを実行できる。 
 
===== Ollamaのインストール =====
Ollamaの公式サイトからインストールスクリプトをダウンロードして実行する。 
curl -fsSL https://ollama.com/install.sh | bash
 
===== モデルのダウンロード =====
Ollamaでモデルをダウンロードする。 
ollama pull qwen2.5-coder
 
===== OpenCodeでの設定 =====
<code>opencode.json</code> でOllamaプロバイダを設定する。 
<syntaxhighlight lang="json">
{
"$schema": "https://opencode.ai/config.json",
"model": "ollama/qwen2.5-coder"
}
</syntaxhighlight>
 

== 前提条件 ==
OpenCodeをインストールするには、以下の前提条件を満たす必要がある。 
 
==== 標準インストール時の前提条件 ====
<center>
{| class="wikitable"
|+ 標準インストール時の前提条件
! 要件 !! 詳細
|-
| OS || Linux、MacOS、Windows
|-
| Node.js || npm経由のインストールに必要 (Node.js 18以上)
|-
| ネットワーク || AIプロバイダへの接続に必要
|-
| AIプロバイダのAPIキー || 使用するプロバイダのAPIキーまたは認証情報
|}
</center>
 

== インストール ==
OpenCodeのインストール方法を以下に示す。 
 
==== クイックインストール (Linux) ====
公式のインストールスクリプトを使用してインストールする。 
curl -fsSL https://opencode.ai/install | bash
 
==== Homebrew (MacOS) ====
Homebrewを使用してインストールできる。 
brew install opencode
 
==== npm (全プラットフォーム) ====
npmを使用してグローバルインストールする。 
npm install -g opencode
 
==== Windows (Scoop / Chocolatey) ====
Windowsでは、ScoopまたはChocolateyを使用してインストールできる。 
 
===== Scoopでのインストール =====
scoop install opencode
 
===== Chocolateyでのインストール =====
choco install opencode
 
==== デスクトップアプリケーション ====
[https://opencode.ai/download OpenCodeの公式Webサイト]にアクセスして、デスクトップアプリケーションをダウンロードする。 
 
対応プラットフォーム: 
* Linux (deb、rpm)
* MacOS (dmg)
* Windows (exe)
 
==== バージョン確認 ====
インストール後、バージョンを確認する。 
opencode --version
 

== 初期設定 ==
OpenCodeの初期設定を以下に示す。 
 
==== プロバイダの認証 ====
OpenCodeの初回起動時に、<code>/connect</code> コマンドまたは <code>opencode auth login</code> コマンドでAIプロバイダとの認証を設定する。 
 
===== GitHub Copilotとの連携 =====
OpenCodeはGitHub Copilotの公式パートナーであり、<code>/connect</code> コマンドで認証を設定できる。 
 
OpenCodeを起動する。 
opencode
 
認証を設定する。 
/connect
 
例えば、GitHub Copilotを選択する。 
Webブラウザが開き、GitHub認証ページが表示される。 
 
認証を完了すると、OpenCodeでGitHub Copilotが使用可能になる。 
 
===== APIキーによる認証 =====
環境変数でAPIキーを設定する方法もある。 
<syntaxhighlight lang="sh">
export ANTHROPIC_API_KEY="sk-..."
export OPENAI_API_KEY="sk-..."
export GOOGLE_API_KEY="..."
</syntaxhighlight>
 
環境変数を永続化する場合は、~/.profileファイル等に環境変数 <code>ANTHROPIC_API_KEY</code> を設定する。 
<syntaxhighlight lang="sh">
export ANTHROPIC_API_KEY="sk-..."
</syntaxhighlight>
 
===== Z.AI (GLM) との連携 =====
Z.AIのGLMモデル (GLM-5、GLM-4.7等) をOpenCodeで使用するには、[https://z.ai/subscribe Z.AI GLM または GLM Coding Plan]のサブスクリプション契約およびAPIキーが必要である。 
 
====== GLM / GLM Coding Planの概要 ======
GLM / GLM Coding Planは、Z.AIが提供するAIコーディング向けのサブスクリプションプランである。 
 
<center>
{| class="wikitable"
|+ GLM Coding Plan
! プラン !! 月額 !! GLM-5対応 !! 5時間あたりの目安
|-
| Lite || $10 || 対応 || 約80プロンプト
|-
| Pro || $30 || 対応 || 約400プロンプト
|-
| Max || $120 || 対応 || 約1,600プロンプト
|}
</center>
 
使用可能なモデルは以下の通りである。 
* GLM-5 (ProプランおよびMaxプランのみ)
* GLM-4.7
* GLM-4.6
* GLM-4.5
* GLM-4.5-Air
 
GLM-5はピーク時 (日本時間 15:00〜19:00) に3倍、オフピーク時に2倍のクォータを消費する。 
日常的なタスクにはGLM-4.7を使用し、複雑なタスクにのみGLM-5を使用することが推奨される。 
 

====== 認証の設定手順 ======
Z.AIの[https://z.ai/manage-apikey/apikey-list APIコンソール]にアクセスして、APIキーを取得する。 
 
<code>opencode auth login</code> コマンドを実行して、プロバイダ選択で Z.AI Coding Plan を選択する。 
 
<syntaxhighlight lang="sh">
opencode auth login
</syntaxhighlight>
 
┌ Add credential
│
◆ Select provider
│ ● Z.AI Coding Plan
│ ...
└
 
Z.AIのAPIキーを入力する。 
┌ Add credential
│
◇ Select provider
│ Z.AI Coding Plan
│
◇ Enter your API key
│ <Z.AIのAPIキーを入力>
└
 
OpenCodeを起動して、<code>/models</code> コマンドでGLM-5 / GLM-4.7等のモデルを選択する。 
opencode
 
/models
 
====== トラブルシューティング : Insufficient balance ======
GLMモデルの使用時に、以下に示すエラーメッセージが表示される場合がある。 
Insufficient balance or no resource package. Please recharge.
 
このエラーは、OpenCodeのプロバイダ設定がGLM Coding Plan専用のエンドポイントに接続されていない場合に発生する。 
 
GLM Coding Planでは、専用のAPIエンドポイント (https://api.z.ai/api/coding/paas/v4) を使用する必要がある。 
プロバイダ選択で Z.AI (通常のAPI) を選択した場合、標準エンドポイント (https://api.z.ai/api/paas/v4) に接続されるため、Coding Planの残高が認識されず、上記のエラーが発生する。 
 
<center>
{| class="wikitable"
|+ Z.AI APIエンドポイントの違い
! エンドポイント !! URL !! 用途
|-
| 標準 (通常API) || https://api.z.ai/api/paas/v4 || 従量課金のAPI利用
|-
| Coding Plan専用 || https://api.z.ai/api/coding/paas/v4 || GLM Coding Planサブスクリプション利用
|}
</center>
 
対処方法として、一旦Z.AIの認証情報をログアウトしてから、Z.AI Coding Plan で再度ログインする。 
 
Z.AIの認証情報をログアウトする。 
<syntaxhighlight lang="sh">
opencode auth logout
</syntaxhighlight>
 
再度ログインして、プロバイダ選択で Z.AI Coding Plan を選択する。 
<syntaxhighlight lang="sh">
opencode auth login
</syntaxhighlight>
 
┌ Add credential
│
◆ Select provider
│ ● Z.AI Coding Plan ← Z.AI ではなく、Z.AI Coding Planを選択すること
│ ...
└
 
APIキーを入力して認証を完了した後、OpenCodeを起動して正常にGLMモデルが使用できることを確認する。 
 
==== 設定ファイル ====
OpenCodeの設定ファイルは、プロジェクトルート または ホームディレクトリ に配置する。 
 
===== 設定ファイルの場所 =====
設定ファイルは以下の順序で検索される。 
* プロジェクトルート
*: opencode.json
* ホームディレクトリ
*: ~/.opencode/config.json
 
===== 設定ファイルの例 =====
<syntaxhighlight lang="json">
{
"$schema": "https://opencode.ai/config.json",
"model": "anthropic/claude-sonnet-4-5-20250929",
"small_model": "anthropic/claude-haiku-4-5-20251001",
"keybinds": {
"leader": "ctrl+x"
}
}
</syntaxhighlight>
 
設定可能な項目を以下に示す。 
* <code>model</code>
*: 使用するモデル名 (プロバイダ/モデル名形式)
*: 例: <code>anthropic/claude-sonnet-4-5-20250929</code>、<code>openai/gpt-4o</code>
* <code>small_model</code>
*: 軽量タスク用のモデル (コスト削減に有効)
*: 例: <code>anthropic/claude-haiku-4-5-20251001</code>
* <code>keybinds.leader</code>
*: リーダーキーの設定
*: デフォルト : <code>ctrl+x</code>
 

== CLIコマンド ==
OpenCodeは、CLIモードと対話モードの両方で使用できる。 
 
==== 主要コマンド ====
<center>
{| class="wikitable"
|+ 主要コマンド一覧
! コマンド !! 説明
|-
| <code>opencode</code> || TUIを起動
|-
| <code>opencode run "プロンプト"</code> || 非対話モードでプロンプトを実行
|-
| <code>opencode --model プロバイダ/モデル名</code> || モデルを指定して起動
|-
| <code>opencode --continue</code> || 前回のセッションを継続して起動
|-
| <code>opencode auth login</code> || プロバイダの認証を設定
|-
| <code>opencode auth logout</code> || 認証情報を削除
|-
| <code>opencode models</code> || 使用可能なモデル一覧を表示
|-
| <code>opencode mcp list</code> || MCPサーバ一覧を表示
|-
| <code>opencode mcp add サーバー名</code> || MCPサーバを追加
|-
| <code>opencode serve</code> || ヘッドレスバックエンドサーバを起動
|-
| <code>opencode --version</code> || バージョンを表示
|-
| <code>opencode --help</code> || ヘルプを表示
|}
</center>
 
==== 非対話モード ====
非対話モードでは、プロンプトをコマンドライン引数として渡すことができる。 
 
===== 使用例 =====
プロジェクトの概要を説明する。 
opencode run "このプロジェクトの概要を説明して"
 
モデルを指定してテストを実行する。 
opencode run "テストを実行して" --model anthropic/claude-sonnet-4-5-20250929
 

== TUI (ターミナルユーザーインターフェース) ==
OpenCodeのTUIは、ターミナルベースの対話型インターフェースである。 
 
==== スラッシュコマンド ====
TUI内でスラッシュコマンドを使用して、様々な操作を実行できる。 
 
<center>
{| class="wikitable"
|+ スラッシュコマンド一覧
! コマンド !! 説明
|-
| <code>/new</code> || 新しいセッションを開始
|-
| <code>/init</code> || プロジェクト構造を分析
|-
| <code>/undo</code> || 直前の変更を元に戻す (Git連携)
|-
| <code>/redo</code> || 元に戻した変更をやり直す
|-
| <code>/compact</code> || 会話を要約して圧縮
|-
| <code>/share</code> || 会話の共有リンクを生成
|-
| <code>/export</code> || 会話をMarkdownでエクスポート
|-
| <code>/sessions</code> || 過去のセッション一覧を表示
|-
| <code>/models</code> || 使用可能なモデル一覧を表示
|-
| <code>/agents</code> || エージェント一覧を表示
|-
| <code>/connect</code> || プロバイダ認証を設定
|-
| <code>/status</code> || 現在のステータスを表示
|-
| <code>/mcp</code> || MCPサーバ一覧を表示
|-
| <code>/theme</code> || テーマを変更
|-
| <code>/editor</code> || 外部エディタで入力
|-
| <code>/help</code> || ヘルプを表示
|-
| <code>/commands</code> || コマンド一覧を表示
|-
| <code>/exit</code> || OpenCodeを終了
|}
</center>
 
==== キーバインド ====
OpenCodeのリーダーキーのデフォルトは、[Ctrl] + [X]キーである。 
リーダーキーを押した後に各キーを入力する。 
 
<center>
{| class="wikitable"
|+ キーバインド一覧
! キー !! 説明
|-
| [Ctrl] + [X] -> [N] || 新しいセッション
|-
| [Ctrl] + [X] -> [L] || セッション一覧
|-
| [Ctrl] + [X] -> [T] || タイムライン
|-
| [Ctrl] + [X] -> [M] || モデル選択ダイアログ
|-
| [Ctrl] + [X] -> [C] || コンパクト表示
|-
| [Ctrl] + [P] || コマンドパレット
|-
| [Tab] || Plan/Buildエージェント切替
|-
| [Page Up] / [Page Down] || スクロール
|-
| [Shift] + [Enter] || 改行入力
|}
</center>
 
==== ファイル参照とBashコマンド ====
TUI内でファイル参照とBashコマンドの実行ができる。 
 
===== ファイル参照 =====
<code>@</code> でファイルをファジー検索して参照を追加する。 
@filename
 
===== Bashコマンドの実行 =====
<code>!</code> をプレフィックスとしてBashコマンドを実行する。 
!ls -la
!git status
 

== CLIバイナリのビルド (SUSE) ==
OpenCode CLIバイナリをSUSE環境でソースコードからビルドすることができる。 
 
==== ビルドの前提条件 ====
<center>
{| class="wikitable"
|+ ビルドの前提条件
! 項目 !! 要件
|-
| OS ||
* RHEL 9 / 10
* SUSE 15 / 16
|-
| Bun || 1.3.x (package.json 内の <code>packageManager</code> で <code>bun@1.3.9</code> を指定)
|-
| git || ブランチ名取得に使用 (Gitリポジトリでない場合は環境変数で回避可能)
|-
| ネットワーク || ビルド時に https://models.dev/api.json からモデルデータを取得
|}
</center>
 
===== 前提条件の確認コマンド =====
# Bunバージョン確認 (1.3.9が必要)
bun --version

# ネットワーク接続の確認
curl -s https://models.dev/api.json | head -c 100
 

==== ビルド方式の説明 ====
<center>
{| class="wikitable"
|+ ビルド方式の説明
! 項目 !! 内容
|-
| 言語 || TypeScript (Bun ランタイム)
|-
| ビルド方式 || <code>Bun.build()</code> の <code>compile: true</code> でスタンドアロン実行ファイルを生成
|-
| ビルドスクリプト || packages/opencode/script/build.ts
|-
| 出力 || Bunランタイムを内蔵した単一バイナリ (<code>opencode</code>)
|}
</center>
 
==== 環境変数の設定 ====
ソースディレクトリがGitリポジトリでない場合、<code>git branch --show-current</code> が失敗するため、環境変数を設定する。 
<syntaxhighlight lang="sh">
export OPENCODE_VERSION=<バージョン例 : 1.2.14>
export OPENCODE_CHANNEL=latest
</syntaxhighlight>
 

==== 依存パッケージのインストール ====
プロジェクトディレクトリに移動して、依存パッケージをインストールする。 
cd /path/to/opencode-<バージョン>
bun install
 
このプロジェクトはBunワークスペース構成のモノレポである。 
<code>bun install</code> コマンドを実行して、ルートおよび全パッケージの依存関係がインストールされる。 
 

==== ビルドの実行 ====
ビルドスクリプトを実行する。 
./packages/opencode/script/build.ts --single
 
<code>--single</code> フラグは現在のプラットフォーム向けのみビルドする。(例: linux-x64) 
フラグなしで実行すると全11プラットフォーム分のクロスコンパイルを試みる。 
 
ビルドスクリプトの処理内容: 
* <code>models.dev</code> からモデルデータを取得し、TypeScript スナップショットを生成
* <code>@opentui/core</code> と <code>@parcel/watcher</code> のネイティブバインディングをインストール
* <code>Bun.build()</code> で TypeScript をスタンドアロンバイナリにコンパイル
* <code>packages/opencode/dist/opencode-linux-x64/bin/opencode</code> に出力
 
==== 動作確認 ====
ビルドが完了したら、バイナリが生成されたか確認する。 
# バイナリが生成されたか確認
ls -la packages/opencode/dist/opencode-linux-x64/bin/opencode

# バージョン表示で動作確認
./packages/opencode/dist/opencode-linux-x64/bin/opencode --help
 
==== トラブルシューティング ====
<center>
{| class="wikitable"
|+ トラブルシューティング
! 問題 !! 原因 !! 対策
|-
| <code>git branch --show-current</code> 失敗 || ソースがGitリポジトリではない || 下記の環境変数を設定する。 OPENCODE_VERSION=<バージョン例: 1.1.53> OPENCODE_CHANNEL=latest
|-
| <code>models.dev</code> に接続できない || ネットワーク制限 || 事前に api.json をダウンロードして、<code>MODELS_DEV_API_JSON=/path/to/api.json</code> で指定する。
|-
| GLIBCバージョン不足 || SUSEのGLIBCのバージョンが古い || <code>--single</code> に加えて <code>--baseline</code> フラグを追加 または、muslビルドを検討する。
|-
| native module のビルド失敗 || C / C++ コンパイラ不足 || ビルドツールをインストールする。
<pre>sudo zypper install gcc gcc-c++ make</pre>
|}
</center>
 
===== オフライン環境でのビルド =====
ネットワークに接続できない場合、モデルデータを事前にダウンロードしておく必要がある。 
# オンライン環境で事前にダウンロード
curl -o api.json https://models.dev/api.json

# ビルド時にローカルファイルを指定
export MODELS_DEV_API_JSON=/path/to/api.json
./packages/opencode/script/build.ts --single
 
===== baselineビルド =====
CPUがAVX2命令セットをサポートしていない場合、<code>--baseline</code> フラグを追加する。 
./packages/opencode/script/build.ts --single --baseline
 

== デスクトップアプリケーションのビルド ==
OpenCode Desktopは、Tauri v2ベースのデスクトップアプリケーションである。 
 
==== デスクトップアプリケーションの構成 ====
<center>
{| class="wikitable"
|+ Desktop アプリの構成
! 項目 !! 内容
|-
| フロントエンド || SolidJS + Vite (TypeScript)
|-
| バックエンド || Rust (Tauri v2 シェル)
|-
| サイドカー || OpenCode CLI バイナリ (CLIバイナリのビルドで作成したもの)
|-
| ビルドスクリプト || packages/desktop/ 配下
|-
| 出力形式 (Linux) || debパッケージ、rpmパッケージ
|-
| ソースディレクトリ || packages/desktop/ (フロントエンド) packages/desktop/src-tauri/ (Rust)
|}
</center>
 
==== ビルドの前提条件 ====
===== OpenCode CLIバイナリのビルド =====
デスクトップアプリケーションでは、OpenCode CLIバイナリをサイドカーとしてバンドルする。 
そのため、まず、OpenCode CLIバイナリのビルドを完了させること。 
 
===== Rustツールチェーン =====
Tauri v2 のビルドには、Rustが必要である。 
 
# Rustのインストール (未インストールの場合)
curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh

# 環境変数の設定を反映
source "$HOME/.cargo/env"

# バージョン確認
rustc --version
cargo --version
 
===== 依存ライブラリのインストール =====
Tauri v2公式ドキュメントに基づく依存関係のライブラリをインストールする。 
sudo zypper install -t pattern devel_basis
sudo zypper install curl wget file webkit2gtk3-devel libopenssl-devel libappindicator3-1 librsvg-devel
 
===== ソースコードのダウンロード =====
[https://github.com/anomalyco/opencode/releases OpenCodeのGithub]にアクセスして、ソースコードをダウンロードする。 
ダウンロードしたファイルを解凍する。 
tar xf opencode-<バージョン>.tar.gz
cd opencode-<バージョン>
 

==== デスクトップアプリケーションのビルド ====
===== Step 1 : 環境変数の設定 =====
環境変数を設定する。 
<syntaxhighlight lang="sh">
export OPENCODE_VERSION=<バージョン例 : 1.2.4>
export OPENCODE_CHANNEL=latest
</syntaxhighlight>
 
===== Step 2 : 依存パッケージのインストール =====
プロジェクトディレクトリに移動して、依存パッケージをインストールする。 
cd /path/to/opencode-<バージョン>
bun install
 
もし、bun installに失敗する場合は、node-gypをインストールする。 
bun add node-gyp -D
# または
npm install -g node-gyp
 
===== Step 2.5 : OpenCode Desktopの最大化に関する不具合 =====
OpenCode Desktopにおいて、前回終了したウィンドウサイズで起動できるようにする場合は、以下に示すファイルの60行目をコメントアウトする。 
 
vi /path/to/opencode-<バージョン>/packages/desktop/src-tauri/src/windows.rs
 
<syntaxhighlight lang="rust">
// /path/to/opencode-<バージョン>/packages/desktop/src-tauri/src/windows.rsファイル

// 編集前
.maximized(true)

// 編集後
//.maximized(true)
</syntaxhighlight>
 
===== Step 3 : CLIバイナリのビルド (未完了の場合) =====
サイドカーとなるOpenCode CLIバイナリが必要である。 
CLIバイナリのビルド手順を完了していない場合は、OpenCode CLIバイナリをインストールする。 
./packages/opencode/script/build.ts --single
 
下記のエラーが表示される場合がある。
| // relax version requirement
| const expectedBunVersionRange = `^${expectedBunVersion}`
|
| if (!semver.satisfies(process.versions.bun, expectedBunVersionRange)) {
| throw new Error(`This script requires bun@${expectedBunVersionRange}, but you are using bun@${process.versions.bun}`)

error: This script requires bun@^X.X.X, but you are using bun@X.X.X
at /path/to/opencode-X.X.XX/packages/script/src/index.ts:16:13
 
この時、bunをアップデートする。 
bun upgrade
 

===== Step 4 : サイドカーの配置 =====
OpenCode CLIバイナリを、Tauriが期待するサイドカーディレクトリにコピーする。 
mkdir -p packages/desktop/src-tauri/sidecars
cp packages/opencode/dist/opencode-linux-x64/bin/opencode \
packages/desktop/src-tauri/sidecars/opencode-cli-x86_64-unknown-linux-gnu
 
tauri.conf.json ファイル内の <code>externalBin</code> に sidecars/opencode-cli が指定されており、Tauriがターゲットトリプル (<code>x86_64-unknown-linux-gnu</code>) を付与して検索する。 
 
===== Step 5 : フロントエンドのビルド確認 (任意) =====
Viteビルドは、<code>tauri build</code> コマンドの <code>beforeBuildCommand</code> で自動実行されるが、事前に確認する場合は以下に示すコマンドを実行する。 
bun run --cwd packages/desktop build
 
===== Step 6 : Tauriビルドの実行 =====
Tauriビルドを実行する。 
bun run --cwd packages/desktop tauri build
 
上記のコマンドは、以下に示す事柄を実行する。 
* <code>beforeBuildCommand</code> (<code>bun run build</code>) でフロントエンドをビルドする。
* Cargo (Rust) でネイティブバイナリをコンパイルする。
* サイドカー (OpenCode CLIバイナリ) をバンドルに含める。
* deb / rpmパッケージを生成する。
 
Cargo.toml ファイルにgitパッチ依存 (specta、tauri 本体) があるため、ネットワーク接続が必須である。 
 
以下に示すエラーが出力される場合がある。 
 
$ tauri build
thread '<unnamed>' panicked at crates/tauri-cli/src/interface/rust.rs:146:8:
called `Result::unwrap()` on an `Err` value: Error { kind: Io(Os { code: 24, kind: Uncategorized, message: "Too many open files" }), paths: [] }
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace
error: script "tauri" was terminated by signal SIGABRT (Abort)
 
これは、Tauriのビルドプロセス (Rustコンパイル含む) が、現在のシェルセッションで許可されているオープンファイル数の上限を超えているため、表示される。 
これを解決するには、オープンファイル数の上限を引き上げる。 
 
ulimit -n 65536
 
もし、<code>ulimit -n 65536</code> コマンドを実行して、Operation not permitted エラーが出力される場合は、システム側のハードリミットも引き上げる必要がある。 
 
sudo vi /etc/security/limits.conf
 
# /etc/security/limits.confファイル

* soft nofile 65536
* hard nofile 65536
 
編集した後、再ログインまたはPCを再起動する。 
 

===== 生成されたファイルの確認 =====
以下に示すディレクトリにファイルが生成される。 
# RPMパッケージ
ls -la packages/desktop/src-tauri/target/release/bundle/rpm/*.rpm

# debパッケージ
ls -la packages/desktop/src-tauri/target/release/bundle/deb/*.deb

# 実行バイナリ (直接実行も可能)
ls -la packages/desktop/src-tauri/target/release/OpenCode
 

==== 動作確認 ====
RPMパッケージをインストールして確認する。 
# RPMパッケージをインストールして確認
sudo zypper install ./packages/desktop/src-tauri/target/release/bundle/rpm/*.rpm

## または

# 実行バイナリを直接起動
./packages/desktop/src-tauri/target/release/OpenCode
 
==== トラブルシューティング ====
<center>
{| class="wikitable"
|+ トラブルシューティング
! 問題 !! 原因 !! 対策
|-
| cargo buildコマンド実行時に、git依存の取得に失敗 || ネットワーク接続なし / プロキシ || Cargo.tomlファイルにgit パッチ依存あり、ネットワーク接続が必須
|-
| opencode-cli-x86_64-unknown-linux-gnu not found || サイドカーが配置されていない || サイドカーの配置手順を実行して、OpenCode CLIバイナリをコピーする。
|-
| 画面が真っ白 / WebView 描画されない || Wayland環境の問題 || 環境変数 <code>OC_ALLOW_WAYLAND=1</code> でWaylandを強制する。
|-
| RPMパッケージが生成されない || tauri.conf.jsonファイルのtargets設定 || deb、rpmが設定されていることを確認する。
|}
</center>
 
===== 特定パッケージ形式のみビルド =====
全形式をビルドする必要がない場合、<code>--bundles</code> フラグで指定できる。 
# RPMのみ
bun run --cwd packages/desktop tauri build --bundles rpm

# debのみ
bun run --cwd packages/desktop tauri build --bundles deb
 
===== デバッグビルド =====
問題の調査が必要な場合、デバッグビルドを実行できる。 
bun run --cwd packages/desktop tauri build --debug
 
デバッグビルドではDevToolsが有効になり、アプリケーション内で右クリック -> [Inspect Element]が利用できる。 
 

== Oh my OpenCode ==
Oh my OpenCodeは、OpenCode用のマルチエージェントオーケストレーションプラグインである。 
フック、MCPサーバ、スキル、専門エージェントを活用してOpenCodeの機能を拡張する。 
 
* GitHubリポジトリ
*: https://github.com/code-yeongyu/oh-my-opencode oh-my-opencode
 
==== 主な機能 ====
Oh my OpenCodeは以下に示す機能を提供する。 
 
<center>
{| class="wikitable"
|+ Oh my OpenCode 機能一覧
! 機能 !! 説明
|-
| ultrawork || 複雑なタスクを専門エージェントに自動分割して並列処理するマジックワード
|-
| フック統合 || ツール実行前後に自動実行されるフック (コード品質チェック、テスト自動実行等)
|-
| MCP統合 || Context7 (ライブラリドキュメント取得)、Sequential Thinking (構造的推論)
|-
| LSP/AST解析 || Language Server ProtocolとAST解析による高精度なコード理解
|-
| スキルシステム || 再利用可能なプロンプトテンプレート 例: <code>/ultra</code>
|}
</center>
 
==== 専門エージェント ====
Oh my OpenCodeは以下の専門エージェントを提供する。 
 
<center>
{| class="wikitable"
|+ 専門エージェント一覧
! エージェント名 !! 役割
|-
| Sisyphus || プランニングと実装を担当するメインエージェント タスク分割、実装、テスト、反復改善を行う。
|-
| Oracle || コードベース全体の調査・分析を担当 プロジェクト構造の把握、依存関係の追跡を行う。
|-
| Frontend Engineer || フロントエンド開発を担当 React / Next.js等のUI実装、アクセシビリティ対応を行う。
|-
| Librarian || ドキュメント管理を担当 README、API仕様書、変更履歴の作成・更新を行う。
|-
| Explorer || 未知のコードベースの探索を担当 新しいプロジェクトの構造理解や技術スタックの調査を行う。
|}
</center>
 
==== インストール ====
インストールの前提条件は以下の通りである。 
 
* OpenCode v1.0.150以上
* Node.js または Bun
 
Oh my OpenCodeをインストールする。 
bunx oh-my-opencode@latest
# または
npx oh-my-opencode@latest
 
非対話モードでインストールする場合は以下のコマンドを実行する。 
bunx oh-my-opencode@latest --non-interactive
 
==== 設定 ====
設定ファイルは以下の場所に配置する。 
 
* プロジェクト単位
*: .opencode/oh-my-opencode.json
* グローバル
*: ~/.config/opencode/oh-my-opencode.json
 
設定ファイルはJSONC (コメント付きJSON) 形式で記述する。 
以下に設定ファイルの例を示す。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"context7": true,
"thinking": true
},
"agents": {
"sisyphus": true,
"oracle": true,
"frontend": true,
"librarian": true,
"explorer": true
},
"hooks": {
"afterEdit": true,
"afterWrite": true
},
"skills": {
"ultra": true
}
}
</syntaxhighlight>
 
下表に、各設定項目の説明を示す。 
 
<center>
{| class="wikitable"
|+ 設定項目一覧
! カテゴリ !! 設定項目 !! 説明
|-
| rowspan="3" | mcpServers || - || MCPサーバの有効 / 無効を設定する。
|-
| context7 || ライブラリドキュメント取得サーバ
|-
| thinking || 構造的推論サーバ
|-
| rowspan="6" | agents || - || 専門エージェントの有効/無効を設定する。
|-
| sisyphus || 個別に制御可能
|-
| oracle || 個別に制御可能
|-
| frontend || 個別に制御可能
|-
| librarian || 個別に制御可能
|-
| explorer || 個別に制御可能
|-
| rowspan="3" | hooks || - || フックの有効 / 無効を設定する。
|-
| afterEdit || ファイル編集後に自動チェックを実行する。
|-
| afterWrite || ファイル作成後に自動チェックを実行する。
|-
| rowspan="2" | skills || - || スキルの有効 / 無効を設定する。
|-
| ultra || ultraworkスキルを有効化する。
|}
</center>
 
==== 使用方法 ====
プロンプトに ultrawork というキーワードを含めるだけで、複雑なタスクを専門エージェントに自動分割して並列処理する。 
 
使用例を以下に示す。 
 
* 大規模リファクタリング
*: <pre>ultrawork このプロジェクトの認証システムをリファクタリングして</pre>
* 新機能実装
*: <pre>ultrawork ユーザ管理機能を実装して</pre>
* ドキュメント調査
*: <pre>ultrawork このコードベースを分析してドキュメントを作成して</pre>
 
==== アンインストール ====
プロジェクト単位の設定ファイルを削除する。 
rm -rf .opencode/agents \
.opencode/hooks \
.opencode/skills \
.opencode/mcp.json \
.opencode/oh-my-opencode.json
 
グローバル設定を削除する。 
rm -rf ~/.config/opencode/oh-my-opencode.json
 
==== 注意事項 ====
Oh my OpenCodeを使用する際は以下の点に注意すること。 
 
* AnthropicモデルのOpenCode対応はコミュニティ主導の取り組みであり、Anthropicの公式サポート対象外である。
* フック機能により外部コマンドが自動実行されるため、設定内容を事前に確認すること。
* MCPサーバはネットワークアクセスを行う場合があるため、セキュリティポリシーに準じて使用すること。
 

== 注意事項 ==
==== プライバシーとデータ取り扱い ====
OpenCodeはオープンソースであり、コードの透明性を確保している。 
* ローカルでの処理を優先、コードの送信は最小限に抑制する。
* 使用するAIプロバイダのプライバシーポリシーを確認すること。
* GitHubリポジトリで実装を検証可能
 
==== 生成コードの検証 ====
AIが生成したコードは必ずレビューして検証する。 
* コードの動作を確認
* セキュリティ上の問題がないか確認
* ライセンス上の問題がないか確認
* コーディング規約に準拠しているか確認
 
==== セキュリティ ====
APIキーやパスワード等の機密情報をコードに含めないように注意する。 
* APIキー、パスワード等の機密情報をコードに含めない。
* 環境変数や設定ファイルで管理する。
* .gitignore ファイルで機密情報を含むファイルを除外する。
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]]

インストール - Hazkey

2026-04-08T00:39:31Z

Wiki: /* SUSE */

== 概要 ==
Hazkeyは、Fcitx5向けの高精度日本語入力エンジンである。 
スローガンは「思考を止めない日本語入力」であり、入力作業を妨げないUI/UXの実装を目指して設計されている。 
 
iOS/MacOS向けアプリであるazooKeyと同じ高精度変換技術 (AzooKeyKanaKanjiConverter) を採用しており、Linux環境での日本語入力を効率化する。 
 
ビルドにはSwift 6.1以上が必要であり、RHEL および SUSE環境ではビルド環境の構築に一定の手順を要する。 
 
主な特徴は以下の通りである。 
 
<center>
{| class="wikitable"
|+ Hazkeyの機能
|-
! 機能 !! 説明
|-
| 高精度変換エンジン || iOS/MacOS向けアプリであるazooKeyと同じ変換技術を採用し、高い変換精度を実現する。
|-
| 自動変換機能 || 入力すると即座に自動で変換され、変換操作に妨げられることなく長文を入力できる。
|-
| Zenzaiニューラル変換 || GPT-2ベースのAIによるプロフィールや文脈を考慮した高度な変換に対応する。(オプション)
|-
| GGMLサポート || GPU対応バックエンド (Vulkan) を利用した高速処理が可能である。
|}
</center>
 
公式情報は以下を参照する。 
* 公式サイト
*: [https://hazkey.hiira.dev hazkey.hiira.dev]
* GitHubリポジトリ
*: [https://github.com/7ka-Hiira/fcitx5-hazkey github.com/7ka-Hiira/fcitx5-hazkey]
 

== 動作要件 ==
Hazkeyのビルドおよび動作に必要なソフトウェアを以下に示す。 
 
<center>
{| class="wikitable"
|+ 動作要件一覧
! ソフトウェア !! 必要バージョン !! 備考
|-
| Swift || 6.1 以上 || Swiftlyによるインストールを推奨
|-
| fcitx5 || 5.0.4 以上 || 入力フレームワーク本体
|-
| Qt || 6.7推奨 (6.2以降で可) || 6.7未満では表示に問題が発生する場合がある。
|-
| CMake || 3.21以上 (4.x以降推奨) || ビルドシステム
|-
| Protobuf || 3.12以上 || プロトコルバッファライブラリ
|-
| Ninja || 最新版推奨 || ビルドツール
|-
| Gettext || 最新版推奨 || 国際化対応ライブラリ
|-
| Vulkan headers || 最新版推奨 || GPU対応バックエンド用 (オプション、無効化可能)
|}
</center>
 

== Swiftのインストール ==
Hazkey のビルドには Swift 6.1以上が必要である。 
現在の推奨インストール方法は、公式ツールの Swiftly (rustup 相当) を使用する方法である。 
 
==== 公式サポート状況 ====
ディストリビューションごとの公式サポート状況を以下に示す。 
 
<center>
{| class="wikitable"
|+ Swift 公式サポート状況
! ディストリビューション !! 公式サポート
|-
| RHEL 9 || 公式サポート
|-
| RHEL 10 || 未公式 (RHEL 9ツールチェインで動作可)
|-
| SUSE 15 / 16 || 未公式 (RHEL 9ツールチェインで動作可)
|}
</center>
 
==== RHEL ====
RHEL 10は、Swiftの公式サポートリストに未掲載だが、RHEL 9と非常に近い構成のため、同ツールチェインで動作する。 
 
まず、依存パッケージをインストールする。 
sudo dnf install pkg-config binutils gcc git glibc-static libbsd-devel libcurl-devel libedit-devel libicu-devel libstdc++-static \
python3 sqlite-devel zlib-devel ncurses-devel
 
Swiftlyをダウンロードして初期化する。 
curl -O https://download.swift.org/swiftly/linux/swiftly-$(uname -m).tar.gz
tar xf swiftly-$(uname -m).tar.gz
cd swiftly-$(uname -m)

./swiftly init --quiet-shell-followup
 
init実行時に RHEL 10は未公式プラットフォームです と表示された場合は、プロンプトでRHEL 9を選択する。 
 
環境変数を設定する。 
<syntaxhighlight lang="sh">
# Bash / Zsh
. "${SWIFTLY_HOME_DIR:-$HOME/.local/share/swiftly}/env.sh"

# Fish
source (set -q SWIFTLY_HOME_DIR; and echo $SWIFTLY_HOME_DIR; or echo $HOME/.local/share/swiftly)/env.fish
</syntaxhighlight>
 
最新のSwiftをインストールする。 
swiftly install latest
 
正常にインストールされているかどうかを確認する。 
swift --version
 
==== SUSE ====
SUSEでは、Swiftlyが非公式プラットフォームと検出するため、手動でRHEL 9ツールチェインを選択する。 
 
まず、依存パッケージをインストールする。 
sudo zypper install pkg-config binutils binutils-gold gcc gcc-c++ git gzip glibc-static libbsd-devel libedit-devel libicu-devel \
libcurl-devel ncurses-devel sqlite3-devel zlib-devel python3
 
Swiftlyをダウンロードして初期化する。 
curl -O https://download.swift.org/swiftly/linux/swiftly-$(uname -m).tar.gz
tar xf swiftly-$(uname -m).tar.gz
cd swiftly-$(uname -m)

./swiftly init --quiet-shell-followup
 
<code>./swiftly init --quiet-shell-followup</code> コマンドを実行した時、以下に示すエラーが出力される場合がある。
 
Error: The ca-certificates package is not installed. Swiftly won't be able to trust the sites to perform its downloads.

You can install the ca-certificates package on your system to fix this.
 
これは、Swiftlyは特定のLinuxディストリビューション (Debian系) のファイルパス (/etc/ssl/certs/ca-certificates.crt )を探しているためである。 
SUSEにおいてはパスが異なるため、所定のパスにシンボリックリンクを貼る必要がある。 
 
sudo ln -s /var/lib/ca-certificates/ca-bundle.pem \
/etc/ssl/certs/ca-certificates.crt
 
再度、<code>./swiftly init --quiet-shell-followup</code> コマンドを実行する。 
 
初期化中に以下のプロンプトが表示されるので、4 を入力して、RHEL 9を選択する。 
 
SUSE Linux Enterprise 15 SP 6 is not an officially supported platform,
but the toolchains for another platform may still work on it.
Please select the platform to use for toolchain downloads:

0) Cancel
1) Ubuntu 24.04
2) Ubuntu 22.04
3) Ubuntu 20.04
4) Ubuntu 18.04
5) Fedora Linux 39
6) RHEL 9
7) Amazon Linux 2
8) Debian GNU/Linux 12
 
環境変数を設定する。 
<syntaxhighlight lang="sh">
# Bash / Zsh
. "${SWIFTLY_HOME_DIR:-$HOME/.local/share/swiftly}/env.sh"

# Fish
source (set -q SWIFTLY_HOME_DIR; and echo $SWIFTLY_HOME_DIR; or echo $HOME/.local/share/swiftly)/env.fish
</syntaxhighlight>
 
最新のSwiftをインストールする。 
swiftly install latest
 
正常にインストールされているかどうかを確認する。 
swift --version
 

==== Swiftlyの主なコマンド ====
下表に、Swiftlyの主なコマンドを示す。 
 
<center>
{| class="wikitable"
|+ Swiftly コマンド一覧
! コマンド !! 説明
|-
| swiftly list-available || インストール可能なバージョンの一覧を表示する。
|-
| swiftly install 6.2.3 || 特定バージョンをインストールする。
|-
| swiftly use 6.2.3 || 使用するバージョンを切り替える。
|-
| swiftly uninstall 5.10 || 指定バージョンを削除する。
|-
| swiftly self-update || Swiftly自体を更新する。
|-
| swiftly install main-snapshot || 開発スナップショットをインストールする。
|}
</center>
 
==== Dockerを使用する方法 ====
RHEL / SUSEの環境構築に問題が生じる場合は、公式コンテナイメージを使用する方法が最も確実である。 
Docker および Podman のどちらでも使用可能である。 
 
# バージョン確認
podman run -it --rm swift:latest swift --version

# プロジェクトのビルド
podman run -it --rm \
-v $(pwd):/workspace -w /workspace \
swift:latest swift build
 

== Swiftのアンインストール ==
Swiftlyでインストールした場合は、Swiftly経由で削除する。 
 
==== ツールチェーンの確認と削除 ====
まず、インストール済みのツールチェーンを確認する。 
 
swiftly list
 
表示されたバージョンをアンインストールする。 
複数バージョンがある場合は、それぞれに対して実行する。 
 
swiftly uninstall <バージョン例: 6.2.3>
 
==== Swiftly本体の削除 ====
Swiftly本体と全てのツールチェーンを削除する。 
 
rm -rf ~/.local/share/swiftly
rm -f ~/.local/bin/swiftly
 
==== シェル設定のクリーンアップ ====
Swiftlyインストール時に追加された環境変数の設定を削除する。 
 
Fishの場合は、以下のコマンドで該当する設定を確認する。 
 
grep -rn "swiftly\|SWIFT" ~/.config/fish/
 
該当する行があれば、エディタで削除する。 
 

== 依存関係のライブラリのインストール ==
Hazkeyのビルドに必要な依存パッケージをインストールする。 
 
==== RHEL ====
Vulkanを使用しない場合は、vulkan-headersのインストールを省略できる。 
 
sudo dnf install cmake ninja-build gettext protobuf-devel protobuf-compiler fcitx5-devel \
qt6-qtbase-devel qt6-qttools-devel vulkan-headers
 
==== SUSE ====
Vulkanを使用しない場合は、vulkan-headersのインストールを省略できる。 
 
sudo zypper install cmake ninja gettext-tools protobuf-devel fcitx5-devel \
qt6-base-devel qt6-tools-devel qt6-linguist-devel vulkan-headers
 

== ビルドとインストール ==
==== ソースコードの取得 ====
Gitを使用して、Hazkeyのソースコードを再帰的にクローンする。 
<code>--recursive</code> オプションはサブモジュールも含めて取得するために必要である。 
 
git clone --recursive https://github.com/7ka-Hiira/fcitx5-hazkey.git -b 0.2.1
 
==== ビルド ====
Hazkeyをビルドおよびインストールする。 
 
Vulkanを無効にしてビルドする場合は、<code>-DGGML_VULKAN=OFF</code> を設定する。 
 
cd fcitx5-hazkey
mkdir build && cd build

cmake -G Ninja \
-DCMAKE_C_COMPILER=<GCC 8以降のGCC> \
-DCMAKE_CXX_COMPILER=<GCC 8以降のG++> \
-DSWIFT_LINK_PATH=$HOME/.local/share/swiftly/toolchains/<バージョン>/usr/lib/swift/linux \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=/usr \
-DGGML_VULKAN=OFF \ # Vulkanを無効にする場合
..

ninja -j $(nproc)
sudo ninja install
 
インストール完了後、Fcitx5を再起動して、Hazkeyを入力メソッドとして選択する。 
 

== トラブルシューティング ==
下表に、ビルドおよびインストール時に発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ トラブルシューティング一覧
! 問題 !! 発生環境 !! 対処法
|-
| 三角関数の再定義エラーが発生する || 全環境 || Swiftのシムヘッダファイル /<swiftのインストール場所>/lib/swift_static/_FoundationCShims/_CStdlib.h の 約50行目にある3行をコメントアウトする。
|-
| <code>_mm256_set_m128</code> が未定義のエラーが発生する || SUSE 15 || SUSE 15付属のGCC 7では _mm256_set_m128 が未定義のため、GCC 8以降を使用する。
|}
</center>
 
==== 三角関数の再定義エラーへの対処 ====
Swift のシムヘッダーファイルに含まれる三角関数の定義が競合する場合がある。 
以下に示す手順でエラーを解消する。 
 
対象ファイルを開いて、該当ファイルの約 50 行目付近にある三角関数の定義に関する3行をコメントアウトする。 
nano /<swiftのインストール場所>/lib/swift_static/_FoundationCShims/_CStdlib.h
 
==== GCCバージョン問題への対処 ====
_mm256_set_m128 というAVX intrinsic関数は、GCC 8 以降のimmintrin.hファイルで追加されたため、GCC 7以前ではビルドできない。 
 
cmake -G Ninja \
-DCMAKE_C_COMPILER=<GCC 8以降のGCC> \
-DCMAKE_CXX_COMPILER=<GCC 8以降のG++> \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=/usr \
-DGGML_VULKAN=OFF \
..
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,Hazkey,Fcitx5,fcitx5-hazkey,日本語入力,IME,azooKey,AzooKeyKanaKanjiConverter,Zenzai,ニューラル変換,Swift,Swiftly,RHEL,SUSE,GCC,CMake,Ninja,Protobuf,Vulkan,GGML
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]]

インストール - Hazkey

2026-04-08T00:37:22Z

Wiki: /* SUSE */

== 概要 ==
Hazkeyは、Fcitx5向けの高精度日本語入力エンジンである。 
スローガンは「思考を止めない日本語入力」であり、入力作業を妨げないUI/UXの実装を目指して設計されている。 
 
iOS/MacOS向けアプリであるazooKeyと同じ高精度変換技術 (AzooKeyKanaKanjiConverter) を採用しており、Linux環境での日本語入力を効率化する。 
 
ビルドにはSwift 6.1以上が必要であり、RHEL および SUSE環境ではビルド環境の構築に一定の手順を要する。 
 
主な特徴は以下の通りである。 
 
<center>
{| class="wikitable"
|+ Hazkeyの機能
|-
! 機能 !! 説明
|-
| 高精度変換エンジン || iOS/MacOS向けアプリであるazooKeyと同じ変換技術を採用し、高い変換精度を実現する。
|-
| 自動変換機能 || 入力すると即座に自動で変換され、変換操作に妨げられることなく長文を入力できる。
|-
| Zenzaiニューラル変換 || GPT-2ベースのAIによるプロフィールや文脈を考慮した高度な変換に対応する。(オプション)
|-
| GGMLサポート || GPU対応バックエンド (Vulkan) を利用した高速処理が可能である。
|}
</center>
 
公式情報は以下を参照する。 
* 公式サイト
*: [https://hazkey.hiira.dev hazkey.hiira.dev]
* GitHubリポジトリ
*: [https://github.com/7ka-Hiira/fcitx5-hazkey github.com/7ka-Hiira/fcitx5-hazkey]
 

== 動作要件 ==
Hazkeyのビルドおよび動作に必要なソフトウェアを以下に示す。 
 
<center>
{| class="wikitable"
|+ 動作要件一覧
! ソフトウェア !! 必要バージョン !! 備考
|-
| Swift || 6.1 以上 || Swiftlyによるインストールを推奨
|-
| fcitx5 || 5.0.4 以上 || 入力フレームワーク本体
|-
| Qt || 6.7推奨 (6.2以降で可) || 6.7未満では表示に問題が発生する場合がある。
|-
| CMake || 3.21以上 (4.x以降推奨) || ビルドシステム
|-
| Protobuf || 3.12以上 || プロトコルバッファライブラリ
|-
| Ninja || 最新版推奨 || ビルドツール
|-
| Gettext || 最新版推奨 || 国際化対応ライブラリ
|-
| Vulkan headers || 最新版推奨 || GPU対応バックエンド用 (オプション、無効化可能)
|}
</center>
 

== Swiftのインストール ==
Hazkey のビルドには Swift 6.1以上が必要である。 
現在の推奨インストール方法は、公式ツールの Swiftly (rustup 相当) を使用する方法である。 
 
==== 公式サポート状況 ====
ディストリビューションごとの公式サポート状況を以下に示す。 
 
<center>
{| class="wikitable"
|+ Swift 公式サポート状況
! ディストリビューション !! 公式サポート
|-
| RHEL 9 || 公式サポート
|-
| RHEL 10 || 未公式 (RHEL 9ツールチェインで動作可)
|-
| SUSE 15 / 16 || 未公式 (RHEL 9ツールチェインで動作可)
|}
</center>
 
==== RHEL ====
RHEL 10は、Swiftの公式サポートリストに未掲載だが、RHEL 9と非常に近い構成のため、同ツールチェインで動作する。 
 
まず、依存パッケージをインストールする。 
sudo dnf install pkg-config binutils gcc git glibc-static libbsd-devel libcurl-devel libedit-devel libicu-devel libstdc++-static \
python3 sqlite-devel zlib-devel ncurses-devel
 
Swiftlyをダウンロードして初期化する。 
curl -O https://download.swift.org/swiftly/linux/swiftly-$(uname -m).tar.gz
tar xf swiftly-$(uname -m).tar.gz
cd swiftly-$(uname -m)

./swiftly init --quiet-shell-followup
 
init実行時に RHEL 10は未公式プラットフォームです と表示された場合は、プロンプトでRHEL 9を選択する。 
 
環境変数を設定する。 
<syntaxhighlight lang="sh">
# Bash / Zsh
. "${SWIFTLY_HOME_DIR:-$HOME/.local/share/swiftly}/env.sh"

# Fish
source (set -q SWIFTLY_HOME_DIR; and echo $SWIFTLY_HOME_DIR; or echo $HOME/.local/share/swiftly)/env.fish
</syntaxhighlight>
 
最新のSwiftをインストールする。 
swiftly install latest
 
正常にインストールされているかどうかを確認する。 
swift --version
 
==== SUSE ====
SUSEでは、Swiftlyが非公式プラットフォームと検出するため、手動でRHEL 9ツールチェインを選択する。 
 
まず、依存パッケージをインストールする。 
sudo zypper install pkg-config binutils binutils-gold gcc gcc-c++ git gzip glibc-static libbsd-devel libedit-devel libicu-devel \
libcurl-devel ncurses-devel sqlite3-devel zlib-devel python3
 
Swiftlyをダウンロードして初期化する。 
curl -O https://download.swift.org/swiftly/linux/swiftly-$(uname -m).tar.gz
tar xf swiftly-$(uname -m).tar.gz
cd swiftly-$(uname -m)

./swiftly init --quiet-shell-followup
 
<code>./swiftly init --quiet-shell-followup</code> コマンドを実行した時、以下に示すエラーが出力される場合がある。
 
Error: The ca-certificates package is not installed. Swiftly won't be able to trust the sites to perform its downloads.

You can install the ca-certificates package on your system to fix this.
 
これは、Swiftlyは特定のLinuxディストリビューション (Debian系) のファイルパス (/etc/ssl/certs/ca-certificates.crt )を探しているためである。 
SUSEにおいてはパスが異なるため、所定のパスにシンボリックリンクを貼る必要がある。 
 
sudo ln -s /var/lib/ca-certificates/ca-bundle.pem \
/etc/ssl/certs/ca-certificates.crt
 
再度、<code>./swiftly init --quiet-shell-followup</code> コマンドを実行する。 
 
初期化中に以下のプロンプトが表示されるので、4 を入力して、RHEL 9を選択する。 
 
SUSE Linux Enterprise 15 SP 6 is not an officially supported platform,
but the toolchains for another platform may still work on it.
Please select the platform to use for toolchain downloads:

0) Cancel
1) Ubuntu 24.04
2) Ubuntu 22.04
3) Ubuntu 20.04
4) Ubuntu 18.04
5) Fedora Linux 39
6) RHEL 9
7) Amazon Linux 2
8) Debian GNU/Linux 12
 
環境変数を設定する。 
<syntaxhighlight lang="sh">
# Bash / Zsh
. "${SWIFTLY_HOME_DIR:-$HOME/.local/share/swiftly}/env.sh"

# Fish
source (set -q SWIFTLY_HOME_DIR; and echo $SWIFTLY_HOME_DIR; or echo $HOME/.local/share/swiftly)/env.fish
</syntaxhighlight>
 
最新のSwiftをインストールする。 
swiftly install latest
 
正常にインストールされているかどうかを確認する。 
swift --version
 

==== Swiftlyの主なコマンド ====
下表に、Swiftlyの主なコマンドを示す。 
 
<center>
{| class="wikitable"
|+ Swiftly コマンド一覧
! コマンド !! 説明
|-
| swiftly list-available || インストール可能なバージョンの一覧を表示する。
|-
| swiftly install 6.2.3 || 特定バージョンをインストールする。
|-
| swiftly use 6.2.3 || 使用するバージョンを切り替える。
|-
| swiftly uninstall 5.10 || 指定バージョンを削除する。
|-
| swiftly self-update || Swiftly自体を更新する。
|-
| swiftly install main-snapshot || 開発スナップショットをインストールする。
|}
</center>
 
==== Dockerを使用する方法 ====
RHEL / SUSEの環境構築に問題が生じる場合は、公式コンテナイメージを使用する方法が最も確実である。 
Docker および Podman のどちらでも使用可能である。 
 
# バージョン確認
podman run -it --rm swift:latest swift --version

# プロジェクトのビルド
podman run -it --rm \
-v $(pwd):/workspace -w /workspace \
swift:latest swift build
 

== Swiftのアンインストール ==
Swiftlyでインストールした場合は、Swiftly経由で削除する。 
 
==== ツールチェーンの確認と削除 ====
まず、インストール済みのツールチェーンを確認する。 
 
swiftly list
 
表示されたバージョンをアンインストールする。 
複数バージョンがある場合は、それぞれに対して実行する。 
 
swiftly uninstall <バージョン例: 6.2.3>
 
==== Swiftly本体の削除 ====
Swiftly本体と全てのツールチェーンを削除する。 
 
rm -rf ~/.local/share/swiftly
rm -f ~/.local/bin/swiftly
 
==== シェル設定のクリーンアップ ====
Swiftlyインストール時に追加された環境変数の設定を削除する。 
 
Fishの場合は、以下のコマンドで該当する設定を確認する。 
 
grep -rn "swiftly\|SWIFT" ~/.config/fish/
 
該当する行があれば、エディタで削除する。 
 

== 依存関係のライブラリのインストール ==
Hazkeyのビルドに必要な依存パッケージをインストールする。 
 
==== RHEL ====
Vulkanを使用しない場合は、vulkan-headersのインストールを省略できる。 
 
sudo dnf install cmake ninja-build gettext protobuf-devel protobuf-compiler fcitx5-devel \
qt6-qtbase-devel qt6-qttools-devel vulkan-headers
 
==== SUSE ====
Vulkanを使用しない場合は、vulkan-headersのインストールを省略できる。 
 
sudo zypper install cmake ninja gettext-tools protobuf-devel fcitx5-devel qt6-base-devel qt6-tools-devel vulkan-headers
 

== ビルドとインストール ==
==== ソースコードの取得 ====
Gitを使用して、Hazkeyのソースコードを再帰的にクローンする。 
<code>--recursive</code> オプションはサブモジュールも含めて取得するために必要である。 
 
git clone --recursive https://github.com/7ka-Hiira/fcitx5-hazkey.git -b 0.2.1
 
==== ビルド ====
Hazkeyをビルドおよびインストールする。 
 
Vulkanを無効にしてビルドする場合は、<code>-DGGML_VULKAN=OFF</code> を設定する。 
 
cd fcitx5-hazkey
mkdir build && cd build

cmake -G Ninja \
-DCMAKE_C_COMPILER=<GCC 8以降のGCC> \
-DCMAKE_CXX_COMPILER=<GCC 8以降のG++> \
-DSWIFT_LINK_PATH=$HOME/.local/share/swiftly/toolchains/<バージョン>/usr/lib/swift/linux \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=/usr \
-DGGML_VULKAN=OFF \ # Vulkanを無効にする場合
..

ninja -j $(nproc)
sudo ninja install
 
インストール完了後、Fcitx5を再起動して、Hazkeyを入力メソッドとして選択する。 
 

== トラブルシューティング ==
下表に、ビルドおよびインストール時に発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ トラブルシューティング一覧
! 問題 !! 発生環境 !! 対処法
|-
| 三角関数の再定義エラーが発生する || 全環境 || Swiftのシムヘッダファイル /<swiftのインストール場所>/lib/swift_static/_FoundationCShims/_CStdlib.h の 約50行目にある3行をコメントアウトする。
|-
| <code>_mm256_set_m128</code> が未定義のエラーが発生する || SUSE 15 || SUSE 15付属のGCC 7では _mm256_set_m128 が未定義のため、GCC 8以降を使用する。
|}
</center>
 
==== 三角関数の再定義エラーへの対処 ====
Swift のシムヘッダーファイルに含まれる三角関数の定義が競合する場合がある。 
以下に示す手順でエラーを解消する。 
 
対象ファイルを開いて、該当ファイルの約 50 行目付近にある三角関数の定義に関する3行をコメントアウトする。 
nano /<swiftのインストール場所>/lib/swift_static/_FoundationCShims/_CStdlib.h
 
==== GCCバージョン問題への対処 ====
_mm256_set_m128 というAVX intrinsic関数は、GCC 8 以降のimmintrin.hファイルで追加されたため、GCC 7以前ではビルドできない。 
 
cmake -G Ninja \
-DCMAKE_C_COMPILER=<GCC 8以降のGCC> \
-DCMAKE_CXX_COMPILER=<GCC 8以降のG++> \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=/usr \
-DGGML_VULKAN=OFF \
..
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,Hazkey,Fcitx5,fcitx5-hazkey,日本語入力,IME,azooKey,AzooKeyKanaKanjiConverter,Zenzai,ニューラル変換,Swift,Swiftly,RHEL,SUSE,GCC,CMake,Ninja,Protobuf,Vulkan,GGML
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]]

インストール - Hazkey

2026-04-08T00:13:14Z

Wiki: /* ビルド */

== 概要 ==
Hazkeyは、Fcitx5向けの高精度日本語入力エンジンである。 
スローガンは「思考を止めない日本語入力」であり、入力作業を妨げないUI/UXの実装を目指して設計されている。 
 
iOS/MacOS向けアプリであるazooKeyと同じ高精度変換技術 (AzooKeyKanaKanjiConverter) を採用しており、Linux環境での日本語入力を効率化する。 
 
ビルドにはSwift 6.1以上が必要であり、RHEL および SUSE環境ではビルド環境の構築に一定の手順を要する。 
 
主な特徴は以下の通りである。 
 
<center>
{| class="wikitable"
|+ Hazkeyの機能
|-
! 機能 !! 説明
|-
| 高精度変換エンジン || iOS/MacOS向けアプリであるazooKeyと同じ変換技術を採用し、高い変換精度を実現する。
|-
| 自動変換機能 || 入力すると即座に自動で変換され、変換操作に妨げられることなく長文を入力できる。
|-
| Zenzaiニューラル変換 || GPT-2ベースのAIによるプロフィールや文脈を考慮した高度な変換に対応する。(オプション)
|-
| GGMLサポート || GPU対応バックエンド (Vulkan) を利用した高速処理が可能である。
|}
</center>
 
公式情報は以下を参照する。 
* 公式サイト
*: [https://hazkey.hiira.dev hazkey.hiira.dev]
* GitHubリポジトリ
*: [https://github.com/7ka-Hiira/fcitx5-hazkey github.com/7ka-Hiira/fcitx5-hazkey]
 

== 動作要件 ==
Hazkeyのビルドおよび動作に必要なソフトウェアを以下に示す。 
 
<center>
{| class="wikitable"
|+ 動作要件一覧
! ソフトウェア !! 必要バージョン !! 備考
|-
| Swift || 6.1 以上 || Swiftlyによるインストールを推奨
|-
| fcitx5 || 5.0.4 以上 || 入力フレームワーク本体
|-
| Qt || 6.7推奨 (6.2以降で可) || 6.7未満では表示に問題が発生する場合がある。
|-
| CMake || 3.21以上 (4.x以降推奨) || ビルドシステム
|-
| Protobuf || 3.12以上 || プロトコルバッファライブラリ
|-
| Ninja || 最新版推奨 || ビルドツール
|-
| Gettext || 最新版推奨 || 国際化対応ライブラリ
|-
| Vulkan headers || 最新版推奨 || GPU対応バックエンド用 (オプション、無効化可能)
|}
</center>
 

== Swiftのインストール ==
Hazkey のビルドには Swift 6.1以上が必要である。 
現在の推奨インストール方法は、公式ツールの Swiftly (rustup 相当) を使用する方法である。 
 
==== 公式サポート状況 ====
ディストリビューションごとの公式サポート状況を以下に示す。 
 
<center>
{| class="wikitable"
|+ Swift 公式サポート状況
! ディストリビューション !! 公式サポート
|-
| RHEL 9 || 公式サポート
|-
| RHEL 10 || 未公式 (RHEL 9ツールチェインで動作可)
|-
| SUSE 15 / 16 || 未公式 (RHEL 9ツールチェインで動作可)
|}
</center>
 
==== RHEL ====
RHEL 10は、Swiftの公式サポートリストに未掲載だが、RHEL 9と非常に近い構成のため、同ツールチェインで動作する。 
 
まず、依存パッケージをインストールする。 
sudo dnf install pkg-config binutils gcc git glibc-static libbsd-devel libcurl-devel libedit-devel libicu-devel libstdc++-static \
python3 sqlite-devel zlib-devel ncurses-devel
 
Swiftlyをダウンロードして初期化する。 
curl -O https://download.swift.org/swiftly/linux/swiftly-$(uname -m).tar.gz
tar xf swiftly-$(uname -m).tar.gz
cd swiftly-$(uname -m)

./swiftly init --quiet-shell-followup
 
init実行時に RHEL 10は未公式プラットフォームです と表示された場合は、プロンプトでRHEL 9を選択する。 
 
環境変数を設定する。 
<syntaxhighlight lang="sh">
# Bash / Zsh
. "${SWIFTLY_HOME_DIR:-$HOME/.local/share/swiftly}/env.sh"

# Fish
source (set -q SWIFTLY_HOME_DIR; and echo $SWIFTLY_HOME_DIR; or echo $HOME/.local/share/swiftly)/env.fish
</syntaxhighlight>
 
最新のSwiftをインストールする。 
swiftly install latest
 
正常にインストールされているかどうかを確認する。 
swift --version
 
==== SUSE ====
SUSEでは、Swiftlyが非公式プラットフォームと検出するため、手動でRHEL 9ツールチェインを選択する。 
 
まず、依存パッケージをインストールする。 
sudo zypper install pkg-config binutils binutils-gold gcc gcc-c++ git gzip glibc-static libbsd-devel libedit-devel libicu-devel \
libcurl-devel ncurses-devel sqlite3-devel zlib-devel python3
 
Swiftlyをダウンロードして初期化する。 
curl -O https://download.swift.org/swiftly/linux/swiftly-$(uname -m).tar.gz
tar xf swiftly-$(uname -m).tar.gz
cd swiftly-$(uname -m)

./swiftly init --quiet-shell-followup
 
 
初期化中に以下のプロンプトが表示されるので、4 を入力して、RHEL 9を選択する。 
 
SUSE Linux Enterprise 15 SP 6 is not an officially supported platform,
but the toolchains for another platform may still work on it.
Please select the platform to use for toolchain downloads:

0) Cancel
1) Ubuntu 24.04
2) Ubuntu 22.04
3) Ubuntu 20.04
4) RHEL 9
5) Amazon Linux 2023
6) Amazon Linux 2
</syntaxhighlight>
 
環境変数を設定する。 
<syntaxhighlight lang="sh">
# Bash / Zsh
. "${SWIFTLY_HOME_DIR:-$HOME/.local/share/swiftly}/env.sh"

# Fish
source (set -q SWIFTLY_HOME_DIR; and echo $SWIFTLY_HOME_DIR; or echo $HOME/.local/share/swiftly)/env.fish
</syntaxhighlight>
 
最新のSwiftをインストールする。 
swiftly install latest
 
正常にインストールされているかどうかを確認する。 
swift --version
 
==== Swiftlyの主なコマンド ====
下表に、Swiftlyの主なコマンドを示す。 
 
<center>
{| class="wikitable"
|+ Swiftly コマンド一覧
! コマンド !! 説明
|-
| swiftly list-available || インストール可能なバージョンの一覧を表示する。
|-
| swiftly install 6.2.3 || 特定バージョンをインストールする。
|-
| swiftly use 6.2.3 || 使用するバージョンを切り替える。
|-
| swiftly uninstall 5.10 || 指定バージョンを削除する。
|-
| swiftly self-update || Swiftly自体を更新する。
|-
| swiftly install main-snapshot || 開発スナップショットをインストールする。
|}
</center>
 
==== Dockerを使用する方法 ====
RHEL / SUSEの環境構築に問題が生じる場合は、公式コンテナイメージを使用する方法が最も確実である。 
Docker および Podman のどちらでも使用可能である。 
 
# バージョン確認
podman run -it --rm swift:latest swift --version

# プロジェクトのビルド
podman run -it --rm \
-v $(pwd):/workspace -w /workspace \
swift:latest swift build
 

== Swiftのアンインストール ==
Swiftlyでインストールした場合は、Swiftly経由で削除する。 
 
==== ツールチェーンの確認と削除 ====
まず、インストール済みのツールチェーンを確認する。 
 
swiftly list
 
表示されたバージョンをアンインストールする。 
複数バージョンがある場合は、それぞれに対して実行する。 
 
swiftly uninstall <バージョン例: 6.2.3>
 
==== Swiftly本体の削除 ====
Swiftly本体と全てのツールチェーンを削除する。 
 
rm -rf ~/.local/share/swiftly
rm -f ~/.local/bin/swiftly
 
==== シェル設定のクリーンアップ ====
Swiftlyインストール時に追加された環境変数の設定を削除する。 
 
Fishの場合は、以下のコマンドで該当する設定を確認する。 
 
grep -rn "swiftly\|SWIFT" ~/.config/fish/
 
該当する行があれば、エディタで削除する。 
 

== 依存関係のライブラリのインストール ==
Hazkeyのビルドに必要な依存パッケージをインストールする。 
 
==== RHEL ====
Vulkanを使用しない場合は、vulkan-headersのインストールを省略できる。 
 
sudo dnf install cmake ninja-build gettext protobuf-devel protobuf-compiler fcitx5-devel \
qt6-qtbase-devel qt6-qttools-devel vulkan-headers
 
==== SUSE ====
Vulkanを使用しない場合は、vulkan-headersのインストールを省略できる。 
 
sudo zypper install cmake ninja gettext-tools protobuf-devel fcitx5-devel qt6-base-devel qt6-tools-devel vulkan-headers
 

== ビルドとインストール ==
==== ソースコードの取得 ====
Gitを使用して、Hazkeyのソースコードを再帰的にクローンする。 
<code>--recursive</code> オプションはサブモジュールも含めて取得するために必要である。 
 
git clone --recursive https://github.com/7ka-Hiira/fcitx5-hazkey.git -b 0.2.1
 
==== ビルド ====
Hazkeyをビルドおよびインストールする。 
 
Vulkanを無効にしてビルドする場合は、<code>-DGGML_VULKAN=OFF</code> を設定する。 
 
cd fcitx5-hazkey
mkdir build && cd build

cmake -G Ninja \
-DCMAKE_C_COMPILER=<GCC 8以降のGCC> \
-DCMAKE_CXX_COMPILER=<GCC 8以降のG++> \
-DSWIFT_LINK_PATH=$HOME/.local/share/swiftly/toolchains/<バージョン>/usr/lib/swift/linux \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=/usr \
-DGGML_VULKAN=OFF \ # Vulkanを無効にする場合
..

ninja -j $(nproc)
sudo ninja install
 
インストール完了後、Fcitx5を再起動して、Hazkeyを入力メソッドとして選択する。 
 

== トラブルシューティング ==
下表に、ビルドおよびインストール時に発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ トラブルシューティング一覧
! 問題 !! 発生環境 !! 対処法
|-
| 三角関数の再定義エラーが発生する || 全環境 || Swiftのシムヘッダファイル /<swiftのインストール場所>/lib/swift_static/_FoundationCShims/_CStdlib.h の 約50行目にある3行をコメントアウトする。
|-
| <code>_mm256_set_m128</code> が未定義のエラーが発生する || SUSE 15 || SUSE 15付属のGCC 7では _mm256_set_m128 が未定義のため、GCC 8以降を使用する。
|}
</center>
 
==== 三角関数の再定義エラーへの対処 ====
Swift のシムヘッダーファイルに含まれる三角関数の定義が競合する場合がある。 
以下に示す手順でエラーを解消する。 
 
対象ファイルを開いて、該当ファイルの約 50 行目付近にある三角関数の定義に関する3行をコメントアウトする。 
nano /<swiftのインストール場所>/lib/swift_static/_FoundationCShims/_CStdlib.h
 
==== GCCバージョン問題への対処 ====
_mm256_set_m128 というAVX intrinsic関数は、GCC 8 以降のimmintrin.hファイルで追加されたため、GCC 7以前ではビルドできない。 
 
cmake -G Ninja \
-DCMAKE_C_COMPILER=<GCC 8以降のGCC> \
-DCMAKE_CXX_COMPILER=<GCC 8以降のG++> \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=/usr \
-DGGML_VULKAN=OFF \
..
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,Hazkey,Fcitx5,fcitx5-hazkey,日本語入力,IME,azooKey,AzooKeyKanaKanjiConverter,Zenzai,ニューラル変換,Swift,Swiftly,RHEL,SUSE,GCC,CMake,Ninja,Protobuf,Vulkan,GGML
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]]

Linuxその他 - ディスクイメージ

2026-04-06T02:05:13Z

Wiki: /* ディスクイメージファイルの拡張 */

== 概要 ==
ディスクイメージは、ディスク全体またはパーティションの完全なコピーであり、後で復元や分析が可能である。 
これは、システムのバックアップや移行、テスト等で非常に役立つ。 
 

== ディスクイメージファイルの拡張 ==
Linux OSのディスクイメージファイルをマウントして使用する場合、ディスクイメージファイルの空き領域が不足する時がある。 
ここでは、ディスクイメージファイルのサイズを変更する手順について記載する。 
 
==== 方法 1 : 非対話式 (推奨) ====
まず、ディスクイメージファイルを確認する。 
 
sudo fdisk -lu <ディスクイメージファイル>.img

# 出力例
ディスク 2023-10-10-raspios-bookworm-arm64-lite.img: 2.54 GiB, 2722103296 バイト, 5316608 セクタ
単位: セクタ (1 * 512 = 512 バイト)
セクタサイズ (論理 / 物理): 512 バイト / 512 バイト
I/O サイズ (最小 / 推奨): 512 バイト / 512 バイト
ディスクラベルのタイプ: dos
ディスク識別子: 0x7788c428

デバイス起動開始位置終了位置セクタサイズ Id タイプ
2023-10-10-raspios-bookworm-arm64-lite.img1 8192 1056767 1048576 512M c W95 FAT32 (LBA)
2023-10-10-raspios-bookworm-arm64-lite.img2 1056768 5316607 4259840 2G 83 Linux
 
<code>dd</code> コマンドを使用して、空き領域を追加する。 
上記の例では、最初のパーティションはブートパーティション（カーネルとバイナリブロブ）、2番目のパーティションはファイルシステムである。 
ディスクイメージファイルに空の空き領域を追加して、2番目のパーティションを拡張する。 
 
sudo dd if=/dev/zero bs=1M count=3072 >> <元のディスクイメージファイル>.img # この例では、3[GB]を追加している
 
空き領域を追加したディスクイメージファイルの情報を表示する。 
この時、出力結果は空き領域が追加されたサイズ(以下の例では、5.54[GiB])と表示するが、ディスクイメージファイルの2番目のパーティションのサイズはまだ変更されていない。(以下の例では、2[G]) 
 
sudo fdisk -lu <元のディスクイメージファイル>.img

# 出力例
ディスク 2023-10-10-raspios-bookworm-arm64-lite.img: 5.54 GiB, 5943328768 バイト, 11608064 セクタ
単位: セクタ (1 * 512 = 512 バイト)
セクタサイズ (論理 / 物理): 512 バイト / 512 バイト
I/O サイズ (最小 / 推奨): 512 バイト / 512 バイト
ディスクラベルのタイプ: dos
ディスク識別子: 0x7788c428

デバイス起動開始位置終了位置セクタサイズ Id タイプ
2023-10-10-raspios-bookworm-arm64-lite.img1 8192 1056767 1048576 512M c W95 FAT32 (LBA)
2023-10-10-raspios-bookworm-arm64-lite.img2 1056768 5316607 4259840 2G 83 Linux
 
これを解決するため、ディスクイメージファイルの空の追加領域の部分を埋めるようにパーティションのサイズを変更する必要がある。 
まず、ループバックデバイスを作成する。 
 
sudo losetup -f -P --show <元のディスクイメージファイル>.img

# 出力例
/dev/loop0
 
これにより、/dev/loopXがディスクイメージファイル全体、/dev/loopXp2がサイズ拡張するパーティションとして設定される。 
他のループバックデバイスを選択する場合は、未使用のループバックデバイスのドライブを割り当てる。 
 
sudo fdisk -lu /dev/loopX # X : ループバックデバイス番号

# 実行例
sudo fdisk -lu /dev/loop0

# 出力例
ディスク /dev/loop0: 5.54 GiB, 5943328768 バイト, 11608064 セクタ
単位: セクタ (1 * 512 = 512 バイト)
セクタサイズ (論理 / 物理): 512 バイト / 512 バイト
I/O サイズ (最小 / 推奨): 512 バイト / 512 バイト
ディスクラベルのタイプ: dos
ディスク識別子: 0x7788c428

デバイス起動開始位置終了位置セクタサイズ Id タイプ
/dev/loop0p1 8192 1056767 1048576 512M c W95 FAT32 (LBA)
/dev/loop0p2 1056768 5316607 4259840 2G 83 Linux
 
上記の出力例では、/dev/loop0p1はブートパーティション、/dev/loop0p2はルートパーティションである。 
 
次に、<code>parted</code> コマンドを非対話モードで実行して、2番目のパーティションのサイズを変更する。 
<code>100%</code> を指定すると、ディスクの残り全領域を使用してパーティションを拡張する。 
 
sudo parted -s /dev/loopX resizepart <パーティション番号> 100%

# 実行例
sudo parted -s /dev/loop0 resizepart 2 100%
 
なお、上記のコマンドで警告が表示されて失敗する場合は、<code>---pretend-input-tty</code> オプションを使用する。 
 
sudo parted ---pretend-input-tty /dev/loopX resizepart <パーティション番号> yes 100%

# 実行例
sudo parted ---pretend-input-tty /dev/loop0 resizepart 2 yes 100%
 
正常に拡張されているかどうかを確認する。 
 
sudo parted -s /dev/loopX print

# 出力例
モデル: Loopback デバイス (loopback)
ディスク /dev/loop0: 5943MB
セクタサイズ (論理/物理): 512B/512B
パーティションテーブル: msdos
ディスクフラグ:

番号開始終了サイズタイプファイルシステムフラグ
1 4194kB 541MB 537MB primary fat32 lba, type=0c
2 541MB 5943MB 5402MB primary ext4 type=83
 
<code>e2fsck</code> コマンドを実行して、拡張したディスクイメージファイルのファイルシステムを確認する。 
 
sudo e2fsck -f /dev/loopXpY # Xはデバイス番号, Yは拡張したパーティション番号
 
<code>resize2fs</code> コマンドで拡張したディスクイメージファイルのファイルシステムを拡張する。 
※パーティションのサイズは既に変更しているので、ここではファイルシステムをリサイズ(拡張)する。 
 
sudo resize2fs /dev/loopXpY # Xはデバイス番号, Yは拡張したパーティション番号
 
最後に、ループバックデバイスを削除する。 
 
sudo losetup -d /dev/loopX
 
 
==== 方法 2 : 対話式 ====
まず、ディスクイメージファイルを確認する。 
sudo fdisk -lu <ディスクイメージファイル>.img

# 出力例
ディスク 2023-10-10-raspios-bookworm-arm64-lite.img: 2.54 GiB, 2722103296 バイト, 5316608 セクタ
単位: セクタ (1 * 512 = 512 バイト)
セクタサイズ (論理 / 物理): 512 バイト / 512 バイト
I/O サイズ (最小 / 推奨): 512 バイト / 512 バイト
ディスクラベルのタイプ: dos
ディスク識別子: 0x7788c428

デバイス起動開始位置終了位置セクタサイズ Id タイプ
2023-10-10-raspios-bookworm-arm64-lite.img1 8192 1056767 1048576 512M c W95 FAT32 (LBA)
2023-10-10-raspios-bookworm-arm64-lite.img2 1056768 5316607 4259840 2G 83 Linux
 
<code>dd</code>コマンドを使用して、空き領域を追加する。 
上記の例では、最初のパーティションはブートパーティション（カーネルとバイナリブロブ）、2番目のパーティションはファイルシステムである。 
ディスクイメージファイルに空の空き領域を追加して、2番目のパーティションを拡張する。 
sudo dd if=/dev/zero bs=1M count=3072 >> <元のディスクイメージファイル>.img # この例では、3[GB]を追加している
 
空き領域を追加したディスクイメージファイルの情報を表示する。 
この時、出力結果は空き領域が追加されたサイズ(以下の例では、5.54[GiB])と表示するが、ディスクイメージファイルの2番目のパーティションのサイズはまだ変更されていない。(以下の例では、2[G]) 
sudo fdisk -lu <元のディスクイメージファイル>.img

# 出力例
ディスク 2023-10-10-raspios-bookworm-arm64-lite.img: 5.54 GiB, 5943328768 バイト, 11608064 セクタ
単位: セクタ (1 * 512 = 512 バイト)
セクタサイズ (論理 / 物理): 512 バイト / 512 バイト
I/O サイズ (最小 / 推奨): 512 バイト / 512 バイト
ディスクラベルのタイプ: dos
ディスク識別子: 0x7788c428

デバイス起動開始位置終了位置セクタサイズ Id タイプ
2023-10-10-raspios-bookworm-arm64-lite.img1 8192 1056767 1048576 512M c W95 FAT32 (LBA)
2023-10-10-raspios-bookworm-arm64-lite.img2 1056768 5316607 4259840 2G 83 Linux
 
これを解決するため、ディスクイメージファイルの空の追加領域の部分を埋めるようにパーティションのサイズを変更する必要がある。 
まず、ループバックデバイスを作成する。 
sudo losetup -f -P --show <元のディスクイメージファイル>.img

# 出力例
/dev/loop0
 
これにより、/dev/loopXがディスクイメージファイル全体、/dev/loopXp2がサイズ拡張するパーティションとして設定される。 
他のループバックデバイスを選択する場合は、未使用のループバックデバイスのドライブを割り当てる。 
sudo fdisk -lu /dev/loopX # X : ループバックデバイス番号

# 実行例
sudo fdisk -lu /dev/loop0

# 出力例
ディスク /dev/loop0: 5.54 GiB, 5943328768 バイト, 11608064 セクタ
単位: セクタ (1 * 512 = 512 バイト)
セクタサイズ (論理 / 物理): 512 バイト / 512 バイト
I/O サイズ (最小 / 推奨): 512 バイト / 512 バイト
ディスクラベルのタイプ: dos
ディスク識別子: 0x7788c428

デバイス起動開始位置終了位置セクタサイズ Id タイプ
/dev/loop0p1 8192 1056767 1048576 512M c W95 FAT32 (LBA)
/dev/loop0p2 1056768 5316607 4259840 2G 83 Linux
 
上記の出力例では、/dev/loop0p1はブートパーティション、/dev/loop0p2はルートパーティションである。 
 
次に、<code>parted</code>を実行して、パーティションのサイズを変更する。 
2番目のパーティションのサイズを、<code>parted</code>コマンドのヘッダ出力のDiskまたはディスクで始まる行で指定された/dev/loopXのフルサイズに変更する。 
以下の例では、ディスクは5943[MB]である。 
sudo parted /dev/loopX
 
(parted) print

# 出力例
モデル: Loopback デバイス (loopback)
ディスク /dev/loop0: 5943MB
セクタサイズ (論理/物理): 512B/512B
パーティションテーブル: msdos
ディスクフラグ:

番号開始終了サイズタイプファイルシステムフラグ
1 4194kB 541MB 537MB primary fat32 lba, type=0c
2 541MB 2722MB 2181MB primary ext4 type=83
 
2番目のパーティションサイズを変更する。 
以下の例では、2番目のパーティション(ルートパーティション)をフルサイズに変更している。 
(parted) resizepart <パーティション番号> <拡張するサイズ>
または
(parted) resizepart <パーティション番号> <拡張するサイズの割合>

# 実行例
(parted) resizepart 2 5943MB
または
(parted) resizepart 2 100%
 
正常に拡張されているかどうかを確認する。 
(parted) print

# 出力例
モデル: Loopback デバイス (loopback)
ディスク /dev/loop0: 5943MB
セクタサイズ (論理/物理): 512B/512B
パーティションテーブル: msdos
ディスクフラグ:

番号開始終了サイズタイプファイルシステムフラグ
1 4194kB 541MB 537MB primary fat32 lba, type=0c
2 541MB 5943MB 5402MB primary ext4 type=83
 
<code>e2fsck</code>コマンドを実行して、拡張したディスクイメージファイルのファイルシステムを確認する。 
sudo e2fsck -f /dev/loopXpY # Xはデバイス番号, Yは拡張したパーティション番号
 
<code>resize2fs</code>で拡張したディスクイメージファイルのファイルシステムを拡張する。 
※パーティションのサイズは既に変更しているので、ここではファイルシステムをリサイズ（拡張）する。 
sudo resize2fs /dev/loopXpY # Xはデバイス番号, Yは拡張したパーティション番号
 
ディスクイメージファイルが正常に拡張されているかどうかを確認する。 
sudo parted /dev/loopX

(parted) print

# 出力例 (正常に拡張されている場合)
モデル: Loopback デバイス (loopback)
ディスク /dev/loop0: 5943MB
セクタサイズ (論理/物理): 512B/512B
パーティションテーブル: msdos
ディスクフラグ:

番号開始終了サイズタイプファイルシステムフラグ
1 4194kB 541MB 537MB primary fat32 lba, type=0c
2 541MB 5943MB 5402MB primary ext4 type=83
 
最後に、ループバックデバイスを削除する。 
sudo losetup -d /dev/loopX
 

==== 方法 3 ====
まず、空のイメージファイルを作成する。 
以下の例では、拡張するサイズを5[GiB]としている。 
truncate -s 5GiB <空のイメージファイル名>.img
 
元のディスクイメージファイルと空のイメージファイルを結合する。 
cat <元のディスクイメージファイル>.img <空のイメージファイル名>.img > <結合したディスクイメージファイル名>.img
 
現在空いているループバックデバイスを確認する。 
sudo losetup -f

# 出力例
/dev/loop0
 
結合したディスクイメージファイルをループバックデバイスにマウントする。 
sudo losetup /dev/loopX <結合したディスクイメージファイル名>.img # X : ループバックデバイス番号
 
正常にマウントできたかどうかを確認するため、ループバックデバイスの設定状況を確認する。 
sudo losetup -a

# 出力例
/dev/loop0: []: (<結合したディスクイメージファイル名>.img)
 
パーティションテーブルを確認する。 
sudo fdisk -lu /dev/loopX

# 出力例
Disk /dev/loop0: 5.6 GiB, 3054501888 bytes, 5965824 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disklabel type: gpt
Disk identifier: 00CF01F2-3FB1-498B-BFE9-BA5B68507014

デバイス起動 Start 最後からセクタ Size Id タイプ
/dev/loop0p1 2048 1048576 131072 511M c W95 FAT32 (LBA)
/dev/loop0p2 1048576 13913020 13313020 4.1G 83 Linux ファイルシステム
 
結合したディスクイメージファイルのパーティションを設定する。 
sudo fdisk /dev/loopX

# 出力例
Welcome to fdisk (util-linux 2.37.4).
Changes will remain in memory only, until you decide to write them.
Be careful before using the write command.
 
まず、拡張するパーティションを削除する。 
<code>d</code>キーを入力した後、拡張するパーティション番号を入力する。 
コマンド (m でヘルプ): d
パーティション番号 (1,2, default 2): 2

Partition 2 has been deleted.
 
次に、拡張するパーティションの種類を選択する。 
ここでは、プライマリとして使用するため、<code>n</code>キーを入力した後、<code>p</code>キーを入力する。 
なお、extendedパーティション(拡張パーティション)は、主にスワップ向けに使用される。 
コマンド (m でヘルプ): n
Partition type
p primary (1 primary, 0 extended, 3 free)
e extended (container for logical partitions)

Select (default p): p
 
拡張するパーティション番号および拡張するサイズ(セクタ番号の最初と最後)を入力する。 
デフォルトの値は、最大セクタサイズである。 
パーティション番号 (2-4, default 2): 2

# 出力例
First sector (1048576-15913020, default 1048576):
Last sector, +sectors or +size{K,M,G,T,P} (1048576-15913020, default 15913020):

Created a new partition 2 of type 'Linux' and of size 7.1 GiB.
 
拡張するパーティションタイプを指定する。 
<code>t</code>キーを入力した後、パーティション番号およびLinuxファイルシステムを示すパーティションタイプである<code>83</code>を入力する。 
コマンド (m でヘルプ): t
パーティション番号 (1,2, default 2): 2
Partition type (type L to list all types): 83

# 出力例
Changed type of partition 'Linux' to 'Linux'.
 
設定したパーティションを確認する。 
<code>p</code>キーを入力する。 
コマンド (m でヘルプ): p

# 出力例
Disk /dev/loop0: 7.59 GiB, 8147483648 bytes, 14864445 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disklabel type: gpt
Disk identifier: 00CF01F2-3FB1-498B-BFE9-BA5B68507014

デバイス起動 Start 最後からセクタ Size Id タイプ
/dev/loop0p1 2048 1048576 1048576 511M c EFI システム
/dev/loop0p2 1048576 15913020 14864445 7.1G 83 Linux ファイルシステム
 
上記で設定したパーティションを書き込む。 
<code>w</code>キーを入力する。 
コマンド (m でヘルプ): w

# 出力例
The partition table has been altered.
Calling ioctl() to re-read partition table.
Re-reading the partition table failed.: 無効な引数です

The kernel still uses the old table. The new table will be used at the next reboot or after you run partprobe(8) or kpartx(8).
 
ループバックデバイスを削除する。 
sudo losetup -d /dev/loopX
 
ディスクイメージをマウントする。 
sudo mount -o loop,offset=<オフセット番号 (1セクタサイズ ✕ セクタの開始番号)> <結合したディスクイメージファイル名>.img <マウントするディレクトリ>
 
拡張の設定をしたパーティションを拡大する。 
# 設定されているループバックデバイス名を確認
sudo losetup -a

# パーティションの拡大
sudo resize2fs /dev/loopX
 
拡張したパーティションを確認する。 
df

# 出力例
/dev/loop0 1048576 15913020 14864445 35% /mnt
 

== SDカードのパーティションの拡張 ==
SDカードの場合は、SDカードをPCに挿入してパーティションのサイズを変更する。 
イメージファイルをフラッシュした後にパーティションのサイズを変更する。 
 
パーティションのサイズを拡張するには、以下に示す2つの方法がある。 
 
* Growpartの使用
*# GrowPartをインストールする。
*#: <code>sudo zypper install growpart</code>
*# GrowPartを実行して、パーティションのサイズを設定する。
*#: <code>sudo growpart /dev/mmcblkX Y</code> # Xはストレージデバイス番号, Yはパーティション番号
*# パーティションのサイズを変更する。
*#: <code>sudo resize2fs /dev/mmcblkXpY</code> # Xはストレージデバイス番号, Yはパーティション番号
*: 
* Partedの使用 (推奨)
*# PCにSDカードを挿入する。
*# Partedを実行して、パーティションのサイズを設定する。
*#: <code>sudo parted /dev/sdX</code> # Xはストレージデバイス番号
*#: <code>(parted) resizepart 2 100%</code>
*#: <code>(parted) quit</code>
*# パーティションのサイズを変更する。
*#: <code>sudo resize2fs /dev/sdXY</code> # Xはストレージデバイス番号, Yはパーティション番号
 
※注意 1 
実機の内部からパーティションのサイズを変更することは禁止である。 
現在マウントされているパーティションのサイズを変更すると、奇妙な結果になることがある。 
 
※注意 2 : PinePhone Beta/ProのeMMCの拡張 
PinePhone Beta/ProのeMMCを拡張する場合、Jumpdriveを使用して、PCとUSBケーブルで接続してeMMCに直接アクセスする。 
その後、eMMCのパーティションのサイズを変更する。 
 

== qcow2ファイルのサイズの拡張 ==
KVMで作成した仮想マシンのディスクファイル(qcow2ファイル)を拡張する。 
なお、仮想マシンのセットアップが完了していることが前提となる。 
 
仮想マシンのディスクファイルのリサイズは、<code>virsh</code>コマンドを使用する。 
sudo virsh vol-resize <仮想マシン名または仮想マシンのパス> <ファイルサイズ> [--pool <プール名または UUID>] [--allocate] [--delta] [--shrink]
 
ファイルサイズは、<code>50GB</code>、<code>50000MB</code>、または、<code>50GiB</code>、<code>5120MiB</code>等と記述する。 
 
<code>--allocate</code>オプションは、rawファイルにのみ対応しており、qcow2ファイルに対して指定するとエラーになるので注意する。 (基本的には使用しない) 
 
<code>--delta</code>オプションを付加しない場合、<ファイルサイズ>には変更後のサイズを指定する。 
<code>--delta</code>オプションを付加する場合、代わりにサイズ拡張 / 縮小の差分の値を指定する。 
 
<code>--shrink</code>オプションを付加する場合、サイズを縮小する際に指定する。 
拡張の際に指定するとエラーとなることに注意する。 
 
==== 拡張手順 ====
まず、プール名を確認する。 
sudo virsh pool-list

# 出力例
# Name State Autostart
# ----------------------------------------------
# default active yes
 
プール名にある仮想マシン名を確認する。 
sudo virsh vol-list --pool <プール名>

# 出力例
# 名前パス
# -----------------------------------------------------
# RHEL_9 /run/media/suse/SAMSUNG860EVO/KVM/RHEL_9
 
現在のボリュームサイズを確認する。 
sudo virsh vol-info --pool <プール名> <仮想マシン名または仮想マシンのファイルのパス>

# 出力例
名前: RHEL_9.qcow2
タイプ: ファイル
容量: 40.00 GiB
割り当て: 12.19 GiB
 
以下の例では、プール名 : defaultに存在するサイズ : 50[GiB]の仮想マシン名 : RHEL_9.qcow2を、50[GiB]に拡張している。 
以下に示す2種類のコマンドは、同様の結果になる。 
 
なお、<code>--delta</code>を使用する方が現在の容量を意識せずに済む。 
sudo virsh vol-resize <仮想マシン名または仮想マシンのファイルのパス> --pool <プール名> --delta 10GiB
# または
sudo virsh vol-resize <仮想マシン名または仮想マシンのファイルのパス> --pool <プール名> 50GiB
 
以下の例では、仮想マシンのファイルサイズを5[GiB]縮小している。 
ファイルサイズの縮小する場合はデータを破壊するリスクがあるため、実行する前にバックアップを作成した方がよい。 
sudo virsh vol-resize <仮想マシン名または仮想マシンのファイルのパス> --pool <プール名> --delta -5GiB --shrink
# または
sudo virsh vol-resize <仮想マシン名または仮想マシンのファイルのパス> --pool <プール名> 35GiB --shrink
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,Podman,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:PinePhone]]

インストール - OpenCode

2026-04-05T08:56:12Z

Wiki: /* デスクトップアプリケーションのビルド */

== 概要 ==
OpenCodeは、オープンソースのAIコーディングエージェントである。 
ターミナルベースのTUI (ターミナルユーザーインターフェース) を提供し、75以上のLLMプロバイダに対応している。 
 
主要な特徴として、以下が挙げられる。 
* Anthropic (Claude)、OpenAI (GPT)、Google (Gemini)、GitHub Copilot、Ollama等のモデルの主要プロバイダをサポート
* 2026年1月にGitHub Copilotとの公式パートナーシップを発表
* プライバシー重視の設計
*: コードは送信されず、ローカルでの処理を優先
* CLI、TUI、Desktop アプリ、IDE拡張機能、Webインターフェースを提供
* MCP (Model Context Protocol) とLSP (Language Server Protocol) をサポート
* 組み込みエージェント
** build (開発用)
** plan (読み取り専用分析)
 
OpenCodeは、Go言語でBubble Tea TUIフレームワークを使用して実装されている。 
セッション管理、マルチセッション対応を備え、会話履歴の保存、復元、エクスポートが可能である。 
 
Desktop アプリはTauri v2ベースのネイティブアプリケーションとして実装されており、TypeScriptで実装された内部CLI、Rust + SolidJSで構築されたフロントエンドを組み合わせている。 
 

== 主な機能 ==
OpenCodeは、多様な機能を提供する包括的なAIコーディングツールである。 
 
<center>
{| class="wikitable"
|+ 主要機能一覧
! 機能 !! 説明
|-
| TUI (Bubble Tea) || ターミナルベースの対話型インターフェース
|-
| マルチプロバイダ対応 || 75以上のLLMプロバイダをサポート
|-
| セッション管理 || 会話履歴の保存、復元、エクスポート
|-
| ツール統合 || ファイル操作、Bash実行、テスト実行等
|-
| MCP (Model Context Protocol) || 外部ツールとの統合プロトコル
|-
| LSP (Language Server Protocol) || 25以上の組み込みLSPサーバーによる言語サーバーとの連携
|-
| 組み込みエージェント || build (開発用) plan (読み取り専用分析) general (調査用) explore (コード探索用)
|-
| Desktop アプリ || Tauri v2ベースのネイティブアプリ
|-
| IDE拡張機能 || VS Code、JetBrains等のIDE拡張
|-
| カスタムコマンド || .opencode/commands/ ディレクトリ内でユーザ定義コマンド作成
|-
| Git統合 || <code>/undo</code>、<code>/redo</code> コマンドでGitバック付きの変更管理
|}
</center>
 

== 対応AIプロバイダとモデル ==
OpenCodeは、75以上のLLMプロバイダに対応している。 
 
==== 主要プロバイダ一覧 ====
<center>
{| class="wikitable"
|+ 主要プロバイダ一覧
! プロバイダ !! 認証方法 !! 備考
|-
| Anthropic || APIキー (<code>ANTHROPIC_API_KEY</code>) || Claude 4.x系をサポート
|-
| OpenAI || APIキー (<code>OPENAI_API_KEY</code>) || GPT-4o、o3等をサポート
|-
| Google || APIキー (<code>GOOGLE_API_KEY</code>) || Gemini 3等をサポート
|-
| GitHub Copilot || GitHub認証 (OAuth) || <code>/connect</code> コマンドで認証
|-
| Z.AI || APIキー || GLM-5、GLM-4.7等をサポート GLM Coding Plan対応
|-
| AWS Bedrock || AWS認証情報 || Anthropicモデルのホスティング
|-
| Azure OpenAI || Azureエンドポイント || OpenAIモデルのホスティング
|-
| Ollama || ローカル実行 (認証不要) || ローカルモデルの実行
|-
| OpenRouter || APIキー || 複数プロバイダのルーティング
|-
| Groq || APIキー || 高速推論
|-
| Together AI || APIキー || オープンソースモデル
|-
| Fireworks AI || APIキー || 高速推論
|}
</center>
 
==== 推奨モデル ====
<center>
{| class="wikitable"
|+ 用途別推奨モデル
! 用途 !! 推奨モデル
|-
| 高精度コーディング || Claude Sonnet 4.5、GPT-4o
|-
| 高速処理 || Claude Haiku 4.5、Gemini 2.5 Flash
|-
| 複雑な推論 || Claude Opus 4.6、o3
|-
| ローカル実行 || Qwen 2.5 Coder (Ollama)
|-
| コスト効率重視 || GLM-4.7、GLM-5 (Z.AI Coding Plan)
|}
</center>
 
==== ローカルモデル (Ollama) ====
Ollamaを使用することで、ローカル環境でモデルを実行できる。 
 
===== Ollamaのインストール =====
Ollamaの公式サイトからインストールスクリプトをダウンロードして実行する。 
curl -fsSL https://ollama.com/install.sh | bash
 
===== モデルのダウンロード =====
Ollamaでモデルをダウンロードする。 
ollama pull qwen2.5-coder
 
===== OpenCodeでの設定 =====
<code>opencode.json</code> でOllamaプロバイダを設定する。 
<syntaxhighlight lang="json">
{
"$schema": "https://opencode.ai/config.json",
"model": "ollama/qwen2.5-coder"
}
</syntaxhighlight>
 

== 前提条件 ==
OpenCodeをインストールするには、以下の前提条件を満たす必要がある。 
 
==== 標準インストール時の前提条件 ====
<center>
{| class="wikitable"
|+ 標準インストール時の前提条件
! 要件 !! 詳細
|-
| OS || Linux、MacOS、Windows
|-
| Node.js || npm経由のインストールに必要 (Node.js 18以上)
|-
| ネットワーク || AIプロバイダへの接続に必要
|-
| AIプロバイダのAPIキー || 使用するプロバイダのAPIキーまたは認証情報
|}
</center>
 

== インストール ==
OpenCodeのインストール方法を以下に示す。 
 
==== クイックインストール (Linux) ====
公式のインストールスクリプトを使用してインストールする。 
curl -fsSL https://opencode.ai/install | bash
 
==== Homebrew (MacOS) ====
Homebrewを使用してインストールできる。 
brew install opencode
 
==== npm (全プラットフォーム) ====
npmを使用してグローバルインストールする。 
npm install -g opencode
 
==== Windows (Scoop / Chocolatey) ====
Windowsでは、ScoopまたはChocolateyを使用してインストールできる。 
 
===== Scoopでのインストール =====
scoop install opencode
 
===== Chocolateyでのインストール =====
choco install opencode
 
==== デスクトップアプリケーション ====
[https://opencode.ai/download OpenCodeの公式Webサイト]にアクセスして、デスクトップアプリケーションをダウンロードする。 
 
対応プラットフォーム: 
* Linux (deb、rpm)
* MacOS (dmg)
* Windows (exe)
 
==== バージョン確認 ====
インストール後、バージョンを確認する。 
opencode --version
 

== 初期設定 ==
OpenCodeの初期設定を以下に示す。 
 
==== プロバイダの認証 ====
OpenCodeの初回起動時に、<code>/connect</code> コマンドまたは <code>opencode auth login</code> コマンドでAIプロバイダとの認証を設定する。 
 
===== GitHub Copilotとの連携 =====
OpenCodeはGitHub Copilotの公式パートナーであり、<code>/connect</code> コマンドで認証を設定できる。 
 
OpenCodeを起動する。 
opencode
 
認証を設定する。 
/connect
 
例えば、GitHub Copilotを選択する。 
Webブラウザが開き、GitHub認証ページが表示される。 
 
認証を完了すると、OpenCodeでGitHub Copilotが使用可能になる。 
 
===== APIキーによる認証 =====
環境変数でAPIキーを設定する方法もある。 
<syntaxhighlight lang="sh">
export ANTHROPIC_API_KEY="sk-..."
export OPENAI_API_KEY="sk-..."
export GOOGLE_API_KEY="..."
</syntaxhighlight>
 
環境変数を永続化する場合は、~/.profileファイル等に環境変数 <code>ANTHROPIC_API_KEY</code> を設定する。 
<syntaxhighlight lang="sh">
export ANTHROPIC_API_KEY="sk-..."
</syntaxhighlight>
 
===== Z.AI (GLM) との連携 =====
Z.AIのGLMモデル (GLM-5、GLM-4.7等) をOpenCodeで使用するには、[https://z.ai/subscribe Z.AI GLM または GLM Coding Plan]のサブスクリプション契約およびAPIキーが必要である。 
 
====== GLM / GLM Coding Planの概要 ======
GLM / GLM Coding Planは、Z.AIが提供するAIコーディング向けのサブスクリプションプランである。 
 
<center>
{| class="wikitable"
|+ GLM Coding Plan
! プラン !! 月額 !! GLM-5対応 !! 5時間あたりの目安
|-
| Lite || $10 || 対応 || 約80プロンプト
|-
| Pro || $30 || 対応 || 約400プロンプト
|-
| Max || $120 || 対応 || 約1,600プロンプト
|}
</center>
 
使用可能なモデルは以下の通りである。 
* GLM-5 (ProプランおよびMaxプランのみ)
* GLM-4.7
* GLM-4.6
* GLM-4.5
* GLM-4.5-Air
 
GLM-5はピーク時 (日本時間 15:00〜19:00) に3倍、オフピーク時に2倍のクォータを消費する。 
日常的なタスクにはGLM-4.7を使用し、複雑なタスクにのみGLM-5を使用することが推奨される。 
 

====== 認証の設定手順 ======
Z.AIの[https://z.ai/manage-apikey/apikey-list APIコンソール]にアクセスして、APIキーを取得する。 
 
<code>opencode auth login</code> コマンドを実行して、プロバイダ選択で Z.AI Coding Plan を選択する。 
 
<syntaxhighlight lang="sh">
opencode auth login
</syntaxhighlight>
 
┌ Add credential
│
◆ Select provider
│ ● Z.AI Coding Plan
│ ...
└
 
Z.AIのAPIキーを入力する。 
┌ Add credential
│
◇ Select provider
│ Z.AI Coding Plan
│
◇ Enter your API key
│ <Z.AIのAPIキーを入力>
└
 
OpenCodeを起動して、<code>/models</code> コマンドでGLM-5 / GLM-4.7等のモデルを選択する。 
opencode
 
/models
 
====== トラブルシューティング : Insufficient balance ======
GLMモデルの使用時に、以下に示すエラーメッセージが表示される場合がある。 
Insufficient balance or no resource package. Please recharge.
 
このエラーは、OpenCodeのプロバイダ設定がGLM Coding Plan専用のエンドポイントに接続されていない場合に発生する。 
 
GLM Coding Planでは、専用のAPIエンドポイント (https://api.z.ai/api/coding/paas/v4) を使用する必要がある。 
プロバイダ選択で Z.AI (通常のAPI) を選択した場合、標準エンドポイント (https://api.z.ai/api/paas/v4) に接続されるため、Coding Planの残高が認識されず、上記のエラーが発生する。 
 
<center>
{| class="wikitable"
|+ Z.AI APIエンドポイントの違い
! エンドポイント !! URL !! 用途
|-
| 標準 (通常API) || https://api.z.ai/api/paas/v4 || 従量課金のAPI利用
|-
| Coding Plan専用 || https://api.z.ai/api/coding/paas/v4 || GLM Coding Planサブスクリプション利用
|}
</center>
 
対処方法として、一旦Z.AIの認証情報をログアウトしてから、Z.AI Coding Plan で再度ログインする。 
 
Z.AIの認証情報をログアウトする。 
<syntaxhighlight lang="sh">
opencode auth logout
</syntaxhighlight>
 
再度ログインして、プロバイダ選択で Z.AI Coding Plan を選択する。 
<syntaxhighlight lang="sh">
opencode auth login
</syntaxhighlight>
 
┌ Add credential
│
◆ Select provider
│ ● Z.AI Coding Plan ← Z.AI ではなく、Z.AI Coding Planを選択すること
│ ...
└
 
APIキーを入力して認証を完了した後、OpenCodeを起動して正常にGLMモデルが使用できることを確認する。 
 
==== 設定ファイル ====
OpenCodeの設定ファイルは、プロジェクトルート または ホームディレクトリ に配置する。 
 
===== 設定ファイルの場所 =====
設定ファイルは以下の順序で検索される。 
* プロジェクトルート
*: opencode.json
* ホームディレクトリ
*: ~/.opencode/config.json
 
===== 設定ファイルの例 =====
<syntaxhighlight lang="json">
{
"$schema": "https://opencode.ai/config.json",
"model": "anthropic/claude-sonnet-4-5-20250929",
"small_model": "anthropic/claude-haiku-4-5-20251001",
"keybinds": {
"leader": "ctrl+x"
}
}
</syntaxhighlight>
 
設定可能な項目を以下に示す。 
* <code>model</code>
*: 使用するモデル名 (プロバイダ/モデル名形式)
*: 例: <code>anthropic/claude-sonnet-4-5-20250929</code>、<code>openai/gpt-4o</code>
* <code>small_model</code>
*: 軽量タスク用のモデル (コスト削減に有効)
*: 例: <code>anthropic/claude-haiku-4-5-20251001</code>
* <code>keybinds.leader</code>
*: リーダーキーの設定
*: デフォルト : <code>ctrl+x</code>
 

== CLIコマンド ==
OpenCodeは、CLIモードと対話モードの両方で使用できる。 
 
==== 主要コマンド ====
<center>
{| class="wikitable"
|+ 主要コマンド一覧
! コマンド !! 説明
|-
| <code>opencode</code> || TUIを起動
|-
| <code>opencode run "プロンプト"</code> || 非対話モードでプロンプトを実行
|-
| <code>opencode --model プロバイダ/モデル名</code> || モデルを指定して起動
|-
| <code>opencode --continue</code> || 前回のセッションを継続して起動
|-
| <code>opencode auth login</code> || プロバイダの認証を設定
|-
| <code>opencode auth logout</code> || 認証情報を削除
|-
| <code>opencode models</code> || 使用可能なモデル一覧を表示
|-
| <code>opencode mcp list</code> || MCPサーバ一覧を表示
|-
| <code>opencode mcp add サーバー名</code> || MCPサーバを追加
|-
| <code>opencode serve</code> || ヘッドレスバックエンドサーバを起動
|-
| <code>opencode --version</code> || バージョンを表示
|-
| <code>opencode --help</code> || ヘルプを表示
|}
</center>
 
==== 非対話モード ====
非対話モードでは、プロンプトをコマンドライン引数として渡すことができる。 
 
===== 使用例 =====
プロジェクトの概要を説明する。 
opencode run "このプロジェクトの概要を説明して"
 
モデルを指定してテストを実行する。 
opencode run "テストを実行して" --model anthropic/claude-sonnet-4-5-20250929
 

== TUI (ターミナルユーザーインターフェース) ==
OpenCodeのTUIは、ターミナルベースの対話型インターフェースである。 
 
==== スラッシュコマンド ====
TUI内でスラッシュコマンドを使用して、様々な操作を実行できる。 
 
<center>
{| class="wikitable"
|+ スラッシュコマンド一覧
! コマンド !! 説明
|-
| <code>/new</code> || 新しいセッションを開始
|-
| <code>/init</code> || プロジェクト構造を分析
|-
| <code>/undo</code> || 直前の変更を元に戻す (Git連携)
|-
| <code>/redo</code> || 元に戻した変更をやり直す
|-
| <code>/compact</code> || 会話を要約して圧縮
|-
| <code>/share</code> || 会話の共有リンクを生成
|-
| <code>/export</code> || 会話をMarkdownでエクスポート
|-
| <code>/sessions</code> || 過去のセッション一覧を表示
|-
| <code>/models</code> || 使用可能なモデル一覧を表示
|-
| <code>/agents</code> || エージェント一覧を表示
|-
| <code>/connect</code> || プロバイダ認証を設定
|-
| <code>/status</code> || 現在のステータスを表示
|-
| <code>/mcp</code> || MCPサーバ一覧を表示
|-
| <code>/theme</code> || テーマを変更
|-
| <code>/editor</code> || 外部エディタで入力
|-
| <code>/help</code> || ヘルプを表示
|-
| <code>/commands</code> || コマンド一覧を表示
|-
| <code>/exit</code> || OpenCodeを終了
|}
</center>
 
==== キーバインド ====
OpenCodeのリーダーキーのデフォルトは、[Ctrl] + [X]キーである。 
リーダーキーを押した後に各キーを入力する。 
 
<center>
{| class="wikitable"
|+ キーバインド一覧
! キー !! 説明
|-
| [Ctrl] + [X] -> [N] || 新しいセッション
|-
| [Ctrl] + [X] -> [L] || セッション一覧
|-
| [Ctrl] + [X] -> [T] || タイムライン
|-
| [Ctrl] + [X] -> [M] || モデル選択ダイアログ
|-
| [Ctrl] + [X] -> [C] || コンパクト表示
|-
| [Ctrl] + [P] || コマンドパレット
|-
| [Tab] || Plan/Buildエージェント切替
|-
| [Page Up] / [Page Down] || スクロール
|-
| [Shift] + [Enter] || 改行入力
|}
</center>
 
==== ファイル参照とBashコマンド ====
TUI内でファイル参照とBashコマンドの実行ができる。 
 
===== ファイル参照 =====
<code>@</code> でファイルをファジー検索して参照を追加する。 
@filename
 
===== Bashコマンドの実行 =====
<code>!</code> をプレフィックスとしてBashコマンドを実行する。 
!ls -la
!git status
 

== CLIバイナリのビルド (SUSE) ==
OpenCode CLIバイナリをSUSE環境でソースコードからビルドすることができる。 
 
==== ビルドの前提条件 ====
<center>
{| class="wikitable"
|+ ビルドの前提条件
! 項目 !! 要件
|-
| OS ||
* RHEL 9 / 10
* SUSE 15 / 16
|-
| Bun || 1.3.x (package.json 内の <code>packageManager</code> で <code>bun@1.3.9</code> を指定)
|-
| git || ブランチ名取得に使用 (Gitリポジトリでない場合は環境変数で回避可能)
|-
| ネットワーク || ビルド時に https://models.dev/api.json からモデルデータを取得
|}
</center>
 
===== 前提条件の確認コマンド =====
# Bunバージョン確認 (1.3.9が必要)
bun --version

# ネットワーク接続の確認
curl -s https://models.dev/api.json | head -c 100
 

==== ビルド方式の説明 ====
<center>
{| class="wikitable"
|+ ビルド方式の説明
! 項目 !! 内容
|-
| 言語 || TypeScript (Bun ランタイム)
|-
| ビルド方式 || <code>Bun.build()</code> の <code>compile: true</code> でスタンドアロン実行ファイルを生成
|-
| ビルドスクリプト || packages/opencode/script/build.ts
|-
| 出力 || Bunランタイムを内蔵した単一バイナリ (<code>opencode</code>)
|}
</center>
 
==== 環境変数の設定 ====
ソースディレクトリがGitリポジトリでない場合、<code>git branch --show-current</code> が失敗するため、環境変数を設定する。 
<syntaxhighlight lang="sh">
export OPENCODE_VERSION=<バージョン例 : 1.2.14>
export OPENCODE_CHANNEL=latest
</syntaxhighlight>
 

==== 依存パッケージのインストール ====
プロジェクトディレクトリに移動して、依存パッケージをインストールする。 
cd /path/to/opencode-<バージョン>
bun install
 
このプロジェクトはBunワークスペース構成のモノレポである。 
<code>bun install</code> コマンドを実行して、ルートおよび全パッケージの依存関係がインストールされる。 
 

==== ビルドの実行 ====
ビルドスクリプトを実行する。 
./packages/opencode/script/build.ts --single
 
<code>--single</code> フラグは現在のプラットフォーム向けのみビルドする。(例: linux-x64) 
フラグなしで実行すると全11プラットフォーム分のクロスコンパイルを試みる。 
 
ビルドスクリプトの処理内容: 
* <code>models.dev</code> からモデルデータを取得し、TypeScript スナップショットを生成
* <code>@opentui/core</code> と <code>@parcel/watcher</code> のネイティブバインディングをインストール
* <code>Bun.build()</code> で TypeScript をスタンドアロンバイナリにコンパイル
* <code>packages/opencode/dist/opencode-linux-x64/bin/opencode</code> に出力
 
==== 動作確認 ====
ビルドが完了したら、バイナリが生成されたか確認する。 
# バイナリが生成されたか確認
ls -la packages/opencode/dist/opencode-linux-x64/bin/opencode

# バージョン表示で動作確認
./packages/opencode/dist/opencode-linux-x64/bin/opencode --help
 
==== トラブルシューティング ====
<center>
{| class="wikitable"
|+ トラブルシューティング
! 問題 !! 原因 !! 対策
|-
| <code>git branch --show-current</code> 失敗 || ソースがGitリポジトリではない || 下記の環境変数を設定する。 OPENCODE_VERSION=<バージョン例: 1.1.53> OPENCODE_CHANNEL=latest
|-
| <code>models.dev</code> に接続できない || ネットワーク制限 || 事前に api.json をダウンロードして、<code>MODELS_DEV_API_JSON=/path/to/api.json</code> で指定する。
|-
| GLIBCバージョン不足 || SUSEのGLIBCのバージョンが古い || <code>--single</code> に加えて <code>--baseline</code> フラグを追加 または、muslビルドを検討する。
|-
| native module のビルド失敗 || C / C++ コンパイラ不足 || ビルドツールをインストールする。
<pre>sudo zypper install gcc gcc-c++ make</pre>
|}
</center>
 
===== オフライン環境でのビルド =====
ネットワークに接続できない場合、モデルデータを事前にダウンロードしておく必要がある。 
# オンライン環境で事前にダウンロード
curl -o api.json https://models.dev/api.json

# ビルド時にローカルファイルを指定
export MODELS_DEV_API_JSON=/path/to/api.json
./packages/opencode/script/build.ts --single
 
===== baselineビルド =====
CPUがAVX2命令セットをサポートしていない場合、<code>--baseline</code> フラグを追加する。 
./packages/opencode/script/build.ts --single --baseline
 

== デスクトップアプリケーションのビルド ==
OpenCode Desktopは、Tauri v2ベースのデスクトップアプリケーションである。 
 
==== デスクトップアプリケーションの構成 ====
<center>
{| class="wikitable"
|+ Desktop アプリの構成
! 項目 !! 内容
|-
| フロントエンド || SolidJS + Vite (TypeScript)
|-
| バックエンド || Rust (Tauri v2 シェル)
|-
| サイドカー || OpenCode CLI バイナリ (CLIバイナリのビルドで作成したもの)
|-
| ビルドスクリプト || packages/desktop/ 配下
|-
| 出力形式 (Linux) || debパッケージ、rpmパッケージ
|-
| ソースディレクトリ || packages/desktop/ (フロントエンド) packages/desktop/src-tauri/ (Rust)
|}
</center>
 
==== ビルドの前提条件 ====
===== OpenCode CLIバイナリのビルド =====
デスクトップアプリケーションでは、OpenCode CLIバイナリをサイドカーとしてバンドルする。 
そのため、まず、OpenCode CLIバイナリのビルドを完了させること。 
 
===== Rustツールチェーン =====
Tauri v2 のビルドには、Rustが必要である。 
 
# Rustのインストール (未インストールの場合)
curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh

# 環境変数の設定を反映
source "$HOME/.cargo/env"

# バージョン確認
rustc --version
cargo --version
 
===== 依存ライブラリのインストール =====
Tauri v2公式ドキュメントに基づく依存関係のライブラリをインストールする。 
sudo zypper install -t pattern devel_basis
sudo zypper install curl wget file webkit2gtk3-devel libopenssl-devel libappindicator3-1 librsvg-devel
 
===== ソースコードのダウンロード =====
[https://github.com/anomalyco/opencode/releases OpenCodeのGithub]にアクセスして、ソースコードをダウンロードする。 
ダウンロードしたファイルを解凍する。 
tar xf opencode-<バージョン>.tar.gz
cd opencode-<バージョン>
 

==== デスクトップアプリケーションのビルド ====
===== Step 1 : 環境変数の設定 =====
環境変数を設定する。 
<syntaxhighlight lang="sh">
export OPENCODE_VERSION=<バージョン例 : 1.2.4>
export OPENCODE_CHANNEL=latest
</syntaxhighlight>
 
===== Step 2 : 依存パッケージのインストール =====
プロジェクトディレクトリに移動して、依存パッケージをインストールする。 
cd /path/to/opencode-<バージョン>
bun install
 
もし、bun installに失敗する場合は、node-gypをインストールする。 
bun add node-gyp -D
# または
npm install -g node-gyp
 
===== Step 2.5 : OpenCode Desktopの最大化に関する不具合 =====
OpenCode Desktopにおいて、前回終了したウィンドウサイズで起動できるようにする場合は、以下に示すファイルの60行目をコメントアウトする。 
 
vi /path/to/opencode-<バージョン>/packages/desktop/src-tauri/src/windows.rs
 
<syntaxhighlight lang="rust">
// /path/to/opencode-<バージョン>/packages/desktop/src-tauri/src/windows.rsファイル

// 編集前
.maximized(true)

// 編集後
//.maximized(true)
</syntaxhighlight>
 
===== Step 3 : CLIバイナリのビルド (未完了の場合) =====
サイドカーとなるOpenCode CLIバイナリが必要である。 
CLIバイナリのビルド手順を完了していない場合は、OpenCode CLIバイナリをインストールする。 
./packages/opencode/script/build.ts --single
 
下記のエラーが表示される場合がある。
| // relax version requirement
| const expectedBunVersionRange = `^${expectedBunVersion}`
|
| if (!semver.satisfies(process.versions.bun, expectedBunVersionRange)) {
| throw new Error(`This script requires bun@${expectedBunVersionRange}, but you are using bun@${process.versions.bun}`)

error: This script requires bun@^X.X.X, but you are using bun@X.X.X
at /path/to/opencode-X.X.XX/packages/script/src/index.ts:16:13
 
この時、bunをアップデートする。 
bun upgrade
 

===== Step 4 : サイドカーの配置 =====
OpenCode CLIバイナリを、Tauriが期待するサイドカーディレクトリにコピーする。 
mkdir -p packages/desktop/src-tauri/sidecars
cp packages/opencode/dist/opencode-linux-x64/bin/opencode \
packages/desktop/src-tauri/sidecars/opencode-cli-x86_64-unknown-linux-gnu
 
tauri.conf.json ファイル内の <code>externalBin</code> に sidecars/opencode-cli が指定されており、Tauriがターゲットトリプル (<code>x86_64-unknown-linux-gnu</code>) を付与して検索する。 
 
===== Step 5 : フロントエンドのビルド確認 (任意) =====
Viteビルドは、<code>tauri build</code> コマンドの <code>beforeBuildCommand</code> で自動実行されるが、事前に確認する場合は以下に示すコマンドを実行する。 
bun run --cwd packages/desktop build
 
===== Step 6 : Tauriビルドの実行 =====
Tauriビルドを実行する。 
bun run --cwd packages/desktop tauri build
 
上記のコマンドは、以下に示す事柄を実行する。 
* <code>beforeBuildCommand</code> (<code>bun run build</code>) でフロントエンドをビルドする。
* Cargo (Rust) でネイティブバイナリをコンパイルする。
* サイドカー (OpenCode CLIバイナリ) をバンドルに含める。
* deb / rpmパッケージを生成する。
 
Cargo.toml ファイルにgitパッチ依存 (specta、tauri 本体) があるため、ネットワーク接続が必須である。 
 
===== 生成されたファイルの確認 =====
以下に示すディレクトリにファイルが生成される。 
# RPMパッケージ
ls -la packages/desktop/src-tauri/target/release/bundle/rpm/*.rpm

# debパッケージ
ls -la packages/desktop/src-tauri/target/release/bundle/deb/*.deb

# 実行バイナリ (直接実行も可能)
ls -la packages/desktop/src-tauri/target/release/OpenCode
 

==== 動作確認 ====
RPMパッケージをインストールして確認する。 
# RPMパッケージをインストールして確認
sudo zypper install ./packages/desktop/src-tauri/target/release/bundle/rpm/*.rpm

## または

# 実行バイナリを直接起動
./packages/desktop/src-tauri/target/release/OpenCode
 
==== トラブルシューティング ====
<center>
{| class="wikitable"
|+ トラブルシューティング
! 問題 !! 原因 !! 対策
|-
| cargo buildコマンド実行時に、git依存の取得に失敗 || ネットワーク接続なし / プロキシ || Cargo.tomlファイルにgit パッチ依存あり、ネットワーク接続が必須
|-
| opencode-cli-x86_64-unknown-linux-gnu not found || サイドカーが配置されていない || サイドカーの配置手順を実行して、OpenCode CLIバイナリをコピーする。
|-
| 画面が真っ白 / WebView 描画されない || Wayland環境の問題 || 環境変数 <code>OC_ALLOW_WAYLAND=1</code> でWaylandを強制する。
|-
| RPMパッケージが生成されない || tauri.conf.jsonファイルのtargets設定 || deb、rpmが設定されていることを確認する。
|}
</center>
 
===== 特定パッケージ形式のみビルド =====
全形式をビルドする必要がない場合、<code>--bundles</code> フラグで指定できる。 
# RPMのみ
bun run --cwd packages/desktop tauri build --bundles rpm

# debのみ
bun run --cwd packages/desktop tauri build --bundles deb
 
===== デバッグビルド =====
問題の調査が必要な場合、デバッグビルドを実行できる。 
bun run --cwd packages/desktop tauri build --debug
 
デバッグビルドではDevToolsが有効になり、アプリケーション内で右クリック -> [Inspect Element]が利用できる。 
 

== Oh my OpenCode ==
Oh my OpenCodeは、OpenCode用のマルチエージェントオーケストレーションプラグインである。 
フック、MCPサーバ、スキル、専門エージェントを活用してOpenCodeの機能を拡張する。 
 
* GitHubリポジトリ
*: https://github.com/code-yeongyu/oh-my-opencode oh-my-opencode
 
==== 主な機能 ====
Oh my OpenCodeは以下に示す機能を提供する。 
 
<center>
{| class="wikitable"
|+ Oh my OpenCode 機能一覧
! 機能 !! 説明
|-
| ultrawork || 複雑なタスクを専門エージェントに自動分割して並列処理するマジックワード
|-
| フック統合 || ツール実行前後に自動実行されるフック (コード品質チェック、テスト自動実行等)
|-
| MCP統合 || Context7 (ライブラリドキュメント取得)、Sequential Thinking (構造的推論)
|-
| LSP/AST解析 || Language Server ProtocolとAST解析による高精度なコード理解
|-
| スキルシステム || 再利用可能なプロンプトテンプレート 例: <code>/ultra</code>
|}
</center>
 
==== 専門エージェント ====
Oh my OpenCodeは以下の専門エージェントを提供する。 
 
<center>
{| class="wikitable"
|+ 専門エージェント一覧
! エージェント名 !! 役割
|-
| Sisyphus || プランニングと実装を担当するメインエージェント タスク分割、実装、テスト、反復改善を行う。
|-
| Oracle || コードベース全体の調査・分析を担当 プロジェクト構造の把握、依存関係の追跡を行う。
|-
| Frontend Engineer || フロントエンド開発を担当 React / Next.js等のUI実装、アクセシビリティ対応を行う。
|-
| Librarian || ドキュメント管理を担当 README、API仕様書、変更履歴の作成・更新を行う。
|-
| Explorer || 未知のコードベースの探索を担当 新しいプロジェクトの構造理解や技術スタックの調査を行う。
|}
</center>
 
==== インストール ====
インストールの前提条件は以下の通りである。 
 
* OpenCode v1.0.150以上
* Node.js または Bun
 
Oh my OpenCodeをインストールする。 
bunx oh-my-opencode@latest
# または
npx oh-my-opencode@latest
 
非対話モードでインストールする場合は以下のコマンドを実行する。 
bunx oh-my-opencode@latest --non-interactive
 
==== 設定 ====
設定ファイルは以下の場所に配置する。 
 
* プロジェクト単位
*: .opencode/oh-my-opencode.json
* グローバル
*: ~/.config/opencode/oh-my-opencode.json
 
設定ファイルはJSONC (コメント付きJSON) 形式で記述する。 
以下に設定ファイルの例を示す。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"context7": true,
"thinking": true
},
"agents": {
"sisyphus": true,
"oracle": true,
"frontend": true,
"librarian": true,
"explorer": true
},
"hooks": {
"afterEdit": true,
"afterWrite": true
},
"skills": {
"ultra": true
}
}
</syntaxhighlight>
 
下表に、各設定項目の説明を示す。 
 
<center>
{| class="wikitable"
|+ 設定項目一覧
! カテゴリ !! 設定項目 !! 説明
|-
| rowspan="3" | mcpServers || - || MCPサーバの有効 / 無効を設定する。
|-
| context7 || ライブラリドキュメント取得サーバ
|-
| thinking || 構造的推論サーバ
|-
| rowspan="6" | agents || - || 専門エージェントの有効/無効を設定する。
|-
| sisyphus || 個別に制御可能
|-
| oracle || 個別に制御可能
|-
| frontend || 個別に制御可能
|-
| librarian || 個別に制御可能
|-
| explorer || 個別に制御可能
|-
| rowspan="3" | hooks || - || フックの有効 / 無効を設定する。
|-
| afterEdit || ファイル編集後に自動チェックを実行する。
|-
| afterWrite || ファイル作成後に自動チェックを実行する。
|-
| rowspan="2" | skills || - || スキルの有効 / 無効を設定する。
|-
| ultra || ultraworkスキルを有効化する。
|}
</center>
 
==== 使用方法 ====
プロンプトに ultrawork というキーワードを含めるだけで、複雑なタスクを専門エージェントに自動分割して並列処理する。 
 
使用例を以下に示す。 
 
* 大規模リファクタリング
*: <pre>ultrawork このプロジェクトの認証システムをリファクタリングして</pre>
* 新機能実装
*: <pre>ultrawork ユーザ管理機能を実装して</pre>
* ドキュメント調査
*: <pre>ultrawork このコードベースを分析してドキュメントを作成して</pre>
 
==== アンインストール ====
プロジェクト単位の設定ファイルを削除する。 
rm -rf .opencode/agents \
.opencode/hooks \
.opencode/skills \
.opencode/mcp.json \
.opencode/oh-my-opencode.json
 
グローバル設定を削除する。 
rm -rf ~/.config/opencode/oh-my-opencode.json
 
==== 注意事項 ====
Oh my OpenCodeを使用する際は以下の点に注意すること。 
 
* AnthropicモデルのOpenCode対応はコミュニティ主導の取り組みであり、Anthropicの公式サポート対象外である。
* フック機能により外部コマンドが自動実行されるため、設定内容を事前に確認すること。
* MCPサーバはネットワークアクセスを行う場合があるため、セキュリティポリシーに準じて使用すること。
 

== 注意事項 ==
==== プライバシーとデータ取り扱い ====
OpenCodeはオープンソースであり、コードの透明性を確保している。 
* ローカルでの処理を優先、コードの送信は最小限に抑制する。
* 使用するAIプロバイダのプライバシーポリシーを確認すること。
* GitHubリポジトリで実装を検証可能
 
==== 生成コードの検証 ====
AIが生成したコードは必ずレビューして検証する。 
* コードの動作を確認
* セキュリティ上の問題がないか確認
* ライセンス上の問題がないか確認
* コーディング規約に準拠しているか確認
 
==== セキュリティ ====
APIキーやパスワード等の機密情報をコードに含めないように注意する。 
* APIキー、パスワード等の機密情報をコードに含めない。
* 環境変数や設定ファイルで管理する。
* .gitignore ファイルで機密情報を含むファイルを除外する。
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]]

インストール - クリップボード

2026-04-05T07:18:53Z

Wiki: /* RHEL / SUSE */

== 概要 ==
クリップボードは、システム上のクリップボードに保存された全ての履歴を保持するユーティリティやツールのことである。 
 
ここでは、様々なクリップボードマネージャとインストール手順を記載する。 
 

== CopyQ ==
==== CopyQとは ====
CopyQは強力なクリップボードマネージャであり、データの保存、エントリの編集したり、暗号化等をすることができる。 
ここでは、CopyQのインストール方法を記載する。 
 
==== CopyQのインストール ====
===== Windows =====
[https://github.com/hluk/CopyQ/releases CopyQのGithub]にアクセスして、Windows向けのEXEファイルをダウンロードする。
ダウンロードしたファイルをダブルクリックしてインストールする。
 
===== RHEL / SUSE =====
* パッケージ管理システムからインストール
# RHEL
sudo dnf install copyq
 
* ソースコードからインストール
CopyQの依存関係のライブラリをインストールするため、以下のコマンドを実行する。 
# RHEL

## Qt 5を使用する場合
sudo dnf install git cmake extra-cmake-modules gcc-c++ git libXfixes-devel libXtst-devel libSM-devel \
qt5-qtbase-devel qt5-qtdeclarative-devel qt5-qtsvg-devel qt5-qttools-devel qt5-qtwayland-devel qt5-qtx11extras-devel \
libqt5-qtbase-private-headers-devel wayland-devel

## Qt 6を使用する場合
sudo dnf install git cmake extra-cmake-modules ninja-build gcc-c++ \
libSM-devel libXfixes-devel libXtst-devel miniaudio-devel \
kf6-kguiaddons-devel kf6-knotifications-devel kf6-kstatusnotifieritem-devel \
qt6-qtbase-devel qt6-qtbase-private-devel qt6-qtdeclarative-devel qt6-qtsvg-devel \
qt6-qttools-devel qt6-qtwayland-devel qca-qt6-devel qca-qt6-ossl qtkeychain-qt6-devel \
wayland-devel

# SUSE

## Qt 5を使用する場合
sudo zypper install git cmake extra-cmake-modules ninja gcc-c++ \
libXfixes-devel libXtst-devel libSM-devel miniaudio-devel knotifications-devel \
libqt5-qtbase-devel libqt5-qtbase-private-headers-devel libqt5-qtdeclarative-devel libqt5-qtsvg-devel \
libqt5-qttools-devel libqt5-qtwayland-devel libqt5-qtx11extras-devel qca-qt5-devel qtkeychain-qt5-devel \
wayland-devel

## Qt 6を使用する場合
sudo zypper install git cmake extra-cmake-modules ninja gcc-c++ \
libXfixes-devel libXtst-devel libSM-devel miniaudio-devel \
kf6-kguiaddons-devel kf6-knotifications-devel kf6-kstatusnotifieritem-devel \
qt6-base-devel qt6-base-private-devel qt6-declarative-devel qt6-svg-devel qt6-tools-devel qt6-wayland-devel \
qca-qt6-devel qtkeychain-qt6-devel wayland-devel
 
[https://github.com/hluk/CopyQ/releases CopyQのGithub]にアクセスして、CopyQのソースコードをダウンロードする。 
または、<code>git clone</code>コマンドを実行して、CopyQのソースコードをダウンロードする。 
git clone https://github.com/hluk/CopyQ.git
cd CopyQ
 
パッケージマネージャからインストールできるQtのバージョンが古い場合は、 
Qtの公式WebサイトからQtをインストールして、環境変数にQtライブラリのパスを追加する必要がある。 
export PATH="/<Qtのインストールディレクトリ>/<Qtのバージョン>/gcc_64/bin:$PATH"; \
export LD_LIBRARY_PATH="/<Qtのインストールディレクトリ>/<Qtのバージョン>/gcc_64/bin:$LD_LIBRARY_PATH"; \
export PKG_CONFIG_PATH="$PKG_CONFIG_PATH:$(pkg-config --variable pc_path pkg-config)"; \
export PKG_CONFIG_PATH="/<Qtのインストールディレクトリ>/<Qtのバージョン>/gcc_64/lib/pkgconfig:$PKG_CONFIG_PATH"
 
CopyQをビルドおよびインストールする。 
mkdir build && cd build

cmake -DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=<CopyQのインストールディレクトリ> \
-DCMAKE_C_COMPILER=<GCCの実行ファイルのパス> \ # GCCコンパイラを指定する場合
-DCMAKE_CXX_COMPILER=<G++の実行ファイルのパス> \ # G++コンパイラを指定する場合
-DWITH_QT6=ON \ # Qt 6を使用する場合
..

make -j $(nproc)
make install
 
* RPMファイルからインストール (SUSEのみ)
[https://github.com/hluk/CopyQ/releases CopyQのGithub]にアクセスして、SUSE向けのrpmファイルをダウンロードする。 
ダウンロードしたファイルにおいて、以下のコマンドを実行してインストールする。 
sudo zypper install ./copyq_<バージョン>_openSUSE_.*.rpm
 
次に、/<CopyQのインストールディレクトリ>/binディレクトリに、CopyQの起動用のラッパーシェルスクリプトを作成する。 
vi /<CopyQのインストールディレクトリ>/bin/copyq.sh
 
<syntaxhighlight lang="sh">
# /<CopyQのインストールディレクトリ>/bin/copyq.shファイル

#!/usr/bin/env sh

appname="copyq"

# use -f to make the readlink path absolute
dirname="$(dirname -- "$(readlink -f -- "${0}")" )"

if [ "$dirname" = "." ]; then
dirname="$PWD/$dirname"
fi

cd $dirname

# Initialize interpreter path
export LD_LIBRARY_PATH="${dirname}/../lib:$LD_LIBRARY_PATH"
#export LD_LIBRARY_PATH="/<Qtのインストールディレクトリ>/<Qtのバージョン>/gcc_64/lib:$LD_LIBRARY_PATH"

# Run CopyQ binary
"$dirname/$appname" "$@"
</syntaxhighlight>
 
CopyQのデスクトップエントリファイルを作成する。 
vi ~/.local/share/applications/com.github.hluk.copyq.desktop
 
<syntaxhighlight lang="ini">
# ~/.local/share/applications/com.github.hluk.copyq.desktop

[Desktop Entry]
Name=CopyQ
GenericName=Clipboard Manager
Comment=A cut & paste history utility
Exec=/<CopyQのインストールディレクトリ>/bin/copyq.sh --start-server show
Icon=copyq

# Workaround / fix for issue #1526 that prevents a proper autostart of the tray icon in GNOME
X-GNOME-Autostart-Delay=3

# The rest is taken from Klipper application.
Type=Application
GenericName[ja]=クリップボードツール
Comment[ja]=カット＆ペースト履歴ユーティリティ
Categories=Qt;KDE;Utility;
Terminal=false
X-KDE-autostart-after=panel
X-KDE-StartupNotify=false
X-KDE-UniqueApplet=true
</syntaxhighlight>
 
CopyQの自動起動ファイルを作成する。 
vi ~/.config/autostart/copyq.desktop
 
<syntaxhighlight lang="ini">
# ~/.config/autostart/copyq.desktopファイル

[Desktop Entry]
Type=Application
Name=CopyQ (User Build)
GenericName=Clipboard Manager
Comment=A cut & paste history utility
Path=
TryExec=/<CopyQのインストールディレクトリ>/bin/copyq.sh
Exec=QT_SCREEN_SCALE_FACTORS=1 /<CopyQのインストールディレクトリ>/bin/copyq.sh --start-server
Icon=copyq
Categories=Qt;KDE;Office;WordProcessor;
MimeType=
StartupNotify=false
Terminal=false
TerminalOptions=
X-DBUS-ServiceName=
X-DBUS-StartupType=
X-GNOME-Autostart-Delay=3
X-KDE-StartupNotify=false
X-KDE-SubstituteUID=false
X-KDE-UniqueApplet=true
X-KDE-Username=
X-KDE-autostart-after=panel
</syntaxhighlight>
 

==== SELinuxの設定 ====
SELinuxを使用している場合、CopyQ向けにセキュリティの設定を行う必要がある。 
 
まず、ポリシーファイルを作成する。 
sudo ausearch -c 'copyq' --raw | audit2allow -M <ポリシー名例: CopyQ>
例: sudo ausearch -c 'copyq' --raw | audit2allow -M my-copyq
 
次に、SELinuxにCopyQ向けのポリシーパッケージファイルをインストールする。 
sudo semodule -X 300 -i <ポリシーパッケージファイル名例: CopyQ.pp>
例: sudo semodule -X 300 -i my-copyq.pp
 
==== 自動起動の設定 ====
CopyQを使用する前に、自動起動エントリを設定しておくことを推奨する。 
スタートアップエントリを設定することは、クリップボードのデータを常に監視して保存するためには重要である。 
 
CopyQの起動エントリを設定するには様々な方法があるが、ここではターミナルに焦点を当てて記載する。 
 
まず、デスクトップエントリディレクトリに移動する。 
cd /usr/local/share/applications
 
自動起動エントリのディレクトリを作成して、CopyQのデスクトップエントリファイルをそのディレクトリにコピーする。 
cp com.github.hluk.copyq.desktop ~/.config/autostart/
 
デスクトップエントリファイルのパーミッションを変更する。 
chmod u+x ~/.config/autostart/com.github.hluk.copyq.desktop
 

==== CopyQの操作方法 ====
* コピー
*: CopyQには多くの機能があるが、主となるのはクリップボードマネージャである。
*: 使用するには、任意のテキストを選択してコピーすると、自動的にCopyQのエントリーとして保存される。
 
* クリップボードに移動
*: CopyQの古いエントリーをクリップボードに移動する場合は、古いエントリーを選択して[クリップボードに移動]アイコンを押下する。
 
* エントリの暗号化
*: CopyQに保存した機密情報は、暗号化機能を使用すべきである。
*: 暗号化するには、エントリーを選択して[ロック]アイコンを押下する。そうすると、GnuPGが起動して自動的にデータが暗号化される。
*: ※注意
*: 暗号化機能は、GnuPGが必須である。
 
* エントリの作成
*: CopyQの機能には、クリップボードを使用せずにクリップボードの新規項目を作成する機能がある。
*: この機能の使い方は、[新規項目]アイコンを押下して、そこからテキストを書き込み、[保存]アイコンを押下する。
*: すると、CopyQが保存したデータの一覧に、新しいクリップボードエントリが追加される。
 

== GPaste ==
==== GPasteとは ====
GNOMEベースの優れたクリップボードマネージャであるが、様々なデスクトップ環境でも動作する。 
GPasteは、以下のような機能を持っている。 
* GNOMEシェルとの統合
* クリップボードの履歴管理
* クイックアクセスのショートカット
* 画像のコピー
* GTK+3 GUI
 
==== GPasteのインストール ====
* パッケージ管理システムからインストール
*: 以下のコマンドを実行して、GPasteをインストールする。
*: <code>sudo zypper install gpaste gpaste-lang libgpaste11 typelib-1_0-GPaste-1_0 gnome-shell-extension-gpaste</code>
*: 
* ソースコードからインストール
*: GPasteのソースコードをダウンロードする。 
*: <code>git clone https://github.com/Keruspe/GPaste.git GPaste</code>
*: <code>cd GPaste</code>
*: 
*: GPasteのソースコードをビルドしてインストールする。 
*: <code>./autogen.sh</code>
*: 
*: <code>mkdir build && cd build</code>
*: 
*: <code>../configure --sysconfdir=/home/<ユーザ名>/.GPaste --prefix=/home/<ユーザ名>/InstallSoftware/GPaste</code>
*: <code>make -j $(nproc)</code>
*: <code>make install</code>
*: 
*: <code>sudo glib-compile-schemas /usr/share/glib-2.0/schemas/</code>
*: 
** GPasteのアップデート (ソースコードからインストールしている場合のみ)
**: GPasteをアップグレードした場合は、新しい機能を有効化するために、以下のコマンドを実行する。
**: <code>gpaste-client dr aka gpaste-client daemon-reexec</code>
**: 
**: 次に、以下のコマンドを実行して、デーモンが正常に動作していることを確認する。
**: <code>gpaste-client daemon-version</code>
 

== Parcellite ==
==== Parcelliteとは ====
Parcelliteは、Linux向けのGTK+2の基本的な機能を備えたクリップボードマネージャである。 
 
==== Parcelliteのインストール ====
Parcelliteの依存関係のライブラリをインストールする。 
# RHEL
sudo dnf install gtk3

# SUSE
sudo zypper install gtk3
 
[http://parcellite.sourceforge.net/ SourceForge]からソースコードをダウンロードする。 
ダウンロードしたファイルを解凍する。 
tar zxvf parcellite-<バージョン名>.tar.gz
cd parcellite-<バージョン名>
 
Parcelliteのソースコードをコンパイルしてインストールする。 
./configure --prefix=/home/<ユーザ名>/InstallSoftware/Parcellite
make -j 8
make install
 

== Diodon ==
==== Diodonのインストール ====
Diodonのビルドに必要な依存関係のライブラリをインストールする。 
sudo zypper install vala libayatana-appindicator3-devel libpeas-devel zeitgeist-devel xvfb-run wayland-protocols-devel
 
DiodonのGithunからソースコードをダウンロードする。 
git clone https://github.com/diodon-dev/diodon.git
cd diodon
 
Diodonをビルドおよびインストールする。 
/<Python3のインストールディレクトリ>/bin/meson -Dprefix=<Diodonのインストールディレクトリ> builddir
cd builddir
 
アプリケーションインジケータ用のパッケージを提供していないディストリビューションでは、 
builddir作成コマンドを調整することにより、インジケータのビルドを無効化することができる。 
/<Python3のインストールディレクトリ>/bin/meson -Dprefix=<Diodonのインストールディレクトリ> builddir -Ddisable-indicator-plugin=true
cd builddir
 
ninja
ninja test
sudo ninja install
 
Diodonをアンインストールする場合は、上記のソースコードディレクトリ内において、以下のコマンドを実行する。 
sudo ninja uninstall
 
==== Diodonのプラグイン ====
Diodonプラグインを作成する場合は、[http://esite.ch/2011/10/19/writing-a-plugin-for-diodon/ こちらの記事]を参照すること。 
 
下表に、Diodon向けの便利なプラグインを示す。 
<center>
{| class="wikitable" style="background-color:#fefefe;"
|+ プラグインの概要
! style="background-color:#66CCFF;" | プラグイン
! style="background-color:#66CCFF;" | 説明
|-
| [https://github.com/RedHatter/diodon-plugins Features] || Diodonメニューの追加機能
|-
| [https://github.com/RedHatter/diodon-plugins Numbers] || クリップボードのメニュー項目数を表示する。
|-
| [https://github.com/RedHatter/diodon-plugins Pop Item] || アクティブなクリップボード項目を貼り付けてから削除する。
|-
| [https://github.com/RedHatter/diodon-plugins Paste All] || 最近のアイテムを一度に貼り付ける。
|-
| [https://github.com/RedHatter/diodon-plugins Edit] || アクティブなアイテムを編集するように促す。
|}
</center>
 

== Glipper ==
==== Glipperとは ====
Glipperは、GNOME向けのクリップボードマネージャであり、プラグインを使用して機能を拡張することができる。 
クリップボードマネージャの基本的な機能のほとんどを持っている。 
 
==== Glipperのインストール ====
Glipperの依存関係のライブラリをインストールする。 
* Python 2.4以降
* pygtk-2.6以降(モジュール名 : gtk、gtk.gdk、gobject)
* python-keybinder(モジュール名 : keybinder)
* python-distutils-extra(モジュール名 : DistUtilsExtra)
* python-appindicator(モジュール名 : appindicator)
* python-xdg(モジュール名 : xdg.BaseDirectory)
* オプション : python-prctl(モジュール名 : prctl)
* オプション : python-crypto
 
# RHEL
sudo dnf install python2 python3 pygtk python-keybinder python-distutils-extra python-appindicator python-xdg python-prctl python-crypto

# SUSE
sudo zypper install python2 python3 pygtk python-keybinder python-distutils-extra python-appindicator python-xdg python-prctl python-crypto
 
Glipperの[https://launchpad.net/glipper 公式Webサイト]からソースコードをダウンロードする。 
ダウンロードしたファイルを解凍する。 
tar zxvf glipper-<バージョン名>.tar.gz
 
Glipperのソースコードを実行してインストールする。 
sudo python setup.py install
 

== Clipit ==
==== Clipitとは ====
GTK+の軽量で機能が豊富なクリップボードマネージャである。 
Clipitは、Parcelliteからフォークされている。 
 
==== Clipitのインストール ====
Clipitのビルドに必要な依存関係のライブラリをインストールする。 
sudo zypper install gtk2-devel gtk3-devel xdotool-devel intltool automake autoconf autopoint
 
ClipitのGithubから、ソースコードをダウンロードする。 
git clone https://github.com/CristianHenzel/ClipIt.git
 
Clipitのソースコードをビルドおよびインストールする。 
./autogen.sh
./configure --with-gtk3 --prefix=/home/<ユーザ名>/InstallSoftware/Clipit
make -j $(nproc)
make install
 

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Windows10]]

GitHub - SSHの設定

2026-04-01T02:16:25Z

Wiki: ページの作成:「== 概要 == SSH (Secure Shell) は、暗号化された通信を用いてリモートサーバーに安全に接続するためのプロトコルである。 GitHubとの通信方法にはHTTPSとSSHの2種類があり、HTTPSではリポジトリへのプッシュ / プルのたびにユーザ名とPersonal Access Tokenの入力が必要となる。 一方、SSHでは公開鍵認証方式を使用するため、一度鍵を設定すれば以降の認…」

== 概要 ==
SSH (Secure Shell) は、暗号化された通信を用いてリモートサーバーに安全に接続するためのプロトコルである。 
 
GitHubとの通信方法にはHTTPSとSSHの2種類があり、HTTPSではリポジトリへのプッシュ / プルのたびにユーザ名とPersonal Access Tokenの入力が必要となる。 
一方、SSHでは公開鍵認証方式を使用するため、一度鍵を設定すれば以降の認証は自動的に行われる。 
 
Claude CodeやOpenCode等のAIコーディングツールからGitHubリポジトリを操作する場合にも、SSH接続の設定が必要となる。 
 
SSHを使用する主なメリットは以下の通りである。 
* パスワードやトークンの入力が不要
*: 毎回の認証操作が省略されるため、作業効率が向上する。
* 高い安全性
*: 公開鍵認証方式はパスワード認証よりも安全であり、通信内容も暗号化される。
* 利便性
*: 一度設定すれば、以降のgit push / pull / clone等の操作で追加の認証入力は不要である。
* AIコーディングツールとの親和性
*: Claude CodeやOpenCode等のターミナルベースのAIツールは対話的なパスワード入力に対応していない場合があるため、SSH接続が事実上必須となる。
 
SSH接続の仕組みは以下の通りである。 
# ローカルコンピュータでSSH鍵ペア (秘密鍵と公開鍵) を生成する。
# 公開鍵をGitHubアカウントに登録する。
# ローカルからGitHubに接続する際、秘密鍵で署名を生成してGitHubが公開鍵で検証する。
# 検証に成功すると認証が完了して、リポジトリへのアクセスが許可される。
 

== SSHの設定 ==
==== SSH鍵の種類 ====
SSH鍵にはいくつかの暗号アルゴリズムが存在する。 
 
下表に、主なSSH鍵の種類と特徴を示す。 
 
<center>
{| class="wikitable"
|+ SSH鍵の種類
! アルゴリズム !! 鍵長 !! 特徴
|-
| Ed25519 || 256ビット固定 || 現在最も推奨されるアルゴリズム。 高速かつ安全性が高い。GitHubも推奨している。
|-
| RSA || 2048 / 4096ビット || 広く普及しており互換性が高い。 4096ビット以上の使用を推奨する。
|-
| ECDSA || 256 / 384 / 521ビット || 楕円曲線暗号を使用する。 Ed25519が利用できない環境での代替として使用される。
|-
| DSA || 1024ビット || 非推奨。OpenSSH 7.0以降ではデフォルトで無効化されている。
|}
</center>
 
特別な理由がない限り、Ed25519の使用を推奨する。 
 
==== SSH鍵の生成 ====
以下のコマンドを実行して、Ed25519アルゴリズムのSSH鍵ペア (秘密鍵と公開鍵) を生成する。 
 
# Ed25519鍵を生成する (推奨)
ssh-keygen -t ed25519 -C "GitHubに登録しているメールアドレス" -f ~/.ssh/id_ed25519_github

# Ed25519が使用できない環境の場合はRSA 4096ビットを使用する
ssh-keygen -t rsa -b 4096 -C "GitHubに登録しているメールアドレス" -f ~/.ssh/id_rsa_github
 
コマンド実行時のオプションの詳細は以下の通りである。 
* <code>-t ed25519</code>
*: 鍵の種類を指定する。
* <code>-C "メールアドレス"</code>
*: コメントを設定する。一般的にメールアドレスを指定する。
* <code>-f ~/.ssh/id_ed25519_github</code>
*: 鍵ファイルの保存先とファイル名を指定する。
 
コマンド実行後にパスフレーズの入力を求められる。 
 
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
 
パスフレーズを設定すると、鍵の使用時にパスフレーズの入力が必要になる。 
セキュリティの観点からパスフレーズの設定を推奨するが、空欄のまま[Enter]キーを押下して省略することも可能である。 
 
鍵の生成が完了すると、以下に示す2つのファイルが作成される。 
* ~/.ssh/id_ed25519_github
*: 秘密鍵。絶対に他者と共有してはならない。
* ~/.ssh/id_ed25519_github.pub
*: 公開鍵。GitHubに登録するファイル。
 
==== SSH Agentの設定 ====
SSH Agentは秘密鍵をメモリ上に保持して、SSH接続時に自動的に鍵を提供するデーモンである。 
パスフレーズを設定した場合、SSH Agentを使用することで毎回のパスフレーズ入力を省略できる。 
 
# SSH Agentをバックグラウンドで起動する
eval "$(ssh-agent -s)"

# 秘密鍵をSSH Agentに追加する
ssh-add ~/.ssh/id_ed25519_github
 
パスフレーズを設定している場合は、<code>ssh-add</code>コマンドの実行時に1度だけパスフレーズの入力を求められる。 
 
SSH Agentの起動をシェルのログイン時に自動化する場合は、シェルの設定ファイルに以下を追記する。 
 
<syntaxhighlight lang="sh">
# Bashの場合

# SSH Agent
if [ -z "$SSH_AUTH_SOCK" ]
then
eval "$(ssh-agent -s)" > /dev/null 2>&1
ssh-add ~/.ssh/id_ed25519_github > /dev/null 2>&1
fi
</syntaxhighlight>
 
<syntaxhighlight lang="fish">
# Fishの場合

# SSH Agent
if not set -q SSH_AUTH_SOCK
eval (ssh-agent -c) > /dev/null 2>&1
ssh-add ~/.ssh/id_ed25519_github > /dev/null 2>&1
end
</syntaxhighlight>
 
==== SSH configの設定 ====
~/.ssh/config ファイルにGitHub用の設定を追記する。 
この設定により、GitHub接続時に使用する鍵ファイルが自動的に選択される。 
 
Host github.com
HostName github.com
User git
IdentityFile ~/.ssh/id_ed25519_github
AddKeysToAgent yes
 
各設定項目の詳細は以下の通りである。 
 
<center>
{| class="wikitable"
|+ SSH config設定項目
! 項目 !! 説明
|-
| Host || 接続先のエイリアス名 github.com を指定する。
|-
| HostName || 実際の接続先ホスト名 github.com を指定する。
|-
| User || 接続ユーザ名 GitHubでは常に git を指定する。
|-
| IdentityFile || 使用する秘密鍵のパス
|-
| AddKeysToAgent || <code>yes</code> を指定すると、初回接続時に自動的にSSH Agentに鍵が追加される。
|}
</center>
 
複数のGitHubアカウントを使い分ける場合は、以下に示すようにHostを別名にして設定する。 
 
# メインアカウント
Host github.com
HostName github.com
User git
IdentityFile ~/.ssh/id_ed25519_github_main

# サブアカウント
Host github-sub
HostName github.com
User git
IdentityFile ~/.ssh/id_ed25519_github_sub
 
サブアカウントのリポジトリをクローンする場合は、以下に示すように指定する。 
 
git clone git@github-sub:<ユーザ名>/<リポジトリ名>.git
 
==== 公開鍵のGitHubへの登録 ====
生成した公開鍵をGitHubアカウントに登録する。 
 
まず、公開鍵の内容をクリップボードにコピーする。 
 
# 公開鍵の内容を表示する
cat ~/.ssh/id_ed25519_github.pub
 
# 表示例
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI... user@example.com
 
表示された文字列を全てコピーして、以下の手順でGitHubに登録する。 
 
# GitHubにログインする。
# 右上のプロフィールアイコンを選択して、[Settings]を選択する。
# 左メニューの[Access]セクションにある[SSH and GPG keys]を選択する。
# [New SSH key]ボタンを押下する。
# 以下の項目を入力する。
#* Title
#*: 鍵の識別名を入力する。
#*: 例: SUSE-PC
#* Key type
#*: Authentication Key を選択する。(デフォルト)
#* Key
#*: コピーした公開鍵を貼り付ける。
# [Add SSH key]ボタンを押下する。
# GitHubのパスワード入力を求められた場合は、入力して認証する。
 
GitHub CLIを使用して登録する場合は、以下に示すコマンドを実行する。 
 
gh ssh-key add ~/.ssh/id_ed25519_github.pub --title "SUSE-PC"
 
==== 接続テスト ====
SSH鍵の登録が完了した後、GitHubとのSSH接続が正常に動作するかテストする。 
 
ssh -T git@github.com
 
初回接続時は、以下のようにホスト鍵の確認を求められるため<code>yes</code>と入力する。 
 
The authenticity of host 'github.com (20.27.177.113)' can't be established.
ED25519 key fingerprint is SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
 
接続に成功すると、以下のメッセージが表示される。 
 
Hi <ユーザ名>! You've successfully authenticated, but GitHub does not provide shell access.
 
上記のメッセージが表示されれば、SSHの設定は完了である。 
 
接続に失敗した場合は、以下のコマンドを実行して詳細なデバッグ情報を確認する。 
 
ssh -vT git@github.com
 
==== 既存リポジトリのリモートURLをSSHに変更 ====
既にHTTPSでクローンしたリポジトリをSSH接続に切り替える場合は、リモートURLを変更する。 
 
# 現在のリモートURLを確認する
git remote -v

# リモートURLをSSHに変更する
git remote set-url origin git@github.com:<ユーザ名>/<リポジトリ名>.git

# 変更後のリモートURLを確認する
git remote -v
 
==== SSH鍵のセキュリティに関する注意事項 ====
SSH鍵を安全に運用するために、以下に示す事柄に留意する必要がある。 
 
<center>
{| class="wikitable"
|+ SSH鍵のセキュリティ対策
! 項目 !! 説明
|-
| 秘密鍵の権限設定 || 秘密鍵ファイルのパーミッションは<code>600</code> (所有者のみ読み書き可) に設定する。 <code>chmod 600 ~/.ssh/id_ed25519_github</code>
|-
| 秘密鍵の共有禁止 || 秘密鍵は絶対に他者と共有してはならない。共有するのは公開鍵 (<code>.pub</code>) のみである。
|-
| パスフレーズの設定 || 秘密鍵にはパスフレーズを設定することを推奨する。 万が一秘密鍵ファイルが漏洩した場合のリスクを軽減する。
|-
| 鍵のローテーション || 定期的に新しい鍵ペアを生成して、古い鍵をGitHubから削除することを推奨する。
|-
| 不要な鍵の削除 || 使用しなくなったデバイスの鍵は、GitHubの[SSH and GPG keys]設定ページから速やかに削除する。
|}
</center>
 
==== トラブルシューティング ====
下表に、SSH接続に関する一般的な問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ SSHトラブルシューティング
! 症状 !! 原因 !! 対処法
|-
| Permission denied (publickey) || 公開鍵がGitHubに登録されていない、 または秘密鍵のパスが正しくない || <code>ssh-add -l</code>で登録済みの鍵を確認する。 SSH configのIdentityFileパスを確認する。 GitHubに公開鍵が正しく登録されているか確認する。
|-
| Could not open a connection to your authentication agent || SSH Agentが起動していない || <code>eval "$(ssh-agent -s)"</code>を実行してSSH Agentを起動する。
|-
| WARNING: UNPROTECTED PRIVATE KEY FILE! || 秘密鍵ファイルのパーミッションが緩すぎる || <code>chmod 600 ~/.ssh/id_ed25519_github</code>を実行する。
|-
| Connection timed out || ファイアウォール等でSSHポート (22) がブロックされている || HTTPS経由のSSH接続 (ポート443) を試行する。 SSH configに以下を設定する。 <code>Host github.com</code> <code>  HostName ssh.github.com</code> <code>  Port 443</code>
|}
</center>
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric
Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry
Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open
SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:Git]]

Raspberry Piの初期設定

2026-03-25T13:04:50Z

Wiki: /* ソフトウェアの自動起動 */

== Raspbianのダウンロード ==
以下のWebサイトにアクセスして、任意のRaspbian OSのzipファイルまたはtorrentファイルをダウンロードする。(torrentを使用することを推奨する) 
* Raspberry Pi 公式Webサイト
*: https://www.raspberrypi.com/software/operating-systems/
* ミラーサイト(JAIST)
*: http://ftp.jaist.ac.jp/pub/raspberrypi/
 
ダウンロードしたRaspbian OSのzipファイルは解凍せずに、balenaEtcher等を使用してSDカードに書き込む。 
 

== RaspberryPi Imagerを使用してインストール ==
==== RaspberryPi Imagerとは ====
RaspberryPi Imagerは、Raspberry Pi OSや他OSをmicroSDカードにインストールして、Raspberry Piで使用できるようにするためソフトウェアである。 
RaspberryPi ImagerをPCにインストールした後、Raspberry Piで使用するSDカードをPCに挿入して、Raspberry Pi Imagerを起動する。 
 
==== RaspberryPi Imagerのインストール ====
RaspberryPi Imagerのビルドに必要なライブラリをインストールする。 
sudo zypper install libarchive-devel libcurl-devel zlib-devel libgnutls-devel \

# Qt 5を使用する場合
libqt5-qtbase-common-devel libQt5Widgets-devel libQt5DBus-devel libQt5Concurrent-devel \
libqt5-qtsvg-devel libQt5QuickControls2-devel libqt5-linguist-devel

# Qt 6を使用する場合
qt6-base-devel qt6-base-common-devel qt6-core-devel qt6-dbus-devel qt6-concurrent-devel \
qt6-svg-devel qt6-quick-devel qt6-quickcontrols2-devel qt6-linguist-devel
 
[https://github.com/raspberrypi/rpi-imager/releases/ RaspberryPi ImagerのGithub]にアクセスして、RaspberryPi Imagerのソースコードをダウンロードする。 
ダウンロードしたファイルを解凍する。 
tar xf rpi-imager-<バージョン>.tar.gz
cd rpi-imager-<バージョン>
 
または、<code>git clone</code>コマンドを使用して、RaspberryPi Imagerのソースコードをダウンロードする。 
git clone --depth 1 https://github.com/raspberrypi/rpi-imager.git
cd rpi-imager
 
ビルドディレクトリを作成する。 
mkdir build && cd build
 
RaspberryPi Imagerをビルドおよびインストールする。 
cmake -DCMAKE_C_COMPILER=<GCC 8以降のgcc> -DCMAKE_CXX_COMPILER=<G++ 8以降のg++> \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=<RaspberryPi Imagerのインストールディレクトリ> \
-DENABLE_TELEMETRY=OFF \
../src

make -j $(nproc)
make install
 
RaspberryPi Imagerのデスクトップエントリファイルを作成する。 
vi ~/.local/applications/RaspberryPi_Imager.desktop
 
<syntaxhighlight lang="ini">
# ~/.local/applications/RaspberryPi_Imager.desktopファイル

[Desktop Entry]
Type=Application
Version=1.0
Name=Raspberry Pi Imager
Comment=Raspberry Pi Imager
Exec=/<RaspberryPi Imagerのインストールディレクトリ>/bin/rpi-imager --disable-telemetry
Icon=/<RaspberryPi Imagerのインストールディレクトリ>/share/icons/hicolor/128x128/apps/rpi-imager.png
Categories=Utility
StartupNotify=false
</syntaxhighlight>
 

==== テレメトリの無効化 ====
標準のRaspberry Piイメージを使用する場合、 
ソフトウェアの使用状況（Raspberry Pi Imagerのバージョンの普及状況、どのイメージとOSが最も人気があるか等）を把握するため、 
選択したイメージのURL、OS名、カテゴリ、Raspberry Pi Imagerの実行バージョン、使用しているOS、CPUアーキテクチャ、ロケール、Raspberry Piリビジョンを、 
https://rpi-imager-stats.raspberrypi.com へ送信している。 
 
このサービスは、Herokuによってホストされており、eu-west-1地域における1日あたりの各URL、OS名、カテゴリについて、Redis Sorted Setを使用して増分するカウンターを保存している。 
ただし、これらのカウントに個人データを関連付けることはない。 
これにより、時間の経過と共にダウンロード数を照会のみを行っている。 
 
Linuxでは、<code>rpi-imager --disable-telemetry</code>を実行する、または、~/.config/Raspberry Pi/Imager.confファイルに以下に示す内容を追記する。 
# ~/.config/Raspberry Pi/Imager.confファイル

[General]
telemetry=false
 

==== RaspberryPi Imagerの設定 ====
RaspberryPi Imagerの使用時において、[Ctrl] + [Shift] + [X]キーを同時押下することにより、詳細オプションダイアログを表示する。 
 
これは、Raspberry Piのブート設定ファイルで設定するいくつかの事柄を指定することができる。 
例えば、SSHの有効化および無効化、Wi-Fiの設定、ロケールの設定を行うことができる。 
 

== Raspbianの設定 ==
まず、Raspbianを最新の状態にするため、以下のコマンドを実行する。 
sudo apt update
sudo apt upgrade
 

== キーボードの設定 ==
設定用アプリケーションの[Localisation]タブの[Set Keyboard]ボタンを押下する。 
表示されたウインドウにある[Country]を[Japan]に、[Variant]を[Japanese(OADG 109A)]に設定する。 
 

== タイムゾーンの設定 ==
設定用アプリケーションの[Localisation]タブの[Set Timezone]ボタンを押下する。 
表示されたウインドウにある[Area]を[Asia]に、[Location]を[Tokyo]に設定する。 
 

== IPアドレスの設定 ==
==== GUIで設定する ====
まず、デスクトップ画面右上のネットワークアイコンを右クリックして、[Wireless & Wired Network Settings]を選択する。 
[Network Preferences]が開くので、[Interface]プルダウンを選択して、有線LANの場合は[eth0]、Wi-Fiの場合は[wlan0]を選択する。 
 
次に、以下のネットワークの設定を行う。 
* IPアドレス
*: <IPアドレス>/<サブネットマスク例. 24>
* Router
*: <ゲートウェイのIPアドレス>
* DNS
*: <DNSサーバのIPアドレス>
 
最後に、[適用]ボタンを押下する。 
 
==== CUIで設定する (推奨) ====
===== Raspberry Pi OS Bookwormの場合 =====
sudo vi '/etc/NetworkManager/system-connections/Wired connection 1.nmconnection'
 
<syntaxhighlight lang="ini">
# /etc/NetworkManager/system-connections/Wired connection 1.nmconnectionファイル

[connection]
type=ethernet
id=Wired connection 1
uuid=xxxx-xxxx-xxxx-xxxx-xxxx
autoconnect=true
interface-name=eth0
timestamp=1732023900

[ethernet]

[ipv4]
address1=<Raspberry PiのIPアドレス例: 192.168.0.100>/<サブネットマスク例: 24>,<デフォルトゲートウェイ例: 192.168.0.1> # 任意の値
dns=<DNSのアドレス例: 192.168.0.1>; # 任意の値
method=manual

[ipv6]
addr-gen-mode=stable-privacy
#method=auto
method=disabled # IPv6を無効化する場合

[proxy]
</syntaxhighlight>
 
===== Raspberry Pi OS Bullseyeの場合 =====
まず、/etc/dhcpcd.confファイルの最下行に、以下の設定を追記する。 
sudo vi /etc/dhcpcd.conf
 
# /etc/dhcpcd.confファイル

interface <eth0 または wlan0>
static ip_address=<IPアドレス>/<サブネットマスク例. 24>
static routers=<ゲートウェイのIPアドレス>
static domain_name_servers=<DNSのIPアドレス>
noipv6 # IPv6を使用しない場合
 
上記の設定を有効にする。 
sudo systemctl restart networking
sudo systemctl restart dhcpcd
 
PCを再起動する。 
 
静的IPアドレスに設定できているかどうかを確認する。<bt>
ip a
 
もし、静的IPアドレスが設定できない場合、dhcpcdデーモンの状態を確認する。 
sudo systemctl status dhcpcd
 
以下に示すようなメッセージが出力されている場合は、静的IPアドレスが他の端末と衝突しているため、別の静的IPアドレスの値を設定する必要がある。 
〜 dhcpcd 〜: eth0: hardware address <MACアドレス> claims <上記で設定した静的IPアドレス>
〜 dhcpcd 〜: eth0: DAD detected <上記で設定した静的IPアドレス>
 

== 日本語フォントのインストールと言語の変更 ==
日本語フォントをインストールするために、以下のコマンドを実行する。 
sudo apt install fonts-noto-cjk fonts-vlgothic
 
インストール完了後、GUI環境で日本語を表示するために言語の変更を行う。 
設定用アプリケーションの[Localisation]タブの[Set Locale]ボタンを押下する。 
表示されたウインドウにある[Language]を[JP(Japan)]に、[Character Set]を[UTF-8]に設定する。 
設定後、再起動が促されるのでYesボタンを押下して再起動する。 
 
上記だけでなく、以下のフォントも使用可能である。 
sudo apt install ttf-kochi-gothic ttf-kochi-mincho fonts-takao fonts-vlgothic fonts-ipafont xfonts-intl-japanese xfonts-intl-japanese-big xfonts-kaname
 

== 日本語入力ソフトウェアのインストール ==
日本語入力ソフトウェアは2種類存在するのでどちらか一方を選択する。 
 
==== Bullseye以降のRaspberry Pi OS ====
Mozcをインストールするため、以下のコマンドを実行する。 
sudo apt install ibus-mozc
または
sudo apt install fcitx5-mozc
 
Fcitx5-mozcをインストールした場合、以下の設定を行う。 
QT_QPA_PLATFORM=wayland fcitx5-configtool
 
sudo vi /etc/environment
# または
vi ~/.xprofile
 
<syntaxhighlight lang="sh">
# ~/.xprofileファイル

INPUT_METHOD=fcitx5
XMODIFIERS=@im=fcitx5
GTK_IM_MODULE=fcitx5
QT_IM_MODULE=fcitx5

fcitx5 &
</syntaxhighlight>
 
インストール完了後、Raspberry Piを再起動する。 
[半角 / 全角]キー等で日本語入力の切り替えができることを確認する。 
 

==== Mozcをインストールする場合 (NOOBS 1.4.2以降のRaspbian) ====
Mozcをインストールするため、以下のコマンドを実行する。 
sudo apt install ibus-mozc
または
sudo apt install fcitx-mozc
 
インストール完了後、Raspberry Piを再起動する。 
[半角 / 全角]キーで日本語入力の切り替えができることを確認する。 
 
Fcitx-mozcをインストールした場合、以下の設定を行う。 
# デスクトップ画面左上からのメニューアイコンから、[設定] - [Fcitx設定]を選択する。
# [入力メソッドの設定]画面が開くので、画面左下にある[+]ボタンを押下する。
# [入力メソッドの追加]画面が開くので、[キーボード - 日本語 - 日本語(OADG 109A)]を選択する。
# [入力メソッドの設定]画面に戻ると、選択したキーボードが最も下に表示されるので、[↑]ボタンを押下して最も上に移動する。 もし、選択したものと異なるキーボードが表示されている場合は、そのキーボードを選択した状態で[-]ボタンを押下する。
# [入力メソッドの設定]画面の[全体の設定]タブを選択して、[入力メソッドのオンオフ]項目が[Zenkakuhankaku]に設定されていることを確認する。
# [入力メソッドの設定]画面の[外観]タブを選択して、[状態パネルを隠すモード]項目のプルダウンから[表示]を選択する。
# [入力メソッドの設定]画面右上の[x]ボタンを押下する。
 
===== UIMをインストールする場合(NOOBS 1.4.1までのRaspbian推奨) =====
wheezyをインストールするため、以下のコマンドを実行する。 
sudo apt install uim uim-anthy xfonts-kaname
 
インストール完了後、Raspbianを再起動する。 
[半角／全角]キーまたは[Shift][Space]キーを同時押下することで日本語入力のオンオフを切り替えることができる。 
 

== ランレベルの変更 ==
デスクトップ画面左上のアイコンから、[設定] - [Raspberry Piの設定]を選択する。 
[System]タブ - [ブート]項目から、[デスクトップ]または[CLI]を選択して、[自動ログイン]のチェックを外す。 
[OK]ボタンを押下する。 
 
Raspberry Piを再起動すると、CLIまたはGUIでRaspberry Piが起動する。 
 
※注意 
リモートデスクトップ接続する場合は、[デスクトップ]を選択すること。 
 

== ファイヤーウォールの設定 ==
firewalldのインストールを行う。 
sudo apt install firewalld
 
正常にインストールできたかどうか確認する。 
Active: active (running)と表示されていれば正常に起動している。 
sudo systemctl status firewalld
 
ファイヤーウォールを自動で起動するには以下のコマンドを入力する。 
sudo systemctl enable firewalld
 
ファイヤーウォールの設定を確認するには以下のコマンドを入力する。 
firewall-cmd --list-all
 
ファイヤーウォールのポートを開放するには以下のコマンドを入力する。 
下記は、SSHやHTTPのポートを開放する例である。 
sudo firewall-cmd --permanent --zone=public --add-port=ssh // SSHを開放
sudo firewall-cmd --permanent --zone=public --add-port=http // HTTPを開放
sudo firewall-cmd --permanent --zone=public --add-port=22/tcp // TCPポート22番を開放
sudo firewall-cmd --permanent --zone=public --add-port=80/tcp // TCPポート80番を開放
 
また、ファイヤーウォールのポートを閉じるには以下のコマンドを入力する。 
下記は、SSHやHTTPのポートを閉じる例である。 
sudo firewall-cmd --permanent --zone=public --remove-service=ssh
sudo firewall-cmd --permanent --zone=public --remove-service=http
 
以下のコマンドでは、publicゾーンの設定をWi-Fiのインターフェース(インターフェース名 : wlan0)に割り当てる。 
sudo firewall-cmd --permanent --zone=public --change-interface=wlan0
 
最後に、設定を反映させるため以下のコマンドを入力する。 
successと表示されていれば成功である。 
sudo firewall-cmd --reload
 

== Wi-Fiの無効化 ==
Wi-Fiを無効にする場合、以下のコマンドを実行する。 
Raspberry Piを再起動することにより、設定が有効になる。 
sudo iwconfig wlan0 txpower off
 
再度、Wi-Fiを有効にする場合は、以下のコマンドを実行して再起動する。 
sudo iwconfig wlan0 txpower on
または
sudo iwconfig wlan0 txpower auto
 

== debパッケージのインストールとアンインストール ==
* debファイルのみをインストールする。
*: <code>sudo deb -i <パッケージ名>.deb</code> または <code>sudo dpkg -i <パッケージ名>.deb</code>
* 依存関係のパッケージも含めてインストールする
*: <code>sudo gdebi <パッケージ名>.deb</code>
* 依存関係を無視してインストールする。
*: <code>sudo dpkg -i --force-depends <パッケージ名>.deb</code>
* debパッケージがインストールされているか確認する。
*: <code>sudo dpkg --list <パッケージ名></code>
* debパッケージをアンインストールする。
*: <code>sudo dpkg -r <パッケージ名></code>
*: <code>sudo dpkg -purge <パッケージ名> # 設定ファイルも含めて削除する場合</code>
*: また、アンインストール時に依存関係により問題が生じる場合、<code>--force-depends</code>オプションを付加することで強制的に削除することができる。
*: <code>sudo dpkg -r --force-depends <パッケージ名></code>
* インストールされたパッケージの情報を確認する。
*: <code>sudo dpkg -s <パッケージ名></code>
* debパッケージの情報を確認する。
*: <code>sudo dpkg -I <パッケージ名>.deb</code>
 
* <code>dpkg-reconfigure</code>コマンドを使用すると、既にインストールされたdebパッケージの状態を再設定できる。 設定の初期化等も可能である。
*: <code>sudo dpkg-reconfigure <パッケージ名></code>
*: また、<code>--force</code>オプションを付加する場合、設定ファイルが破損している場合でも強制実行することができる。
*: <code>sudo dpkg-reconfigure --force <パッケージ名></code>
 
* その他のオプション
** インストールを行わずに、確認のみを行う。
**: <code>--no-act</code>
** システムにインストール済みのパッケージが新しい場合は、インストールしない。
**: <code>-G</code>
** 同バージョンがインストール済みの場合は、再インストールしない。
**: <code>-E</code>
 

== Bluetoothの無効化 ==
オンボードのBluetoothおよび関連サービスを無効にする。 
これらの手順は、Raspberry Piの起動時にbluetooth、hci_uart、btbcm等の関連カーネルモジュールのロードも無効化する。 
 
Raspberry Pi 3B、3B+、3A+、4B、Zero Wにおいて、オンボードのBluetoothを無効化する。 
また、GPIO 14(pin 8)とGPIO 15(pin10)上のUART0 / ttyAMA0を復元する。 
 
N.B.モデムを初期化するsystemdサービスを無効にしてUARTを使用しないようにするには、<code>sudo systemctl disable hciuart</code>を使用する。 
sudo vi /boot/config.txt
 
# /boot/config.txtファイル

# Disable Bluetooth
dtoverlay=disable-bt
 
Bluetoothのデーモンを無効化する。 
sudo systemctl disable hciuart.service
sudo systemctl disable bluealsa.service
sudo systemctl disable bluetooth.service
 
Raspberry Piを再起動する。 
sudo systemctl reboot
 
ただし、オンボードのBluetoothおよび関連サービスを無効にしても、外付けのBluetoothアダプタを接続する場合、Bluetoothは利用できる。 
もし、Bluetoothが不要な場合は、Bluetoothスタックをアンインストールする。 
これにより、外付けのBluetoothアダプタも利用できなくなる。 
sudo apt purge bluez
sudo apt autoremove
 

== ソフトウェアの自動起動 ==
==== autostartファイルについて ====
ソフトウェアのパスの前に<code>@</code>が記述されていることがある。 
<code>@</code>は、指定されたソフトウェアがクラッシュした場合、再起動するようLXDEに指示するものである。 
したがって、<code>@</code>を付加することにより、ソフトウェアが予期せず終了した場合でも自動的に再起動されるようになる。 
 
<code>@</code>を付加せずにソフトウェアを指定する場合、そのソフトウェアはシステムの起動時に1度だけ実行される。 
 
==== システム全体に設定する場合 ====
/etc/xdg/lxsession/LXDE-pi/autostartファイルに自動起動するソフトウェアのパスを記述する。 
echo "@<ソフトウェアのパス> [オプション]" >> /etc/xdg/lxsession/LXDE-pi/autostart
 

==== 各ユーザに設定する場合 ====
まず、/etc/xdg/lxsession/LXDE-pi/autostartファイルを~/.config/lxsession/LXDE-piにコピーする。 
mkdir -p ~/.config/lxsession/LXDE-pi
cp /etc/xdg/lxsession/LXDE-pi/autostart ~/.config/lxsession/LXDE-pi/
 
次に、コピーした~/.config/lxsession/LXDE-pi/autostartファイルに自動起動するソフトウェアのパスを記述する。 
echo "@<ソフトウェアのパス> [オプション]" >> ~/.config/lxsession/LXDE-pi/autostart
 
※注意 
~/.config/lxsession/LXDE-pi/autostart ファイルを作成する時、/etc/xdg/lxsession/LXDE-pi/autostart が完全に上書きされる。 
そのため、~/.config/lxsession/LXDE-pi/autostart ファイルを作成してカスタム項目を追加する場合は、必ずデフォルトの内容をコピーしてから編集すること。 
 

== その他の設定 ==
デスクトップ画面左上から、[設定] - [Raspberry Piの設定]を選択する。 
[System]タブ - [スプラッシュ画面:]項目を[無効]にする。 
 
これは、起動時に何か問題が発生した場合、様々なエラーを表示できるからである。 
 

__FORCETOC__
[[Category:Raspberry_Pi]]

MCPサーバ - Filesystem

2026-03-25T09:57:53Z

Wiki: /* プロジェクトルートのみ参照する場合 */

== 概要 ==
Filesystem MCP Server (@modelcontextprotocol/server-filesystem) は、AnthropicがNode.jsで実装したMCPサーバである。 
MITライセンスで公開されている。 
 
Model Context Protocol (MCP) を通じて、AIアシスタントにローカルファイルシステムへの安全で制御されたアクセスを提供する。 
起動時に許可するディレクトリを明示的に指定することで、AIアシスタントはそのディレクトリ内に限定したファイル操作を実行できる。 
 
Claude Desktop、Claude Code、VS Code、Cursor等の主要なMCPクライアントに対応している。 
Windows、MacOS、Linuxに対応する。 
 
主な特徴は以下の通りである。 
* 14個のファイル操作ツールを提供 (読み取り、書き込み、ディレクトリ管理、検索等)
* 指定ディレクトリ外へのアクセスをブロックするパストラバーサル防止機能
* Dockerイメージ (mcp/filesystem) による実行にも対応
* Rootsプロトコルによる実行時のディレクトリ動的更新
* Dockerの <code>:ro</code> フラグを使用した読み取り専用アクセスの設定が可能
 

== 動作要件 ==
==== 前提条件 ====
Filesystem MCP Serverを使用するために必要な前提条件を以下に示す。 
 
* Node.js v18.0.0以上
*: <code>npx</code> コマンドを使用してFilesystem MCP Serverを実行するために必要
* <code>npx</code> コマンド
*: Node.jsに同梱されているため、Node.jsのインストールで利用可能になる。
* Docker (オプション)
*: Dockerを使用してFilesystem MCP Serverを実行する場合に必要
 

== インストール ==
==== npxを使用した実行 ====
<code>npx</code> コマンドを使用する場合、インストール不要でFilesystem MCP Serverを直接実行できる。 
アクセスを許可するディレクトリへの絶対パスをコマンドライン引数で指定する (複数指定可能)。 
 
npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory1 /path/to/allowed/directory2
 
MCPクライアントの設定ファイルで指定する場合は、後述の各クライアント設定を参照すること。 
 
==== Dockerを使用した実行 ====
Docker Hubに公式イメージ (mcp/filesystem) が公開されており、Node.jsをインストールせずにFilesystem MCP Serverを実行できる。 
 
以下に示すコマンドを実行することにより、ローカルディレクトリをコンテナ内の <code>/projects</code> にマウントしてサーバを起動する。 
<code>:ro</code> フラグを付与することで、読み取り専用アクセスとなる。 
 
docker run -i --rm -v /path/to/local/directory:/projects:ro mcp/filesystem
 
書き込みアクセスを許可する場合は、<code>:ro</code> フラグを省略する。 
 
docker run -i --rm -v /path/to/local/directory:/projects mcp/filesystem
 

== MCPクライアントの設定 ==
==== 設定ファイルの場所 ====
各MCPクライアントの設定ファイルの場所は以下の通りである。 
 
Claude Desktopの設定ファイルを以下に示す。 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* MacOS
*: ~/Library/Application Support/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
Claude Codeの設定ファイルを以下に示す。 
* ローカルスコープ
*: .mcp.json (プロジェクトルート) : <code>claude mcp add</code> コマンドで生成される。
* ユーザスコープ
*: ~/.claude.json (ホームディレクトリ)
 
VS Codeの設定ファイルを以下に示す。 
* .vscode/mcp.json (プロジェクトルート)
 
Cursorの設定ファイルを以下に示す。 
* グローバル設定
*: ~/.cursor/mcp.json
* プロジェクト設定
*: .cursor/mcp.json
 
==== Claude Desktopの設定 ====
claude_desktop_config.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory1", "/path/to/allowed/directory2"]
}
}
}
</syntaxhighlight>
 
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。 
 
==== Claude Codeの設定 ====
Claude Codeでは、<code>claude mcp add</code> コマンドを使用してFilesystem MCP Serverを追加できる。 
 
以下に示すコマンドで、MCPサーバをClaude Codeに登録する。 
 
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory
 
プロジェクトスコープで設定する場合は、<code>--scope project</code> オプションを追加する。 
設定は、.mcp.json ファイルに保存される。 
 
claude mcp add --scope project filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory
 
上記コマンドにより生成される .mcp.json ファイルの内容を以下に示す。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
}
}
}
</syntaxhighlight>
 
==== OpenCodeの設定 ====
OpenCodeでは、プロジェクトルートまたはグローバル設定の opencode.json ファイルにMCPサーバを定義する。 
 
設定ファイルの読み込み優先順位は以下の通りである。(後の設定が前の設定にマージされる) 
* グローバル設定
*: ~/.config/opencode/opencode.json
* プロジェクト設定
*: プロジェクトルートの opencode.json
 
opencode.json ファイルに以下の内容を記述して、Filesystem MCP Serverを登録する。 
 
<syntaxhighlight lang="json">
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"filesystem": {
"type": "local",
"command": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"],
"enabled": true
}
}
}
</syntaxhighlight>
 
複数のディレクトリへのアクセスを許可する場合は、<code>command</code> 配列にディレクトリパスを追加する。 
 
<syntaxhighlight lang="json">
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"filesystem": {
"type": "local",
"command": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir1", "/path/to/dir2"],
"enabled": true
}
}
}
</syntaxhighlight>
 
MCPサーバを一時的に無効にする場合は、<code>enabled</code> を <code>false</code> に設定する。 
 

==== VS Codeの設定 ====
.vscode/mcp.json ファイルに以下に示す内容を設定する。 
変数 <code>${workspaceFolder}</code> を使用することにより、ワークスペースのルートディレクトリを自動的に許可対象に指定できる。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "${workspaceFolder}"]
}
}
}
</syntaxhighlight>
 
==== Cursorの設定 ====
~/.cursor/mcp.json (グローバル設定) または .cursor/mcp.json (プロジェクト設定) ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
}
}
}
</syntaxhighlight>
 
==== プロジェクトルートのみ参照する場合 ====
.mcp.json / opencode.jsonファイルがあるディレクトリ自体を指すには、相対パス <code>.</code> を指定する。 
<code>.</code> は、MCPサーバ起動時のカレントディレクトリ (一般的には、.mcp.json / opencode.jsonファイルがあるプロジェクトルート) を指す。 
 
サブディレクトリに限定する場合は、./src のように指定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
}
}
}
</syntaxhighlight>
 

== 提供ツール ==
Filesystem MCP Serverは、ファイル読み取り、ファイル書き込み、ディレクトリ管理、ファイル検索・管理の4カテゴリで合計14個のツールを提供する。 
 
==== ファイル読み取りツール ====
下表に、ファイルの内容を読み込むためのツールを示す。 
 
<center>
{| class="wikitable"
|+ ファイル読み取りツールの一覧
! ツール名 !! 説明
|-
| <code>read_file</code> || 指定したファイルの完全な内容を読み込む。
|-
| <code>read_text_file</code> || テキストファイルを読み込む。 <code>read_file</code> よりも詳細なエラーメッセージを提供する。
|-
| <code>read_media_file</code> || 画像やオーディオファイルをBase64エンコードして読み込む。
|-
| <code>read_multiple_files</code> || 複数のファイルを同時に読み込む。
|}
</center>
 
==== ファイル書き込みツール ====
下表に、ファイルの作成・編集を行うためのツールを示す。 
 
<center>
{| class="wikitable"
|+ ファイル書き込みツールの一覧
! ツール名 !! 説明
|-
| <code>write_file</code> || ファイルを新規作成する。 既存ファイルが存在する場合は上書きする。
|-
| <code>edit_file</code> || 行ベースの編集を行う。 検索・置換操作に対応し、git形式のdiffを出力する。
|}
</center>
 
==== ディレクトリ管理ツール ====
下表に、ディレクトリの作成・参照を行うためのツールを示す。 
 
<center>
{| class="wikitable"
|+ ディレクトリ管理ツールの一覧
! ツール名 !! 説明
|-
| <code>create_directory</code> || ディレクトリを作成する。 ネストしたディレクトリ構造の作成にも対応する。
|-
| <code>list_directory</code> || ディレクトリの内容を一覧表示する。 ファイルには <code>[FILE]</code>、ディレクトリには <code>[DIR]</code> のプレフィックスが付与される。
|-
| <code>list_directory_with_sizes</code> || ファイルサイズを含むディレクトリの内容を一覧表示する。
|-
| <code>directory_tree</code> || ディレクトリ構造をJSON形式のツリーとして取得する。
|}
</center>
 
==== ファイル検索・管理ツール ====
下表に、ファイルの検索・メタデータ取得・移動に関するツールを示す。 
 
<center>
{| class="wikitable"
|+ ファイル検索・管理ツールの一覧
! ツール名 !! 説明
|-
| <code>search_files</code> || グロブパターンを使用してファイルを再帰的に検索する。
|-
| <code>get_file_info</code> || ファイルのメタデータを取得する。 取得できる情報: ファイルサイズ、作成日時、更新日時等
|-
| <code>move_file</code> || ファイルまたはディレクトリを移動する。 ファイル、ディレクトリのリネームにも使用できる。
|-
| <code>list_allowed_directories</code> || サーバ起動時に許可として設定されたディレクトリの一覧を表示する。
|}
</center>
 

== セキュリティ ==
==== アクセス制限の仕組み ====
Filesystem MCP Serverは、起動時に指定したディレクトリのみへのアクセスを許可する設計となっている。 
指定ディレクトリ外へのアクセス試行はブロックされる。 
 
主なセキュリティ機能を以下に示す。 
* 指定ディレクトリへのアクセス制限
*: サーバ起動時にコマンドライン引数で指定したディレクトリのみにアクセスを限定する。
* パストラバーサル防止
*: <code>../</code> 等を利用した許可ディレクトリ外へのアクセスを防止する。
* Rootsプロトコルによる動的更新
*: MCPのRootsプロトコルにより、実行時に許可ディレクトリを動的に更新できる。
* Docker使用時の読み取り専用設定
*: Docker実行時に <code>:ro</code> フラグを付与することで、マウントしたディレクトリへの書き込みを禁止できる。
 
==== セキュリティ上の注意事項 ====
下表に、Filesystem MCP Serverを安全に使用するための推奨事項を示す。 
 
<center>
{| class="wikitable"
|+ セキュリティに関する推奨事項
! 項目 !! 説明
|-
| 許可ディレクトリの最小化 || 必要最小限のディレクトリのみを許可対象として指定する。 ルートディレクトリ (/ や C:\) を許可対象に含めることは避けること。
|-
| 読み取り専用の活用 || 書き込みが不要な用途では、 Dockerの <code>:ro</code> フラグを使用して読み取り専用で実行することを推奨する。
|-
| バージョン管理 || 過去バージョンにパス検証の脆弱性が存在したため、常に最新バージョンを使用すること。 最新版では修正済みである。
|}
</center>
 

== 使用例 ==
Filesystem MCP Serverのツールは、AIアシスタントが自然言語の指示を受けて自動的に呼び出す。 
 
==== ファイルの読み取り ====
ファイルの内容を読み込む場合の操作例を以下に示す。 
 
* 単一ファイルを読み込む場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects/config.yaml の内容を読み込んでください。
</syntaxhighlight>
*: 
* 複数ファイルをまとめて読み込む場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

src/main.py と src/utils.py の2つのファイルを同時に読み込んでください。
</syntaxhighlight>
*: 
 
==== ディレクトリの参照 ====
ディレクトリの内容を確認する場合の操作例を以下に示す。 
 
* ディレクトリの一覧を表示する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects ディレクトリの内容を一覧表示してください。
</syntaxhighlight>
*: 
* ディレクトリ構造をツリー形式で確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects/myapp のディレクトリツリーを表示してください。
</syntaxhighlight>
*: 
 
==== ファイルの作成・編集 ====
ファイルを作成または編集する場合の操作例を以下に示す。 
 
* 新しいファイルを作成する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects/myapp/README.md を作成して、プロジェクトの概要を記述してください。
</syntaxhighlight>
*: 
* 既存ファイルを編集する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects/myapp/config.py の DEBUG 変数の値を False に変更してください。
</syntaxhighlight>
*: 
 
==== ファイルの検索 ====
特定のファイルを検索する場合の操作例を以下に示す。 
 
* globパターンでPythonファイルを検索する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects 配下にある全ての .py ファイルを検索してください。
</syntaxhighlight>
*: 
 

== トラブルシューティング ==
==== 共通の問題 ====
下表に、OS問わず発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ 共通トラブルシューティング
! 問題 !! 原因 !! 対処法
|-
| Server transport closed unexpectedly エラーが発生する || PATHの問題 NVM等のバージョンマネージャを使用している場合に発生しやすい。 || Node.jsの完全パスを設定ファイルの <code>command</code> に指定する。 または、NVM向けのラッパースクリプトを作成して使用する。
|-
| MCP filesystem: Server disconnected エラーが発生する || NVM環境での実行時に環境が正しく初期化されていない。 || シェルの設定ファイルでNVMを正しく初期化した上でMCPクライアントを起動する。 または、<code>nvm use</code> を実行してからMCPクライアントを起動する。
|-
| 設定ファイルが読み込まれない || JSONファイルにコメントが含まれている。 JSON標準仕様ではコメントは使用不可である。 || 設定ファイルからコメントを全て削除する。
|-
| アクセスが拒否される || 指定した許可ディレクトリの外にあるファイルへのアクセスを試みている。 || <code>list_allowed_directories</code> ツールで許可ディレクトリを確認し、 必要に応じてサーバの起動引数に対象ディレクトリを追加する。
|}
</center>
 
==== Windowsでの問題 ====
下表に、Windows環境で発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ Windowsのトラブルシューティング
! 問題 !! 原因 !! 対処法
|-
| パスが正しく認識されない || OneDriveが有効な場合、表示上のパスと実際のパスが異なることがある。 || エクスプローラーでフォルダのプロパティを確認し、 実際のパスを設定ファイルに記述する。
|-
| サーバが起動しない || <code>npx</code> コマンドがWindowsのパス解決で問題を起こすことがある。 || <code>command</code> に <code>cmd</code>、<code>args</code> の先頭に <code>["/c", "npx"]</code> を追加して <code>cmd /c</code> ラッパーを使用する。
|}
</center>
 
==== 一般的なデバッグ手順 ====
問題が発生した場合は、以下に示す手順でデバッグを行う。 
 
# MCPクライアント (Claude Desktop等) を完全に終了する。
# 設定ファイルのJSON構文を検証する。(JSONリンターを使用する)
# Node.jsのバージョンが、v18.0.0以上であることを確認する。
# <code>npx</code> コマンドが使用可能であることを確認する。(<code>npx --version</code> を実行する)
# 以下に示すコマンドを手動で実行してサーバが正常に起動するか確認する。
#: <code>npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory</code>
# MCPクライアントを再起動する。
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,Filesystem,MCP,Model Context Protocol,filesystem-mcp-server,Claude,Claude Desktop,Claude Code,VS Code,Cursor,Node.js,npx,Docker,ファイルシステム,AIアシスタント,MCPサーバ
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

MCPサーバ - Filesystem

2026-03-25T09:56:30Z

Wiki: /* Cursorの設定 */

== 概要 ==
Filesystem MCP Server (@modelcontextprotocol/server-filesystem) は、AnthropicがNode.jsで実装したMCPサーバである。 
MITライセンスで公開されている。 
 
Model Context Protocol (MCP) を通じて、AIアシスタントにローカルファイルシステムへの安全で制御されたアクセスを提供する。 
起動時に許可するディレクトリを明示的に指定することで、AIアシスタントはそのディレクトリ内に限定したファイル操作を実行できる。 
 
Claude Desktop、Claude Code、VS Code、Cursor等の主要なMCPクライアントに対応している。 
Windows、MacOS、Linuxに対応する。 
 
主な特徴は以下の通りである。 
* 14個のファイル操作ツールを提供 (読み取り、書き込み、ディレクトリ管理、検索等)
* 指定ディレクトリ外へのアクセスをブロックするパストラバーサル防止機能
* Dockerイメージ (mcp/filesystem) による実行にも対応
* Rootsプロトコルによる実行時のディレクトリ動的更新
* Dockerの <code>:ro</code> フラグを使用した読み取り専用アクセスの設定が可能
 

== 動作要件 ==
==== 前提条件 ====
Filesystem MCP Serverを使用するために必要な前提条件を以下に示す。 
 
* Node.js v18.0.0以上
*: <code>npx</code> コマンドを使用してFilesystem MCP Serverを実行するために必要
* <code>npx</code> コマンド
*: Node.jsに同梱されているため、Node.jsのインストールで利用可能になる。
* Docker (オプション)
*: Dockerを使用してFilesystem MCP Serverを実行する場合に必要
 

== インストール ==
==== npxを使用した実行 ====
<code>npx</code> コマンドを使用する場合、インストール不要でFilesystem MCP Serverを直接実行できる。 
アクセスを許可するディレクトリへの絶対パスをコマンドライン引数で指定する (複数指定可能)。 
 
npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory1 /path/to/allowed/directory2
 
MCPクライアントの設定ファイルで指定する場合は、後述の各クライアント設定を参照すること。 
 
==== Dockerを使用した実行 ====
Docker Hubに公式イメージ (mcp/filesystem) が公開されており、Node.jsをインストールせずにFilesystem MCP Serverを実行できる。 
 
以下に示すコマンドを実行することにより、ローカルディレクトリをコンテナ内の <code>/projects</code> にマウントしてサーバを起動する。 
<code>:ro</code> フラグを付与することで、読み取り専用アクセスとなる。 
 
docker run -i --rm -v /path/to/local/directory:/projects:ro mcp/filesystem
 
書き込みアクセスを許可する場合は、<code>:ro</code> フラグを省略する。 
 
docker run -i --rm -v /path/to/local/directory:/projects mcp/filesystem
 

== MCPクライアントの設定 ==
==== 設定ファイルの場所 ====
各MCPクライアントの設定ファイルの場所は以下の通りである。 
 
Claude Desktopの設定ファイルを以下に示す。 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* MacOS
*: ~/Library/Application Support/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
Claude Codeの設定ファイルを以下に示す。 
* ローカルスコープ
*: .mcp.json (プロジェクトルート) : <code>claude mcp add</code> コマンドで生成される。
* ユーザスコープ
*: ~/.claude.json (ホームディレクトリ)
 
VS Codeの設定ファイルを以下に示す。 
* .vscode/mcp.json (プロジェクトルート)
 
Cursorの設定ファイルを以下に示す。 
* グローバル設定
*: ~/.cursor/mcp.json
* プロジェクト設定
*: .cursor/mcp.json
 
==== Claude Desktopの設定 ====
claude_desktop_config.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory1", "/path/to/allowed/directory2"]
}
}
}
</syntaxhighlight>
 
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。 
 
==== Claude Codeの設定 ====
Claude Codeでは、<code>claude mcp add</code> コマンドを使用してFilesystem MCP Serverを追加できる。 
 
以下に示すコマンドで、MCPサーバをClaude Codeに登録する。 
 
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory
 
プロジェクトスコープで設定する場合は、<code>--scope project</code> オプションを追加する。 
設定は、.mcp.json ファイルに保存される。 
 
claude mcp add --scope project filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory
 
上記コマンドにより生成される .mcp.json ファイルの内容を以下に示す。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
}
}
}
</syntaxhighlight>
 
==== OpenCodeの設定 ====
OpenCodeでは、プロジェクトルートまたはグローバル設定の opencode.json ファイルにMCPサーバを定義する。 
 
設定ファイルの読み込み優先順位は以下の通りである。(後の設定が前の設定にマージされる) 
* グローバル設定
*: ~/.config/opencode/opencode.json
* プロジェクト設定
*: プロジェクトルートの opencode.json
 
opencode.json ファイルに以下の内容を記述して、Filesystem MCP Serverを登録する。 
 
<syntaxhighlight lang="json">
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"filesystem": {
"type": "local",
"command": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"],
"enabled": true
}
}
}
</syntaxhighlight>
 
複数のディレクトリへのアクセスを許可する場合は、<code>command</code> 配列にディレクトリパスを追加する。 
 
<syntaxhighlight lang="json">
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"filesystem": {
"type": "local",
"command": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir1", "/path/to/dir2"],
"enabled": true
}
}
}
</syntaxhighlight>
 
MCPサーバを一時的に無効にする場合は、<code>enabled</code> を <code>false</code> に設定する。 
 

==== VS Codeの設定 ====
.vscode/mcp.json ファイルに以下に示す内容を設定する。 
変数 <code>${workspaceFolder}</code> を使用することにより、ワークスペースのルートディレクトリを自動的に許可対象に指定できる。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "${workspaceFolder}"]
}
}
}
</syntaxhighlight>
 
==== Cursorの設定 ====
~/.cursor/mcp.json (グローバル設定) または .cursor/mcp.json (プロジェクト設定) ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
}
}
}
</syntaxhighlight>
 
==== プロジェクトルートのみ参照する場合 ====
.mcp.json / opencode.jsonファイルがあるディレクトリ自体を指すには、相対パス . を指定する。 
. は、MCPサーバ起動時のカレントディレクトリ (一般的には、.mcp.jsonがあるプロジェクトルート) を指す。 
 
.mcp.json / opencode.json ファイルがあるディレクトリを作業ディレクトリとしてMCPサーバを起動するため、. でそのディレクトリを指定できる。 
サブディレクトリに限定する場合は、./src のように指定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
}
}
}
</syntaxhighlight>
 

== 提供ツール ==
Filesystem MCP Serverは、ファイル読み取り、ファイル書き込み、ディレクトリ管理、ファイル検索・管理の4カテゴリで合計14個のツールを提供する。 
 
==== ファイル読み取りツール ====
下表に、ファイルの内容を読み込むためのツールを示す。 
 
<center>
{| class="wikitable"
|+ ファイル読み取りツールの一覧
! ツール名 !! 説明
|-
| <code>read_file</code> || 指定したファイルの完全な内容を読み込む。
|-
| <code>read_text_file</code> || テキストファイルを読み込む。 <code>read_file</code> よりも詳細なエラーメッセージを提供する。
|-
| <code>read_media_file</code> || 画像やオーディオファイルをBase64エンコードして読み込む。
|-
| <code>read_multiple_files</code> || 複数のファイルを同時に読み込む。
|}
</center>
 
==== ファイル書き込みツール ====
下表に、ファイルの作成・編集を行うためのツールを示す。 
 
<center>
{| class="wikitable"
|+ ファイル書き込みツールの一覧
! ツール名 !! 説明
|-
| <code>write_file</code> || ファイルを新規作成する。 既存ファイルが存在する場合は上書きする。
|-
| <code>edit_file</code> || 行ベースの編集を行う。 検索・置換操作に対応し、git形式のdiffを出力する。
|}
</center>
 
==== ディレクトリ管理ツール ====
下表に、ディレクトリの作成・参照を行うためのツールを示す。 
 
<center>
{| class="wikitable"
|+ ディレクトリ管理ツールの一覧
! ツール名 !! 説明
|-
| <code>create_directory</code> || ディレクトリを作成する。 ネストしたディレクトリ構造の作成にも対応する。
|-
| <code>list_directory</code> || ディレクトリの内容を一覧表示する。 ファイルには <code>[FILE]</code>、ディレクトリには <code>[DIR]</code> のプレフィックスが付与される。
|-
| <code>list_directory_with_sizes</code> || ファイルサイズを含むディレクトリの内容を一覧表示する。
|-
| <code>directory_tree</code> || ディレクトリ構造をJSON形式のツリーとして取得する。
|}
</center>
 
==== ファイル検索・管理ツール ====
下表に、ファイルの検索・メタデータ取得・移動に関するツールを示す。 
 
<center>
{| class="wikitable"
|+ ファイル検索・管理ツールの一覧
! ツール名 !! 説明
|-
| <code>search_files</code> || グロブパターンを使用してファイルを再帰的に検索する。
|-
| <code>get_file_info</code> || ファイルのメタデータを取得する。 取得できる情報: ファイルサイズ、作成日時、更新日時等
|-
| <code>move_file</code> || ファイルまたはディレクトリを移動する。 ファイル、ディレクトリのリネームにも使用できる。
|-
| <code>list_allowed_directories</code> || サーバ起動時に許可として設定されたディレクトリの一覧を表示する。
|}
</center>
 

== セキュリティ ==
==== アクセス制限の仕組み ====
Filesystem MCP Serverは、起動時に指定したディレクトリのみへのアクセスを許可する設計となっている。 
指定ディレクトリ外へのアクセス試行はブロックされる。 
 
主なセキュリティ機能を以下に示す。 
* 指定ディレクトリへのアクセス制限
*: サーバ起動時にコマンドライン引数で指定したディレクトリのみにアクセスを限定する。
* パストラバーサル防止
*: <code>../</code> 等を利用した許可ディレクトリ外へのアクセスを防止する。
* Rootsプロトコルによる動的更新
*: MCPのRootsプロトコルにより、実行時に許可ディレクトリを動的に更新できる。
* Docker使用時の読み取り専用設定
*: Docker実行時に <code>:ro</code> フラグを付与することで、マウントしたディレクトリへの書き込みを禁止できる。
 
==== セキュリティ上の注意事項 ====
下表に、Filesystem MCP Serverを安全に使用するための推奨事項を示す。 
 
<center>
{| class="wikitable"
|+ セキュリティに関する推奨事項
! 項目 !! 説明
|-
| 許可ディレクトリの最小化 || 必要最小限のディレクトリのみを許可対象として指定する。 ルートディレクトリ (/ や C:\) を許可対象に含めることは避けること。
|-
| 読み取り専用の活用 || 書き込みが不要な用途では、 Dockerの <code>:ro</code> フラグを使用して読み取り専用で実行することを推奨する。
|-
| バージョン管理 || 過去バージョンにパス検証の脆弱性が存在したため、常に最新バージョンを使用すること。 最新版では修正済みである。
|}
</center>
 

== 使用例 ==
Filesystem MCP Serverのツールは、AIアシスタントが自然言語の指示を受けて自動的に呼び出す。 
 
==== ファイルの読み取り ====
ファイルの内容を読み込む場合の操作例を以下に示す。 
 
* 単一ファイルを読み込む場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects/config.yaml の内容を読み込んでください。
</syntaxhighlight>
*: 
* 複数ファイルをまとめて読み込む場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

src/main.py と src/utils.py の2つのファイルを同時に読み込んでください。
</syntaxhighlight>
*: 
 
==== ディレクトリの参照 ====
ディレクトリの内容を確認する場合の操作例を以下に示す。 
 
* ディレクトリの一覧を表示する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects ディレクトリの内容を一覧表示してください。
</syntaxhighlight>
*: 
* ディレクトリ構造をツリー形式で確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects/myapp のディレクトリツリーを表示してください。
</syntaxhighlight>
*: 
 
==== ファイルの作成・編集 ====
ファイルを作成または編集する場合の操作例を以下に示す。 
 
* 新しいファイルを作成する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects/myapp/README.md を作成して、プロジェクトの概要を記述してください。
</syntaxhighlight>
*: 
* 既存ファイルを編集する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects/myapp/config.py の DEBUG 変数の値を False に変更してください。
</syntaxhighlight>
*: 
 
==== ファイルの検索 ====
特定のファイルを検索する場合の操作例を以下に示す。 
 
* globパターンでPythonファイルを検索する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects 配下にある全ての .py ファイルを検索してください。
</syntaxhighlight>
*: 
 

== トラブルシューティング ==
==== 共通の問題 ====
下表に、OS問わず発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ 共通トラブルシューティング
! 問題 !! 原因 !! 対処法
|-
| Server transport closed unexpectedly エラーが発生する || PATHの問題 NVM等のバージョンマネージャを使用している場合に発生しやすい。 || Node.jsの完全パスを設定ファイルの <code>command</code> に指定する。 または、NVM向けのラッパースクリプトを作成して使用する。
|-
| MCP filesystem: Server disconnected エラーが発生する || NVM環境での実行時に環境が正しく初期化されていない。 || シェルの設定ファイルでNVMを正しく初期化した上でMCPクライアントを起動する。 または、<code>nvm use</code> を実行してからMCPクライアントを起動する。
|-
| 設定ファイルが読み込まれない || JSONファイルにコメントが含まれている。 JSON標準仕様ではコメントは使用不可である。 || 設定ファイルからコメントを全て削除する。
|-
| アクセスが拒否される || 指定した許可ディレクトリの外にあるファイルへのアクセスを試みている。 || <code>list_allowed_directories</code> ツールで許可ディレクトリを確認し、 必要に応じてサーバの起動引数に対象ディレクトリを追加する。
|}
</center>
 
==== Windowsでの問題 ====
下表に、Windows環境で発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ Windowsのトラブルシューティング
! 問題 !! 原因 !! 対処法
|-
| パスが正しく認識されない || OneDriveが有効な場合、表示上のパスと実際のパスが異なることがある。 || エクスプローラーでフォルダのプロパティを確認し、 実際のパスを設定ファイルに記述する。
|-
| サーバが起動しない || <code>npx</code> コマンドがWindowsのパス解決で問題を起こすことがある。 || <code>command</code> に <code>cmd</code>、<code>args</code> の先頭に <code>["/c", "npx"]</code> を追加して <code>cmd /c</code> ラッパーを使用する。
|}
</center>
 
==== 一般的なデバッグ手順 ====
問題が発生した場合は、以下に示す手順でデバッグを行う。 
 
# MCPクライアント (Claude Desktop等) を完全に終了する。
# 設定ファイルのJSON構文を検証する。(JSONリンターを使用する)
# Node.jsのバージョンが、v18.0.0以上であることを確認する。
# <code>npx</code> コマンドが使用可能であることを確認する。(<code>npx --version</code> を実行する)
# 以下に示すコマンドを手動で実行してサーバが正常に起動するか確認する。
#: <code>npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory</code>
# MCPクライアントを再起動する。
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,Filesystem,MCP,Model Context Protocol,filesystem-mcp-server,Claude,Claude Desktop,Claude Code,VS Code,Cursor,Node.js,npx,Docker,ファイルシステム,AIアシスタント,MCPサーバ
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

MCPサーバ - Filesystem

2026-03-25T09:52:57Z

Wiki: /* Claude Codeの設定 */

== 概要 ==
Filesystem MCP Server (@modelcontextprotocol/server-filesystem) は、AnthropicがNode.jsで実装したMCPサーバである。 
MITライセンスで公開されている。 
 
Model Context Protocol (MCP) を通じて、AIアシスタントにローカルファイルシステムへの安全で制御されたアクセスを提供する。 
起動時に許可するディレクトリを明示的に指定することで、AIアシスタントはそのディレクトリ内に限定したファイル操作を実行できる。 
 
Claude Desktop、Claude Code、VS Code、Cursor等の主要なMCPクライアントに対応している。 
Windows、MacOS、Linuxに対応する。 
 
主な特徴は以下の通りである。 
* 14個のファイル操作ツールを提供 (読み取り、書き込み、ディレクトリ管理、検索等)
* 指定ディレクトリ外へのアクセスをブロックするパストラバーサル防止機能
* Dockerイメージ (mcp/filesystem) による実行にも対応
* Rootsプロトコルによる実行時のディレクトリ動的更新
* Dockerの <code>:ro</code> フラグを使用した読み取り専用アクセスの設定が可能
 

== 動作要件 ==
==== 前提条件 ====
Filesystem MCP Serverを使用するために必要な前提条件を以下に示す。 
 
* Node.js v18.0.0以上
*: <code>npx</code> コマンドを使用してFilesystem MCP Serverを実行するために必要
* <code>npx</code> コマンド
*: Node.jsに同梱されているため、Node.jsのインストールで利用可能になる。
* Docker (オプション)
*: Dockerを使用してFilesystem MCP Serverを実行する場合に必要
 

== インストール ==
==== npxを使用した実行 ====
<code>npx</code> コマンドを使用する場合、インストール不要でFilesystem MCP Serverを直接実行できる。 
アクセスを許可するディレクトリへの絶対パスをコマンドライン引数で指定する (複数指定可能)。 
 
npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory1 /path/to/allowed/directory2
 
MCPクライアントの設定ファイルで指定する場合は、後述の各クライアント設定を参照すること。 
 
==== Dockerを使用した実行 ====
Docker Hubに公式イメージ (mcp/filesystem) が公開されており、Node.jsをインストールせずにFilesystem MCP Serverを実行できる。 
 
以下に示すコマンドを実行することにより、ローカルディレクトリをコンテナ内の <code>/projects</code> にマウントしてサーバを起動する。 
<code>:ro</code> フラグを付与することで、読み取り専用アクセスとなる。 
 
docker run -i --rm -v /path/to/local/directory:/projects:ro mcp/filesystem
 
書き込みアクセスを許可する場合は、<code>:ro</code> フラグを省略する。 
 
docker run -i --rm -v /path/to/local/directory:/projects mcp/filesystem
 

== MCPクライアントの設定 ==
==== 設定ファイルの場所 ====
各MCPクライアントの設定ファイルの場所は以下の通りである。 
 
Claude Desktopの設定ファイルを以下に示す。 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* MacOS
*: ~/Library/Application Support/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
Claude Codeの設定ファイルを以下に示す。 
* ローカルスコープ
*: .mcp.json (プロジェクトルート) : <code>claude mcp add</code> コマンドで生成される。
* ユーザスコープ
*: ~/.claude.json (ホームディレクトリ)
 
VS Codeの設定ファイルを以下に示す。 
* .vscode/mcp.json (プロジェクトルート)
 
Cursorの設定ファイルを以下に示す。 
* グローバル設定
*: ~/.cursor/mcp.json
* プロジェクト設定
*: .cursor/mcp.json
 
==== Claude Desktopの設定 ====
claude_desktop_config.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory1", "/path/to/allowed/directory2"]
}
}
}
</syntaxhighlight>
 
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。 
 
==== Claude Codeの設定 ====
Claude Codeでは、<code>claude mcp add</code> コマンドを使用してFilesystem MCP Serverを追加できる。 
 
以下に示すコマンドで、MCPサーバをClaude Codeに登録する。 
 
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory
 
プロジェクトスコープで設定する場合は、<code>--scope project</code> オプションを追加する。 
設定は、.mcp.json ファイルに保存される。 
 
claude mcp add --scope project filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory
 
上記コマンドにより生成される .mcp.json ファイルの内容を以下に示す。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
}
}
}
</syntaxhighlight>
 
==== OpenCodeの設定 ====
OpenCodeでは、プロジェクトルートまたはグローバル設定の opencode.json ファイルにMCPサーバを定義する。 
 
設定ファイルの読み込み優先順位は以下の通りである。(後の設定が前の設定にマージされる) 
* グローバル設定
*: ~/.config/opencode/opencode.json
* プロジェクト設定
*: プロジェクトルートの opencode.json
 
opencode.json ファイルに以下の内容を記述して、Filesystem MCP Serverを登録する。 
 
<syntaxhighlight lang="json">
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"filesystem": {
"type": "local",
"command": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"],
"enabled": true
}
}
}
</syntaxhighlight>
 
複数のディレクトリへのアクセスを許可する場合は、<code>command</code> 配列にディレクトリパスを追加する。 
 
<syntaxhighlight lang="json">
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"filesystem": {
"type": "local",
"command": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir1", "/path/to/dir2"],
"enabled": true
}
}
}
</syntaxhighlight>
 
MCPサーバを一時的に無効にする場合は、<code>enabled</code> を <code>false</code> に設定する。 
 

==== VS Codeの設定 ====
.vscode/mcp.json ファイルに以下に示す内容を設定する。 
変数 <code>${workspaceFolder}</code> を使用することにより、ワークスペースのルートディレクトリを自動的に許可対象に指定できる。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "${workspaceFolder}"]
}
}
}
</syntaxhighlight>
 
==== Cursorの設定 ====
~/.cursor/mcp.json (グローバル設定) または .cursor/mcp.json (プロジェクト設定) ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
}
}
}
</syntaxhighlight>
 

== 提供ツール ==
Filesystem MCP Serverは、ファイル読み取り、ファイル書き込み、ディレクトリ管理、ファイル検索・管理の4カテゴリで合計14個のツールを提供する。 
 
==== ファイル読み取りツール ====
下表に、ファイルの内容を読み込むためのツールを示す。 
 
<center>
{| class="wikitable"
|+ ファイル読み取りツールの一覧
! ツール名 !! 説明
|-
| <code>read_file</code> || 指定したファイルの完全な内容を読み込む。
|-
| <code>read_text_file</code> || テキストファイルを読み込む。 <code>read_file</code> よりも詳細なエラーメッセージを提供する。
|-
| <code>read_media_file</code> || 画像やオーディオファイルをBase64エンコードして読み込む。
|-
| <code>read_multiple_files</code> || 複数のファイルを同時に読み込む。
|}
</center>
 
==== ファイル書き込みツール ====
下表に、ファイルの作成・編集を行うためのツールを示す。 
 
<center>
{| class="wikitable"
|+ ファイル書き込みツールの一覧
! ツール名 !! 説明
|-
| <code>write_file</code> || ファイルを新規作成する。 既存ファイルが存在する場合は上書きする。
|-
| <code>edit_file</code> || 行ベースの編集を行う。 検索・置換操作に対応し、git形式のdiffを出力する。
|}
</center>
 
==== ディレクトリ管理ツール ====
下表に、ディレクトリの作成・参照を行うためのツールを示す。 
 
<center>
{| class="wikitable"
|+ ディレクトリ管理ツールの一覧
! ツール名 !! 説明
|-
| <code>create_directory</code> || ディレクトリを作成する。 ネストしたディレクトリ構造の作成にも対応する。
|-
| <code>list_directory</code> || ディレクトリの内容を一覧表示する。 ファイルには <code>[FILE]</code>、ディレクトリには <code>[DIR]</code> のプレフィックスが付与される。
|-
| <code>list_directory_with_sizes</code> || ファイルサイズを含むディレクトリの内容を一覧表示する。
|-
| <code>directory_tree</code> || ディレクトリ構造をJSON形式のツリーとして取得する。
|}
</center>
 
==== ファイル検索・管理ツール ====
下表に、ファイルの検索・メタデータ取得・移動に関するツールを示す。 
 
<center>
{| class="wikitable"
|+ ファイル検索・管理ツールの一覧
! ツール名 !! 説明
|-
| <code>search_files</code> || グロブパターンを使用してファイルを再帰的に検索する。
|-
| <code>get_file_info</code> || ファイルのメタデータを取得する。 取得できる情報: ファイルサイズ、作成日時、更新日時等
|-
| <code>move_file</code> || ファイルまたはディレクトリを移動する。 ファイル、ディレクトリのリネームにも使用できる。
|-
| <code>list_allowed_directories</code> || サーバ起動時に許可として設定されたディレクトリの一覧を表示する。
|}
</center>
 

== セキュリティ ==
==== アクセス制限の仕組み ====
Filesystem MCP Serverは、起動時に指定したディレクトリのみへのアクセスを許可する設計となっている。 
指定ディレクトリ外へのアクセス試行はブロックされる。 
 
主なセキュリティ機能を以下に示す。 
* 指定ディレクトリへのアクセス制限
*: サーバ起動時にコマンドライン引数で指定したディレクトリのみにアクセスを限定する。
* パストラバーサル防止
*: <code>../</code> 等を利用した許可ディレクトリ外へのアクセスを防止する。
* Rootsプロトコルによる動的更新
*: MCPのRootsプロトコルにより、実行時に許可ディレクトリを動的に更新できる。
* Docker使用時の読み取り専用設定
*: Docker実行時に <code>:ro</code> フラグを付与することで、マウントしたディレクトリへの書き込みを禁止できる。
 
==== セキュリティ上の注意事項 ====
下表に、Filesystem MCP Serverを安全に使用するための推奨事項を示す。 
 
<center>
{| class="wikitable"
|+ セキュリティに関する推奨事項
! 項目 !! 説明
|-
| 許可ディレクトリの最小化 || 必要最小限のディレクトリのみを許可対象として指定する。 ルートディレクトリ (/ や C:\) を許可対象に含めることは避けること。
|-
| 読み取り専用の活用 || 書き込みが不要な用途では、 Dockerの <code>:ro</code> フラグを使用して読み取り専用で実行することを推奨する。
|-
| バージョン管理 || 過去バージョンにパス検証の脆弱性が存在したため、常に最新バージョンを使用すること。 最新版では修正済みである。
|}
</center>
 

== 使用例 ==
Filesystem MCP Serverのツールは、AIアシスタントが自然言語の指示を受けて自動的に呼び出す。 
 
==== ファイルの読み取り ====
ファイルの内容を読み込む場合の操作例を以下に示す。 
 
* 単一ファイルを読み込む場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects/config.yaml の内容を読み込んでください。
</syntaxhighlight>
*: 
* 複数ファイルをまとめて読み込む場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

src/main.py と src/utils.py の2つのファイルを同時に読み込んでください。
</syntaxhighlight>
*: 
 
==== ディレクトリの参照 ====
ディレクトリの内容を確認する場合の操作例を以下に示す。 
 
* ディレクトリの一覧を表示する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects ディレクトリの内容を一覧表示してください。
</syntaxhighlight>
*: 
* ディレクトリ構造をツリー形式で確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects/myapp のディレクトリツリーを表示してください。
</syntaxhighlight>
*: 
 
==== ファイルの作成・編集 ====
ファイルを作成または編集する場合の操作例を以下に示す。 
 
* 新しいファイルを作成する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects/myapp/README.md を作成して、プロジェクトの概要を記述してください。
</syntaxhighlight>
*: 
* 既存ファイルを編集する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects/myapp/config.py の DEBUG 変数の値を False に変更してください。
</syntaxhighlight>
*: 
 
==== ファイルの検索 ====
特定のファイルを検索する場合の操作例を以下に示す。 
 
* globパターンでPythonファイルを検索する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects 配下にある全ての .py ファイルを検索してください。
</syntaxhighlight>
*: 
 

== トラブルシューティング ==
==== 共通の問題 ====
下表に、OS問わず発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ 共通トラブルシューティング
! 問題 !! 原因 !! 対処法
|-
| Server transport closed unexpectedly エラーが発生する || PATHの問題 NVM等のバージョンマネージャを使用している場合に発生しやすい。 || Node.jsの完全パスを設定ファイルの <code>command</code> に指定する。 または、NVM向けのラッパースクリプトを作成して使用する。
|-
| MCP filesystem: Server disconnected エラーが発生する || NVM環境での実行時に環境が正しく初期化されていない。 || シェルの設定ファイルでNVMを正しく初期化した上でMCPクライアントを起動する。 または、<code>nvm use</code> を実行してからMCPクライアントを起動する。
|-
| 設定ファイルが読み込まれない || JSONファイルにコメントが含まれている。 JSON標準仕様ではコメントは使用不可である。 || 設定ファイルからコメントを全て削除する。
|-
| アクセスが拒否される || 指定した許可ディレクトリの外にあるファイルへのアクセスを試みている。 || <code>list_allowed_directories</code> ツールで許可ディレクトリを確認し、 必要に応じてサーバの起動引数に対象ディレクトリを追加する。
|}
</center>
 
==== Windowsでの問題 ====
下表に、Windows環境で発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ Windowsのトラブルシューティング
! 問題 !! 原因 !! 対処法
|-
| パスが正しく認識されない || OneDriveが有効な場合、表示上のパスと実際のパスが異なることがある。 || エクスプローラーでフォルダのプロパティを確認し、 実際のパスを設定ファイルに記述する。
|-
| サーバが起動しない || <code>npx</code> コマンドがWindowsのパス解決で問題を起こすことがある。 || <code>command</code> に <code>cmd</code>、<code>args</code> の先頭に <code>["/c", "npx"]</code> を追加して <code>cmd /c</code> ラッパーを使用する。
|}
</center>
 
==== 一般的なデバッグ手順 ====
問題が発生した場合は、以下に示す手順でデバッグを行う。 
 
# MCPクライアント (Claude Desktop等) を完全に終了する。
# 設定ファイルのJSON構文を検証する。(JSONリンターを使用する)
# Node.jsのバージョンが、v18.0.0以上であることを確認する。
# <code>npx</code> コマンドが使用可能であることを確認する。(<code>npx --version</code> を実行する)
# 以下に示すコマンドを手動で実行してサーバが正常に起動するか確認する。
#: <code>npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory</code>
# MCPクライアントを再起動する。
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,Filesystem,MCP,Model Context Protocol,filesystem-mcp-server,Claude,Claude Desktop,Claude Code,VS Code,Cursor,Node.js,npx,Docker,ファイルシステム,AIアシスタント,MCPサーバ
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

MCPサーバ - SQLite

2026-03-25T09:01:37Z

Wiki: ページの作成:「== 概要 == SQLite MCP Server (mcp-server-sqlite) は、Model Context Protocol (MCP) を通じて、AIアシスタントがSQLiteデータベースと対話するための標準化されたインターフェースを提供するサーバである。 Anthropicが開発したMCP公式リファレンス実装の1つであり、MITライセンスで公開されている。 AIアシスタントが自然言語の指示を通じてSQLiteデータベースの…」

== 概要 ==
SQLite MCP Server (mcp-server-sqlite) は、Model Context Protocol (MCP) を通じて、AIアシスタントがSQLiteデータベースと対話するための標準化されたインターフェースを提供するサーバである。 
Anthropicが開発したMCP公式リファレンス実装の1つであり、MITライセンスで公開されている。 
 
AIアシスタントが自然言語の指示を通じてSQLiteデータベースの操作を実行できるようにする。 
 
Claude Desktop、Claude Code、VS Code、Cursor、Windsurf等の主要なMCPクライアントに対応する。 
Windows、MacOS、Linuxの主要なOSに対応する。 
 
このサーバを使用することにより、AIアシスタントがSQLクエリの実行、テーブルの作成・管理、スキーマの確認、ビジネスインサイトの記録等を自然言語による指示で自動化できるようになる。 
 
主な機能は以下の通りである。 
 
<center>
{| class="wikitable"
|+ データベースMCPサーバーツール一覧
|-
! ツール名 !! 説明
|-
| クエリ実行ツール || SELECTクエリによるデータ取得、INSERT、UPDATE、DELETEによるデータ操作
|-
| テーブル管理ツール || テーブルの作成、テーブル一覧の表示、スキーマ情報の確認
|-
| インサイト記録機能 || 分析中に発見したビジネスインサイトを動的メモリソースに蓄積
|}
</center>
 

== 動作要件 ==
==== Python版の要件 ====
Python版のSQLite MCP Serverを使用するために必要な前提条件を以下に示す。 
 
* Python 3.10以上
*: MCPサーバの実行環境として必要
* uv (Astralが提供するPythonパッケージマネージャ)
*: <code>uvx</code> コマンドを使用してMCPサーバを実行するために必要
* SQLite
*: PythonにSQLiteが組み込まれているため、別途インストールは不要
 
==== Node.js版の要件 ====
Node.js版のSQLite MCP Serverを使用するために必要な前提条件を以下に示す。 
 
* Node.js
*: MCPサーバの実行環境として必要
* <code>npx</code> コマンド
*: Node.jsに同梱されている。
*: <code>npx</code> コマンドを使用して、MCPサーバを実行するために必要
 

== インストール ==
==== uvのインストール ====
MCPサーバの実行に必要なuvをインストールする。 
 
===== Windowsの場合 =====
PowerShellを使用する場合は、以下に示すコマンドを実行する。 
 
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
 
WinGetを使用する場合は、以下に示すコマンドを実行する。 
 
winget install --id=astral-sh.uv -e
 
===== MacOSの場合 =====
Homebrewを使用する場合は、以下に示すコマンドを実行する。 
 
brew install uv
 
curlを使用する場合は、以下に示すコマンドを実行する。 
 
curl -LsSf https://astral.sh/uv/install.sh | sh
 
===== Linuxの場合 =====
curlを使用する場合は、以下に示すコマンドを実行する。 
 
curl -LsSf https://astral.sh/uv/install.sh | sh
 
wgetを使用する場合は、以下に示すコマンドを実行する。 
 
wget -qO- https://astral.sh/uv/install.sh | sh
 
==== mcp-server-sqliteのインストール ====
<code>pip</code> コマンドを実行してインストールする場合は、以下に示すコマンドを実行する。 
 
pip install mcp-server-sqlite
 
<code>uvx</code> を使用する場合はインストール不要で、そのままサーバを実行できる。 
 
詳細は、後述の[[#SQLite MCP Serverの実行]]セクションを参照すること。 
 
==== SQLite MCP Serverの実行 ====
インストール後、以下に示すコマンドでSQLite MCP Serverを起動できる。 
 
<code>uvx</code> コマンドを実行して起動する場合 (推奨) は、以下に示すコマンドを実行する。 
 
uvx mcp-server-sqlite --db-path /path/to/database.db
 
<code>npx</code> コマンドを実行して起動する場合は、以下に示すコマンドを実行する。 
 
npx -y @modelcontextprotocol/server-sqlite /path/to/database.db
 
下表に、コマンドラインオプションを示す。 
 
<center>
{| class="wikitable"
|+ コマンドラインオプションの一覧
! オプション !! 必須 !! 説明
|-
| <code>--db-path</code> || 必須 || SQLiteデータベースファイルへのパスを指定する。 絶対パスを使用することを推奨する。
|}
</center>
 

== MCPクライアントの設定 ==
==== 設定ファイルの場所 ====
各MCPクライアントの設定ファイルの場所は以下の通りである。 
 
Claude Desktopの設定ファイルを以下に示す。 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* MacOS
*: ~/Library/Application Support/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
Claude Codeの設定ファイルを以下に示す。 
* ローカルスコープ
*: .mcp.json (プロジェクトルート) : <code>claude mcp add</code> コマンドで生成される
* ユーザスコープ
*: ~/.claude.json (ホームディレクトリ)
 
VS Codeの設定ファイルを以下に示す。 
* .vscode/mcp.json (プロジェクトルート)
 
Cursorの設定ファイルを以下に示す。 
* グローバル設定
*: ~/.cursor/mcp.json
* プロジェクト設定
*: .cursor/mcp.json
 
==== Claude Desktopの設定 ====
claude_desktop_config.json ファイルに以下に示す内容を設定する。 
 
* <code>uvx</code> を使用する場合
*: <syntaxhighlight lang="json">
{
"mcpServers": {
"sqlite": {
"command": "uvx",
"args": ["mcp-server-sqlite", "--db-path", "/path/to/database.db"]
}
}
}
</syntaxhighlight>
*: 
* <code>npx</code> を使用する場合
*: <syntaxhighlight lang="json">
{
"mcpServers": {
"sqlite": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sqlite", "/path/to/database.db"]
}
}
}
</syntaxhighlight>
 
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。 
 
==== Claude Codeの設定 ====
Claude Codeでは、<code>claude mcp add</code> コマンドを実行して、SQLite MCP Serverを追加できる。 
 
以下に示すコマンドでMCPサーバをClaude Codeに登録する。 
 
claude mcp add sqlite -- uvx mcp-server-sqlite --db-path /path/to/database.db
 
プロジェクトスコープで設定する場合は、<code>--scope project</code> オプションを追加する。 
設定は、.mcp.json ファイルに保存される。 
 
claude mcp add --scope project sqlite -- uvx mcp-server-sqlite --db-path /path/to/database.db
 
プロジェクトの .mcp.json ファイルに設定を記述する場合は、以下に示す内容を記述する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"sqlite": {
"command": "uvx",
"args": ["mcp-server-sqlite", "--db-path", "/path/to/database.db"]
}
}
}
</syntaxhighlight>
 
==== VS Code / Cursorの設定 ====
.vscode/mcp.json または .cursor/mcp.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"sqlite": {
"command": "uvx",
"args": ["mcp-server-sqlite", "--db-path", "/path/to/database.db"]
}
}
}
</syntaxhighlight>
 
==== Windowsでの設定の注意点 ====
Windowsでは、パスの区切り文字として2重バックスラッシュを使用する必要がある。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"sqlite": {
"command": "uvx",
"args": ["mcp-server-sqlite", "--db-path", "C:\\Users\\name\\database.db"]
}
}
}
</syntaxhighlight>
 
<code>npx</code> コマンドを使用する場合は、<code>cmd /c</code> ラッパーが必要である。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"sqlite": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@modelcontextprotocol/server-sqlite", "C:\\Users\\name\\database.db"]
}
}
}
</syntaxhighlight>
 

== SQLite MCP Serverの機能 ==
SQLite MCP Serverは、クエリ実行、テーブル管理、インサイト記録の機能を6つのツールと1つのリソースで提供する。 
 
==== 提供ツール一覧 ====
下表に、SQLite MCP Serverが提供する全ツールを示す。 
 
<center>
{| class="wikitable"
|+ ツールの一覧
! ツール !! 説明
|-
| read_query || SELECTクエリを実行してデータを取得する。
|-
| write_query || INSERT、UPDATE、DELETEクエリを実行する。
|-
| create_table || 新しいテーブルを作成する。
|-
| list_tables || データベース内の全テーブル名を一覧表示する。
|-
| describe_table || 指定したテーブルのスキーマ情報 (カラム名、型、制約) を表示する。
|-
| append_insight || ビジネスインサイトを分析メモに追加する。
|}
</center>
 
==== 提供リソース ====
下表に、SQLite MCP Serverが提供するリソースを示す。 
 
<center>
{| class="wikitable"
|+ リソースの一覧
! リソースURI !! 説明
|-
| memo://insights || 分析中に発見したビジネスインサイトを蓄積する動的メモリソース。 append_insight ツールで追記される。
|}
</center>
 
==== 提供プロンプト ====
下表に、SQLite MCP Serverが提供するプロンプトを示す。 
 
<center>
{| class="wikitable"
|+ プロンプトの一覧
! プロンプト名 !! パラメータ !! 説明
|-
| mcp-demo || <code>topic</code> (分析対象を指定) || SQLiteデータベース操作のデモンストレーション用プロンプト。
|}
</center>
 

== 使用例 ==
SQLite MCP Serverの各ツールは、AIアシスタントが自然言語の指示を受けて自動的に呼び出す。 
 
==== テーブルの確認 ====
データベース内のテーブルを確認する場合の操作例を以下に示す。 
 
* データベース内の全テーブルを確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

このデータベースに含まれるすべてのテーブルを表示してください。
</syntaxhighlight>
*: 
* テーブルのスキーマを確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

usersテーブルのカラム構成と制約を確認してください。
</syntaxhighlight>
*: 
 
==== データのクエリ ====
テーブルからデータを取得する場合の操作例を以下に示す。 
 
* 条件を指定してデータを取得する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

productsテーブルから価格が1000円以上の商品の名前と価格を取得してください。
</syntaxhighlight>
*: 
* 月別集計を行う場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

salesデータから2024年の月別売上を集計して、ビジネスインサイトメモに記録してください。
</syntaxhighlight>
*: 
 
==== テーブルの作成 ====
新しいテーブルを作成する場合の操作例を以下に示す。 
 
* スキーマを指定してテーブルを作成する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

以下のスキーマでusersテーブルを作成してください:
id INTEGER PRIMARY KEY, name TEXT NOT NULL, email TEXT UNIQUE
</syntaxhighlight>
*: 
 

== その他 ==
==== セキュリティ ====
下表に、SQLite MCP Serverのセキュリティに関する推奨事項を示す。 
 
<center>
{| class="wikitable"
|+ セキュリティに関する推奨事項
! 項目 !! 説明
|-
| データベースファイルの権限設定 || データベースファイルには適切なファイルパーミッションを設定すること。 例: <code>chmod 644 database.db</code>
|-
| 絶対パスの使用 || <code>--db-path</code> オプションには絶対パスを使用する。 相対パスや ~ (チルダ) は正しく解釈されない場合がある。
|-
| 書き込み権限の考慮 || write_query および create_table ツールはデータを変更するため、 不用意なデータ変更が発生しないよう注意すること。
|}
</center>
 
==== トラブルシューティング ====
下表に、一般的なエラーと対処法を示す。 
 
<center>
{| class="wikitable"
|+ トラブルシューティング一覧
! 問題 !! 原因 !! 対処法
|-
| uvx または npxコマンドが見つからない || uvまたはNode.jsがインストールされていない。 またはPATHが正しく設定されていない。 || uvまたはNode.jsを再インストールして、PATH設定を確認する。
|-
| データベースファイルのパスエラーが発生する || 相対パスや ~ が使用されている。 || <code>--db-path</code> オプションには絶対パスを指定する。
|-
| database is locked エラーが発生する || 他のプロセスが同時にデータベースへアクセスしている。 || 他のプロセスのアクセスを確認・終了する。 または、WALモードの有効化を検討する。
|-
| 権限エラーが発生する || データベースファイルへの読み取り・書き込み権限がない。 || <code>chmod 644 database.db</code> 等でファイルの権限を設定する。
|-
| ツールが表示されない || 設定ファイルのJSON構文が誤っている。 またはMCPクライアントが再起動されていない。 || 設定ファイルのJSON構文を検証して、MCPクライアントを再起動する。
|-
| Windowsでパスが認識されない || パスの区切り文字が正しくない。 || Windowsでは2重バックスラッシュ (<code>C:\\Users\\name\\database.db</code>) を使用する。
|}
</center>
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,SQLite,MCP,Model Context Protocol,mcp-server-sqlite,Claude,AI,データベース,SQL
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

MCPサーバ - PostgreSQL

2026-03-25T08:53:09Z

Wiki: ページの作成:「== 概要 == PostgreSQL MCP Server (@henkey/postgres-mcp-server) は、Model Context Protocol (MCP) を通じて、 AIアシスタントがPostgreSQLデータベースと相互作用するための統合ツールインターフェースを提供するサーバである。 元は46個のツールを17個に統合したメタツール設計を採用しており、効率的なデータベース操作を実現する。 Claude Desktop、Claude Code…」

== 概要 ==
PostgreSQL MCP Server (@henkey/postgres-mcp-server) は、Model Context Protocol (MCP) を通じて、 
AIアシスタントがPostgreSQLデータベースと相互作用するための統合ツールインターフェースを提供するサーバである。 
 
元は46個のツールを17個に統合したメタツール設計を採用しており、効率的なデータベース操作を実現する。 
 
Claude Desktop、Claude Code、OpenCode、VS Code、Cursor等の複数のMCPクライアント環境で動作する。 
Windows、MacOS、Linuxの主要なOSに対応する。 
 
このサーバを使用することにより、AIアシスタントが自然言語の指示を通じてPostgreSQLのスキーマ管理、テーブル操作、クエリ実行、データベース分析、リアルタイム監視等を自動化できるようになる。 
 
主な機能カテゴリは以下の通りである。 
 
<center>
{| class="wikitable"
|+ Supabaseツール一覧
|-
! カテゴリ !! ツール数 !! 内容
|-
| メタツール || 8個 || スキーマ管理、テーブル操作、カラム管理、ENUM管理、 制約管理、インデックス管理、型管理、RLSポリシー管理
|-
| クエリ・ミューテーションツール || 4個 || SELECT文の実行、データ変更 (INSERT / UPDATE / DELETE)、 任意のSQL実行、コメント管理
|-
| 専門ツール || 5個 || データベース分析、デバッグ、データエクスポート / インポート、 データベース間転送、リアルタイム監視
|}
</center>
 

== PostgreSQL MCPサーバのインストール ==
==== 前提条件 ====
PostgreSQL MCP Serverを使用するために必要な前提条件を以下に示す。 
 
* Node.js
*: バージョン v18以降が必要
* PostgreSQL
*: バージョン 12以降が必要
* <code>npx</code> コマンド
*: <code>npx</code> コマンドを使用してPostgreSQL MCP Serverを実行するために必要
*: Node.jsに同梱されている。
 
==== npxを使用したインストール ====
<code>npx</code> コマンドを使用する場合、インストール不要でPostgreSQL MCP Serverを直接実行できる。 
以下に示すコマンドを実行して、PostgreSQL MCP Serverを起動する。 
 
npx @henkey/postgres-mcp-server --connection-string "postgresql://user:password@localhost:5432/database"
 
MCPクライアントの設定ファイルで指定する場合は、後述の各クライアント設定を参照すること。 
 
==== npmグローバルインストール ====
npmを使用してグローバルにインストールする場合は、以下に示すコマンドを実行する。 
 
npm install -g @henkey/postgres-mcp-server
 
==== Dockerを使用したインストール ====
DockerイメージはDocker Hubで公開されており、Node.jsをインストールせずにPostgreSQL MCP Serverを実行できる。 
 
以下に示すコマンドを実行する。 
 
docker run -i --rm -e POSTGRES_CONNECTION_STRING="postgresql://user:password@localhost:5432/database" henkey/postgres-mcp:latest
 
==== Smithery経由のインストール ====
Smithery CLIを使用してClaude向けにインストールする場合は、以下に示すコマンドを実行する。 
 
npx -y @smithery/cli install @HenkDz/postgresql-mcp-server --client claude
 

== MCPクライアントの設定 ==
==== Claude Desktopの設定 ====
Claude Desktopの設定ファイルの場所は以下の通りである。 
 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* MacOS
*: ~/Library/Application Support/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
接続文字列を使用する場合は、設定ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"postgresql": {
"command": "npx",
"args": ["-y", "@henkey/postgres-mcp-server"],
"env": {
"POSTGRES_CONNECTION_STRING": "postgresql://username:password@localhost:5432/database"
}
}
}
}
</syntaxhighlight>
 
Dockerを使用する場合は、設定ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"postgresql": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "POSTGRES_CONNECTION_STRING=postgresql://username:password@host.docker.internal:5432/database",
"henkey/postgres-mcp:latest"
]
}
}
}
</syntaxhighlight>
 
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。 
 
==== Claude Codeの設定 ====
Claude Codeでは、<code>claude mcp add</code> コマンドを使用してPostgreSQL MCP Serverを追加できる。 
 
claude mcp add postgresql -- npx -y @henkey/postgres-mcp-server
 
プロジェクトの .mcp.json ファイルに設定を記述する場合は、以下に示す内容を記述する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"postgresql": {
"command": "npx",
"args": ["-y", "@henkey/postgres-mcp-server"],
"env": {
"POSTGRES_CONNECTION_STRING": "postgresql://username:password@localhost:5432/database"
}
}
}
}
</syntaxhighlight>
 
==== OpenCodeの設定 ====
設定ファイル opencode.json ファイルの <code>mcpServers</code> セクションに以下に示す内容を追加する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"postgresql": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@henkey/postgres-mcp-server"],
"env": {
"POSTGRES_CONNECTION_STRING": "postgresql://username:password@localhost:5432/database"
}
}
}
}
</syntaxhighlight>
 
==== VS Code / Cursorの設定 ====
.vscode/mcp.json または .cursor/mcp.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"postgresql": {
"command": "npx",
"args": ["-y", "@henkey/postgres-mcp-server"],
"env": {
"POSTGRES_CONNECTION_STRING": "postgresql://username:password@localhost:5432/database"
}
}
}
}
</syntaxhighlight>
 

== 環境変数とオプション ==
==== 環境変数一覧 ====
下表に、PostgreSQL MCP Serverの動作をカスタマイズするための環境変数を示す。 
 
<center>
{| class="wikitable"
|+ 環境変数の一覧
! 環境変数 !! 説明
|-
| <code>POSTGRES_CONNECTION_STRING</code> || PostgreSQLへの接続文字列を指定する。 標準のPostgreSQL URI形式を使用する。
|-
| <code>PGHOST</code> || PostgreSQLサーバのホスト名を指定する。
|-
| <code>PGPORT</code> || PostgreSQLサーバのポート番号を指定する。 デフォルト値は 5432
|-
| <code>PGDATABASE</code> || 接続先のデータベース名を指定する。
|-
| <code>PGUSER</code> || PostgreSQLのユーザ名を指定する。
|-
| <code>PGPASSWORD</code> || PostgreSQLのパスワードを指定する。
|-
| <code>PGSSLMODE</code> || SSL接続モードを指定する。 <code>disable</code>、<code>allow</code>、<code>prefer</code>、<code>require</code> 等が使用できる。
|}
</center>
 

== 接続文字列 ==
==== 接続文字列の基本形式 ====
PostgreSQL MCP Serverへの接続文字列の基本形式を以下に示す。 
 
postgresql://username:password@hostname:port/database
 
下表に、各パラメータの説明を示す。 
 
<center>
{| class="wikitable"
|+ 接続パラメータの一覧
! パラメータ !! 説明
|-
| <code>username</code> || PostgreSQLデータベースのユーザ名
|-
| <code>password</code> || PostgreSQLデータベースのパスワード
|-
| <code>hostname</code> || PostgreSQLサーバのホスト名またはIPアドレス
|-
| <code>port</code> || PostgreSQLサーバのポート番号 (デフォルト: 5432)
|-
| <code>database</code> || 接続先のデータベース名
|}
</center>
 
==== 接続文字列の例 ====
ローカル接続 (認証あり) の場合の接続文字列を以下に示す。 
 
postgresql://username:password@localhost:5432/database
 
ローカル接続 (認証なし) の場合の接続文字列を以下に示す。 
 
postgresql://localhost:5432/database
 
SSL接続の場合の接続文字列を以下に示す。 
 
postgresql://username:password@hostname:5432/database?sslmode=require
 
複数のパラメータを指定する場合の接続文字列を以下に示す。 
 
postgresql://username:password@hostname:5432/database?sslmode=require&connect_timeout=10&application_name=mcp_server
 

== PostgreSQL MCPサーバの機能 ==
PostgreSQL MCP Serverは、メタツール、クエリ・ミューテーションツール、専門ツールの3つのカテゴリで17個のツールを提供する。 
 
==== メタツール ====
下表に、データベーススキーマの定義・管理に関するツールを示す。 
 
<center>
{| class="wikitable"
|+ メタツールの一覧
! ツール !! 説明
|-
| schemaManagement || スキーマの作成、変更、削除を管理する。
|-
| tableOperations || テーブルの作成、変更、削除を管理する。
|-
| columnManagement || カラムの追加、変更、削除を管理する。
|-
| enumManagement || ENUM型の作成、変更、削除を管理する。
|-
| constraintManagement || 制約 (主キー、外部キー、一意制約等) の管理を行う。
|-
| indexManagement || インデックスの作成、変更、削除を管理する。
|-
| typeManagement || カスタム型の管理を行う。
|-
| policyManagement || Row Level Security (RLS) ポリシーの管理を行う。
|}
</center>
 
==== クエリ・ミューテーションツール ====
下表に、SQLクエリの実行およびデータ変更に関するツールを示す。 
 
<center>
{| class="wikitable"
|+ クエリ・ミューテーションツールの一覧
! ツール !! 説明
|-
| executeQuery || SELECT文を実行してデータを取得する。 読み取り専用クエリに使用する。
|-
| executeMutation || INSERT、UPDATE、DELETE文を実行してデータを変更する。
|-
| executeSQL || 任意のSQL文を実行する。DDL文やトランザクション制御にも使用できる。
|-
| commentsManagement || テーブル、カラム等のデータベースオブジェクトにコメントを追加・管理する。
|}
</center>
 
==== 専門ツール ====
下表に、データベースの分析・監視・データ転送に関するツールを示す。 
 
<center>
{| class="wikitable"
|+ 専門ツールの一覧
! ツール !! 説明
|-
| databaseAnalysis || データベースの統計情報、テーブルサイズ、インデックス使用状況等を分析する。
|-
| debugDatabase || ロック状況、実行中のクエリ、接続情報等のデバッグ情報を取得する。
|-
| dataExportImport || データのCSV / JSONエクスポートおよびインポートを行う。
|-
| crossDatabaseTransfer || 異なるデータベース間でのデータ転送を行う。
|-
| realtimeMonitoring || データベースのパフォーマンス、接続数、クエリ実行状況をリアルタイムで監視する。
|}
</center>
 

== 使用例 ==
PostgreSQL MCP Serverの各ツールは、AIアシスタントが自然言語の指示を受けて自動的に呼び出す。 
 
==== テーブル構造の確認 ====
テーブルのスキーマ情報を確認する場合の操作例を以下に示す。 
 
* usersテーブルのスキーマ情報を表示する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

usersテーブルのスキーマ情報を表示してください。
</syntaxhighlight>
*: 
 
==== データの検索 ====
テーブルからデータをクエリする場合の操作例を以下に示す。 
 
* 条件を指定して特定フィールドのみ取得する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

productsテーブルから価格が1000円以降の商品の名前と価格を取得してください。
</syntaxhighlight>
*: 
 
==== データベース分析 ====
データベースの統計情報やインデックス使用状況を分析する場合の操作例を以下に示す。 
 
* テーブルサイズとインデックス使用状況を確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

データベースのテーブルサイズとインデックス使用状況を分析してください。
</syntaxhighlight>
*: 
 
==== リアルタイム監視 ====
現在のデータベースの状態をリアルタイムで確認する場合の操作例を以下に示す。 
 
* 実行中のクエリとアクティブな接続数を確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

現在実行中のクエリとアクティブな接続数を確認してください。
</syntaxhighlight>
*: 
 
==== データのエクスポート ====
テーブルデータをファイル形式でエクスポートする場合の操作例を以下に示す。 
 
* テーブルデータをCSV形式でエクスポートする場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

ordersテーブルのデータをCSV形式でエクスポートしてください。
</syntaxhighlight>
*: 
 

== その他 ==
==== セキュリティ ====
下表に、PostgreSQL MCP Serverのセキュリティに関する推奨事項を示す。 
 
<center>
{| class="wikitable"
|+ セキュリティに関する推奨事項
! 項目 !! 説明
|-
| 読み取り専用ユーザの使用 || MCPサーバ用に専用の読み取り専用PostgreSQLユーザを作成することを推奨する。 必要最小限の権限のみを付与すること。
|-
| 認証情報の管理 || 接続文字列やパスワード等の機密情報は、設定ファイルに直接記述せず、 環境変数 (<code>POSTGRES_CONNECTION_STRING</code>、<code>PGPASSWORD</code> 等) を使用して管理することを推奨する。
|-
| SSL/TLS接続の使用 || 本番環境では、接続文字列に <code>sslmode=require</code> を指定して、 SSL/TLS暗号化通信を有効にすることを推奨する。
|-
| ネットワークアクセスの制限 || pg_hba.conf でホストベース認証を設定して、信頼できるネットワーク範囲のみから接続を許可すること。
|-
| ツールアクセス制御 || MCPクライアントのツールアクセス制御機能を活用して、 AIアシスタントが使用できるツールを必要なものだけに制限することを推奨する。
|}
</center>
 
==== トラブルシューティング ====
下表に、一般的なエラーと対処法を示す。 
 
<center>
{| class="wikitable"
|+ トラブルシューティング一覧
! 問題 !! 原因 !! 対処法
|-
| 接続エラーが発生する || 接続文字列のユーザ名またはパスワードが誤っている。 PostgreSQLサーバが起動していない。 || 接続文字列を確認する。 PostgreSQLサーバの起動状態を確認する。 pg_hba.conf ファイルの認証設定を確認する。
|-
| 接続できない (Connection refused) || PostgreSQLがリッスンしているポート (デフォルト: 5432) が ファイアウォールでブロックされている。 || ファイアウォールの設定を確認してポート5432を開放する。 postgresql.conf ファイルの <code>listen_addresses</code> を確認する。
|-
| npxコマンドが見つからない || Node.jsがインストールされていない。 または要件を満たすバージョンでない。 || Node.js v18以降をインストールする。
|-
| SSL接続エラーが発生する || SSL接続モードの設定が誤っている。 SSL証明書が無効 || 接続文字列の <code>sslmode</code> パラメータを確認する。 PostgreSQLサーバ側のSSL設定を確認する。
|-
| 書き込み操作が拒否される || PostgreSQLユーザに書き込み権限が付与されていない。 || PostgreSQLユーザのGRANT権限を確認する。 必要な場合はINSERT、UPDATE、DELETE権限を付与する。
|}
</center>
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,PostgreSQL,MCP,Model Context Protocol,postgres-mcp-server,Claude,AI,MCPサーバ,データベース,スキーマ管理,クエリ,SQL
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

MCPサーバ - YouTube

2026-03-25T08:45:58Z

Wiki: ページの作成:「== 概要 == YouTube MCPサーバは、Model Context Protocol (MCP) を通じて、AIアシスタントがYouTube動画の字幕・トランスクリプトを取得するための機能を提供するサーバである。 YouTube動画のURLを指定するだけで、AIアシスタントが動画の内容を分析・要約できるようになる。 YouTube Data APIキーは不要で、手軽に導入可能である。 Claude Desktop、Claude Code…」

== 概要 ==
YouTube MCPサーバは、Model Context Protocol (MCP) を通じて、AIアシスタントがYouTube動画の字幕・トランスクリプトを取得するための機能を提供するサーバである。 
YouTube動画のURLを指定するだけで、AIアシスタントが動画の内容を分析・要約できるようになる。 
 
YouTube Data APIキーは不要で、手軽に導入可能である。 
Claude Desktop、Claude Code、VS Code等の主要なMCPクライアントに対応し、Windows、MacOS、Linuxの主要なOSで動作する。 
 
代表的な実装として以下の2つが存在する。 
 
<center>
{| class="wikitable"
|+ YouTube文字起こしMCPサーバー実装比較
|-
! 実装名 !! 説明
|-
| mcp-youtube (@anaisbetts/mcp-youtube) || Ani Betts氏が開発した実装であり、yt-dlpを使用して字幕を取得する。 単純な構成で導入が容易であり、YouTube Data APIキーは不要である。
|-
| mcp-server-youtube-transcript (@kimtaeyoon83/mcp-server-youtube-transcript) || Kim Taeyoon氏が開発した実装であり、 多言語対応、広告フィルタリング、タイムスタンプ制御等の高度な機能を提供する。 外部ツールへの依存がなく、Node.jsのみで動作する。
|}
</center>
 
主な活用シーンを以下に示す。 
* 動画コンテンツの要約と分析
* 技術動画から情報抽出
* ポッドキャスト形式コンテンツの分析
* 言語学習における多言語字幕の取得
 

== 2つのサーバの比較 ==
下表に、mcp-youtubeとmcp-server-youtube-transcriptの主要な違いを示す。 
 
<center>
{| class="wikitable"
|+ YouTube MCPサーバ比較
! 項目 !! mcp-youtube !! mcp-server-youtube-transcript
|-
| 開発元 || Ani Betts || Kim Taeyoon
|-
| npmパッケージ || @anaisbetts/mcp-youtube || @kimtaeyoon83/mcp-server-youtube-transcript
|-
| バージョン || 0.6.0 || 0.1.1
|-
| ライセンス || MIT || MIT
|-
| GitHub スター数 || 506 || 503
|-
| 外部依存 || yt-dlp 必須 || なし
|-
| 多言語対応 || 限定的 || 対応 (自動フォールバック)
|-
| 広告フィルタリング || なし || 対応 (デフォルト有効)
|-
| タイムスタンプ制御 || タイムスタンプ除去 || 表示 / 非表示を選択可能
|-
| YouTube Shorts対応 || 不明 || 対応
|-
| YouTube API キー || 不要 || 不要
|}
</center>
 

== 動作要件 ==
==== mcp-youtubeの要件 ====
* Node.js
*: MCPサーバの実行環境として必要
* yt-dlp
*: 字幕取得のために必要な外部ツール
*: MacOS: <code>brew install yt-dlp</code>
*: Python環境: <code>pip install yt-dlp</code>
*: Windows (WinGet): <code>winget install yt-dlp</code>
 
==== mcp-server-youtube-transcriptの要件 ====
* Node.js 18以上
*: MCPサーバの実行環境として必要
*: 外部ツールへの依存はなし
 

== インストール ==
==== yt-dlpのインストール (mcp-youtubeを使用する場合) ====
mcp-youtubeはyt-dlpに依存するため、事前にインストールが必要である。 
 
===== MacOSの場合 =====
Homebrewを使用する場合は、以下に示すコマンドを実行する。 
 
brew install yt-dlp
 
===== Linux / MacOSの場合 (pip経由) =====
pipを使用する場合は、以下に示すコマンドを実行する。 
 
pip install yt-dlp
 
===== Windowsの場合 =====
WinGetを使用する場合は、以下に示すコマンドを実行する。 
 
winget install yt-dlp
 
インストール後、yt-dlpコマンドがPATHに含まれていることを確認する。 
 
yt-dlp --version
 

== MCPクライアントの設定 ==
==== 設定ファイルの場所 ====
各MCPクライアントの設定ファイルの場所は、以下の通りである。 
 
Claude Desktopの設定ファイルを以下に示す。 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* MacOS
*: ~/Library/Application Support/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
Claude Codeの設定ファイルを以下に示す。 
* ローカルスコープ
*: .mcp.json (プロジェクトルート) : <code>claude mcp add</code> コマンドで生成される。
* ユーザスコープ
*: ~/.claude.json (ホームディレクトリ)
 
==== mcp-youtubeの設定 ====
===== Claude Desktopでの設定 =====
claude_desktop_config.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"youtube": {
"command": "npx",
"args": ["-y", "@anaisbetts/mcp-youtube"]
}
}
}
</syntaxhighlight>
 
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。 
 
===== Claude Codeでの設定 =====
Claude Codeでは、<code>claude mcp add</code> コマンドを使用してMCPサーバを追加できる。 
 
claude mcp add youtube -- npx -y @anaisbetts/mcp-youtube
 
プロジェクトスコープで設定する場合は、<code>--scope project</code> オプションを追加する。 
 
claude mcp add --scope project youtube -- npx -y @anaisbetts/mcp-youtube
 
===== VS Code / Cursorでの設定 =====
.vscode/mcp.json または .cursor/mcp.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"youtube": {
"command": "npx",
"args": ["-y", "@anaisbetts/mcp-youtube"]
}
}
}
</syntaxhighlight>
 
===== Windowsでの設定 =====
Windowsでは <code>npx</code> を使用するMCPサーバの場合、<code>cmd /c</code> ラッパーが必要である。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"youtube": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@anaisbetts/mcp-youtube"]
}
}
}
</syntaxhighlight>
 
==== mcp-server-youtube-transcriptの設定 ====
===== Claude Desktopでの設定 =====
claude_desktop_config.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"youtube-transcript": {
"command": "npx",
"args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
}
}
}
</syntaxhighlight>
 
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。 
 
===== Claude Codeでの設定 =====
claude mcp add youtube-transcript -- npx -y @kimtaeyoon83/mcp-server-youtube-transcript
 
プロジェクトスコープで設定する場合は、<code>--scope project</code> オプションを追加する。 
 
claude mcp add --scope project youtube-transcript -- npx -y @kimtaeyoon83/mcp-server-youtube-transcript
 
===== VS Code / Cursorでの設定 =====
.vscode/mcp.json または .cursor/mcp.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"youtube-transcript": {
"command": "npx",
"args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
}
}
}
</syntaxhighlight>
 
===== Windowsでの設定 =====
Windowsでは <code>cmd /c</code> ラッパーを使用する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"youtube-transcript": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
}
}
}
</syntaxhighlight>
 

== ツール仕様 ==
==== mcp-youtubeのツール ====
下表に、mcp-youtubeが提供するツールを示す。 
 
<center>
{| class="wikitable"
|+ mcp-youtube ツール一覧
! ツール名 !! 説明
|-
| get_transcript || YouTube URLを指定して字幕テキストを取得する。 yt-dlpを使用して字幕データを取得し、テキスト形式で返す。
|}
</center>
 
==== mcp-server-youtube-transcriptのツール ====
下表に、mcp-server-youtube-transcriptが提供するツールとパラメータを示す。 
 
<center>
{| class="wikitable"
|+ mcp-server-youtube-transcript ツール一覧
! ツール名 !! パラメータ !! 説明
|-
| get_transcript || url (必須) || YouTube動画URL、Shorts URL、動画IDを指定する。
|-
| get_transcript || lang (オプション、デフォルト: "en") || 取得する字幕の言語コードを指定する。 例: ja (日本語)、en (英語)、ko (韓国語)
|-
| get_transcript || include_timestamps (オプション、デフォルト: false) || タイムスタンプを字幕テキストに含めるかどうかを指定する。
|-
| get_transcript || strip_ads (オプション、デフォルト: true) || 広告・スポンサーシップに関する文字列を除去するかどうかを指定する。
|}
</center>
 
==== 対応URL形式 (mcp-server-youtube-transcript) ====
mcp-server-youtube-transcriptは、以下に示すURL形式に対応している。 
 
* 通常URL
*: https://www.youtube.com/watch?v=<動画ID>
* YouTube Shorts URL
*: https://www.youtube.com/shorts/<動画ID>
* 短縮URL
*: https://youtu.be/<動画ID>
* 動画IDのみ
*: <動画ID>
 

== 使用方法 ==
MCPサーバを設定後、AIアシスタントに自然言語で指示するだけで、対応するツールが自動的に呼び出される。 
 
==== 動画の要約 ====
YouTube動画の内容を要約する場合の操作例を以下に示す。 
 
* 動画全体を要約する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

このYouTube動画を要約してください: https://www.youtube.com/watch?v=xxxxx
</syntaxhighlight>
*: 
* キーポイントを抽出する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

この動画のキーポイントを5つ教えてください: https://www.youtube.com/watch?v=xxxxx
</syntaxhighlight>
*: 
 
==== 多言語字幕の取得 ====
特定の言語で字幕を取得する場合の操作例を以下に示す。 
mcp-server-youtube-transcriptを使用する場合に有効である。 
 
* 日本語字幕を取得する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

この動画の日本語字幕を取得してください: https://www.youtube.com/watch?v=xxxxx
</syntaxhighlight>
*: 
 
==== 技術情報の抽出 ====
技術動画から特定の情報を抽出する場合の操作例を以下に示す。 
 
* 動画で紹介されているツールを一覧化する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

この技術動画で紹介されているツールを一覧にしてください: https://www.youtube.com/watch?v=xxxxx
</syntaxhighlight>
*: 
 

== トラブルシューティング ==
下表に、一般的なエラーと対処法を示す。 
 
<center>
{| class="wikitable"
|+ トラブルシューティング一覧
! 問題 !! 原因 !! 対処法
|-
| yt-dlpが見つからない (mcp-youtube) || yt-dlpがインストールされていない。 または、PATHに含まれていない。 || yt-dlpをインストールして、PATHに追加する。 <code>yt-dlp --version</code> コマンドで動作確認する。
|-
| 字幕が取得できない || 動画に字幕が存在しない。 または、字幕が無効化されている。 || 字幕が存在する動画を指定する。 動画のYouTubeページで字幕の有無を確認する。
|-
| 指定した言語の字幕が取得できない || 指定した言語コードの字幕が動画に存在しない。 || 別の言語コードを試す。 mcp-server-youtube-transcriptは自動フォールバックを試みるが、 全言語で字幕がない場合はエラーとなる。
|-
| npxコマンドエラーが発生する (Windows) || Windowsでは <code>npx</code> を直接実行できない場合がある。 || 設定ファイルで <code>cmd /c</code> ラッパーを使用する。
|-
| Node.jsバージョンエラーが発生する || インストールされているNode.jsが要件を満たしていない。 || mcp-server-youtube-transcriptの場合、 Node.js v18以降にアップグレードする。
|-
| MCPサーバが起動しない || 設定ファイルの記述に誤りがある。 または、Node.jsがインストールされていない。 || MCPクライアントを再起動する。 設定ファイルのJSON構文を確認する。 Node.jsのインストール状態を確認する。
|}
</center>
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,YouTube,MCP,Model Context Protocol,字幕,トランスクリプト,Claude,AI,mcp-youtube,yt-dlp,mcp-server-youtube-transcript,MCPサーバ,AIアシスタント
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

MCPサーバ - Git

2026-03-25T08:38:21Z

Wiki: ページの作成:「== 概要 == Git MCP Server (mcp-server-git) は、Anthropicが開発したModel Context Protocol (MCP) の公式リファレンス実装の1つであり、 AIアシスタントがGitリポジトリと対話するための標準化されたインターフェースを提供するサーバである。 Python (uv) で実装されており、<code>uvx</code> コマンドを使用してインストール不要で直接実行できる。 Claude Desktop、…」

== 概要 ==
Git MCP Server (mcp-server-git) は、Anthropicが開発したModel Context Protocol (MCP) の公式リファレンス実装の1つであり、 
AIアシスタントがGitリポジトリと対話するための標準化されたインターフェースを提供するサーバである。 
 
Python (uv) で実装されており、<code>uvx</code> コマンドを使用してインストール不要で直接実行できる。 
Claude Desktop、Claude Code、VS Code、Cursor、Zed等の主要なMCPクライアントに対応している。 
 
Windows、MacOS、Linuxの主要なOSに対応する。 
 
このサーバを使用することにより、AIアシスタントが自然言語による指示でGitリポジトリの状態確認、差分表示、コミット履歴の確認、 
ファイルのステージング・コミット、ブランチの作成・切り替え等の操作を自動化できるようになる。 
 
提供されるツールは以下の4カテゴリ、合計12個である。 
 
<center>
{| class="wikitable"
|+ Gitツール一覧
|-
| ツール名 || 説明
|-
| リポジトリ状態確認ツール || ワーキングツリーの状態確認と差分表示 (git_status、git_diff_unstaged、git_diff_staged、git_diff)
|-
| コミット履歴・検査ツール || コミット履歴の表示と特定コミットの詳細確認 (git_log、git_show)
|-
| ファイル・コミット管理ツール || ファイルのステージング、コミット、リセット (git_add、git_commit、git_reset)
|-
| ブランチ操作ツール || ブランチの一覧表示、作成、切り替え (git_branch、git_create_branch、git_checkout)
|}
</center>
 

== 動作要件 ==
==== 前提条件 ====
Git MCP Serverを使用するために必要な前提条件を以下に示す。 
 
* Python 3.10以降
*: MCPサーバの実行環境として必要
* uv (Astralが提供するPythonパッケージマネージャ)
*: <code>uvx</code> コマンドを使用してMCPサーバを実行するために必要
* Git
*: Gitリポジトリへのアクセスに必要
*: 事前にインストールされていること
 

== インストール ==
==== uvのインストール ====
MCPサーバの実行に必要なuvをインストールする。 
 
===== Windowsの場合 =====
PowerShellを使用する場合は、以下に示すコマンドを実行する。 
 
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
 
WinGetを使用する場合は、以下に示すコマンドを実行する。 
 
winget install --id=astral-sh.uv -e
 
===== MacOSの場合 =====
Homebrewを使用する場合は、以下に示すコマンドを実行する。 
 
brew install uv
 
curlを使用する場合は、以下に示すコマンドを実行する。 
 
curl -LsSf https://astral.sh/uv/install.sh | sh
 
===== Linuxの場合 =====
curlを使用する場合は、以下に示すコマンドを実行する。 
 
curl -LsSf https://astral.sh/uv/install.sh | sh
 
wgetを使用する場合は、以下に示すコマンドを実行する。 
 
wget -qO- https://astral.sh/uv/install.sh | sh
 
===== pip経由 (全てのOSで対応) =====
pipを使用してインストールする場合は、以下に示すコマンドを実行する。 
 
pip install uv
 
==== Pythonのインストール ====
<code>uv</code> コマンドを使用してPython 3.10以降をインストールする。 
 
uv python install 3.10
 
==== mcp-server-gitのインストール ====
<code>uvx</code> コマンドを実行する場合は、インストール不要で直接実行できる。(推奨) 
以下に示すコマンドを実行して、Git MCP Serverを起動する。 
 
uvx mcp-server-git --repository /path/to/repo
 
<code>pip</code> コマンドを実行してインストールする場合は、以下に示すコマンドを実行する。 
 
pip install mcp-server-git
 
インストール後は、以下のコマンドで起動する。 
 
python -m mcp_server_git
 
===== コマンドラインオプション =====
下表に、Git MCP Serverが受け付けるコマンドラインオプションを示す。 
 
<center>
{| class="wikitable"
|+ コマンドラインオプション一覧
! オプション !! 説明
|-
| <code>--repository</code> || 対象Gitリポジトリのパスを指定する。(省略時はカレントディレクトリを使用する)
|}
</center>
 

== MCPクライアントの設定 ==
==== 設定ファイルの場所 ====
各MCPクライアントの設定ファイルの場所は以下の通りである。 
 
Claude Desktopの設定ファイルを以下に示す。 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* MacOS
*: ~/Library/Application Support/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
Claude Codeの設定ファイルを以下に示す。 
* ローカルスコープ
*: .mcp.json (プロジェクトルート) : <code>claude mcp add</code> コマンドで生成される。
* ユーザスコープ
*: ~/.claude.json (ホームディレクトリ)
 
VS Codeの設定ファイルを以下に示す。 
* .vscode/mcp.json (プロジェクトルート)
 
Cursorの設定ファイルを以下に示す。 
* グローバル設定
*: ~/.cursor/mcp.json
* プロジェクト設定
*: .cursor/mcp.json
 
==== Claude Desktopの設定 ====
claude_desktop_config.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"git": {
"command": "uvx",
"args": ["mcp-server-git", "--repository", "/path/to/repo"]
}
}
}
</syntaxhighlight>
 
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。 
 
==== Claude Codeの設定 ====
Claude Codeでは、<code>claude mcp add</code> コマンドを使用してGit MCP Serverを追加できる。 
 
以に示すコマンドでMCPサーバをClaude Codeに登録する。 
 
claude mcp add git -- uvx mcp-server-git --repository /path/to/repo
 
プロジェクトスコープで設定する場合は、<code>--scope project</code> オプションを追加する。 
設定は、.mcp.json ファイルに保存される。 
 
claude mcp add --scope project git -- uvx mcp-server-git --repository /path/to/repo
 
上記コマンドにより生成される .mcp.json の内容を以下に示す。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"git": {
"command": "uvx",
"args": ["mcp-server-git", "--repository", "/path/to/repo"]
}
}
}
</syntaxhighlight>
 
==== VS Code / Cursorの設定 ====
.vscode/mcp.json または .cursor/mcp.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"git": {
"command": "uvx",
"args": ["mcp-server-git", "--repository", "/path/to/repo"]
}
}
}
</syntaxhighlight>
 

== 提供ツールの一覧 ==
Git MCP Serverは、Gitリポジトリを操作するための12個のツールを4カテゴリに分けて提供する。 
 
==== リポジトリ状態確認ツール ====
下表に、ワーキングツリーの状態確認および差分表示に関するツールを示す。 
 
<center>
{| class="wikitable"
|+ リポジトリ状態確認ツールの一覧
! ツール !! 説明
|-
| <code>git_status</code> || ワーキングツリーの状態を表示する。(変更ファイル、未追跡ファイル等)
|-
| <code>git_diff_unstaged</code> || ステージング前の変更内容を差分表示する。
|-
| <code>git_diff_staged</code> || ステージング済みの変更内容を差分表示する。
|-
| <code>git_diff</code> || ブランチ間またはコミット間の差分を表示する。
|}
</center>
 
==== コミット履歴・検査ツール ====
下表に、コミット履歴の表示と特定コミットの詳細確認に関するツールを示す。 
 
<center>
{| class="wikitable"
|+ コミット履歴・検査ツールの一覧
! ツール !! 説明
|-
| <code>git_log</code> || コミット履歴を表示する。 日付範囲フィルタリング対応。ISO 8601形式または相対日付で指定可能
|-
| <code>git_show</code> || 特定のコミットの詳細内容を表示する。 コミットハッシュ、ブランチ名、タグ等で指定可能
|}
</center>
 
==== ファイル・コミット管理ツール ====
下表に、ファイルのステージング、コミット、リセットに関するツールを示す。 
 
<center>
{| class="wikitable"
|+ ファイル・コミット管理ツールの一覧
! ツール !! 説明
|-
| <code>git_add</code> || ファイルをステージング領域に追加する。
|-
| <code>git_commit</code> || ステージング済みの変更をコミットする。
|-
| <code>git_reset</code> || ステージング済みの変更をリセットする。
|}
</center>
 
==== ブランチ操作ツール ====
下表に、ブランチの一覧表示、作成、切り替えに関するツールを示す。 
 
<center>
{| class="wikitable"
|+ ブランチ操作ツールの一覧
! ツール !! 説明
|-
| <code>git_branch</code> || ブランチを一覧表示する。 ローカル、リモート、全てを指定可能
|-
| <code>git_create_branch</code> || 新しいブランチを作成する。 ベースブランチの指定が可能
|-
| <code>git_checkout</code> || 指定したブランチに切り替える。
|}
</center>
 

== 使用方法 ==
Git MCP Serverを設定後、AIアシスタントに自然言語で指示するだけで、対応するツールが自動的に呼び出される。 
 
==== リポジトリ状態の確認 ====
リポジトリの状態や変更内容を確認する場合の操作例を以下に示す。 
 
* ワーキングツリーの状態を確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

リポジトリの現在のステータスを確認してください。
</syntaxhighlight>
*: 
* ステージング前の変更内容を確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

ステージング前の変更内容を見せてください。
</syntaxhighlight>
*: 
* 2つのブランチ間の差分を確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

mainブランチとdevelopブランチの差分を表示してください。
</syntaxhighlight>
 
==== コミット履歴の確認 ====
コミット履歴を確認する場合の操作例を以下に示す。 
 
* 過去1ヶ月のコミット履歴を確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

過去1ヶ月のコミット履歴を表示してください。
</syntaxhighlight>
*: 
* 特定のコミットの詳細を確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

コミットハッシュ abc1234 の詳細内容を表示してください。
</syntaxhighlight>
 
==== ファイルのステージングとコミット ====
ファイルをステージングしてコミットする場合の操作例を以下に示す。 
 
* 変更ファイルを全てステージングしてコミットする場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

変更ファイルをすべてステージングして、"Fix: typo in README" というメッセージでコミットしてください。
</syntaxhighlight>
 
==== ブランチの操作 ====
ブランチを作成して切り替える場合の操作例を以下に示す。 
 
* 新しいブランチを作成して切り替える場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

developブランチから feature/new-api ブランチを作成して切り替えてください。
</syntaxhighlight>
*: 
* ブランチの一覧を確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

ローカルブランチの一覧を表示してください。
</syntaxhighlight>
 

== トラブルシューティング ==
==== 共通の問題 ====
下表に、OS問わず発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ 共通トラブルシューティング
! 問題 !! 対処法
|-
| uvxコマンドが見つからない || PATHの設定を確認する。 シェルの設定ファイル (~/.bashrc 等) を再読み込みまたは uvを再インストールする。
|-
| Pythonバージョンが不足している || <code>uv python install 3.10</code> コマンドを実行して、Python 3.10以降をインストールする。
|-
| Gitがインストールされていない || パッケージ管理システムを使用して、Gitをインストールする。
|-
| <code>--repository</code> パスが不正 || 相対パスではなく絶対パスを指定することを推奨する。 パスにスペースが含まれる場合は、クォートで囲む。
|-
| パーミッションエラーが発生する || <code>chmod</code> または <code>chown</code> コマンドを実行して、リポジトリのアクセス権限を調整する。
|-
| JSON設定ファイルの構文エラーが発生する || JSONバリデータを使用して設定ファイルの構文を確認する。 修正後、MCPクライアントを再起動して設定を反映する。
|-
| サーバが起動しない || MCPクライアントを再起動する。 ログファイルを確認してエラーの詳細を調べる。
|}
</center>
 
==== Linuxでの問題 ====
下表に、Linux環境で発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ Linuxのトラブルシューティング
! 問題 !! 対処法
|-
| uvコマンドが見つからない || ~/.profile ファイル等に環境変数 <code>PATH</code> が正しく設定されているか確認する。
|-
| パーミッションエラーが発生する || 実行権限を付与する。 例: <code>chmod +x ~/.local/bin/uv</code>
|}
</center>
 
==== MacOSでの問題 ====
下表に、MacOS環境で発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ MacOSのトラブルシューティング
! 問題 !! 対処法
|-
| Apple Silicon環境で、uvコマンドが見つからない || Homebrewを使用して、uvを再インストールする。 <code>brew install uv</code> コマンドを実行する。
|}
</center>
 
==== Windowsでの問題 ====
下表に、Windows環境で発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ Windowsのトラブルシューティング
! 問題 !! 対処法
|-
| ENOENTエラーが発生する || 設定ファイルに環境変数 (<code>PATH</code> 等) を明示的に指定する。
|-
| パスの区切り文字に関するエラーが発生する || Windowsのパス区切り文字 (<code>\</code>) を使用する。 または、スラッシュ (<code>/</code>) に統一して指定する。
|}
</center>
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,Git,MCP,Model Context Protocol,mcp-server-git,Claude,AI,バージョン管理,リポジトリ,Anthropic,uvx,uv,Python
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

MCPサーバ - Sequential Thinking

2026-03-25T08:30:07Z

Wiki: ページの作成:「== 概要 == Sequential Thinking MCP Server は、Model Context Protocol (MCP) を通じてAIアシスタントに構造化された段階的思考プロセスを提供するサーバである。 Anthropicが開発したMCP公式リファレンス実装の一つであり、MITライセンスで公開されている。 複雑な問題を管理可能なステップに分解し、動的かつ反省的な問題解決を実現する。 理解が深まる…」

== 概要 ==
Sequential Thinking MCP Server は、Model Context Protocol (MCP) を通じてAIアシスタントに構造化された段階的思考プロセスを提供するサーバである。 
Anthropicが開発したMCP公式リファレンス実装の一つであり、MITライセンスで公開されている。 
 
複雑な問題を管理可能なステップに分解し、動的かつ反省的な問題解決を実現する。 
理解が深まるにつれて思考を修正・精緻化したり、推論の代替経路へ分岐させたりすることが可能である。 
 
主な特徴は以下の通りである。 
* 複雑な問題を段階的なステップに分解
* 理解が深まるにつれて思考を修正・精緻化
* 推論の代替経路への分岐
* 必要な思考ステップ数の動的調整
* ソリューション仮説の生成と検証
 
提供するツールは sequential_thinking の1つのみであるが、思考番号・修正・分岐等のパラメータにより柔軟な推論プロセスを制御できる。 
 
Claude Desktop、Claude Code、VS Code、Cursor、ChatGPT等の主要なMCPクライアントに対応している。 
 

== 動作要件 ==
==== 前提条件 ====
Sequential Thinking MCP Serverを使用するために必要な前提条件を以下に示す。 
 
* Node.js v18以上
*: <code>npx</code> コマンドを使用してMCPサーバを実行するために必要
* <code>npx</code> コマンド
*: Node.jsに同梱されている。
*: MCPサーバを直接実行するために使用する。
 

== インストール ==
==== npxを使用したインストール (推奨) ====
<code>npx</code> コマンドを使用する場合、インストール不要でSequential Thinking MCP Serverを直接実行できる。 
以下のコマンドを実行して、MCPサーバを起動する。 
 
npx -y @modelcontextprotocol/server-sequential-thinking
 
MCPクライアントの設定ファイルで指定する場合は、後述の各クライアント設定を参照すること。 
 
==== Dockerを使用したインストール ====
Node.jsをインストールせずにDockerでMCPサーバを実行できる。 
 
docker run --rm -i mcp/sequentialthinking
 
==== npmを使用したグローバルインストール ====
グローバルにインストールする場合は、以下のコマンドを実行する。 
 
npm install -g @modelcontextprotocol/server-sequential-thinking
 

== MCPクライアントの設定 ==
==== 設定ファイルの場所 ====
各MCPクライアントの設定ファイルの場所は以下の通りである。 
 
Claude Desktopの設定ファイルを以下に示す。 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* MacOS
*: ~/Library/Application Support/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
Claude Codeの設定ファイルを以下に示す。 
* ローカルスコープ
*: .mcp.json (プロジェクトルート) : <code>claude mcp add</code> コマンドで生成される。
* ユーザスコープ
*: ~/.claude.json (ホームディレクトリ)
 
VS Codeの設定ファイルを以下に示す。 
* .vscode/mcp.json (プロジェクトルート)
 
Cursorの設定ファイルを以下に示す。 
* グローバル設定
*: ~/.cursor/mcp.json
* プロジェクト設定
*: .cursor/mcp.json
 
==== Claude Desktopの設定 ====
claude_desktop_config.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"sequential-thinking": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
}
}
}
</syntaxhighlight>
 
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。 
 
==== Claude Codeの設定 ====
Claude Codeでは、<code>claude mcp add</code> コマンドを実行してMCPサーバを追加できる。 
 
claude mcp add sequential-thinking -- npx -y @modelcontextprotocol/server-sequential-thinking
 
プロジェクトの .mcp.json ファイルに設定を記述する場合は、以下に示す内容を記述する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"sequential-thinking": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
}
}
}
</syntaxhighlight>
 
==== VS Code / Cursorの設定 ====
.vscode/mcp.json または .cursor/mcp.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"sequential-thinking": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
}
}
}
</syntaxhighlight>
 
==== Dockerを使用した設定 ====
Dockerを使用する場合は、設定ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"sequential-thinking": {
"command": "docker",
"args": ["run", "--rm", "-i", "mcp/sequentialthinking"]
}
}
}
</syntaxhighlight>
 
==== Windowsでの設定の注意点 ====
Windowsでは、<code>npx</code> を使用するMCPサーバの場合、<code>cmd /c</code> ラッパーが必須である。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"sequential-thinking": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@modelcontextprotocol/server-sequential-thinking"]
}
}
}
</syntaxhighlight>
 

== 環境変数 ==
==== 環境変数一覧 ====
下表に、Sequential Thinking MCP Serverの動作をカスタマイズするための環境変数を示す。 
 
<center>
{| class="wikitable"
|+ 環境変数の一覧
! 環境変数 !! 説明
|-
| <code>DISABLE_THOUGHT_LOGGING</code> || 思考プロセスのコンソールログ出力を制御する。 <code>true</code>: ログ出力を無効化する <code>false</code>: ログ出力を有効化する (デフォルト)
|}
</center>
 
Claude Desktopの設定ファイルで環境変数を指定する場合は、以下に示すように設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"sequential-thinking": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"],
"env": {
"DISABLE_THOUGHT_LOGGING": "true"
}
}
}
}
</syntaxhighlight>
 

== 提供ツール ==
Sequential Thinking MCP Serverが提供するツールは <code>sequential_thinking</code> の1つのみである。 
このツールは、必須パラメータとオプションパラメータを組み合わせて、柔軟な段階的思考プロセスを実現する。 
 
==== 必須パラメータ ====
下表に、<code>sequential_thinking</code> ツールの必須パラメータを示す。 
 
<center>
{| class="wikitable"
|+ 必須パラメータの一覧
! パラメータ !! 型 !! 説明
|-
| <code>thought</code> || 文字列 || 現在のステップにおける思考内容
|-
| <code>nextThoughtNeeded</code> || 真偽値 || さらなる思考ステップが必要かどうかを示す。 <code>true</code>: 継続が必要 <code>false</code>: 結論に到達
|-
| <code>thoughtNumber</code> || 整数 || 現在の思考番号 (1から開始)
|-
| <code>totalThoughts</code> || 整数 || 問題解決に必要と推定される総思考数 後から修正することも可能
|}
</center>
 
==== オプションパラメータ ====
下表に、<code>sequential_thinking</code> ツールのオプションパラメータを示す。 
 
これらのパラメータにより、修正・分岐・延長といった高度な推論制御が可能になる。 
 
<center>
{| class="wikitable"
|+ オプションパラメータの一覧
! パラメータ !! 型 !! 説明
|-
| <code>isRevision</code> || 真偽値 || 前の思考ステップの修正かどうかを示す。 デフォルト値は <code>false</code>
|-
| <code>revisesThought</code> || 整数 || 修正対象の思考番号。 <code>isRevision</code> が true の場合に使用する。
|-
| <code>branchFromThought</code> || 整数 || 分岐開始点の思考番号 代替経路を探索する場合に使用する。
|-
| <code>branchId</code> || 文字列 || 分岐を識別するための一意な識別子
|-
| <code>needsMoreThoughts</code> || 真偽値 || 推定思考数を超えて追加の思考が必要かどうかを示す。
|}
</center>
 

== 使用例 ==
Sequential Thinking MCP Serverのツールは、AIアシスタントが自然言語の指示を受けて自動的に呼び出す。 
 
==== 設計課題への適用 ====
複雑な設計課題に段階的思考を適用する場合の操作例を以下に示す。 
 
* マイクロサービスアーキテクチャを計画する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

マイクロサービスアーキテクチャを構築するための包括的な計画を、段階的に考えてください。
</syntaxhighlight>
*: 
* システム設計のレビューを行う場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

このシステム設計のセキュリティ、スケーラビリティ、保守性を段階的に評価してください。
</syntaxhighlight>
*: 
 
==== 技術選定・比較分析 ====
技術の選定や比較分析を段階的に行う場合の操作例を以下に示す。 
 
* クラウドプロバイダを比較する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

AWSとGCPのメリット・デメリットを段階的に比較分析してください。
</syntaxhighlight>
*: 
 
==== デバッグ・問題解析 ====
エラーや問題の原因を段階的に分析する場合の操作例を以下に示す。 
 
* エラーの原因を特定して解決策を提案する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

このエラーの原因を段階的に分析して、解決策を提案してください。
</syntaxhighlight>
*: 
 

== トラブルシューティング ==
==== 共通の問題 ====
下表に、OS問わず発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ 共通トラブルシューティング
! 問題 !! 対処法
|-
| Node.jsがインストールされていない || Node.js v18以上をインストールする。 [https://nodejs.org/ Node.js公式サイト]からインストーラをダウンロードする。
|-
| ツールが応答しない || メモリ不足でないか確認する。 初回実行時はパッケージのダウンロードが発生するため、ネットワーク接続を確認する。
|-
| JSON設定の構文エラーが発生する || JSONバリデータで設定ファイルの構文を確認する。 全角括弧（）が含まれていないかを確認する。
|-
| ツールがクライアントに表示されない || MCPクライアントを完全に再起動する。
|}
</center>
 
==== Windowsでの問題 ====
下表に、Windows環境で発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ Windowsのトラブルシューティング
! 問題 !! 対処法
|-
| npxコマンドが見つからない || <code>cmd /c</code> ラッパーを設定ファイルに追加する。 または、以下に示すコマンドを実行してグローバルインストールする。 <code>npm install -g @modelcontextprotocol/server-sequential-thinking</code>
|-
| ENOENTエラーが発生する || 設定ファイルに環境変数 (<code>PATH</code> 等) を明示的に指定する。
|}
</center>
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,Sequential Thinking,MCP,Model Context Protocol,段階的思考,Claude,AI,問題解決,推論,sequential_thinking,Anthropic,Claude Desktop,Claude Code,VS Code,Cursor
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

MCPサーバ - Docker

2026-03-25T06:52:13Z

Wiki: ページの作成:「== 概要 == Docker MCP Catalog and Toolkitは、Docker社が提供するMCPサーバの統合管理プラットフォームである。 Docker Desktopに組み込まれた Docker MCP Toolkit と Docker MCP Catalog から構成される。 Docker MCP Catalogは200以上の検証済みMCPサーバを含む信頼できるレジストリであり、Docker Hub上で配布されている。 Docker MCP Toolkitは、MCPサーバのセット…」

== 概要 ==
Docker MCP Catalog and Toolkitは、Docker社が提供するMCPサーバの統合管理プラットフォームである。 
Docker Desktopに組み込まれた Docker MCP Toolkit と Docker MCP Catalog から構成される。 
 
Docker MCP Catalogは200以上の検証済みMCPサーバを含む信頼できるレジストリであり、Docker Hub上で配布されている。 
Docker MCP Toolkitは、MCPサーバのセットアップ・管理・実行を行うDocker Desktopに統合されたUIツールである。 
 
Claude Desktop、Claude Code、VS Code、Cursor等の主要AIクライアントと統合できる。 
Windows、MacOS、Linuxの主要なOSに対応しており、Docker Desktop 4.59以降で利用可能である。 
 
主な特徴は以下の通りである。 
* 200以上の検証済みMCPサーバへのアクセス (Docker MCP Catalog)
* Docker DesktopのUIからMCPサーバを簡単にセットアップ・管理 (Docker MCP Toolkit)
* コンテナ隔離によるセキュアなMCPサーバ実行環境
* Docker社によるデジタル署名とSBOM (ソフトウェア部品表) による信頼性の確保
* Docker Desktopの暗号化シークレット機能による認証情報の安全な管理
* Stripe、Elastic、Neo4j、Grafana等200以上のパートナー製MCPサーバに対応
 

== 主要コンポーネント ==
Docker MCP Catalog and Toolkitは、3つの主要コンポーネントで構成されている。 
 
==== Docker MCP Catalog ====
200以上のMCPサーバを含む信頼できるレジストリである。 
Docker Hub上で <code>mcp/</code> 名前空間以下に配布されており、Docker社によるデジタル署名とSBOMが付与されている。 
 
主なパートナーMCPサーバは以下の通りである。 
* Stripe
* Elastic
* Neo4j
* Grafana
* New Relic
* Atlassian
* Slack
* Notion
* Kong
* GitLab
 
==== Docker MCP Toolkit ====
Docker Desktopに統合されたUIツールである。 
MCPサーバのセットアップ・管理・実行を行い、AIクライアントとの接続設定を自動化する。 
 
==== Docker MCP Gateway ====
MCPサーバのコンテナ管理とAIクライアント間の通信を仲介するCLIプラグインである。 
 
* GitHub
*: [https://github.com/docker/mcp-gateway docker/mcp-gateway]
 
以下に示す2つの方法で実行できる。 
* CLI経由
*: <code>docker mcp gateway run</code>
* npx経由
*: <code>npx @docker/mcp-gateway</code>
 

== 動作要件 ==
==== 前提条件 ====
Docker MCP Catalog and Toolkitを使用するために必要な前提条件を以下に示す。 
 
* Docker Desktop 4.59以降
*: Docker MCP Toolkitが統合されている最低バージョン
* 対応OS
*: Windows
*: MacOS
*: Linux
 

== インストール ==
==== Docker DesktopでのMCP Toolkitの有効化 ====
Docker Desktop上でDocker MCP Toolkitを有効化する手順を以下に示す。 
 
# Docker Desktopを起動する。
# [Settings] - [Beta Features]を開く。
# [Enable Docker MCP Toolkit]にチェックを入力する。
# Docker Desktopを再起動する。
 
有効化後、Docker Desktopのサイドバーに[MCP Toolkit]のタブが表示される。 
 

== MCPクライアントの設定 ==
Docker MCP Toolkitでは、Docker DesktopのUIからAIクライアントへの接続設定を自動的に行うことができる。 
 
==== Claude Desktopの設定 ====
Docker DesktopのClientsタブからClaude Desktopを選択して、[Connect]を選択することにより自動設定が行われる。 
 
手動で設定する場合は、Claude Desktopの設定ファイルに以下に示す内容を設定する。 
 
Claude Desktopの設定ファイルの場所は以下の通りである。 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* MacOS
*: ~/Library/Application Support/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
設定ファイルに以下の内容を追記する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"docker": {
"command": "docker",
"args": ["mcp", "gateway", "run"]
}
}
}
</syntaxhighlight>
 
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。 
 
==== Claude Codeの設定 ====
Docker DesktopのClientsタブからClaude Codeを選択して、[Connect]を選択することにより設定が行われる。 
 
CLIで設定する場合は、以下に示すコマンドを実行する。 
 
docker mcp client connect claude-code
 
.mcp.json ファイルに手動で設定する場合は、以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"docker": {
"command": "docker",
"args": ["mcp", "gateway", "run"]
}
}
}
</syntaxhighlight>
 
==== VS Codeの設定 ====
settings.json ファイルに以下に示す内容を設定した後、以下に示すコマンドを実行する。 
 
<syntaxhighlight lang="json">
{
"mcp": {
"servers": {
"docker": {
"command": "docker",
"args": ["mcp", "gateway", "run"]
}
}
}
}
</syntaxhighlight>
 
docker mcp client connect vscode
 
==== Cursorの設定 ====
Docker DesktopのClientsタブからCursorを選択して、[Connect]を選択する。 
設定適用後、Cursorを完全に終了して再起動する。 
 

== 提供されるMCPサーバのツール ==
==== Docker Hub MCP Serverのツール ====
Docker Hub MCP Serverは、コンテナイメージとリポジトリの検索・情報取得に関するツールを提供する。 
 
<center>
{| class="wikitable"
|+ Docker Hub MCP Serverのツール一覧
! ツール !! 説明
|-
| <code>search_images</code> || 自然言語によるコンテナイメージの検索を行う。
|-
| <code>get_image_details</code> || 指定したイメージの詳細情報を取得する。
|-
| <code>get_image_tags</code> || 指定したイメージのタグ一覧を取得する。
|-
| <code>search_repositories</code> || Docker Hub上のリポジトリを検索する。
|-
| <code>get_repository_details</code> || 指定したリポジトリの統計情報を取得する。
|}
</center>
 
==== Dockerコンテナ管理MCPサーバのツール ====
Dockerコンテナ管理MCPサーバは、コンテナおよびイメージの管理に関するツールを提供する。 
 
<center>
{| class="wikitable"
|+ Dockerコンテナ管理MCPサーバのツール一覧
! ツール !! 説明
|-
| <code>list_containers</code> || 実行中および停止中のコンテナ一覧を表示する。
|-
| <code>create_container</code> || 新しいコンテナを作成する。
|-
| <code>start_container</code> || 指定したコンテナを起動する。
|-
| <code>stop_container</code> || 指定したコンテナを停止する。
|-
| <code>remove_container</code> || 指定したコンテナを削除する。
|-
| <code>get_container_logs</code> || 指定したコンテナのログを取得する。
|-
| <code>list_images</code> || ローカルのDockerイメージ一覧を表示する。
|-
| <code>pull_image</code> || Docker Hubから指定したイメージをプルする。
|-
| <code>deploy_compose</code> || Docker Composeスタックをデプロイする。
|}
</center>
 

== 使用方法 ==
MCPサーバを設定後、AIアシスタントに自然言語で指示するだけで、対応するツールが自動的に呼び出される。 
 
==== Docker Hub MCPサーバの使用例 ====
Docker Hubのイメージやリポジトリを検索・確認する操作例を以下に示す。 
 
* Nginxの最新イメージを検索する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

Docker Hubから公式のNginxイメージを検索して、最新のタグ一覧を表示してください。
</syntaxhighlight>
*: 
* Pythonイメージの詳細情報を確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

python:3.12-slimイメージの詳細情報とサイズを教えてください。
</syntaxhighlight>
 
==== Dockerコンテナ管理MCPサーバの使用例 ====
コンテナとイメージの管理に関する操作例を以下に示す。 
 
* 実行中のコンテナを確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

現在実行中のDockerコンテナ一覧を表示してください。
</syntaxhighlight>
*: 
* コンテナのログを確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

my-appコンテナの最新100行のログを表示してください。
</syntaxhighlight>
*: 
* Docker Composeスタックをデプロイする場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

docker-compose.ymlを使用してアプリケーションスタックをデプロイしてください。
</syntaxhighlight>
 

== セキュリティ ==
==== セキュリティ機能の概要 ====
Docker MCP Catalog and Toolkitは、MCPサーバの安全な実行のために複数のセキュリティ機能を提供する。 
 
<center>
{| class="wikitable"
|+ セキュリティ機能の一覧
! 機能 !! 説明
|-
| コンテナ隔離 || 各MCPサーバはコンテナとして実行され、リソース制限が適用される。 CPU使用率は1コア以下、メモリは2[GB]以上の割り当てが推奨される。
|-
| デジタル署名 || Docker Hub上のmcp/カタログイメージはDocker社がデジタル署名を行っている。
|-
| SBOM (ソフトウェア部品表) || 全てのカタログイメージにSBOMが含まれており、コンポーネントの透明性を確保している。
|-
| シークレット管理 || Docker Desktopの暗号化シークレット機能を使用して、APIキー等の認証情報を安全に保管する。
|-
| ツール許可リスト || 特定のツールのみを許可する設定が可能であり、AIアシスタントが使用できるツールを制限できる。
|}
</center>
 
==== セキュリティに関する推奨事項 ====
Docker MCP Catalog and Toolkitを安全に使用するための推奨事項を以下に示す。 
 
* APIキーや認証情報は、設定ファイルに直接記述せず、Docker Desktopのシークレット管理機能を使用して保管する。
* ツール許可リストを設定して、AIアシスタントが実行できる操作を必要最小限に制限する。
* Docker Hub上のイメージはDocker社が署名した検証済みのものを使用し、非公式イメージの使用は避ける。
* コマンドインジェクション対策として、AIアシスタントからの操作実行前にユーザ確認が求められる場合がある。これは正常な動作である。
 

== トラブルシューティング ==
==== よくある問題と対処法 ====
下表に、Docker MCP Catalog and Toolkitの使用時に発生しやすい問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ トラブルシューティング一覧
! 問題 !! 原因 !! 対処法
|-
| Docker DesktopがMCP Toolkitを認識しない || Beta FeaturesでDocker MCP Toolkitが有効になっていない。 または、Docker Desktopのバージョンが古い。 || [Settings] - [Beta Features]を開いて、 [Enable Docker MCP Toolkit]を有効化してDocker Desktopを再起動する。 Docker Desktopを4.59以降にアップデートする。
|-
| MCPクライアントが接続できない || クライアントの設定が正しく適用されていない。 または、MCP Gatewayが起動していない。 || Docker DesktopのClientsタブで接続状態を確認して、 [Connect]で再接続する。 MCPクライアントを完全に終了して再起動する。
|-
| MCPサーバが起動しない || Docker Desktopが実行されていない。 または、リソースが不足している。 || <code>docker ps</code> コマンドでDocker Desktopの動作を確認する。 [Settings] - [Resources]でリソース割り当てを確認・調整する。 コンテナログを確認してエラーの詳細を調べる。
|-
| APIキーが認識されない || 環境変数や認証情報の設定が正しくない。 || Docker Desktopの[Config]タブで環境変数の設定を再確認する。 設定変更後にMCPサーバを再起動する。
|-
| セキュリティ警告が表示される || コマンドインジェクション対策によるユーザ確認が求められている。 || これは正常な動作である。 内容を確認して、問題がなければ許可する。
|}
</center>
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,Docker,Docker Desktop,MCP,Model Context Protocol,Docker MCP,MCP Toolkit,MCP Catalog,MCP Gateway,Claude,Claude Code,Claude Desktop,VS Code,Cursor,AIアシスタント,コンテナ,MCPサーバ
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

MCPサーバ - Memory Bank

2026-03-25T06:43:43Z

Wiki: ページの作成:「== 概要 == Memory Bank MCP (@allpepper/memory-bank-mcp) は、AIアシスタントのコンテキスト永続化を実現するMCPサーバ実装である。 Cline Memory Bankの概念を基に、マルチプロジェクト対応のMCP実装として拡張されている。 プロジェクト固有の知識をマークダウンファイルで構造化して、複数のセッションにわたってAIアシスタントが継続的にアクセスでき…」

== 概要 ==
Memory Bank MCP (@allpepper/memory-bank-mcp) は、AIアシスタントのコンテキスト永続化を実現するMCPサーバ実装である。 
Cline Memory Bankの概念を基に、マルチプロジェクト対応のMCP実装として拡張されている。 
 
プロジェクト固有の知識をマークダウンファイルで構造化して、複数のセッションにわたってAIアシスタントが継続的にアクセスできる永続メモリシステムを提供する。 
これにより、AIアシスタントはセッションをまたいでプロジェクトの背景・設計・進捗情報を保持し、継続的な作業を行えるようになる。 
 
開発元はalioshr (GitHub) であり、MITライセンスのもとで公開されている。 
npmパッケージ名は <code>@allpepper/memory-bank-mcp</code> で、[https://github.com/alioshr/memory-bank-mcp GitHubリポジトリ] から入手できる。 
 
Claude Desktop、Claude Code、Cline、Roo Code、VS Code、Cursor等の主要なMCPクライアントに対応し、Windows、MacOS、Linuxで動作する。 
 
下表に、主な機能を示す。 
 
<center>
{| class="wikitable"
|+ 主な機能一覧
|-
! 機能 !! 説明
|-
| マルチプロジェクト対応 || プロジェクト固有のメモリバンクディレクトリで隔離管理
|-
| 永続コンテキスト || セッション間でプロジェクトの知識を保持
|-
| ファイル操作 || 構造化されたマークダウンファイルの読み取り・書き込み・更新
|-
| セキュリティ || パストラバーサル防止による安全なファイルアクセス
|}
</center>
 

== 動作要件 ==
==== 前提条件 ====
Memory Bank MCPを使用するために必要な前提条件を以下に示す。 
 
* Node.js
*: v16以上が必要。v18以上を推奨。
* npxコマンド
*: <code>npx</code> コマンドを使用して、Memory Bank MCPを実行するために必要
*: Node.jsに同梱されている。
* メモリバンク用ディレクトリ
*: 環境変数 <code>MEMORY_BANK_ROOT</code> で指定するディレクトリが必要
*: 事前に作成しておくこと。
 

== インストール ==
==== Smithery経由のインストール ====
Smithery CLIを使用してインストールする場合は、以下に示すコマンドを実行する。 
 
npx -y @smithery/cli install @allpepper/memory-bank-mcp --client claude
 
<code>--client</code> オプションには、使用するMCPクライアント名 (claude 等) を指定する。 
 
==== NPM直接インストール ====
npmを使用してグローバルインストールする場合は、以下に示すコマンドを実行する。 
 
npm install -g @allpepper/memory-bank-mcp
 

== MCPクライアントの設定 ==
==== 設定ファイルの場所 ====
各MCPクライアントの設定ファイルの場所は、以下の通りである。 
 
===== Claude Desktop =====
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* MacOS
*: ~/Library/Application Support/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
===== Claude Code =====
* ローカルスコープ
*: .mcp.json (プロジェクトルート) : <code>claude mcp add</code> コマンドで生成される。
* ユーザスコープ
*: ~/.claude.json (ホームディレクトリ)
 
===== VS Code =====
* .vscode/mcp.json (プロジェクトルート)
 
===== Cursor =====
* グローバル設定
*: ~/.cursor/mcp.json
* プロジェクト設定
*: .cursor/mcp.json
 
==== Claude Desktopの設定 ====
claude_desktop_config.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"memory-bank": {
"command": "npx",
"args": ["-y", "@allpepper/memory-bank-mcp@latest"],
"env": {
"MEMORY_BANK_ROOT": "/path/to/memory-banks"
}
}
}
}
</syntaxhighlight>
 
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。 
 
==== Claude Codeの設定 ====
Claude Codeでは、<code>claude mcp add</code> コマンドを実行して、Memory Bank MCPを追加できる。 
 
以下に示すコマンドで、MCPサーバをClaude Codeに登録する。 
 
claude mcp add memory-bank -- npx -y @allpepper/memory-bank-mcp@latest
 
プロジェクトの .mcp.json ファイルに設定を記述する場合は、以下の内容を記述する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"memory-bank": {
"command": "npx",
"args": ["-y", "@allpepper/memory-bank-mcp@latest"],
"env": {
"MEMORY_BANK_ROOT": "/path/to/memory-banks"
}
}
}
}
</syntaxhighlight>
 
==== VS Code / Cursorの設定 ====
.vscode/mcp.json または .cursor/mcp.json ファイルに以下に示す内容を設定する。 
ワークスペースフォルダ内にメモリバンクを配置する場合は、変数 <code>${workspaceFolder}</code> を使用できる。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"memory-bank": {
"command": "npx",
"args": ["-y", "@allpepper/memory-bank-mcp@latest"],
"env": {
"MEMORY_BANK_ROOT": "${workspaceFolder}/memory-banks"
}
}
}
}
</syntaxhighlight>
 

== 環境変数 ==
==== 環境変数一覧 ====
下表に、Memory Bank MCPの動作をカスタマイズするための環境変数を示す。 
 
<center>
{| class="wikitable"
|+ 環境変数の一覧
! 環境変数 !! 必須 !! 説明
|-
| <code>MEMORY_BANK_ROOT</code> || 必須 || メモリバンクディレクトリのルートパスを指定する。 全プロジェクトのメモリバンクがこのディレクトリ配下に作成される。
|-
| <code>MEMORY_BANK_FOLDER</code> || オプション || メモリバンクのカスタムフォルダ名を指定する。 デフォルト値は memory-bank である。
|}
</center>
 

== 提供ツール ==
==== ツール一覧 ====
下表に、Memory Bank MCPが提供するツールを示す。 
 
<center>
{| class="wikitable"
|+ 提供ツールの一覧
! ツール名 !! 説明 !! パラメータ
|-
| <code>memory_bank_read</code> || メモリバンクファイルの内容を読み取る。 || <code>projectId</code>: プロジェクト識別子 <code>filePath</code>: 読み取るファイルのパス
|-
| <code>memory_bank_write</code> || 新規メモリバンクファイルを作成して内容を書き込む。 || <code>projectId</code>: プロジェクト識別子 <code>filePath</code>: 作成するファイルのパス <code>content</code>: 書き込む内容
|-
| <code>memory_bank_update</code> || 既存のメモリバンクファイルを部分的に更新する。 || <code>projectId</code>: プロジェクト識別子 <code>filePath</code>: 更新するファイルのパス <code>patches</code>: 適用するパッチ内容
|-
| <code>list_projects</code> || メモリバンクに登録されているプロジェクトの一覧を表示する。 || なし
|-
| <code>list_project_files</code> || 指定したプロジェクト内のファイル一覧を表示する。 || <code>projectId</code>: プロジェクト識別子
|}
</center>
 

== メモリバンクのファイル構造 ==
==== 推奨ファイル構成 ====
メモリバンクは、プロジェクトルート配下の memory-bank ディレクトリに構造化されたマークダウンファイルとして保存される。 
推奨されるファイル構成を以下に示す。 
 
<プロジェクト>/
└── memory-bank/
├── projectContext.md # プロジェクトの基礎定義 (目的、スコープ、制約)
├── productContext.md # ビジネス・ユーザー視点の背景情報
├── activeContext.md # 現在のセッション状態とタスク情報
├── systemPatterns.md # 技術アーキテクチャと設計パターン
├── techContext.md # 技術スタック・開発環境の詳細
├── progress.md # プロジェクトの進捗状況と履歴
└── decisionLog.md # 技術的意思決定の記録 (オプション)
</syntaxhighlight>
 
==== 各ファイルの役割 ====
下表に、各メモリバンクファイルの役割と記録する内容を示す。 
 
<center>
{| class="wikitable"
|+ メモリバンクファイルの一覧
! ファイル名 !! 役割 !! 記録する内容
|-
| projectContext.md || プロジェクトの基礎定義 || プロジェクトの目的、スコープ、制約条件
|-
| productContext.md || 製品・ビジネス背景 || ビジネス要件、ユーザー視点の背景情報
|-
| activeContext.md || 現在の作業状態 || 現在のセッション状態、進行中のタスク情報
|-
| systemPatterns.md || 技術設計情報 || 技術アーキテクチャ、設計パターン、規約
|-
| techContext.md || 技術環境情報 || 技術スタック、開発環境の詳細、依存関係
|-
| progress.md || 進捗管理 || プロジェクトの進捗状況と作業履歴
|-
| decisionLog.md || 意思決定記録 (オプション) || 技術的意思決定とその根拠の記録
|}
</center>
 

== 使用例 ==
Memory Bank MCPの各ツールは、AIアシスタントが自然言語の指示を受けて自動的に呼び出す。 
 
==== メモリバンクの初期化 ====
プロジェクト開始時にメモリバンクを初期化する場合の操作例を以下に示す。 
 
* 新しいプロジェクトでメモリバンクを作成する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

Initialize a memory bank for this project.
</syntaxhighlight>
*: 
 
==== セッション開始時の確認 ====
セッション開始時に前回の作業状態を確認する場合の操作例を以下に示す。 
 
* 前回のセッションからの継続作業を確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

Let me check the active context to see where we left off.
</syntaxhighlight>
*: 
 
==== 設計決定の記録 ====
アーキテクチャや技術的な意思決定をメモリバンクに記録する場合の操作例を以下に示す。 
 
* 技術的な設計決定を記録する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

Record this architectural decision in the memory bank.
</syntaxhighlight>
*: 
 
==== 進捗の更新 ====
作業の進捗状況をメモリバンクに記録する場合の操作例を以下に示す。 
 
* 本日完了した作業を進捗ファイルに記録する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

Update the progress file to reflect what we've completed today.
</syntaxhighlight>
*: 
 

== トラブルシューティング ==
==== 一般的な問題 ====
下表に、Memory Bank MCPで発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ トラブルシューティング一覧
! 問題 !! 原因 !! 対処法
|-
| Node.jsバージョンエラーが発生する || Node.jsのバージョンが要件を満たしていない。 || Node.js v18以上にアップグレードする。 アップグレード後、パッケージを再インストールする。
|-
| サーバが起動しない || 設定ファイルの記述が誤っている。 || 設定JSONの <code>command</code> と <code>args</code> の内容を確認する。 ターミナルで手動実行してエラー内容を確認する。
|-
| JSON解析エラーが発生する || サーバの出力に不正なJSON形式が含まれている。 || サーバのログを確認する。 パッケージを一度アンインストールして再インストールする。
|-
| 接続タイムアウトが発生する || サーバの起動に時間が掛かっている。 || MCPクライアントの設定でタイムアウト値を増加させる。 例: <code>"timeout": 300000</code>
|-
| 権限エラーが発生する || <code>MEMORY_BANK_ROOT</code> で指定したディレクトリへの書き込み権限がない。 || ディレクトリの書き込み権限を確認する。 例: <code>ls -ld /path/to/memory-banks</code> 権限がない場合は、<code>chmod 755 /path/to/memory-banks</code> を実行する。
|-
| パストラバーサルエラーが発生する || 指定したファイルパスが <code>MEMORY_BANK_ROOT</code> 配下にない。 || ファイルパスが <code>MEMORY_BANK_ROOT</code> 内に収まっているか確認する。 <code>../</code> 等の相対パスによる上位ディレクトリへのアクセスは拒否される。
|}
</center>
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,Memory Bank,MCP,Model Context Protocol,memory-bank-mcp,Claude,Claude Code,Claude Desktop,Cline,Roo Code,VS Code,Cursor,AIアシスタント,永続メモリ,コンテキスト,プロジェクト管理
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

MCPサーバ - Filesystem

2026-03-25T06:37:42Z

Wiki: ページの作成:「== 概要 == Filesystem MCP Server (@modelcontextprotocol/server-filesystem) は、AnthropicがNode.jsで実装したMCPサーバである。 MITライセンスで公開されている。 Model Context Protocol (MCP) を通じて、AIアシスタントにローカルファイルシステムへの安全で制御されたアクセスを提供する。 起動時に許可するディレクトリを明示的に指定することで、AIアシスタント…」

== 概要 ==
Filesystem MCP Server (@modelcontextprotocol/server-filesystem) は、AnthropicがNode.jsで実装したMCPサーバである。 
MITライセンスで公開されている。 
 
Model Context Protocol (MCP) を通じて、AIアシスタントにローカルファイルシステムへの安全で制御されたアクセスを提供する。 
起動時に許可するディレクトリを明示的に指定することで、AIアシスタントはそのディレクトリ内に限定したファイル操作を実行できる。 
 
Claude Desktop、Claude Code、VS Code、Cursor等の主要なMCPクライアントに対応している。 
Windows、MacOS、Linuxに対応する。 
 
主な特徴は以下の通りである。 
* 14個のファイル操作ツールを提供 (読み取り、書き込み、ディレクトリ管理、検索等)
* 指定ディレクトリ外へのアクセスをブロックするパストラバーサル防止機能
* Dockerイメージ (mcp/filesystem) による実行にも対応
* Rootsプロトコルによる実行時のディレクトリ動的更新
* Dockerの <code>:ro</code> フラグを使用した読み取り専用アクセスの設定が可能
 

== 動作要件 ==
==== 前提条件 ====
Filesystem MCP Serverを使用するために必要な前提条件を以下に示す。 
 
* Node.js v18.0.0以上
*: <code>npx</code> コマンドを使用してFilesystem MCP Serverを実行するために必要
* <code>npx</code> コマンド
*: Node.jsに同梱されているため、Node.jsのインストールで利用可能になる。
* Docker (オプション)
*: Dockerを使用してFilesystem MCP Serverを実行する場合に必要
 

== インストール ==
==== npxを使用した実行 ====
<code>npx</code> コマンドを使用する場合、インストール不要でFilesystem MCP Serverを直接実行できる。 
アクセスを許可するディレクトリへの絶対パスをコマンドライン引数で指定する (複数指定可能)。 
 
npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory1 /path/to/allowed/directory2
 
MCPクライアントの設定ファイルで指定する場合は、後述の各クライアント設定を参照すること。 
 
==== Dockerを使用した実行 ====
Docker Hubに公式イメージ (mcp/filesystem) が公開されており、Node.jsをインストールせずにFilesystem MCP Serverを実行できる。 
 
以下に示すコマンドを実行することにより、ローカルディレクトリをコンテナ内の <code>/projects</code> にマウントしてサーバを起動する。 
<code>:ro</code> フラグを付与することで、読み取り専用アクセスとなる。 
 
docker run -i --rm -v /path/to/local/directory:/projects:ro mcp/filesystem
 
書き込みアクセスを許可する場合は、<code>:ro</code> フラグを省略する。 
 
docker run -i --rm -v /path/to/local/directory:/projects mcp/filesystem
 

== MCPクライアントの設定 ==
==== 設定ファイルの場所 ====
各MCPクライアントの設定ファイルの場所は以下の通りである。 
 
Claude Desktopの設定ファイルを以下に示す。 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* MacOS
*: ~/Library/Application Support/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
Claude Codeの設定ファイルを以下に示す。 
* ローカルスコープ
*: .mcp.json (プロジェクトルート) : <code>claude mcp add</code> コマンドで生成される。
* ユーザスコープ
*: ~/.claude.json (ホームディレクトリ)
 
VS Codeの設定ファイルを以下に示す。 
* .vscode/mcp.json (プロジェクトルート)
 
Cursorの設定ファイルを以下に示す。 
* グローバル設定
*: ~/.cursor/mcp.json
* プロジェクト設定
*: .cursor/mcp.json
 
==== Claude Desktopの設定 ====
claude_desktop_config.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory1", "/path/to/allowed/directory2"]
}
}
}
</syntaxhighlight>
 
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。 
 
==== Claude Codeの設定 ====
Claude Codeでは、<code>claude mcp add</code> コマンドを使用してFilesystem MCP Serverを追加できる。 
 
以下に示すコマンドで、MCPサーバをClaude Codeに登録する。 
 
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory
 
プロジェクトスコープで設定する場合は、<code>--scope project</code> オプションを追加する。 
設定は、.mcp.json ファイルに保存される。 
 
claude mcp add --scope project filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory
 
上記コマンドにより生成される .mcp.json ファイルの内容を以下に示す。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
}
}
}
</syntaxhighlight>
 
==== VS Codeの設定 ====
.vscode/mcp.json ファイルに以下に示す内容を設定する。 
変数 <code>${workspaceFolder}</code> を使用することにより、ワークスペースのルートディレクトリを自動的に許可対象に指定できる。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "${workspaceFolder}"]
}
}
}
</syntaxhighlight>
 
==== Cursorの設定 ====
~/.cursor/mcp.json (グローバル設定) または .cursor/mcp.json (プロジェクト設定) ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
}
}
}
</syntaxhighlight>
 

== 提供ツール ==
Filesystem MCP Serverは、ファイル読み取り、ファイル書き込み、ディレクトリ管理、ファイル検索・管理の4カテゴリで合計14個のツールを提供する。 
 
==== ファイル読み取りツール ====
下表に、ファイルの内容を読み込むためのツールを示す。 
 
<center>
{| class="wikitable"
|+ ファイル読み取りツールの一覧
! ツール名 !! 説明
|-
| <code>read_file</code> || 指定したファイルの完全な内容を読み込む。
|-
| <code>read_text_file</code> || テキストファイルを読み込む。 <code>read_file</code> よりも詳細なエラーメッセージを提供する。
|-
| <code>read_media_file</code> || 画像やオーディオファイルをBase64エンコードして読み込む。
|-
| <code>read_multiple_files</code> || 複数のファイルを同時に読み込む。
|}
</center>
 
==== ファイル書き込みツール ====
下表に、ファイルの作成・編集を行うためのツールを示す。 
 
<center>
{| class="wikitable"
|+ ファイル書き込みツールの一覧
! ツール名 !! 説明
|-
| <code>write_file</code> || ファイルを新規作成する。 既存ファイルが存在する場合は上書きする。
|-
| <code>edit_file</code> || 行ベースの編集を行う。 検索・置換操作に対応し、git形式のdiffを出力する。
|}
</center>
 
==== ディレクトリ管理ツール ====
下表に、ディレクトリの作成・参照を行うためのツールを示す。 
 
<center>
{| class="wikitable"
|+ ディレクトリ管理ツールの一覧
! ツール名 !! 説明
|-
| <code>create_directory</code> || ディレクトリを作成する。 ネストしたディレクトリ構造の作成にも対応する。
|-
| <code>list_directory</code> || ディレクトリの内容を一覧表示する。 ファイルには <code>[FILE]</code>、ディレクトリには <code>[DIR]</code> のプレフィックスが付与される。
|-
| <code>list_directory_with_sizes</code> || ファイルサイズを含むディレクトリの内容を一覧表示する。
|-
| <code>directory_tree</code> || ディレクトリ構造をJSON形式のツリーとして取得する。
|}
</center>
 
==== ファイル検索・管理ツール ====
下表に、ファイルの検索・メタデータ取得・移動に関するツールを示す。 
 
<center>
{| class="wikitable"
|+ ファイル検索・管理ツールの一覧
! ツール名 !! 説明
|-
| <code>search_files</code> || グロブパターンを使用してファイルを再帰的に検索する。
|-
| <code>get_file_info</code> || ファイルのメタデータを取得する。 取得できる情報: ファイルサイズ、作成日時、更新日時等
|-
| <code>move_file</code> || ファイルまたはディレクトリを移動する。 ファイル、ディレクトリのリネームにも使用できる。
|-
| <code>list_allowed_directories</code> || サーバ起動時に許可として設定されたディレクトリの一覧を表示する。
|}
</center>
 

== セキュリティ ==
==== アクセス制限の仕組み ====
Filesystem MCP Serverは、起動時に指定したディレクトリのみへのアクセスを許可する設計となっている。 
指定ディレクトリ外へのアクセス試行はブロックされる。 
 
主なセキュリティ機能を以下に示す。 
* 指定ディレクトリへのアクセス制限
*: サーバ起動時にコマンドライン引数で指定したディレクトリのみにアクセスを限定する。
* パストラバーサル防止
*: <code>../</code> 等を利用した許可ディレクトリ外へのアクセスを防止する。
* Rootsプロトコルによる動的更新
*: MCPのRootsプロトコルにより、実行時に許可ディレクトリを動的に更新できる。
* Docker使用時の読み取り専用設定
*: Docker実行時に <code>:ro</code> フラグを付与することで、マウントしたディレクトリへの書き込みを禁止できる。
 
==== セキュリティ上の注意事項 ====
下表に、Filesystem MCP Serverを安全に使用するための推奨事項を示す。 
 
<center>
{| class="wikitable"
|+ セキュリティに関する推奨事項
! 項目 !! 説明
|-
| 許可ディレクトリの最小化 || 必要最小限のディレクトリのみを許可対象として指定する。 ルートディレクトリ (/ や C:\) を許可対象に含めることは避けること。
|-
| 読み取り専用の活用 || 書き込みが不要な用途では、 Dockerの <code>:ro</code> フラグを使用して読み取り専用で実行することを推奨する。
|-
| バージョン管理 || 過去バージョンにパス検証の脆弱性が存在したため、常に最新バージョンを使用すること。 最新版では修正済みである。
|}
</center>
 

== 使用例 ==
Filesystem MCP Serverのツールは、AIアシスタントが自然言語の指示を受けて自動的に呼び出す。 
 
==== ファイルの読み取り ====
ファイルの内容を読み込む場合の操作例を以下に示す。 
 
* 単一ファイルを読み込む場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects/config.yaml の内容を読み込んでください。
</syntaxhighlight>
*: 
* 複数ファイルをまとめて読み込む場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

src/main.py と src/utils.py の2つのファイルを同時に読み込んでください。
</syntaxhighlight>
*: 
 
==== ディレクトリの参照 ====
ディレクトリの内容を確認する場合の操作例を以下に示す。 
 
* ディレクトリの一覧を表示する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects ディレクトリの内容を一覧表示してください。
</syntaxhighlight>
*: 
* ディレクトリ構造をツリー形式で確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects/myapp のディレクトリツリーを表示してください。
</syntaxhighlight>
*: 
 
==== ファイルの作成・編集 ====
ファイルを作成または編集する場合の操作例を以下に示す。 
 
* 新しいファイルを作成する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects/myapp/README.md を作成して、プロジェクトの概要を記述してください。
</syntaxhighlight>
*: 
* 既存ファイルを編集する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects/myapp/config.py の DEBUG 変数の値を False に変更してください。
</syntaxhighlight>
*: 
 
==== ファイルの検索 ====
特定のファイルを検索する場合の操作例を以下に示す。 
 
* globパターンでPythonファイルを検索する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

/home/user/Projects 配下にある全ての .py ファイルを検索してください。
</syntaxhighlight>
*: 
 

== トラブルシューティング ==
==== 共通の問題 ====
下表に、OS問わず発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ 共通トラブルシューティング
! 問題 !! 原因 !! 対処法
|-
| Server transport closed unexpectedly エラーが発生する || PATHの問題 NVM等のバージョンマネージャを使用している場合に発生しやすい。 || Node.jsの完全パスを設定ファイルの <code>command</code> に指定する。 または、NVM向けのラッパースクリプトを作成して使用する。
|-
| MCP filesystem: Server disconnected エラーが発生する || NVM環境での実行時に環境が正しく初期化されていない。 || シェルの設定ファイルでNVMを正しく初期化した上でMCPクライアントを起動する。 または、<code>nvm use</code> を実行してからMCPクライアントを起動する。
|-
| 設定ファイルが読み込まれない || JSONファイルにコメントが含まれている。 JSON標準仕様ではコメントは使用不可である。 || 設定ファイルからコメントを全て削除する。
|-
| アクセスが拒否される || 指定した許可ディレクトリの外にあるファイルへのアクセスを試みている。 || <code>list_allowed_directories</code> ツールで許可ディレクトリを確認し、 必要に応じてサーバの起動引数に対象ディレクトリを追加する。
|}
</center>
 
==== Windowsでの問題 ====
下表に、Windows環境で発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ Windowsのトラブルシューティング
! 問題 !! 原因 !! 対処法
|-
| パスが正しく認識されない || OneDriveが有効な場合、表示上のパスと実際のパスが異なることがある。 || エクスプローラーでフォルダのプロパティを確認し、 実際のパスを設定ファイルに記述する。
|-
| サーバが起動しない || <code>npx</code> コマンドがWindowsのパス解決で問題を起こすことがある。 || <code>command</code> に <code>cmd</code>、<code>args</code> の先頭に <code>["/c", "npx"]</code> を追加して <code>cmd /c</code> ラッパーを使用する。
|}
</center>
 
==== 一般的なデバッグ手順 ====
問題が発生した場合は、以下に示す手順でデバッグを行う。 
 
# MCPクライアント (Claude Desktop等) を完全に終了する。
# 設定ファイルのJSON構文を検証する。(JSONリンターを使用する)
# Node.jsのバージョンが、v18.0.0以上であることを確認する。
# <code>npx</code> コマンドが使用可能であることを確認する。(<code>npx --version</code> を実行する)
# 以下に示すコマンドを手動で実行してサーバが正常に起動するか確認する。
#: <code>npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory</code>
# MCPクライアントを再起動する。
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,Filesystem,MCP,Model Context Protocol,filesystem-mcp-server,Claude,Claude Desktop,Claude Code,VS Code,Cursor,Node.js,npx,Docker,ファイルシステム,AIアシスタント,MCPサーバ
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

MCPサーバ - Context7

2026-03-25T06:30:13Z

Wiki: ページの作成:「== 概要 == Context7 MCP Server (@upstash/context7-mcp) は、Upstashが開発したMCPサーバである。 LLMのコンテキストウィンドウに最新のバージョン固有のライブラリドキュメントとコード例を直接注入することで、ハルシネーションを排除し、正確なコード生成を実現する。 LLMは学習データに基づいて回答するため、古いバージョンのAPIを使用したコード…」

== 概要 ==
Context7 MCP Server (@upstash/context7-mcp) は、Upstashが開発したMCPサーバである。 
LLMのコンテキストウィンドウに最新のバージョン固有のライブラリドキュメントとコード例を直接注入することで、ハルシネーションを排除し、正確なコード生成を実現する。 
 
LLMは学習データに基づいて回答するため、古いバージョンのAPIを使用したコードを生成したり、存在しない関数やメソッドを生成することがある。 
Context7はこの問題を解決するために、プロンプトに <code>use context7</code> と追記するだけで、対象ライブラリの最新ドキュメントを自動的に取得してコンテキストに統合する。 
 
主な特徴は以下の通りである。 
* 最新バージョン固有のドキュメントをリアルタイムで取得
* Next.js、React、Vue.js、TypeScript等、数千のライブラリに対応
* プロンプトへの <code>use context7</code> 追記だけで動作する簡単な操作性
* Claude Desktop、Claude Code、Cursor、VS Code、Windsurf等の主要MCPクライアントに対応
* Windows、MacOS、Linuxに対応
 

== 動作要件 ==
==== 前提条件 ====
Context7 MCP Serverを使用するために必要な前提条件を以下に示す。 
 
* Node.js v18以上
*: <code>npx</code> コマンドを使用してContext7 MCP Serverを実行するために必要
* インターネット接続
*: ライブラリドキュメントをContext7サーバから取得するために必要
 

== インストール ==
==== 簡単セットアップ ====
<code>ctx7</code> CLIを使用して、MCPクライアントへの設定を自動的に行うことができる。 
 
全クライアントを対象にセットアップする場合は、以下のコマンドを実行する。 
 
npx ctx7 setup
 
特定のMCPクライアントのみを対象にセットアップする場合は、以下に示すコマンドを実行する。 
 
Claude Desktop向けのセットアップコマンドを以下に示す。 
 
npx ctx7 setup --claude
 
Cursor向けのセットアップコマンドを以下に示す。 
 
npx ctx7 setup --cursor
 
VS Code向けのセットアップコマンドを以下に示す。 
 
npx ctx7 setup --code
 
==== Smithery経由のインストール ====
Smitheryを使用してContext7 MCP Serverをインストールする場合は、以下に示すコマンドを実行する。 
 
npx -y @smithery/cli install @upstash/context7-mcp --client claude
 

== 設定 ==
==== 設定ファイルの場所 ====
各MCPクライアントの設定ファイルの場所は以下の通りである。 
 
Claude Desktopの設定ファイルを以下に示す。 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* MacOS
*: ~/Library/Application Support/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
Claude Codeの設定ファイルを以下に示す。 
* ローカルスコープ
*: .mcp.json (プロジェクトルート) : <code>claude mcp add</code> コマンドで生成される。
* ユーザスコープ
*: ~/.claude.json (ホームディレクトリ)
 
Cursorの設定ファイルを以下に示す。 
* グローバル設定
*: ~/.cursor/mcp.json
* プロジェクト設定
*: .cursor/mcp.json
 
VS Codeの設定ファイルを以下に示す。 
* .vscode/mcp.json (プロジェクトルート)
 
==== Claude Desktopの設定 ====
claude_desktop_config.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp@latest"]
}
}
}
</syntaxhighlight>
 
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。 
 
==== Claude Codeの設定 ====
Claude Codeでは、<code>claude mcp add</code> コマンドを使用してContext7 MCP Serverを追加できる。 
 
以下のコマンドでMCPサーバをClaude Codeに登録する。 
 
claude mcp add context7 -- npx -y @upstash/context7-mcp@latest
 
==== Cursorの設定 ====
~/.cursor/mcp.json または .cursor/mcp.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp@latest"]
}
}
}
</syntaxhighlight>
 
==== VS Codeの設定 ====
.vscode/mcp.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp@latest"]
}
}
}
</syntaxhighlight>
 
==== APIキーを使用した設定 ====
APIキーを使用する場合は、設定ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
}
}
}
</syntaxhighlight>
 
APIキーは、[https://context7.com/dashboard Context7ダッシュボード]から取得できる。 
APIキーは作成時のみ表示されるため、作成後は安全な場所に保管すること。 
 

== 環境変数とオプション ==
==== 環境変数一覧 ====
下表に、Context7 MCP Serverの動作をカスタマイズするための環境変数を示す。 
 
<center>
{| class="wikitable"
|+ 環境変数の一覧
! 環境変数 !! 説明
|-
| <code>DEFAULT_MINIMUM_TOKENS</code> || ドキュメント取得時のトークン数の最小値を指定する。 デフォルト値は 10000 である。
|-
| <code>CONTEXT7_API_KEY</code> || Context7 APIの認証用キーを指定する。 [https://context7.com/dashboard Context7ダッシュボード]から取得できる。 CLIフラグ <code>--api-key</code> おオプションでも指定可能
|}
</center>
 
環境変数を設定ファイルに記述する場合の例を以下に示す。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp@latest"],
"env": {
"DEFAULT_MINIMUM_TOKENS": "20000",
"CONTEXT7_API_KEY": "YOUR_API_KEY"
}
}
}
}
</syntaxhighlight>
 

== 提供ツール ==
Context7 MCP Serverは、ライブラリドキュメントを取得するための2つのツールを提供する。 
 
==== ツール一覧 ====
下表に、Context7 MCP Serverが提供するツールを示す。 
 
<center>
{| class="wikitable"
|+ ツール一覧
! ツール名 !! 説明
|-
| <code>resolve-library-id</code> || ライブラリの一般名をContext7互換のライブラリIDに変換する。 例: "next.js" --> "/vercel/next.js"
|-
| <code>query-docs</code> || ライブラリIDを使用してドキュメントを取得する。 パラメータ: <code>libraryId</code>、<code>query</code> トークン制限: デフォルト 5000〜10000
|}
</center>
 

== 使用方法 ==
Context7 MCP Serverを設定後、プロンプトに <code>use context7</code> と追記するだけで、 
AIアシスタントが自動的にContext7ツールを呼び出し、最新のドキュメントをコンテキストに統合する。 
 
==== 基本的な使用例 ====
基本的なプロンプトの書き方を以下に示す。 
 
* Next.js 14でルーティングとサーバコンポーネントを使用する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

Create a Next.js 14 project with routing and server components. use context7
</syntaxhighlight>
*: 
* zodのスキーマ定義でバリデーションを行う場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

zod v4のスキーマ定義で文字列かつ最低5文字以上という制約を持たせたい。use context7
</syntaxhighlight>
*: 
 
==== ライブラリIDを指定した使用例 ====
ライブラリIDを直接指定することにより、曖昧さなく対象ライブラリのドキュメントを取得できる。 
 
* Supabaseのライブラリを指定する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

use library /supabase/supabase for API and docs.
</syntaxhighlight>
*: 
 
==== 複数ライブラリを指定した使用例 ====
複数のライブラリを同時に指定することもできる。 
 
* MongoDBとExpress.jsを組み合わせてREST APIを構築する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

Create a REST API using MongoDB and Express.js with JWT authentication. use context7
</syntaxhighlight>
*: 
 
==== 対応ライブラリ ====
Context7が対応している主なライブラリを以下に示す。 
 
<center>
{| class="wikitable"
|+ 技術スタック一覧
|-
! カテゴリ !! 技術
|-
| フロントエンド || Next.js、React、Vue.js、Astro
|-
| バックエンド || Node.js、Express.js、Django、FastAPI
|-
| データベース || MongoDB、Supabase、PostgreSQL
|-
| バリデーション || Zod
|-
| 言語 || TypeScript
|}
</center>
 
その他、数千のライブラリに対応している。 
詳細を知りたい場合は、[https://context7.com context7.com]を参照すること。 
 

== トラブルシューティング ==
==== 一般的な問題 ====
下表に、一般的なエラーと対処法を示す。 
 
<center>
{| class="wikitable"
|+ トラブルシューティング一覧
! 問題 !! 対処法
|-
| <code>ERR_MODULE_NOT_FOUND</code> エラーが発生する || <code>npx</code> の代わりに <code>bunx</code> または <code>deno</code> を使用する。 <code>@latest</code> サフィックスを削除して試す。
|-
| <code>Cannot find module</code> エラーが発生する || Node.js v18以上がインストールされているか確認する。
|-
| APIキーエラー (403) が発生する || [https://context7.com/dashboard Context7ダッシュボード]で新しいAPIキーを生成する。 APIキーは作成時のみ表示されるため、再生成が必要な場合がある。
|-
| ドキュメントの取得に失敗する || <code>resolve-library-id</code> ツールでライブラリIDを確認する。 [https://context7.com context7.com] でライブラリが対応しているか確認する。
|-
| 接続問題が発生する || Node.jsのバージョンを確認する。 <code>npm cache clean --force</code> コマンドでnpmキャッシュをクリアする。
|}
</center>
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,Context7,MCP,Model Context Protocol,context7-mcp,Claude,Claude Code,Claude Desktop,Cursor,VS Code,Windsurf,Upstash,Node.js,npx,ドキュメント,ハルシネーション,Next.js,React,TypeScript,AIアシスタント,MCPサーバ
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

VPN - IVPN

2026-03-24T18:41:00Z

Wiki: ページの作成:「== 概要 == IVPNは、プライバシー保護を最優先に設計された、ジブラルタルに本拠を置くVPNサービスである。 2009年に設立され、IVPN Limited (旧: Privatus Limited、2020年に名称変更) が運営している。 本社は、5 Secretary's Lane, Gibraltar (ジブラルタル) に位置している。 IVPNの最大の特徴は、徹底したプライバシー保護への取り組みである。 ア…」

== 概要 ==
IVPNは、プライバシー保護を最優先に設計された、ジブラルタルに本拠を置くVPNサービスである。 
2009年に設立され、IVPN Limited (旧: Privatus Limited、2020年に名称変更) が運営している。 
 
本社は、5 Secretary's Lane, Gibraltar (ジブラルタル) に位置している。 
 
IVPNの最大の特徴は、徹底したプライバシー保護への取り組みである。 
アカウント登録時にメールアドレスは不要で、15文字のアカウントIDのみで認証する完全匿名の仕組みを採用している。 
 
また、全クライアントソフトウェアはオープンソースとしてGitHubで公開されており、Cure53による定期的な第三者監査を受けている。 
 
Freedom of the Press Foundationが推奨するVPNサービスの1つであり、ジャーナリストや活動家等の高いプライバシーを必要とするユーザに支持されている。 
 
IVPNは、以下に示す特徴がある。 
 
<center>
{| class="wikitable"
|+ IVPNの主な特徴
|-
! 特徴 !! 説明
|-
| 匿名アカウント || メールアドレス不要 15文字のアカウントIDのみで登録・認証が完結する。
|-
| ノーログ || VPN接続ログ、ユーザのIPアドレス、通信内容、DNSクエリを一切記録しない。
|-
| 外部監査 || Cure53による定期的な第三者セキュリティ監査を受けており、全レポートを公開している。
|-
| オープンソース || 全クライアントソフトウェアをGitHubで公開している。 バックドアがないことを誰でも検証できる。
|-
| マルチホップ || 複数のVPNサーバを経由する多段接続に対応しており、追跡をより困難にする。
|-
| AntiTracker || DNSレベルで広告、トラッカーをブロックする機能を内蔵している。 Hardcoreモードでは、Facebook / Google IPもブロックする。
|-
| キルスイッチ || VPN接続が切断された時に全ネットワークトラフィックを自動停止するファイアウォール機能を備えている。
|-
| SOCKS5プロキシ || 認証不要のSOCKS5プロキシサービスを提供している。(ポート1080)
|-
| V2Ray難読化 || Deep Packet Inspection (DPI) による検閲を回避する難読化機能を備えている。
|-
| 令状カナリー || 月次更新の令状カナリーと年次透明性レポートを公開している。
|}
</center>
 
デメリットとしては、以下に示すことが挙げられる。 
* 料金が競合他社と比較して高め。
* サーバ数が32カ国40ロケーション以上と少なめ。
* ストリーミングサービスの視聴用途には最適化されていない。
* ポートフォワーディングには対応していない。
* 本社がジブラルタル (英国領、5 Eyes圏内) に位置している。
* モバイルアプリのUIが限定的。
 
料金は以下の通りである。(2026年3月現在) 
 
<center>
{| class="wikitable"
|+ IVPNの料金プラン
! プラン !! 同時接続台数 !! 週額 !! 月額 !! 年額
|-
| Standard || 2台 || $2 || $6 || $60
|-
| Pro || 7台 || $4 || $10 || $100
|}
</center>
 
Proプランでは、マルチホップおよびポートフォワーディング非対応のかわりに接続台数が増加する。 
30日間の返金保証が提供されている。 
 
支払い方法はクレジットカード、PayPal、Bitcoin、Monero、現金に対応しており、匿名支払いも可能である。 
 

== ノーログポリシーの実態 ==
==== 公式ノーログポリシーの内容 ====
IVPNは完全なノーログポリシーを採用しており、以下に示す情報を一切記録しない。 
 
* VPN接続ログ (接続日時、切断日時、接続先サーバ)
* ユーザのIPアドレス
* 通信内容
* DNSクエリ
* 帯域幅・データ転送量
* セッション情報
 
一方、以下に示す情報は最低限記録される。 
 
* アカウント登録日
* 支払い情報 (Monero、Bitcoin、現金による匿名決済を選択することで最小化可能)
 
また、IVPNはメールアドレスを含む個人情報を収集しない設計を採用しており、 
 
アカウントは15文字のIDのみで管理される。 
これにより、サービス側が保持するユーザ情報を構造的に最小化している。 
 
==== 第三者監査の実施状況 ====
IVPNは、プライバシー保護の実効性を証明するため、Cure53によるセキュリティ監査を定期的に受けている。 
 
<center>
{| class="wikitable"
|+ IVPN Cure53監査実績
! 年 !! 監査対象 !! 結果
|-
| 2019年 || インフラセキュリティ・ノーログ検証 || プライバシー違反なし、ノーログ確認済み
|-
| 2022年 || アプリケーションセキュリティ || 重大な脆弱性なし
|-
| 2024年 || Webインフラセキュリティ || 問題なし
|-
| 2024年 || modDNS機能 || セキュリティ上の問題なし
|-
| 2025年 || 年次監査 (予定) || -
|}
</center>
 
監査はCure53チームによる7日間以上の詳細調査として実施されており、SSHおよびrootアクセスを許可した踏み込んだ調査が行われている。 
 
全監査報告書はIVPN公式Webサイトで公開されている。 
 
==== 捜査機関への対応事例 ====
IVPNは、捜査機関からの法的要求に対するデータ提供実績を年次透明性レポートとして公開している。 
 
* 2024年の対応事例
*: 12件の法的要求を受領した。
*: そのうち法的妥当性があると判断したのは1件のみであった。
*: データ提供件数はゼロ件であった。
*: ノーログポリシーにより、提供すべきデータが存在しなかった。
 
IVPNのノーログポリシーは実際の法執行機関との対応においても、その有効性が確認されている。 
 
==== 技術的なプライバシー保護 ====
IVPNが採用する技術的なプライバシー保護の仕組みを以下に示す。 
 
* 匿名アカウント制
*: メールアドレス、名前、パスワードは一切不要である。
*: 15文字のアカウントIDのみで登録・認証が完結する。
* 匿名支払い対応
*: Monero、Bitcoin、現金による完全匿名の支払いが可能である。
*: クレジットカードやPayPalによる支払いも選択できる。
* オープンソース
*: 全クライアントソフトウェアはGitHubで公開されている。
*: バックドアやセキュリティ脆弱性がないことを誰でも検証できる。
* AntiTracker
*: DNSレベルで広告およびトラッカードメインをブロックする。
*: HardcoreモードではFacebook / Meta / GoogleのIPアドレスをASNレベルで追加ブロックする。
* V2Ray難読化
*: Deep Packet Inspection (DPI) による検閲を回避する難読化機能を提供する。
*: 検閲が厳しい地域での使用を想定している。
* modDNS機能 (ベータ)
*: DNS-over-HTTPS、DNS-over-TLS、DNS-over-QUICに対応する。
*: Cure53による監査を受けている。
 
==== 管轄法域に関する考慮事項 ====
IVPNの本社はジブラルタル (英国領) に位置しており、5 Eyes諜報同盟の間接的な管轄圏内となることに注意が必要である。 
 
* ジブラルタルの法的環境
*: 英国領であるが、独自の法体系を持つ自治領である。
*: ジブラルタル独自のプライバシー法制が存在する。
*: 5 Eyes諸国からの法的要求を受ける可能性がある。
* リスク軽減要因
*: ノーログポリシーにより、要求に応じても提供すべきデータが存在しない。
*: 法的妥当性のない要求に対しては法的に対抗する方針を採っている。
*: 令状カナリーを月次で更新しており、現在も green (秘密の捜査令状なし) の状態を維持している。
*: 年次透明性レポートを公開している。
 
ノーログを技術的に実装した上で法的にも対抗する姿勢を採っているため、管轄法域のリスクは構造的に軽減されていると評価されている。 
 
==== 他のノーログVPNとの比較 ====
<center>
{| class="wikitable"
|+ 主要なノーログVPNとの比較
! 項目 !! IVPN !! Mullvad !! ProtonVPN
|-
| 設立年 || 2009年 || 2009年 || 2014年
|-
| 本社 || ジブラルタル (英国領) || スウェーデン || スイス
|-
| Five Eyes || 間接的に圏内 || 圏外 || 圏外
|-
| 第三者監査 || Cure53 (定期的) || Cure53・NCC Group等 || SEC Consult等
|-
| オープンソース || あり || あり || あり
|-
| 匿名登録 || あり (メール不要) || あり (メール不要) || なし (メール必要)
|-
| 匿名支払い || Bitcoin・Monero・現金 || Bitcoin・Monero・現金 || Bitcoin・現金
|-
| 料金 (月額) || $6〜$10 || €5 || $4〜$10
|-
| 同時接続 || 2〜7台 || 5台 || 1〜10台
|-
| サーバ数 || 40ロケーション以上 || 900台以上 || 9,800台以上
|-
| マルチホップ || あり (Proプラン) || あり || あり (Plusプラン)
|-
| ポートフォワーディング || なし || なし (2023年廃止) || なし
|}
</center>
 
==== 留意点 ====
* IVPNの本社は5 Eyes圏の管轄に入る可能性があるジブラルタルに位置している。 ただし、ノーログポリシーの構造的な実装により、このリスクは大幅に軽減される。
* サーバ数は競合他社と比較して少ないため、特定地域でのパフォーマンスが限定される場合がある。
* ストリーミング視聴用途には最適化されていないため、動画配信サービスのVPN迂回には適さない場合がある。
* 料金は競合他社と比較して高めであるが、プライバシー重視の設計に対する対価と位置づけられている。
 

== IVPNの契約方法 ==
IVPNの契約手順を以下にに示す。 
 
# [https://www.ivpn.net/ IVPNの公式Webサイト]へアクセスして、[Get IVPN]を選択する。
# プランを選択する。 Standard (2台接続) またはPro (7台接続) のいずれかを選択する。
# 請求サイクルを選択する。 週額、月額、年額のいずれかを選択する。
# アカウントIDが発行される。
#: このIDはIVPNへのログインに使用する唯一の認証情報であるため、大切に保管すること。
#: メールアドレスの登録は不要である。
# 支払い方法を選択して決済する。
#: クレジットカード、PayPal、Bitcoin、Monero、現金のいずれかを選択できる。
#: 匿名性を重視する場合は、Moneroおよび現金を推奨する。
# [https://www.ivpn.net/apps/ IVPNの公式Webサイト]にアクセスして、使用するOSに対応したIVPNアプリをダウンロードする。
#: 対応OSはWindows、MacOS、Linux、iOS、Androidである。
# IVPNアプリを起動して、発行されたアカウントIDでログインする。
 
30日間の返金保証が提供されているため、サービス内容に満足できない場合はサポートへ連絡することで返金を受けられる。 
 

== VPN over Tor ==
IVPNは、Torネットワーク経由でVPN接続を行うVPN over Tor接続の構成をSOCKS5プロキシ機能により実現できる。 
 
* VPN over Tor接続の通信フロー
*: ユーザ --> Torエントリーノード --> Tor出口ノード --> IVPN SOCKS5プロキシ --> インターネット
 
この構成では、IVPNサーバにはTorの出口IPアドレスのみが伝わり、ユーザの実際のIPアドレスはIVPNに対して秘匿される。 
 
==== IVPN SOCKS5プロキシの仕様 ====
下表に、IVPNが提供するSOCKS5プロキシの仕様を示す。 
 
<center>
{| class="wikitable"
|+ IVPN SOCKS5プロキシ仕様
! 項目 !! 値
|-
| IPアドレス || 10.1.0.1
|-
| ポート番号 || 1080
|-
| DNS名 || socks5.gw.ivpn.net
|-
| 認証 || 不要
|-
| 対応プロトコル || TCPのみ
|-
| 対応VPNプロトコル || WireGuard、OpenVPN、IKEv2全て
|}
</center>
 
SOCKS5プロキシはTCPのみに対応しており、UDPには対応していないことに注意する。 
 
==== VPN over Torの設定手順 ====
===== 事前準備 =====
VPN over Tor接続の構成では、TorをIVPN SOCKS5プロキシへの前段プロキシとして使用する。 
IVPNに接続する前にTorを起動しておく必要がある。 
 
推奨環境として、同一マシン上でTorとIVPNクライアントを同時実行すると、ルーティングが複雑になる場合があるため、 
別のマシンまたはVM上でTorを実行することを推奨する。 
 
===== Torの起動 =====
ターミナルを起動して、Torを起動する。 
sudo systemctl start tor
 
Torが正常に起動していることを確認する。 
sudo systemctl status tor
 
===== IVPNのSOCKS5プロキシをTorのブリッジとして設定する =====
IVPNのSOCKS5プロキシを、Torが外部ネットワークに接続する時のブリッジ (前段プロキシ) として設定することで、VPN over Tor接続の構成を実現する。 
 
IVPNに接続した状態で、Torの設定ファイルを編集する。 
sudo vi /etc/tor/torrc
 
# /etc/tor/torrcファイル

# IVPNのSOCKS5プロキシをTorの前段ブリッジとして使用する
# 10.1.0.1はIVPN VPN接続中にのみアクセス可能なゲートウェイアドレスである
Socks5Proxy 10.1.0.1:1080
 
設定を反映するためにTorを再起動する。 
sudo systemctl restart tor
 
===== アプリケーションからの接続 =====
Tor起動後、アプリケーションのプロキシ設定にTorのSOCKS5プロキシ (127.0.0.1:9050) を指定することにより、 
アプリケーションのトラフィックがIVPN SOCKS5プロキシを経由してTorネットワークに転送される。 
 
curlコマンドでの使用例を以下に示す。 
curl --socks5-hostname 127.0.0.1:9050 https://check.torproject.org/api/ip
 
===== proxychainsを使用した方法 =====
proxychainsを使用することにより、任意のアプリケーションをIVPN SOCKS5プロキシ経由のTorで接続することができる。 
 
proxychainsをインストールする。 
# SUSE
sudo zypper install proxychains-ng
 
proxychainsの設定ファイルを編集する。 
sudo vi /etc/proxychains.conf
 
<syntaxhighlight lang="ini">
# /etc/proxychains.confファイル

# IVPNのSOCKS5プロキシを経由してTorに接続するプロキシチェーン
[ProxyList]
# IVPN SOCKS5プロキシ (VPN接続中のみアクセス可能)
socks5 10.1.0.1 1080
# TorのローカルSOCKS5プロキシ
socks5 127.0.0.1 9050
</syntaxhighlight>
 
proxychainsを使用してアプリケーションを起動する。 
proxychains firefox
 
==== 注意事項 ====
* SOCKS5プロキシはTCPのみ対応のため、UDPを使用するアプリケーションでは使用できない。
* 同一PCでTorクライアントとIVPNクライアントを直接実行している場合、ルーティングが複雑になる場合がある。 別のPC または VM上でTorを実行することを推奨する。
* AntiTracker機能、カスタムDNS設定、Split Tunnelとは同時に使用できない。
* SOCKS5プロキシはIVPN VPN接続中にのみ使用可能である。 VPN未接続の状態ではプロキシアドレス 10.1.0.1 にアクセスできない。
 

== Tor over VPN ==
Tor over VPN接続は、一般的なTorとVPNの組み合わせ方法であり、特別な設定は不要である。 
 
* Tor over VPNの通信フロー
*: ユーザ --> IVPN VPNサーバ --> Torエントリノード --> Tor出口ノード --> インターネット
 
==== Tor over VPNのメリット ====
* IVPNサーバがユーザの実IPアドレスを確認するが、通信の宛先はIVPNに対して秘匿される。
* ISP (インターネットサービスプロバイダ) に対して、Torを使用していることを隠すことができる。
* IVPNのノーログポリシーにより、接続情報は記録されない。
 
==== Tor over VPNの設定手順 ====
# IVPNアプリを起動して、任意のIVPNサーバに接続する。
# VPN接続状態を確認してから、Tor Browserを起動する。
# Tor Browserを通常通り使用する。
 
Tor Browserが自動的にTorネットワークへの接続を確立するため、追加の設定は不要である。 
 
==== VPN over Torとの比較 ====
<center>
{| class="wikitable"
|+ Tor+VPN構成の比較
! 項目 !! Tor over VPN !! VPN over Tor
|-
| 設定の手間 || 不要 || SOCKS5プロキシ設定が必要
|-
| ISPへのTor利用の秘匿 || 可能 || 不可能
|-
| VPNへの通信内容の秘匿 || 可能 || 不可能
|-
| VPNへの実IP開示 || あり || なし (Tor経由)
|-
| 速度 || 低速 || より低速
|-
| IVPN SOCKS5プロキシ || 不要 || 使用する
|}
</center>
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:PinePhone]][[カテゴリ:Windows10]][[カテゴリ:Windows11]]

VPN - PrivadoVPN

2026-03-24T18:25:08Z

Wiki: ページの作成:「== 概要 == PrivadoVPNは、スイスのツッグに本社を置くVPNサービスであり、2019年にPrivado Networks AGによって設立された。 エンタープライズ向けサービスは2019年4月、コンシューマー向けサービスは2019年12月に開始された。 スイスを拠点とすることで、EU圏外のデータ保護法 (スイス連邦データ保護法: FADP) の適用を受けており、5/9/14 Eyes (情報共有…」

== 概要 ==
PrivadoVPNは、スイスのツッグに本社を置くVPNサービスであり、2019年にPrivado Networks AGによって設立された。 
エンタープライズ向けサービスは2019年4月、コンシューマー向けサービスは2019年12月に開始された。 
 
スイスを拠点とすることで、EU圏外のデータ保護法 (スイス連邦データ保護法: FADP) の適用を受けており、5/9/14 Eyes (情報共有協定) の加盟国に属さないことが特徴である。 
 
PrivadoVPNは、無料プランを提供している数少ないVPNサービスのひとつであり、月間10[GB]のデータ通信量と10カ国のサーバが無料で利用できる。 
無料プランのデータ上限を超過した場合も、約1[Mbps]の低速接続 (Lite Mode) で継続して利用できる点が他社との差別化ポイントとなっている。 
 
PrivadoVPNは、以下に示す主な特徴がある。 
 
<center>
{| class="wikitable"
|+ PrivadoVPN の主な特徴
! 特徴 !! 説明
|-
| 無料プラン || 月間10[GB]の高速データ通信と10カ国のサーバが無料で利用可能。 データ超過後はLite Mode (約1[Mbps]) で継続して接続できる。
|-
| ノーログポリシー || ブラウジング履歴、トラフィック宛先、データ内容、ユーザIPアドレス、DNSクエリを記録しない。
|-
| スイス拠点 || スイス連邦データ保護法 (FADP) の保護を受け、5/9/14 Eyes の管轄外である。
|-
| キルスイッチ || VPN接続が切断された場合に自動でネットワーク通信を遮断して、IPアドレスの漏洩を防ぐ。
|-
| スプリットトンネリング || 特定のアプリやサイトのみVPNを経由させることができる。
|-
| 広告ブロッカー || 広告や追跡スクリプトをブロックするフィルタリング機能を内蔵している。
|-
| SOCKS5プロキシ || Torrentクライアント向けにSOCKS5プロキシを提供している。 60以上のグローバルプロキシサーバを選択できる。
|-
| ストリーミング対応 || Netflix、Hulu、Amazon Prime Video等の主要ストリーミングサービスに対応している。
|-
| 同時接続台数 || 有料プランでは最大10台のデバイスを同時に接続できる。
|-
| 30日間返金保証 || 有料プランに加入後30日以内であれば全額返金を受けることができる。
|}
</center>
 
デメリットとしては、以下に示すことが挙げられる。 
* 第三者による独立したセキュリティ監査が未実施であり、透明性レポートも公開されていない。
* サーバ数が338〜377台と他の主要VPNと比較して限定的である。
* ストリーミングサービス利用時にIPアドレスがブロックされる事例が報告されている。
* Lite Modeの速度は約1[Mbps]であり、動画視聴等の用途には不向きである。
* 公式Linux向けアプリが提供されていないため、Linux環境での利用には手動設定が必要となる。
* カスタマーサポートは主に英語対応であり、日本語サポートは提供されていない。
 
<center>
{| class="wikitable"
|+ PrivadoVPN 料金プラン (2026年3月現在)
! プラン !! 料金 !! 接続台数 !! 備考
|-
| 無料 || 無料 || 1台 || 月間10[GB]、10カ国のサーバ、Lite Mode対応
|-
| 1ヶ月プラン || $10.99/月 || 10台 || 無制限データ通信、全サーバ利用可能
|-
| 1年プラン || $3.99/月 (年払い) || 10台 || 無制限データ通信、全サーバ利用可能
|-
| 2年プラン || $1.99/月 (2年払い) || 10台 || 無制限データ通信、全サーバ利用可能
|}
</center>
 
<center>
{| class="wikitable"
|+ PrivadoVPN 無料プランで利用できるサーバ国 (10カ国)
! 地域 !! 国
|-
| ヨーロッパ || 英国、オランダ、ドイツ、フランス
|-
| 北米 || 米国、カナダ、メキシコ
|-
| 南米 || ブラジル、アルゼンチン
|-
| アジア || インド
|}
</center>
 

== ノーログポリシーの実態 ==
==== 公式ノーログポリシーの内容 ====
PrivadoVPNは、厳格なノーログポリシーを公式に掲げており、ユーザのプライバシーを保護するために以下の情報を記録しないと明言している。 
 
<center>
{| class="wikitable"
|+ ログポリシーの詳細
|-
! 記録しない情報 !! 記録する情報
|-
| ブラウジング履歴 (アクセスしたWebの記録) || メールアドレス (アカウント作成・管理のため)
|-
| トラフィックの宛先(接続先のIPアドレスやドメイン) || 帯域幅の使用量 (無料プランのデータ制限管理のため)
|-
| データ内容(通信の中身) ||
|-
| ユーザの実IPアドレス ||
|-
| DNSクエリ(DNS検索の記録) ||
|}
</center>
 
なお、帯域幅の使用量の記録は無料プランのデータ制限 (月間10[GB]) を管理するための技術的な必要性によるものであり、VPNの利用内容とは紐付けられていないとしている。 
 
==== 第三者監査の状況 ====
PrivadoVPNは、2026年3月現在において第三者機関による独立したセキュリティ監査を実施していない。 
公開された監査レポートも存在しない。 
 
主要なVPNプロバイダの多くが定期的な第三者監査を実施してノーログポリシーの有効性を客観的に証明しているのに対して、PrivadoVPNはノーログポリシーを自己申告のみで主張している状況である。 
 
また、透明性レポート (政府機関や法執行機関からの情報提供要請件数を公開する文書) も確認されておらず、外部からの検証手段が限られていることは留意が必要である。 
 
==== 技術的なプライバシー保護 ====
PrivadoVPNは、ノーログポリシーを支える技術的な仕組みとして以下を採用している。 
 
* AES-256ビット暗号化
*: 業界標準の最高レベルの暗号化方式を採用している。
* 対応プロトコル
*: WireGuard、OpenVPN、IKEv2/IPSecの3つのプロトコルに対応している。
*: WireGuardは高速かつ軽量なプロトコルであり、モバイル端末での利用に適している。
* キルスイッチ
*: VPN接続が予期せず切断された場合に、自動的にインターネット接続を遮断してIPアドレスの漏洩を防ぐ機能である。
*: 無料プランでも利用できる。
* DNS漏洩防止
*: VPN接続中はPrivadoVPN独自のDNSサーバを使用し、ISP (インターネットサービスプロバイダ) へのDNSクエリの漏洩を防ぐ。
* スプリットトンネリング
*: 特定のアプリやウェブサイトをVPNトンネルの外で通信させることができる機能である。
*: バンキングアプリ等、VPN経由でのアクセスが問題になる場合に有用である。
 
==== 管轄法域に関する考慮事項 ====
PrivadoVPNはスイスのツッグに拠点を置いており、スイスの法律の適用を受ける。 
 
スイスの法的環境として、以下に示す事柄が挙げられる。 
 
* FADP (スイス連邦データ保護法) の保護
*: スイスは独自のデータ保護法であるFADP (Federal Act on Data Protection) により、個人データの収集・処理に厳格な制限を設けている。
*: EUのGDPRと同等以上のデータ保護水準を持つとされている。
* 5/9/14 Eyes 非加盟
*: スイスは、米国、英国、カナダ、オーストラリア、ニュージーランドを中心とする情報共有協定 (5/9/14 Eyes) の加盟国ではない。
*: 加盟国の情報機関からの情報共有要請に自動的に応じる義務を持たない。
* 第三者からの情報請求への対応
*: スイス法の規定により、PrivadoVPNはユーザの情報を第三者に提供する場合、当該ユーザへの通知義務を負うとされている。
*: ただし、裁判所命令等の法的根拠に基づく情報提供要請に対しては応じる可能性がある。
 
==== 他のノーログVPNとの比較 ====
<center>
{| class="wikitable"
|+ ノーログVPN 比較
! 項目 !! PrivadoVPN !! Mullvad !! ProtonVPN
|-
| 拠点 || スイス || スウェーデン || スイス
|-
| 第三者監査 || 未実施 || 定期実施 (Cure53等) || 実施済み
|-
| 透明性レポート || 非公開 || 重大事件のみ公開 || 定期公開
|-
| 無料プラン || あり (10[GB]/月) || なし || あり (無制限・低速)
|-
| 匿名支払い || 限定的 || 現金、Monero等対応 || 暗号通貨対応
|-
| Linux公式アプリ || なし || あり || あり
|-
| 5/9/14 Eyes || 非加盟 || 加盟 (スウェーデン) || 非加盟
|}
</center>
 
==== 留意点 ====
* 第三者監査が未実施であるため、ノーログポリシーの有効性を客観的に検証する手段が現時点では存在しない。
* スイスはプライバシー保護の観点で有利な法域であるが、スイス法に基づく適法な情報提供要請には応じる可能性がある。
* 透明性レポートが公開されていないため、政府機関等からの情報提供要請件数を確認する方法がない。
* 高度なプライバシー要件を持つユーザは、第三者監査を実施済みのVPNサービスと比較検討することを推奨する。
 

== PrivadoVPNの契約方法 ==
PrivadoVPNの契約手順を以下に記載する。 
 
# [https://privadovpn.com/ PrivadoVPNの公式Webサイト]へアクセスして、ページ上部の[Get PrivadoVPN]または[Start for Free]を選択する。
# プランを選択する。 無料プランを利用する場合は[Free]を選択、有料プランを利用する場合は希望のプランを選択する。
# メールアドレスを入力してアカウントを作成する。
#: 登録したメールアドレスは、アカウント管理および重要な通知に使用されるため、正確に入力すること。
# 有料プランを選択した場合は、クレジットカード、PayPal等の支払い方法を選択して決済を行う。
# [https://privadovpn.com/apps/ PrivadoVPNのダウンロードページ]にアクセスして、使用するOSに対応したアプリをダウンロードする。
#: Windows、MacOS、iOS、Androidに対応している。
# アプリをインストールして、登録したメールアドレスとパスワードでログインする。
# 接続したいサーバを選択して、[Connect]ボタンを押すとVPN接続が開始される。
 
PrivadoVPNの有料プランは、最安で$1.99/月 (2年プラン) から利用できる。(2026年3月現在) 
有料プランには30日間の返金保証が付いており、期間内であれば全額返金を受けることができる。 
 
無料プランはクレジットカード情報の登録なしで利用でき、月間10[GB]のデータ通信量が提供される。 
 
データ上限を超過した場合は、約1[Mbps]の低速接続 (Lite Mode) に自動的に切り替わり、接続自体は維持される。 
 

== VPN over Tor ==
VPN over Torとは、Torネットワークを経由した上でVPNに接続する構成のことである。 
この構成では、VPNプロバイダに対してもユーザの実IPアドレスを隠すことができる。 
 
PrivadoVPNは、VPN over Torを公式にはサポートしていない。 
ただし、SOCKS5プロキシを提供しており、主にTorrentクライアント向けの用途で提供されている。 
 
==== SOCKS5プロキシの詳細 ====
下表に、PrivadoVPNが提供するSOCKS5プロキシの仕様を示す。 
 
<center>
{| class="wikitable"
|+ PrivadoVPN SOCKS5プロキシ仕様
! 項目 !! 内容
|-
| プロキシサーバ || proxy.privado.io
|-
| ポート番号 || 1080
|-
| 認証 || 必要 (ユーザ名、パスワード)
|-
| プロキシ数 || 60以上のグローバルプロキシ
|-
| 主な用途 || Torrentクライアントでの匿名ダウンロード
|}
</center>
 
SOCKS5プロキシに対応したTorrentクライアントの例として、以下に示すものが挙げられる。 
* qBittorrent
* uTorrent
* BitComet
 
SOCKS5プロキシはVPNトンネルとは異なり、全ての通信を暗号化するものではなく、対応したアプリケーションの通信のみをプロキシ経由でルーティングする仕組みである。 
そのため、SOCKS5プロキシ単体はVPN over Torとしての機能を完全には提供しない。 
 
VPN over Tor構成を必要とする場合は、Torネットワークへの接続設定を手動で行った上でVPN接続を確立する必要があり、技術的な難易度が高い。 
高度なプライバシー要件を持つ用途には、VPN over Torを公式にサポートするサービスの利用を推奨する。 
 

== Tor over VPN ==
Tor over VPNとは、まずVPNに接続した上でTorネットワークを使用する構成のことである。 
この構成では、ISP (インターネットサービスプロバイダ) に対してTorの利用を隠すことができ、またTorの入口ノードに対してもユーザの実IPアドレスを隠すことができる。 
 
PrivadoVPNは、Tor over VPNを公式にはサポートしていない。 
しかし、理論的には以下の手順で実現することができる。 
 
# PrivadoVPNアプリを起動して任意のサーバに接続する。
# VPN接続が確立された状態で、Torブラウザを起動して利用する。
 
この方法では、PrivadoVPNを経由した上でTorネットワークに接続するため、ISPからはTorの利用が隠される。 
ただし、VPNプロバイダであるPrivadoVPNは、ユーザがTorを使用していることは認識できる状態となる点に注意が必要である。 
 
Torブラウザは [https://www.torproject.org/ Tor Projectの公式Webサイト] から無料でダウンロードできる。 
 
Tor over VPN構成を利用する場合の留意点を以下に示す。 
* Torネットワーク経由の通信は通常よりも大幅に速度が低下する。
* VPNとTorを組み合わせることにより、複数のレイヤーで保護されるが、完全な匿名性を保証するものではない。
* PrivadoVPNの公式サポート対象外の構成であるため、技術的な問題が発生した場合のサポートを受けることができない。
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:PinePhone]][[カテゴリ:Windows10]][[カテゴリ:Windows11]]

VPN - OVPN

2026-03-24T18:17:14Z

Wiki: ページの作成:「== 概要 == OVPNは、スウェーデンのストックホルムに拠点を置くプライバシー重視のVPNサービスである。 2014年にOVPN Integritet ABとして設立され、RAM-onlyサーバやマルチホップ接続等、技術的なプライバシー保護に注力している。 2020年のスウェーデン法廷において、ノーログポリシーが法的に実証された実績を持つ。 2023年5月にPangoに買収さ…」

== 概要 ==
OVPNは、スウェーデンのストックホルムに拠点を置くプライバシー重視のVPNサービスである。 
2014年にOVPN Integritet ABとして設立され、RAM-onlyサーバやマルチホップ接続等、技術的なプライバシー保護に注力している。 
2020年のスウェーデン法廷において、ノーログポリシーが法的に実証された実績を持つ。 
 
2023年5月にPangoに買収され、2024年にPoint Wild (旧TotalAV) と合併している。 
この買収後もノーログポリシーの継続が明記されているが、Point Wildグループの他製品に関するプライバシー上の懸念が指摘されている。 
 
下表に、OVPNの主な特徴を示す。 
 
<center>
{| class="wikitable"
|+ OVPN VPNの主な特徴
|-
! 特徴 !! 説明
|-
| RAM-onlyサーバ || ハードドライブを持たず、iPXEによる暗号化起動と署名検証を採用している。 物理コンソールおよびUSBポートを廃止しており、電源切断でデータが消滅する。
|-
| 法廷でのノーログ実証 || 2020年のスウェーデン裁判所の判決により、ノーログポリシーが法的に実証されている。 これは、VPNプロバイダとしては世界初のケースとされている。
|-
| マルチホップ (Dynamic Multihop) || 2つのサーバを経由する接続であり、入口サーバと出口サーバを個別に選択できる。 単一サーバへの依存を排除してプライバシーを強化する。
|-
| ポートフォワーディング || 最大7ポートのポートフォワーディングをサポートしている。 使用可能なポート範囲は49152〜65535である。
|-
| Public IPv4 || 月額$4で専用の静的IPv4アドレスを取得できるオプション機能である。
|-
| キルスイッチ || VPN接続が切断された時に自動でネットワークトラフィックを遮断する機能を搭載している。
|-
| DNSリーク保護 || OVPNの独自DNSサーバの使用を強制して、1秒ごとに監視する仕組みを採用している。
|-
| 暗号通貨・現金対応 || Bitcoin、Ethereum、Moneroの暗号通貨に加え、現金の郵送による完全匿名での支払いに対応している。
|}
</center>
 
<center>
{| class="wikitable"
|+ OVPNのメリットとデメリット
|-
! メリット !! デメリット
|-
| RAM-onlyサーバを採用しており、法廷でノーログポリシーが実証されている。 || サーバ台数が世界32都市96台のみであり、競合他社の数千台と比較して大幅に少ない。
|-
| 暗号通貨および現金郵送に対応しており、完全匿名での契約が可能である。 || 月額$4.22〜$12の料金は、競合他社と比較して高めである。
|-
| 平均ダウンロード速度141[Mbps]、アップロード速度120[Mbps]の通信速度を持つ。 || 同時接続デバイス数が最大7台(36ヶ月契約時)と制限がある。
|-
| WireGuardおよびOpenVPNの両プロトコルに対応している。 || BBC iPlayer等、一部のストリーミングサービスに対応していない。
|-
| || 第三者機関による独立した監査の公開レポートが確認されていない。
|-
| || 透明性レポートが未公開である。
|-
| || Pangoグループ(Point Wild)との関係において、プライバシー上の懸念がある。
|}
</center>
 
下表に、OVPNの料金を示す。(2026年3月現在) 
 
<center>
{| class="wikitable"
|+ OVPN 料金プラン
! プラン !! 月額料金 !! 同時接続台数
|-
| 1ヶ月 || $12/月 || 4台
|-
| 12ヶ月 || $4.99/月 || 5台
|-
| 36ヶ月 || $4.22/月 || 7台
|}
</center>
 
10日間の返金保証が設けられている。 
対応OSは、Windows、MacOS、Linux (Ubuntu、Debian、Fedora、openSUSE)、Android、iOSである。 
 

== ノーログポリシーの実態 ==
==== 公式ノーログポリシーの内容 ====
OVPNは、以下に示すデータを記録しないとしている。 
* ユーザのIPアドレス
* デバイスID
* 接続日時および時間
* データ転送量
* 訪問したURL
* ダウンロード情報
* 使用したプロトコル
* DNSクエリ
 
一方、以下に示すデータは保持される。 
* ユーザ名およびパスワード (メールアドレスはオプション)
* デバイス接続数 (IPアドレスやタイムスタンプを含まない)
* 接続成功フラグ (ブール値のみ)
* 支払い情報
* サポート連絡先
 
したがって、OVPNは一切のデータを保持しないわけではなく、通信に関するログを保持しない という意味でのノーログVPNである。 
 
==== 第三者監査の状況 ====
OVPNは、2026年3月現在において、公開された第三者機関による独立した監査レポートが確認されていない。 
 
これは、Mullvad VPNやNordVPN等の主要競合他社が定期的に第三者監査を実施し、その結果を公開していることと対照的である。 
透明性レポートについても未公開であり、このことはOVPNの信頼性評価における留意点となる。 
 
==== 法廷での実績 (2020年スウェーデン) ====
OVPNのノーログポリシーは、2020年のスウェーデンにおける裁判において法的に実証されている。 
 
* 経緯
*: 映画制作企業 (AB Svensk FilmindustriおよびNordisk Film A/S) が、Rights Alliance経由でユーザ情報の開示をOVPNに要求した。
* 裁判所の判断
*: スウェーデン特許・市場裁判所が判決を下し、OVPNはログを保有しておらず、情報開示が不可能であると認定した。
*: 裁判所はOVPNをインターネットプロバイダーではないと判断して、データ保持指令の適用対象外であるとした。
* 結果
*: 映画制作企業がOVPNの弁護士費用として約108,000 SEK (約$12,300) を負担することになった。
*: これは、VPNプロバイダのノーログポリシーが法廷で実証された事例として広く知られている。
 
==== 技術的なプライバシー保護 ====
OVPNは以下に示す技術的な仕組みによりプライバシーを保護している。 
 
* RAM-onlyサーバ
*: 全サーバがハードドライブを持たない揮発性メモリ (RAM) のみで動作している。
*: iPXEによる暗号化起動と署名検証を採用しており、改竄を検知できる仕組みを持つ。
*: 物理コンソールおよびUSBポートを廃止しており、物理的なアクセスによるデータ抽出が困難である。
*: 電源を切断した時点でサーバ上の全データが消滅する。
* マルチホップ (Dynamic Multihop)
*: 2つのVPNサーバを経由して接続する機能であり、入口サーバと出口サーバを個別に選択できる。
*: 単一のサーバが侵害された場合でも、ユーザの実際のIPアドレスと通信内容を同時に把握することが困難になる。
* DNSリーク保護
*: OVPNの独自DNSサーバの使用を強制し、1秒ごとに監視する仕組みを採用している。
*: DNSクエリが外部に漏洩することを防止する。
* 対応プロトコル
*: OpenVPN (AES-256-GCM暗号化、ChaCha20-Poly1305、TLSv1.3) およびWireGuardに対応している。
 
==== 管轄法域に関する考慮事項 ====
OVPNはスウェーデンに拠点を置いており、スウェーデンは14 Eyes情報共有同盟の加盟国である。 
 
* データ保持指令に関する経緯
*: スウェーデンは2012年にEUのデータ保持指令を国内法化した。
*: 2014年、EU司法裁判所がこのデータ保持指令を無効と判断した。
*: 2020年の裁判では、裁判所がOVPNをISPではないと判断して、データ保持義務が適用されないと認定した。
* 留意事項
*: スウェーデンは14 Eyes加盟国であるため、国際的な情報共有の枠組みの影響を受ける可能性がある。
*: 令状カナリーおよび透明性レポートが未公開であり、法執行機関からの要請状況を外部から確認できない。
 
==== 他のノーログVPNとの比較 ====
下表に、OVPNと主要なノーログVPNとの比較を示す。 
 
<center>
{| class="wikitable"
|+ ノーログVPN 比較
! 項目 !! OVPN !! Mullvad !! NordVPN
|-
| 本社所在地 || スウェーデン || スウェーデン || パナマ
|-
| 14 Eyes加盟国 || 該当する || 該当する || 該当しない
|-
| 第三者監査 || 公開レポートなし || 定期実施・公開あり || 定期実施・公開あり
|-
| 法廷での実績 || 2020年スウェーデン (ノーログ実証済み) || 2023年スウェーデン (家宅捜索でデータ提供不可) || 2024年パナマ (支払い情報のみ提供)
|-
| RAMオンリーサーバ || 対応済み || 2024年9月完全移行 || 対応済み
|-
| 透明性レポート || 未公開 || 重大事件のみ公開 || 公開あり
|-
| サーバ数 || 96台 (32都市) || 数百台 (約45カ国) || 数千台 (約111カ国)
|-
| マルチホップ || 対応 (Dynamic Multihop) || 対応 || 対応 (Double VPN)
|-
| 匿名支払い || 暗号通貨・現金 || 暗号通貨・現金 || 暗号通貨
|-
| 料金 (最安) || $4.22/月 (36ヶ月) || 約€4.9/月 || 約$3.09/月
|}
</center>
 
==== 留意点 ====
OVPNを選択する時には、以下の点に留意することを推奨する。 
 
* 2023年にPangoに買収され、2024年にPoint Wild (旧TotalAV) と合併している。 Point Wildグループの他製品 (Hotspot Shield、Betternet等) にはプライバシー上の懸念が指摘されており、 OVPNへの影響について継続的な注視が必要である。
* 第三者機関による独立した監査レポートが公開されておらず、ノーログポリシーの技術的な実装について外部から検証することが困難である。
* スウェーデンは14 Eyes加盟国であり、国際的な情報共有の枠組みの影響を受ける可能性がある。
* 一方で、2020年の法廷での実績はノーログポリシーの信頼性を裏付ける重要な根拠となっている。
 

== OVPNの契約方法 ==
OVPNの契約手順を以下にに示す。 
 
# [https://www.ovpn.com/ OVPNの公式Webサイト]へアクセスして、料金プランを選択する。
# アカウントを作成する。
#: メールアドレスはオプションであり、ユーザ名とパスワードのみで登録できる。
#: 完全な匿名性を希望する場合は、使い捨てメールアドレスの使用を検討すること。
# 支払い方法を選択して、料金を支払う。
#: 支払い方法は、クレジットカード、PayPal、暗号通貨 (Bitcoin、Ethereum、Monero)、または現金郵送から選択できる。
#: 完全な匿名性を希望する場合は、Moneroまたは現金郵送が推奨される。
# [https://www.ovpn.com/en/download OVPNの公式Webサイト]にアクセスして、使用するOSに対応したOVPNクライアントをダウンロードする。
#: 対応OSは、Windows、MacOS、Linux (Ubuntu、Debian、Fedora、openSUSE)、Android、iOSである。
# OVPNクライアントをインストールおよび起動して、登録したユーザ名とパスワードでログインする。
# 接続するサーバを選択して、VPN接続を開始する。
#: マルチホップ接続を使用する場合は、入口サーバと出口サーバを個別に選択する。
 
10日間の返金保証が設けられており、不満がある場合はサポートに連絡することで返金を受けられる。 
 

== VPN over Tor ==
OVPNは、VPN over Tor (Tor経由でVPNに接続する方式) を公式にはサポートしていない。 
 
SOCKS5プロキシサービスの提供もないため、他のVPNプロバイダが提供する公式なVPN over Tor接続機能は利用できない。 
 
技術的には、OpenVPNの設定ファイルに以下に示すオプションを設定することにより、手動でTor経由のVPN接続を試みることは可能である。 
ただし、この方法はOVPNの公式サポート対象外であり、動作の保証はない。 
 
# OpenVPN設定ファイルに追記する (非公式)
socks-proxy 127.0.0.1 9050
 
この場合、Torクライアント (Torブラウザまたは Torデーモン) を事前に起動しておく必要がある。 
 
なお、OpenVPNをTor経由で使用する場合は、TorはTCPのみをサポートするため、OpenVPNのプロトコルをTCPに設定する必要がある。 
 

== Tor over VPN ==
VPNネットワーク経由でTorに接続する方法である。 
この方式では、OVPNが出口ノードとなり、その先にTorネットワークが続く構成になる。 
 
OVPNは公式ドキュメントにTor over VPNの手順を明記していないが、VPN接続後にTorブラウザを起動する標準的な方法で実現できる。 
 
# OVPNクライアントを起動して、任意のVPNサーバに接続する。
# [https://www.torproject.org/download/ Torブラウザの公式Webサイト]にアクセスして、Torブラウザをダウンロードおよびインストールする。
# Torブラウザを起動して、[Connect]ボタンを押下する。
#: Torブラウザの設定はデフォルトのままでよい。
 
この方式により、インターネットサービスプロバイダ (ISP) からはVPN接続のみが見え、Torを使用していることが隠蔽される。 
また、TorネットワークはVPN接続の先にあるため、OVPNのサーバからはTor経由のトラフィックとして見える。 
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:PinePhone]][[カテゴリ:Windows10]][[カテゴリ:Windows11]]

VPN - Nord VPN

2026-03-24T17:19:03Z

Wiki:

== 概要 ==
NordVPNは、通信に関するログを取らないVPNサービスであり、ユーザが使用したローカルまたは割り当てられたIPアドレス、接続履歴、トラフィックログ、DNSクエリを保持しない。 
ただし、アカウント管理目的でメールアドレスおよび支払い情報は保持される。 
 
NordVPNの特徴を、以下に示す。 
* ロケーション
*: NordVPNは、プライバシーの安全な場所であるパナマに本社を構えており、パナマには、EU、イギリス、オーストラリアのようなデータを保持する法律がない。
*: また、パナマは5つの目、9つの目、または14の目の国のメンバーではない。
* セキュリティ
*: NordVPNは、256ビットAESのデータ暗号化を提供している。
*: これは、優れたファイアウォールと保護されたサーバと一緒に、NordVPNの安全性を最高級に保護している。
* 通信速度
*: 以前、通信速度がNordVPNの弱点であったが、現在は最速のVPNサービスの1つになってきている。
*: また、P2PやTorrentの速度も非常に優れており、Netflixのようなコンテンツをアンロックすることも可能である。
* 契約
*: Eメール、支払い方法、パスワードのみで、アカウントを作成することができる。
*: つまり、ProtonMailのような匿名のメールサービスとBitcoinのような安全な支払い方法を用いることにより、NordVPNは完全な匿名性を求める人に提供できる可能性がある。
*: クレジットカードや銀行振込等、別の支払い方法を利用する場合は、個人の銀行情報を提供する必要がある。
 

== ノーログポリシーの検証 ==
==== 記録しないデータ ====
NordVPNが記録しないとしているデータは、以下の通りである。 
* ユーザの実際のIPアドレス
* インターネットアクティビティログ (訪問したWebサイト、ダウンロード内容)
* トラフィックデータ (通信内容)
* DNS照会記録
* VPN接続ログ (接続先サーバ、接続時刻等)
 
このノーログポリシーは、Standard VPN、Double VPN、Onion Over VPN、難読化サーバ、P2Pサーバの全てのサーバタイプに適用される。 
 
==== 記録するデータ ====
一方、アカウント管理目的で以下のデータは保持される。 
* メールアドレス
* 支払い情報
 
したがって、NordVPNは一切のデータを保持しないわけではなく、通信に関するログを保持しない という意味でのノーログVPNである。 
 
==== 技術的な裏付け - RAMオンリーサーバ ====
NordVPNは全サーバをRAMオンリー (ディスクレス) 構成に移行済みである。 
* メモリ (RAM) 上でのみデータを処理し、ハードディスクにはデータを保存しない
* サーバがシャットダウンまたは再起動された時点で、全てのデータが自動削除される
* 不正アクセスやハードウェア押収が発生した場合でも、データ抽出が不可能
 
==== 第三者監査の実施状況 ====
NordVPNのノーログポリシーは、以下の通り複数回の独立した第三者監査で検証されている。 
 
<center>
{| class="wikitable"
|+ ノーログポリシー監査履歴
! 回 !! 年 !! 監査機関 !! 結果
|-
| 第1回 || 2018年 || PricewaterhouseCoopers AG Switzerland (PwC) || ノーログポリシーの遵守を確認
|-
| 第2回 || 2020年 || PricewaterhouseCoopers AG Switzerland (PwC) || ノーログポリシーの遵守を確認
|-
| 第3回 || 2022年 || Deloitte Audit Lithuania || ノーログポリシーの遵守を確認
|-
| 第4回 || 2023年 || Deloitte Audit Lithuania || ノーログポリシーの遵守を確認
|-
| 第5回 || 2024年 || Deloitte Audit Lithuania || ノーログポリシーの遵守を確認
|-
| 第6回 || 2025年 || Deloitte Audit Lithuania || ノーログポリシーの遵守を確認
|}
</center>
 
2024年の第5回監査 (2024年11月18日〜12月20日) では、ISAE 3000基準に基づき、ユーザの活動をユーザ個人に関連付けることが不可能な状態であることが検証された。 
 
==== 法的立場 ====
NordVPNはパナマに本社 (Nordvpn S.A.) を置いており、以下の法的優位性を持つ。 
* パナマにはVPNプロバイダに対する強制的なデータ保持法が存在しない
* パナマは5 Eyes、9 Eyes、14 Eyesのいずれの国際情報共有同盟にも属していない
* 他国政府がNordVPNに対してデータ提供を強制するための法的メカニズムが制限されている
 
ただし、パナマの検察官から法的拘束力のある令状が発行された場合は、保持しているデータの開示に応じる。 
 
==== 捜査機関へのデータ提出事例 ====
NordVPNが法執行機関にデータを提出した事例と、他社VPNの事例を以下に整理する。 
 
===== 2024年10月: パナマ検察からの令状 =====
NordVPNはパナマの検察官から法的拘束力のある令状を受け、ユーザデータの開示に応じた。 
* 提供されたデータは、支払い情報およびアカウント存在確認のみ
* トラフィックログ、接続ログ等は保持していないため提供不可能であった。
* この事例を契機に、Warrant CanaryからTransparency Report (透明性レポート) への移行を開始
 
===== 2024年1月〜4月の統計 =====
* 政府機関からの問い合わせ: 81件
* DMCA請求: 約242万件
* いずれもユーザ情報の開示には至らなかったと報告されている。
 
===== 他社VPNの事例との比較 =====
<center>
{| class="wikitable"
|+ 他社VPNのログ提出事例との比較
! プロバイダ !! 事例 !! 実態
|-
| PureVPN (2017年) || FBIにサイバーストーキング事件のログを提供 || ノーログと謳いながら詳細な接続ログを保持していた。
|-
| HideMyAss (2011年) || FBIにLulzSecハッカーの接続データを提供 || 同様にログを保持していた。
|-
| NordVPN (2024年) || パナマ検察に支払い情報のみ提供 || トラフィックログは実際に存在せず提供不可能であった。
|}
</center>
 
PureVPNやHideMyAssは、ノーログを謳いながら実際には詳細なログを保持していたのに対し、 
NordVPNは第三者監査および実際の法的事例により、トラフィックログを保持していないことが裏付けられている。 
 
==== セキュリティインシデント ====
===== 2019年: サーバ侵害事件 =====
2018年3月、フィンランドのCreanova Datacenterから借用していた約3,000台中1台のサーバが侵害された。 
* 原因
*: データセンター側がIPMI (Intelligent Platform Management Interface) アカウントを未開示のまま放置していた。
* ユーザのパスワード、課金情報、VPNログの流出はなし
* 侵害の発見は2019年4月 (事件発生から約1年後)、公開は2019年10月 (発見からさらに6ヶ月後)
 
この事件を受けて、NordVPNは以下の改善策を実施した。 
* Creanovaとの契約を即座に解除
* 全サーバをRAMオンリー (ディスクレス) 構成に移行
* 自社管理コロケーションサーバの導入 (2020年10月〜)
* バグバウンティプログラムの開始 (2019年10月〜)
* VPN Trust Initiativeの創設メンバーとして参加
 
===== 親会社に関する懸念 =====
NordVPNの親会社であるNord Security (リトアニア) は、Tesonetというスタートアップインキュベーターの傘下にある。 
* Tesonetはデータ収集企業Oxylabsも保有しており、利益相反の可能性が指摘されている。
* 企業構造の不透明さが批判されることがある。
* ただし、複数の独立監査によりユーザデータが外部と共有されていないことは検証されている。
 
==== 総合評価 ====
下表に、NordVPNのノーログポリシーに関する総合評価を示す。 
 
<center>
{| class="wikitable"
|+ ノーログポリシー総合評価
! 観点 !! 評価
|-
| ノーログの真正性 || 6回の独立監査で検証済み。 2024年の令状事例でも実際にログが存在しないことが裏付けられた。
|-
| 捜査機関への対応 || 法的令状には応じるが、提供可能データは支払い情報のみ
|-
| 他社VPNとの違い || PureVPN、HideMyAssはノーログを詐称していたが、NordVPNは監査で裏付けあり
|-
| 懸念事項 || 親会社Tesonetの企業構造の不透明さ、2019年侵害事件の公表遅延
|}
</center>
 

== Nord VPNの契約 ==
Nord VPNの契約方法を以下に示す。 
 
# まず、Nord VPNの公式Webサイトへアクセスして、画面上にある[価格]を選択する。
# 価格画面からプランを選択する。
#: プランはスタンダード、プラス、コンプリートの3つのティアがあり、それぞれ1ヶ月、1年、2年の契約期間を選択できる。
#: 最もコストパフォーマンスが良いのは2年プランである。(3年プランは廃止されている)
#: プランを選択後、アカウントの作成と支払い方法の選択をする。
#: 
#: ※注意
#: NordVPNはパナマ所在の企業であるため、クレジットカード会社が海外購入として制限を掛け、否決される可能性がある。
#: PayPalまたは暗号通貨 (ビットコイン、イーサリアム、ライトコイン) での支払いを推奨する。
#: 
# 次に、[消費税適用外]項目から[日本]を選択して、[続ける]ボタンを押下する。
# ここでは、PayPalで決済するため、[Pay with PayPal]を選択して支払いを進める。 支払いが完了すると、支払い受付画面に移動する。
# Nord VPNからE-mailが3通届くので、アカウントを有効化するために"NordVPN account activation"という件名のメールを開く。
# [Set Password and Activate Account]ボタンを押下すると、Nord VPNのWebサイトへ移動するので、パスワード設定とアカウントの有効化を行う。 ここで入力するパスワードは、VPN接続する時のパスワードとなる。
# パスワードを設定すると、自動的にNord VPNソフトウェアのダウンロードが開始される。 または、[https://nordvpn.com/ja/download/ Nord VPNの公式Webサイト]でも個別にダウンロードできる。
 

== Nord VPNソフトウェアのインストール ==
===== RHEL =====
ターミナルを起動して、以下のコマンドを実行する。 
sudo wget -qnc https://repo.nordvpn.com/yum/nordvpn/centos/noarch/Packages/n/nordvpn-release-1.0.0-1.noarch.rpm
sudo dnf update
 
Nord VPNソフトウェアをインストールするため、以下のコマンドを実行する。 
sudo dnf install nordvpn
 
自分のNord VPNアカウントにログインする。 
nordvpn login
 
Nord VPNサーバに接続する。 
nordvpn connect
または
nordvpn c
 
===== SUSE =====
ターミナルを起動して、以下のコマンドを実行する。 
sudo rpm -v --import https://repo.nordvpn.com/gpg/nordvpn_public.asc
sudo zypper install https://repo.nordvpn.com/yum/nordvpn/centos/noarch/Packages/n/nordvpn-release-1.0.0-1.noarch.rpm
sudo zypper addrepo /etc/yum.repos.d/nordvpn.repo
 
Nord VPNソフトウェアをインストールするため、以下のコマンドを実行する。 
sudo zypper install nordvpn
 
自分のNord VPNアカウントにログインする。 
nordvpn login
 
Nord VPNサーバに接続する。 
nordvpn connect
または
nordvpn c
 
===== LinuxにおけるNord VPNコマンド =====
nordvpn login - ログイン
nordvpn login --token [トークン] - トークンを使用してログイン (GUI無し環境用)
nordvpn connect or nordvpn c - VPNに接続する。特定のサーバに接続する場合は nordvpn connect <country_code server_number> (例: nordvpn connect uk715)
nordvpn disconnect or nordvpn d - VPNから切断する
 
nordvpn set or nordvpn s - 設定オプション:
nordvpn set threatprotectionlite on or off - Threat Protection Lite (DNSフィルタリング・広告ブロック) の有効化/無効化 (旧: cybersec)
nordvpn set killswitch on or off - Kill Switchの有効化/無効化
nordvpn set autoconnect on or off - 自動接続の有効化/無効化。特定サーバの自動接続: nordvpn set autoconnect on us2435
nordvpn set dns 1.1.1.1 1.0.0.1 - カスタムDNSの設定 (1つまたは2つ指定可能)
nordvpn set technology nordlynx or openvpn - VPNプロトコルの切り替え
nordvpn set obfuscate on or off - 難読化サーバの有効化/無効化
nordvpn set firewall on or off - ファイアウォールの有効化/無効化
nordvpn set ipv6 on or off - IPv6サポートの有効化/無効化
nordvpn set lan_discovery on or off - LANデバイス検出の有効化/無効化
nordvpn set post_quantum_vpn on or off - ポスト量子暗号の有効化/無効化
nordvpn set notify on or off - 通知の有効化/無効化
nordvpn set tray on or off - システムトレイアイコンの有効化/無効化
nordvpn set defaults - デフォルト設定にリセット
 
nordvpn allowlist add port 22 - ポート22をVPN例外リストに追加 (旧: whitelist)
nordvpn allowlist add port 22 protocol TCP - プロトコル指定でポートを追加
nordvpn allowlist remove port 22 - ポート22のルールを削除
nordvpn allowlist add subnet 192.168.0.0/16 - サブネットをVPN例外リストに追加
nordvpn allowlist remove subnet 192.168.0.0/16 - サブネットのルールを削除
nordvpn allowlist remove all - VPN例外リストの全ルールを削除
 
nordvpn settings - 現在の設定を表示
nordvpn status - 接続状態を表示
nordvpn account - アカウント情報を表示
nordvpn countries - 利用可能な国一覧を表示
nordvpn cities - 利用可能な都市一覧を表示
nordvpn groups - 利用可能なサーバグループ一覧を表示
nordvpn version - アプリケーションバージョンを表示
nordvpn logout - ログアウト
nordvpn help or nordvpn h - コマンド一覧またはヘルプを表示
 
<code>man nordvpn</code>コマンドを使用して、コマンドの全リストを見ることができる。 
 
===== Windows =====
Nord VPNソフトウェアのインストール手順を記載する。 
# 上記セクションでダウンロードしたNordVPNSetup.exeを実行する。
# インストール先を選択するダイアログが表示されるので、必要であればフォルダを変更して[Next]ボタンを押下する。
# [Install]ボタンを押下してインストールを始める。
# [Finish]ボタンを押下してインストールを完了する。
 
Nord VPNソフトウェアを起動手順を記載する。 
# Nord VPNソフトウェアの起動後、ログイン画面が表示されるので、Nord VPNで登録したメールアドレスとパスワードを入力して[Sign In]ボタンを押下する。
# ログインに成功すると、VPNサーバを選択する画面が表示される。 メイン画面下の[Quick connect]ボタンを押下すると、近距離にあるVPNサーバが選択される。(日本国内から接続すれば、日本のVPNサーバが選択される)
# 接続したい国があれば、世界地図の上から選択する事もできる。 例えば、ブラジルのVPNサーバに接続する場合、ブラジルを選択してから[Quick connect]ボタンを押下する。 あるいは、メイン画面左から接続したい国を選択して接続することもできる。
# 接続が成功すると、国のアイコンが緑色に変化する。また、接続状態も[UNCONECTED]から[PROTECTED]に変化して[Connected to Brazil]と表示される。
# 切断する場合は、[Disconnect]ボタンを押下する。
 

== Network Managerを使用したNord VPNの接続 ==
# Nord VPNの公式Webサイトから、[https://downloads.nordcdn.com/configs/archives/servers/ovpn.zip OpenVPN構成ファイルパッケージ]をダウンロードして解凍する。
# Network Managerの設定画面を起動する。(GNOMEの場合は、[VPNオフ]を選択後、ドロップダウンから[VPN設定]を選択する)
# 設定画面下にある[+]ボタンを押下する。(GNOMEの場合は、 [VPN]項目横にある[+]ボタンを押下する)
# 接続タイプは、[VPN接続をインポート...]を選択する。(GNOMEの場合は、[ファイルからインポート...]を選択する)
# 上記でダウンロードしたファイルから1つを選択して、[開く]ボタンを押下する。
# ポップアップウィンドウにNord VPNで取得したのユーザ名とパスワードを入力して、[追加]ボタンを押下する。
# 追加したNord VPNサービスの資格情報は、Nordアカウントダッシュボードで確認できる。右側のボタンを使用して認証情報をコピーします。
# 最後に、Network Managerの設定画面から、VPNオプションの下のスライダーを押下して、Nord VPNサーバに接続する。 VPN接続が開始されると、スライダーは緑色に変化する。
 

== Nord VPNソフトウェアの設定 ==
Nord VPNソフトウェアのメイン画面右上にある歯車のアイコンを選択する。 
設定項目は、[General]、[Auto Connect]、[Advanced]がある。 
 
===== General =====
Nord VPNの[General]項目において、重要な項目は以下の2つである。 
* Start NordVPN on startup
* Internet Kill Switch
 
[Start NordVPN on startup]項目は、初期設定で有効化されている。 
OS起動時にNordVPNを動作させるため、[オン]にする。 
 
[Internet Kill Switch]項目は、VPNを経由しない通信をすべて遮断する。匿名性を向上させるため、[オン]に設定する。 
注意点として、Nord VPNに接続していない状態では、一切ネットワーク接続できなくなる点である。 
VPNを切断してVPN非経由でインターネット接続する場合は、[Internet Kill Switch]項目を[オフ]に設定する必要がある。 
 
===== Auto Connect =====
Nord VPNの[Auto Connect]項目では、自動接続設定を行う。 
VPNクライアントを起動した際、自動的にVPN接続する場合は、[Connect when app starts]項目を[オン]に設定する。 
 
また、外出先でWi-Fiに接続する可能性がある場合は、[Connect on insecure wireless]項目を[オン]に設定するとよい。 
 
自動接続する国を選択したい場合は、[Auto connect to]項目で選択して、更に細かく指定する場合は[Preferred region]項目で指定する。 
通常は、[Preferred region]項目は[Automatically pick best]に設定することを推奨する。 
 

== Double VPNで接続する ==
NordVPNのメリットの1つに、匿名性を高めるDouble VPNが存在する。 
Double VPNを利用するとVPNサーバを2つ経由する。 
ユーザが利用するISPには、1つ目のVPNサーバと通信している記録が残るが、最終的な接続先から見ると2つ目のVPNサーバから接続している記録が残る。 
そして1つ目と2つ目のVPNサーバ間は通信を中継しているだけであるため、VPNサーバ間の通信記録にユーザの情報は残らない。 
そのため極めて高い匿名性が確保される。 
 
極めて高い匿名性を提供するDouble VPNであるが、利用方法は簡単である。 
# Nord VPNのソフトウェアを起動する。 メイン画面左にある[Double VPN]を選択すると、自動的にDouble VPNで接続できる。
# 接続するVPNサーバを指定する場合は、[Double VPN]の右側にある[...]を選択する。
# [Double VPN]画面が開くので、[Country:]プルダウンと[Server:]プルダウンを選択する。 初期設定では、最適な国とサーバが自動的に選択される。
# [Country:]プルダウンでは1番目のサーバを選択して、[Server:]プルダウンでは2番目のサーバを選択する。 
 

== Tor over VPN ==
VPNネットワーク経由でTorに接続する方法であり、Torは終了ノードになる。 
 
ISPからTorの使用を隠蔽でき、Torの入口ノードにユーザの実IPアドレスが公開されない。 
 
NordVPNにはOnion Over VPNという組み込み機能があり、Tor over VPNを自動的に実現できる。 
この機能を使用することにより、Torブラウザをインストールすることなく.onionサイトにアクセスすることが可能となる。 
 
Onion Over VPN対応サーバの所在地はオランダおよびスイスであり、プロトコルはOpenVPNのみ対応している。(NordLynxは不可) 
 
==== Onion Over VPN機能を使用する方法 ====
NordVPNアプリのOnion Over VPN機能を使用する手順を以下に示す。 
 
# NordVPNのソフトウェアを起動する。
# サーバーリスト内の[Specialty servers]を選択する。
# [Onion Over VPN]を選択して接続する。
 
==== Onion Over VPN機能をLinux CLIから使用する方法 ====
以下に示すコマンドを実行することにより、Onion Over VPNに接続できる。 
 
nordvpn connect onion_over_vpn
 
==== 通常VPN接続にTorブラウザを組み合わせる方法 ====
Onion Over VPN機能を使用せず、NordVPNの任意のサーバに接続した後にTorブラウザを起動する方法でもTor over VPNを実現できる。 
 
# NordVPNのソフトウェアまたは NetworkManager等を使用して、VPNに接続する。
# [https://www.torproject.org/download/ Torブラウザの公式Webサイト]にアクセスして、Torブラウザをダウンロードおよびインストールする。
# Torブラウザを起動して、[Connect]ボタンを押下する。
#: Torブラウザの設定はデフォルトのままでよい。
 
なお、ダブルエンクリプションと複数のサーバホップにより、インターネット速度が大幅に低下する可能性がある。 
 

== VPN over Tor ==
VPN over Torとは、VPNサーバへの接続にTorネットワークを使用する構成である。 
 
Torネットワークがブリッジとして機能するため、自宅のIPアドレスをVPNプロバイダに公開することなく、VPNに接続できる。 
したがって、プライバシー、セキュリティ、匿名性への2重層を提供する。 
 
ただし、NordVPNはVPN over Torを公式にはサポートしていない。 
NordVPNおよびTor Projectともに一般ユーザへの使用は非推奨としており、設定誤りによるセキュリティリスクにも注意が必要である。 
 
技術的には、OpenVPN設定ファイルを手動編集することでVPN over Torを実現できる。 
ただし、速度の大幅な低下が発生するため、実用上の使用は困難を伴う場合がある。 
 
==== 手動設定による接続手順 ====
以下に示す手順は公式サポート対象外であり、設定誤りのリスクがある。 
そのため、十分に理解した上で実施すること。 
 
# Torブラウザをインストールして起動して、Torネットワークへの接続を確立する。
# NordVPNの[https://nordvpn.com/ovpn/ OpenVPN設定ファイル]をダウンロードする。
# ダウンロードしたOpenVPN設定ファイル (.ovpn拡張子) ファイルをテキストエディタで開いて、以下に示す設定を追記する。
#: <pre>socks-proxy 127.0.0.1 9150</pre>
# 編集した設定ファイルを使用して、OpenVPNクライアントから接続する。
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:Windows7]][[カテゴリ:Windows10]][[カテゴリ:Windows11]]

VPN - ExpressVPN

2026-03-24T16:55:49Z

Wiki: ページの作成:「== 概要 == ExpressVPNは、英領バージン諸島 (BVI) に登録されたVPNサービスプロバイダである。 105カ国以上にサーバを展開しており、AES-256暗号化、独自プロトコルのLightway、TrustedServer技術を採用している。 Windows、MacOS、Linux、Android、iOS、ルーター等に対応しており、最大8台のデバイスを同時接続することができる。 2009年に設立され、2021…」

== 概要 ==
ExpressVPNは、英領バージン諸島 (BVI) に登録されたVPNサービスプロバイダである。 
105カ国以上にサーバを展開しており、AES-256暗号化、独自プロトコルのLightway、TrustedServer技術を採用している。 
 
Windows、MacOS、Linux、Android、iOS、ルーター等に対応しており、最大8台のデバイスを同時接続することができる。 
 
2009年に設立され、2021年にKape Technologiesが約9.36億ドルで買収した。 
 
<center>
{| class="wikitable"
|+ ExpressVPNのメリットとデメリット
|-
! メリット !! デメリット
|-
| 高速通信と広いサーバネットワーク(105カ国以上) || 高価格帯 (競合他社と比較して割高)
|-
| 業界最多水準の第三者監査実績(19〜23件) || Kape Technologies買収による組織的信頼性への懸念
|-
| TrustedServer(RAMオンリー)技術によるデータ保護 || Project Raven問題 (元CIOの監視プログラム関与)
|-
| 30日間返金保証 ||
|}
</center>
 
下表に、ExpressVPNの特徴を示す。 
 
<center>
{| class="wikitable"
|+ ExpressVPNの主な技術的特徴
|-
! 特徴 !! 説明
|-
| TrustedServer技術 || 全サーバがRAMのみで動作し、再起動時に全データが消去される仕組みである。 ディスクにデータが書き込まれないため、サーバが押収されてもユーザデータが残らない。
|-
| Lightwayプロトコル || ExpressVPNが独自開発したVPNプロトコルである。 wolfSSLをベースとした高速・軽量・安全な接続を実現している。
|-
| AES-256暗号化 || 軍事レベルの暗号化技術を採用している。
|-
| 幅広いデバイス対応 || Windows、MacOS、Linux、Android、iOS、ルーター等、主要なプラットフォームに対応している。
|-
| 第三者監査 || 業界最多水準の独立した監査を継続して受けている。
|}
</center>
 
ExpressVPNの料金は、月額6.67ドルからである。(2026年時点、30日間返金保証付き) 
 

== ノーログポリシーの実態 ==
ExpressVPNはノーログVPNを標榜しており、英領バージン諸島の法制度とTrustedServer技術を根拠として、データログを保存または共有していないと主張している。 
 
==== 公式ノーログポリシーの内容 ====
ExpressVPNの公式プライバシーポリシーでは、以下のデータを一切保存しないと明記している。 
 
* アクティビティログ
** ブラウジング履歴
** トラフィック宛先
** データ内容
** DNSクエリ
* コネクションログ
** ユーザのIPアドレス
** 発信VPN IPアドレス
** 接続タイムスタンプ
** セッション継続時間
 
収集されるデータは、アカウント管理に必要な最小限の情報 (メールアドレス、支払い情報) のみである。 
 
TrustedServer技術により、全サーバがRAMのみで動作し、再起動時に全データが消去されるため、技術的にもログが残らない仕組みとなっている。 
 
==== 捜査機関への対応事例 ====
ExpressVPNのノーログポリシーは、実際の捜査機関との対応においても有効性が確認されている。 
 
* 2017年トルコ・ロシア大使暗殺事件
*: 2016年12月、ロシア駐トルコ大使アンドレイ・カルロフが暗殺される事件が発生した。
*: 暗殺者がExpressVPNを使用していたとされ、トルコ当局がExpressVPNサーバを物理的に押収した。
*: 捜査官は指定IPアドレスを使用していたユーザの接続ログを求めたが、ExpressVPNは「接続ログを保持していない」と回答した。
*: トルコ当局はログが存在しないことを確認し、ノーログポリシーが物理的押収においても機能していることが実証された。
*: この事件以降、ExpressVPNはトルコ国内に物理サーバを設置せず、オランダのバーチャルサーバを提供している。
* 法執行機関からの要求と対応実績
*: 2024年: 333件の政府・法執行機関からの法的要求を受けたが、ユーザ関連データは一切提供しなかった。
*: 2025年上半期: 374件の正式な法執行機関要求を受けたが、一切のデータ提供を行わなかった。
*: 2024年のワラント (令状): 3件受領したが、データ開示なし。2025年上半期はワラント0件であった。
 
==== 第三者セキュリティ監査 ====
ExpressVPNは、業界最多水準の独立した第三者監査を継続して受けている。 
 
<center>
{| class="wikitable"
|+ ExpressVPN 第三者セキュリティ監査実績
! 年月 !! 監査機関 !! 対象 !! 結果
|-
| 2019年6月 || PwC Switzerland || プライバシーポリシー、TrustedServer || ポリシー準拠を確認
|-
| 2022年 || KPMG || ノーログポリシー (第1次) || 問題なし
|-
| 2024年11月 || Cure53 || Aircoveルーター (第2次) || セキュリティ監査完了
|-
| 2025年2月 || KPMG || TrustedServer、ノーログポリシー (第2次) || 技術的保護に問題なし
|-
| 2025年6月 || KPMG || ノーログポリシー (第3次) || 合理的確証を提供
|}
</center>
 
Lightwayプロトコルに対するCure53の監査では、5件の低度な問題と4件の情報通知が確認されたが、重大・高度・中度の問題は検出されなかった。 
 
全ての監査はISAE (UK) 3000 Type 1に準拠している。 
また、2025年にISO/IEC 27001、ISO 9001、ISO 18295-1 & 18295-2を取得している。 
業界で最も多くの独立監査を実施しており、その件数は19〜23件に及ぶ。 
 
==== 管轄法域に関する情報 ====
ExpressVPNの拠点である英領バージン諸島 (BVI) は、VPNプロバイダにとってプライバシー上有利な管轄法域とされている。 
 
* データ保持に関する法律がない。
* 5 Eyes、9 Eyes、14 Eyes監視協定のいずれにも加盟していない。
 
これらの条件により、政府からの強制的なデータ開示命令を受けるリスクが低い環境となっている。 
 
==== 運営体制の変遷 ====
<center>
{| class="wikitable"
|+ ExpressVPNの運営体制の変遷
! 時期 !! 出来事
|-
| 2009年 || 英領バージン諸島で設立
|-
| 2019年12月 || Daniel GerickeをCIOとして採用
|-
| 2021年9月 || Kape Technologiesが約9.36億ドルで買収を発表
|-
| 2021年9月 || Daniel GerickeのUAE秘密監視プログラム「Project Raven」への関与が発覚。$335,000の罰金
|-
| 2023年7月 || Daniel GerickeがExpressVPNを離職
|}
</center>
 
Kape Technologies問題について、以下に示す。 
* かつて、Crossriderとして知られており、2018年に名称変更した。
* カリフォルニア大学バークレー校とGoogleの共同研究 (2015年) において、広告注入ツールの主要関連企業として特定された。
* セキュリティコミュニティから、"マルウェア開発者がVPNを買収した"という懸念が提起された。
 
Daniel Gericke / Project Raven問題について、以下に示す。 
* GerickeはUAE政府の秘密監視プログラム "Project Raven" に関与していた。
* 米国人、活動家、各国首脳のハッキングを含む作戦に参加していた。
* ゼロクリックエクスプロイトをKarmaというハッキングシステムに組み込んだ。
* $335,000の罰金を支払い、米国安全保障クリアランスを生涯剥奪された。
* ExpressVPNはGerickeの過去の「主要な事実」を事前に認識していたと主張している。
* 40人以上のExpressVPN従業員が内部で抗議した。
* Edward SnowdenがExpressVPNの使用中止を勧告した。
* Gerickeは2023年7月に離職した。
 
==== 最新動向 (2024年〜2026年) ====
* 2025年4月
*: Windows版アプリの脆弱性 (RDPトラフィックがVPNトンネルを迂回するバグ) が報告され、バージョン12.101.0.45で修正された。
* 透明性レポート
*: 半年ごとに発行を継続している。(2024年下半期: 333件の政府要求、2025年上半期: 374件)
* Bug Bountyプログラム
*: 2025年Q2は82件応募があり、5件が有効な脆弱性として確認された。
* ISO認証
*: ISO/IEC 27001、ISO 9001、ISO 18295-1 & 18295-2を取得した。
 
==== 留意点 ====
ExpressVPNのノーログポリシーの技術的実装は、サーバ押収事件と複数の第三者監査によって裏付けられており、高い信頼性がある。 
 
一方、Kape Technologies買収やProject Raven問題により、組織としての信頼性には相当な懸念が存在する。 
Edward Snowden等信頼できるセキュリティ専門家がExpressVPNの利用を推奨していない点も留意が必要である。 
 
技術は信頼できるが、組織への信頼は分かれているというのが現状の評価である。 
 

== ExpressVPNの契約方法 ==
# [https://www.expressvpn.com ExpressVPNの公式Webサイト]にアクセスする。
# 1ヶ月、6ヶ月、12ヶ月のいずれかのプランを選択する。
# メールアドレスを入力して、アカウントを作成する。
# 支払い方法を選択する。 クレジットカード、PayPal、Bitcoin、その他の暗号通貨が使用できる。
# 支払い完了後、ソフトウェアをダウンロードしてインストールする。
 

== Tor over VPN ==
VPNネットワーク経由でTorに接続する方法であり、Torは終了ノードになる。 
 
この方式では、ユーザのトラフィックはまずExpressVPNサーバーを経由し、その後Torネットワークに入る。 
ISP (インターネットサービスプロバイダ) からはTorの使用が隠蔽され、Torの入口ノードからはユーザの実際のIPアドレスが隠蔽される。 
 
# ExpressVPNアプリを起動して、VPNサーバーに接続する。
# [https://www.torproject.org/download/ Torブラウザの公式Webサイト]にアクセスして、Torブラウザをダウンロードおよびインストールする。
# Torブラウザを起動して、[Connect]ボタンを押下する。 Torブラウザの設定はデフォルトのままでよい。
 
Tor over VPN方式のメリットを以下に示す。 
* ISPからTorの使用を隠すことができる。
* Torの入口ノードにユーザの実際のIPアドレスが公開されない。
* 設定が簡単であり、特別な設定は不要である。
 
Tor over VPN方式のデメリットを以下に示す。 
* Torの出口ノードからはトラフィックが見える可能性がある。(HTTPS通信の場合は暗号化されている)
* VPNプロバイダ (ExpressVPN) は、ユーザの実際のIPアドレスを知ることができる。
 

== VPN over Tor ==
VPNサーバへの接続にTorネットワークを使用する方式を、VPN over Tor、あるいは、VPN through Torと呼ぶ。 
 
ExpressVPNは、VPN over Torの構成を公式にサポートしておらず、非推奨としている。 
 
ExpressVPNがVPN over Torを非推奨とする理由を以下に示す。 
* Torの出口ノードの代わりにVPNプロバイダがトラフィックを見ることになるため、匿名性の向上がない。
* 信頼不要であるTorの設計に、VPNプロバイダという信頼要件を再導入してしまう。
* Torの速度低下というデメリットのみが残り、セキュリティ上のメリットがない。
 
ExpressVPNでTorを利用する場合は、上記のTor over VPN方式を使用すること。 
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:PinePhone]][[カテゴリ:Windows7]][[カテゴリ:Windows10]][[カテゴリ:Windows11]]

VPN - Surfshark

2026-03-24T16:06:22Z

Wiki: ページの作成:「== 概要 == Surfsharkは、2018年にリトアニアで設立されたVPNサービスである。(現在の法人所在地はオランダ) 運営会社はSurfshark B.V.であり、2022年にNord Security傘下に入りCyberspace B.V.として統合されている。 100カ国以上に3,200以上のサーバを展開しており、AES-256-GCM暗号化、WireGuard / OpenVPN / IKEv2プロトコルに対応している。 デバイスの同時接続数…」

== 概要 ==
Surfsharkは、2018年にリトアニアで設立されたVPNサービスである。(現在の法人所在地はオランダ) 
運営会社はSurfshark B.V.であり、2022年にNord Security傘下に入りCyberspace B.V.として統合されている。 
 
100カ国以上に3,200以上のサーバを展開しており、AES-256-GCM暗号化、WireGuard / OpenVPN / IKEv2プロトコルに対応している。 
デバイスの同時接続数が無制限であることも大きな特徴の1つである。 
 
対応OSは、Windows、MacOS、Linux、Android、iOS、Amazon Fire TVである。 
料金は、月額1.99ドルからである。(2026年時点) 
 
全サーバがRAM-only構成であり (2020年に完全移行)、Deloitte (Big Four) による独立監査でノーログポリシーが検証済みである。(2023年および2025年) 
 
<center>
{| class="wikitable"
|+ Surfsharkのメリットとデメリット
|-
! メリット !! デメリット
|-
| コストパフォーマンスが高い。 || 設立が比較的新しい。(2018年)
|-
| デバイス接続台数が無制限である。 || Nine Eyes加盟国(オランダ)に所在している。
|-
| RAM-onlyサーバを採用している。 || Nord Security傘下であり、独立性への懸念がある。
|-
| 第三者機関による監査が実施済みである。 || 一部のサーバでCAPTCHAが頻発するとの報告がある。
|-
| 100カ国以上にサーバが展開されている。 || 接続が不安定になるとの報告がある。
|}
</center>
 
Surfsharkの主な特徴を以下に示す。 
 
<center>
{| class="wikitable"
|+ VPNの主な特徴
|-
! 特徴 !! 説明
|-
| ノーログポリシー || Deloitteによる第三者監査でノーログポリシーが検証されている。
|-
| RAM-onlyサーバ || 全3,200以上のサーバがRAM (揮発性メモリ) のみで動作する。 再起動時にデータが物理的に消去される。
|-
| 無制限デバイス接続 || 1つのアカウントで接続台数の制限なく使用できる。
|-
| AES-256-GCM暗号化 || 米国政府および軍事機関でも採用されている最高レベルの暗号化技術を使用している。
|-
| MultiHop機能 || 2つのVPNサーバを経由する二重VPN接続が可能である。
|}
</center>
 

== ノーログポリシーの実態 ==
SurfsharkはノーログVPNを標榜しており、RAM-onlyサーバおよびDeloitteによる第三者監査を根拠として、ユーザデータを記録・保存しないと主張している。 
 
==== 公式ノーログポリシーの内容 ====
Surfsharkの公式プライバシーポリシーでは、以下に示すデータを一切保存しないと明記している。 
 
* IPアドレス (ユーザの本来のIPアドレス)
* 閲覧履歴およびDNSクエリ
* セッション情報 (接続時刻、切断時刻、セッション継続時間)
* 帯域幅使用量
* 通信プロトコルおよびポート番号
* 接続先サーバのIPアドレス
* ネットワークトラフィック
 
収集・保持されるデータは、以下に示す最小限の情報のみである。 
 
* アカウント情報 (メールアドレス、暗号化されたパスワード)
* 課金および購入履歴
* 一時的な接続メタデータ (ユーザID、IPアドレス、接続タイムスタンプ) --> セッション終了後15分以内に自動削除
 
なお、アカウントデータはサービス利用期間中および最後のログインから2年間保持される。 
 
==== 第三者監査の実施状況 ====
Surfsharkは、透明性の確保とセキュリティの改善のために、定期的に第三者機関による独立した監査を受けている。 
 
<center>
{| class="wikitable"
|+ Surfshark セキュリティ監査実績
! 年月 !! 監査機関 !! 対象 !! 基準 !! 結果
|-
| 2023年 || Deloitte || ノーログポリシー || ISAE 3000 || 合格
|-
| 2024年 || Cure53 || サーバインフラ / ブラウザ拡張機能 || - || 深刻な問題なし 堅牢と評価
|-
| 2025年4月 || SecuRing || Webアプリ / デスクトップアプリ / モバイルアプリ / ブラウザプラグイン || - || 重大な脆弱性なし
|-
| 2025年6月 || Deloitte || ノーログポリシー (2回目) || ISAE 3000 || 合格
|}
</center>
 
全ての監査報告書はSurfsharkのTrust Centerで公開されている。 
 
==== 捜査機関への対応事例 ====
Surfsharkのノーログポリシーに関する捜査機関への対応状況は以下の通りである。 
 
* 令状カナリー (2025年12月15日時点)
*: 国家安全保障文書: 0件
*: 緘黙命令: 0件
*: 政府機関からの令状: 0件
* 2024年4月〜6月の政府機関からの問い合わせ
*: 政府機関から45件の問い合わせを受けたが、いずれもユーザデータの開示には至っていない。
 
全期間を通じて、ユーザデータの捜査機関への提出事例はゼロである。 
ノーログ + RAM-onlyの構成により、要求があっても提供できるデータが物理的に存在しない。 
 
なお、2024年8月に令状カナリーページの更新で一時的に懸念が発生した。 
Surfsharkはシステム不具合と説明しており、その後、透明性レポート制度に移行している。 
 
裁判所でノーログポリシーが正式に検証された事例は確認されていない。(監査による検証のみ) 
 
==== 技術的なプライバシー保護 ====
Surfsharkは、ユーザのプライバシーを保護するために、以下に示す技術的な仕組みを採用している。 
 
<center>
{| class="wikitable"
|+ 技術的なセキュリティ対策
|-
! 特徴 !! 説明
|-
| RAM-onlyサーバ || 全3,200以上のサーバがRAMのみで動作する。(2020年に完全移行) 電源オフまたは再起動時にデータが物理的に消去される。 2024年に全サーバを10Gbps速度にアップグレードしている。
|-
| プロトコルのカスタマイズ || WireGuardとOpenVPNをカスタマイズして、セッション後のファイル作成を排除している。
|-
| 暗号化 || AES-256-GCMを採用しており、米国政府および軍事機関でも採用されている暗号化技術である。
|-
| セッションキー || セッション中のみメモリに存在しており、セッション終了時に破棄される。
|-
| Port Shadow攻撃への耐性 || Port Shadow攻撃への耐性が確認済みである。
|}
</center>
 
==== 管轄法域に関する考慮事項 ====
Surfshark B.V.はオランダに本社を置いている。(2021年にイギリス領バージン諸島から移転) 
 
オランダは9 Eyes情報共有同盟に所属しているが、オランダにはVPNプロバイダに対する強制的なデータ保持義務は存在しない。 
また、EU GDPRに準拠しており、忘れられる権利 が全ユーザに適用される。 
 
2022年にNord Security傘下に入りCyberspace B.V.として統合されている。 
NordVPN (パナマ本社) と同じ親会社であるが、サービスは独立して運営されている。 
 
Nord Security傘下入り後のデータ共有の証拠は報告されていない。 
 
==== 他のノーログVPNとの比較 ====
<center>
{| class="wikitable"
|+ ノーログVPN 比較
! VPN !! ノーログ監査 !! 監査企業 !! サーバ構成 !! 設立年 !! 管轄法域 !! 評価傾向
|-
| Surfshark || あり (2回) || Deloitte, Cure53 || RAM-only || 2018年 || オランダ (9 Eyes) || コスパ優秀だが信頼度はやや低い
|-
| Mullvad || あり (複数回) || Cure53, X41 D-Sec, Assured Security等 || RAM-only || 2009年 || スウェーデン (14 Eyes) || 最高のプライバシー評価
|-
| ProtonVPN || あり || 複数実施 || 非RAM-only || 2014年 || スイス || 法的信頼度が高い
|-
| ExpressVPN || あり (限定的) || - || RAM-only || 2009年 || イギリス領バージン諸島 || サーバ数多だが透明度への批判あり
|}
</center>
 
==== 留意点 ====
Surfsharkのノーログポリシーに関する留意点を以下に示す。 
 
* 15分以内に自動削除という実装
*: 完全なノーログではなく、接続メタデータについてはセッション終了後15分以内に自動削除される仕組みである。
*: 完全にゼロログの構成ではないことに注意する。
* 監査はスナップショットである。
*: 監査は特定時点の状態を評価したものであり、継続的な遵守を保証するものではない。
* 実地検証の事例がない。
*: 裁判等でノーログポリシーが公式に検証された事例はまだない。(Mullvadは2023年に家宅捜索で実証済み)
* 企業統治の透明性
*: Nord Security傘下の企業統治について、出資構造が完全に透明化されていない。
* 設立年が比較的新しい。
*: 2018年設立であり、Mullvad (2009年) や ProtonVPN (2014年) と比較して実績が浅い。
* CAPTCHAの問題
*: GoogleをはじめとするサービスがSurfsharkの一部サーバをブロックリストに含めており、CAPTCHA認証を頻繁に求められるとの報告がある。
 

== Surfsharkの契約方法 ==
# [https://surfshark.com/pricing Surfsharkの公式Webサイト]にアクセスして、[Surfsharkを入手する]ボタンを押下する。
# プランを選択する。
#: 2026年時点で利用可能なプランは以下の通りである。
#* Surfshark Starter
#*: 基本的なVPN機能とAlternative ID機能を含むプランである。
#*: 2年契約で月額約1.99ドルから利用可能である。
#* Surfshark One
#*: VPN機能に加えて、複数のセキュリティツールを統合したサイバーセキュリティバンドルである。
#* Surfshark One+
#*: Incogni (データ削除ツール) を含む最上位のプランである。
# メールアドレスを入力して、パスワードを設定する。 または、GoogleアカウントもしくはAppleアカウントで連携することも可能である。
# 支払い方法を選択する。
#: 以下に示す支払い方法が利用可能である。
#* クレジットカード (VISA、MasterCard、American Express、DISCOVER)
#* PayPal
#* Google Pay / Apple Pay / Amazon Pay
#* 暗号通貨 (ビットコイン、イーサリアム、リップル)
# 支払いを完了すると、アカウントが即座に有効化される。
 
全プラン共通で、デバイスの同時接続台数は無制限であり、30日間の返金保証が付与されている。 
 
なお、返金を受けるには単なる解約だけでは不十分であり、必ずカスタマーサポート (ライブチャット推奨) へ返金リクエストを提出する必要がある。 
App StoreやAmazon等の小売店経由で購入した場合は、返金窓口は購入元となる。 
 
JCBカードには対応していないため注意すること。 
 

== VPN over Tor ==
VPN over Torとは、VPNサーバへの接続にTorネットワークを使用する構成である。 
 
Torネットワークがブリッジとして機能するため、自宅のIPアドレスをVPNプロバイダに公開することなく、VPNに接続できる。 
したがって、プライバシー、セキュリティ、匿名性への2重層を提供する。 
 
ただし、SurfsharkはVPN over Torに対応していない。 
SurfsharkはSOCKS5プロキシサービスを提供しておらず、OpenVPN設定ファイルを介したTor経由の接続も公式にはサポートしていない。 
 

== Tor over VPN ==
VPNネットワーク経由でTorに接続する方法であり、Torは終了ノードになる。 
 
ISPからTorの使用を隠蔽でき、Torの入口ノードにユーザの実IPアドレスが公開されない。 
Surfsharkのソフトウェアまたは NetworkManager等でVPNに接続した後、Torブラウザを起動するだけで実現できる。 
 
# SurfsharkのソフトウェアまたはNetworkManager等を使用して、VPNに接続する。
# [https://www.torproject.org/download/ Torブラウザの公式Webサイト]にアクセスして、Torブラウザをダウンロードおよびインストールする。
# Torブラウザを起動して、[Connect]ボタンを押下する。
#: Torブラウザの設定はデフォルトのままでよい。
 
なお、ダブルエンクリプションと複数のサーバホップにより、インターネット速度が大幅に低下する可能性がある。 
 
SurfsharkにはMultiHop機能が搭載されており、2つのVPNサーバを経由する二重VPN接続も可能である。 
MultiHopを使用することにより、Tor出口ノードへのルーティングに類似したプライバシー保護効果を得ることができる。 
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:PinePhone]][[カテゴリ:Windows7]][[カテゴリ:Windows10]][[カテゴリ:Windows11]]

VPN - PrivateVPN

2026-03-24T15:30:04Z

Wiki: /* VPN over Tor */

== 概要 ==
PrivateVPNは、200以上のサーバからなる小規模なネットワークを運営しており、これらは63カ国以上に配置されている。 
さらに、ラグフリーストリーミングのための高速な接続を提供している。 
 
256ビットAES暗号化、DNSリークからの保護、キルスイッチが用意されており、その厳格なノーログポリシーによって、ユーザのプライバシーを保護する。 
 
Linuxにおいて、PrivateVPNの設定に問題がある場合、ライブチャットと電子メールサポートを利用することができる。 
また、無料のリモートヘルプとインストールも利用できる。 
 
PrivateVPNは、現在、Linux向けのCLIソフトウェアをサポートしている。 
高速で安定した接続と、地理的制限のあるコンテンツの確実なブロック解除が可能である。 
 
Linuxの他にも、Windows、MacOS、Android、iOS、Amazon Fire TV用のPrivateVPNソフトウェアが存在する。 
また、個別の無線ルータで動作するように手動で設定することも可能である。 
 
なお、PrivateVPNは2009年にMartin Muller氏によりスウェーデンで設立された。(運営会社: Privat Kommunikation Sverige AB) 
2022年6月にWebホスティング企業であるMiss Groupに買収されており、創業者は離任している。 
 
* PrivateVPNの長所
** セットアップガイドとカスタマーサポートでユーザフレンドリーである。
** ストリーミングとトレント用の高速サーバーが存在する。
** 人気のあるストリーミングプラットフォームの一貫したブロック解除ができる。
** 厳格なノーログポリシーによるオンラインの匿名性。
** 30日間返金保証。
*: 
* PrivateVPNの短所
** サーバのネットワークが小さい。(全部で200程度しかない)
** ライブチャットが24時間利用できない。
 
PrivateVPNの特徴を以下に示す。 
* ノーログポリシー
*: スウェーデンに会社があり、スウェーデンの個人情報保護法では、政府によって押収されるようなトラフィックログを保存することはない。
* 無制限の帯域幅と速度
*: 他のVPNで見られるような、ビデオのバッファリング、低速なダウンロード、ルーティングホップによるタイムアウトは無い。
* 無料リモートヘルプとインストール
*: サービスに関する問題やヘルプが必要な場合、リモートサポートは無料で行うことができる。
* 10台同時接続
*: 最大10台のデバイスを同時に接続できるVPNであり、全て固有のIPアドレスで接続できる。
* ポートフォワード
*: Torrentに不可欠なオープンポートを少なくとも1つ提供している。
* AES-256による2048ビットの暗号化
*: 軍事でも使用されている最高レベルの暗号化技術を使用している。
 
PrivateVPNの料金は、月額2.00ドルからである。(2025年時点、30日間返金保証付き) 
 

== ノーログポリシーの実態 ==
PrivateVPNはノーログVPNを標榜しており、スウェーデンの強力なプライバシー法を根拠として、データログを保存または共有する法的義務がないと主張している。 
 
==== 公式ノーログポリシーの内容 ====
PrivateVPNの公式プライバシーポリシーでは、以下のデータを一切保存しないと明記している。 
 
* ブラウジング履歴およびトラフィック宛先
* 接続タイムスタンプ
* DNSクエリ
* IPアドレス (割り当てIP、接続IP両方)
* データコンテンツ
* 帯域幅使用量
 
収集されるデータは、ログインメールアドレス、パスワード、支払い方法情報等のアカウント管理に必要な最小限の情報のみである。 
 
==== 過去の捜査機関へのデータ提供 ====
2025年時点の公開情報において、PrivateVPNが法執行機関にユーザデータを提供した具体的な事例、裁判記録、またはリークは確認されていない。 
 
PrivateVPNは "ノーログポリシーを採用しているため、有事の場合でも提出できるデータが存在しない" という立場をとっている。 
ただし、この主張は第三者監査によって検証されていないことに注意する必要がある。 
 
==== 第三者監査の状況 ====
PrivateVPNは、独立した外部監査を一度も受けていない。 
これは業界内での重大な弱点と見なされている。 
 
競合他社との比較として、NordVPNはDeloitteによる監査 (2024年)、IPVanishはSchellman Compliance LLCによる監査 (2025年) を受けており、 
ノーログポリシーの検証において、PrivateVPNは遅れをとっている状況である。 
 
==== 管轄法域に関する懸念 ====
PrivateVPNの拠点であるスウェーデンは、14 Eyes監視協定に加盟している。 
14 Eyes構成国間では、情報機関が収集した情報を共有する枠組みが存在する。 
 
ただし、スウェーデンのプライバシー法により、ノーログポリシーを採用しているVPNプロバイダに対するデータ保持義務は課されていない。 
したがって、ノーログポリシーが正しく実装されている場合、14 Eyesの影響は限定的であると考えられる。 
 
==== 運営体制の変遷 ====
<center>
{| class="wikitable"
|+ PrivateVPNの運営体制の変遷
! 時期 !! 出来事
|-
| 2009年 || Martin Muller氏によりスウェーデンで設立 (運営会社: Privat Kommunikation Sverige AB)
|-
| 2022年6月 || Webホスティング企業のMiss Groupが買収。創業者Martin Muller氏は離任
|-
| 現在 || Miss Group傘下で運営。Miss GroupはPerwyn (プライベートエクイティ企業) が支援
|}
</center>
 
==== 専門家の評価 ====
2025年から2026年時点における専門家の評価は以下の通りである。 
 
<center>
{| class="wikitable"
|+ PrivateVPNの専門家評価
! 評価サイト !! スコア !! 備考
|-
| VPNMentor || 9.2/10 (193中7位) || ストリーミング性能、価格を評価
|-
| Trustpilot || 4.9/5 || 高い顧客満足度
|-
| TechRadar || 非推奨 || 投資不足による遅れを指摘
|-
| TheBestVPN || 30中22位 || 非推奨
|}
</center>
 
主な強みとして、価格競争力 (月額 $2.00から)、ストリーミング性能、基本的なプライバシー保護が挙げられる。 
一方、主な弱みとして、第三者監査の欠落、限定されたサーバネットワーク、Linuxアプリの未提供、スプリットトンネリングおよび二重VPN機能の未対応が指摘されている。 
 

== 契約手順 ==
# [https://privatevpn.com/prices/comparitech PrivateVPNの公式Webサイト]にアクセスする。
# 1ヶ月、3ヶ月、3年のいずれかのプランを選択する。
# E-mailアドレスおよびパスワードを入力してログイン、または、PrivateVPNのアカウントを作成する。
# 支払い方法を選択する。 クレジットカード、Paypal、Bitcoinが使用できる。
 

== 依存関係のライブラリのインストール ==
PrivateVPNソフトウェアを実行するために必要な依存関係のライブラリをインストールする。 
 
# RHEL
sudo dnf install python3 curl openvpn NetworkManager-openvpn \
NetworkManager-openvpn-gnome # GNOMEを使用する場合
plasma-nm-openvpn # KDEを使用する場合

# SUSE
sudo zypper install python3 curl openvpn NetworkManager-openvpn \
NetworkManager-openvpn-gnome # GNOMEを使用する場合
plasma-nm5-openvpn # KDEを使用する場合
 

== ネットワークマネージャトンネルを使用する場合 (推奨) ==
まず、以下に示す2つのファイルをダウンロードする。 
* 証明書ファイル
*: http://privatevpn.com/client/ca.crt
* 鍵ファイル
*: http://privatevpn.com/client/ta.key
 
* GNOMEの場合
# GNOMEのホーム画面右上にある[ネットワーク]アイコンをクリックして、[設定]アイコンを選択する。
# [設定]画面が開くので、画面左にある[ネットワーク] - 画面右の[VPN]項目の右にある[＋]ボタンを押下する。
# [VPNの追加]画面が開くので、[OpenVPN]を選択して、[Create]ボタンを押下する。
# 以下に示す情報を入力する。 もし、Linuxの起動時にVPNを自動的に接続する場合は、[自動的に接続する]を選択する。
#* 接続名
#*: PrivateVPN
#* ゲートウェイ
#*: 接続先サーバが存在する国のアドレスを入力する。
#*: スウェーデンの場合 : se-sto.privatevpn.host
#*: サーバリストの詳細は、https://privatevpn.com/serverlist を参照すること。
#* タイプ
#*: [パスワード]を選択する。
#* ユーザ名
#*: PrivateVPNアカウントのメールアドレスを入力する。
#* パスワード
#*: PrivateVPNアカウントのパスワードを入力する。
#* CA証明書
#*: 上記でダウンロードした証明書ファイル(ca.crtファイル)を選択する。
# [Advanced]ボタンを押下して、[OpenVPN Advanced Options]画面を開く。
#* [General]タブを選択する。
#*: [LZOデータ圧縮を使用する]チェックボックスにチェックを入力する。
#*: [仮想デバイスの種類を設定]チェックボックスにチェックを入力して、[TUN]を選択する。
#*: [IPv6 tun link]チェックボックスにチェックを入力する。
#* [セキュリティタブ]を選択する。
#*: [暗号]プルダウンから[AES-256-CBC]を選択する。
#*: [HMAC認証]プルダウンから[SHA-256]を選択する。
#* [TLS認証]タブを選択する。
#*: [相手（サーバ）の証明書使用状況の署名を確認する]チェックボックスにチェックを入力して、プルダウンから[サーバ]を選択する。
#*: [追加のTLS認証を使用する]チェックボックスにチェックを入力する。
#*: [キーファイル]を、上記でダウンロードした鍵ファイル(ta.keyファイル)を選択する。
#*: [Key Direction]プルダウンから[1]を選択する。
# GNOMEのホーム画面右上にある[ネットワーク]アイコンをクリックして、[VPN接続] - [PrivateVPN]を選択する。
 
* KDEの場合
# [KDEシステム設定]を起動して、[接続]を選択する。
# [接続]画面が開くので、画面左下(接続先リストの下)にある[+]を押下する。
# [接続タイプの選択]画面が開くので、リストから[OpenVPN]を選択して[作成]ボタンを押下する。
# [新しい接続]画面が開くので、以下に示す情報を入力する。
#* [接続名]
#*: 任意でよい。
#*: 例. PrivateVPN
#* [ゲートウェイ]
#*: 接続先サーバが存在する国のアドレスを入力する。
#*: サーバリストの詳細は、https://privatevpn.com/serverlist を参照すること。
#*: 例. スウェーデンの場合 : se-sto.privatevpn.host
#* [接続タイプ]
#*: パスワードを選択する。
#* [CA証明書]
#*: 上記でダウンロードした証明書ファイル(ca.crtファイル)を選択する。
#* [ユーザ名]
#*: PrivateVPNアカウントのメールアドレスを入力する。
#* [パスワード]
#*: PrivateVPNアカウントのパスワードを入力する。
# [Advanced]ボタンを押下して、[OpenVPN Advanced Options]画面を開く。
#* [General]タブを選択する。
#*: [Use Compression]チェックボックスにチェックを入力して、プルダウンから[LZO]を選択する。
#*: [Set virtual device type:]チェックボックスにチェックを入力して、プルダウンから[TUN]を選択する。
#*: [IPv6 tun link]チェックボックスにチェックを入力する。
#* [Security]タブを選択する。
#*: [Cipher:]プルダウンから[AES-256-CBC]を選択する。
#*: [HMAC Authentication:]プルダウンから[SHA-256]を選択する。
#* [TLS Settings]タブを選択する。
#*: [Verify peer（server） certificate usage signature]チェックボックスにチェックを入力して、プルダウンから[Server]を選択する。
#*: [Mode:]プルダウンから[TLS-Auth]を選択する。
#*: [Key File:]を、上記でダウンロードした鍵ファイル(ta.keyファイル)を選択する。
#*: [Key Direction:]プルダウンから[Client(1)]を選択する。
# [OK]ボタンを押下して、[OpenVPN Advanced Options]画面を閉じる。
# [接続]画面右にある[IPv6]タブを選択して、[この接続には IPv6 が必要]チェックボックスのチェックを外す。(この設定は不要の可能性あり)
# [接続画面]右下にある[適用]ボタンを押下する。
# タスクバーにあるネットワークアイコンをクリックすると、PrivateVPNのOpenVPNが表示されるので、[接続]ボタンを押下する。
 

== PrivateVPN CLIを使用する場合 ==
# [https://privatevpn.com/client/install.sh PrivateVPNの公式Webサイト]から、CLIソフトウェアのインストーラをダウンロードする。 または、<code>wget</code>コマンド等を使用してダウンロードする。
#: <code>wget https://privatevpn.com/client/install.sh</code>
# ダウンロードしたインストーラに実行権限を付加する。
#: <code>chmod u+x install.sh</code>
# スーパーユーザ権限でインストーラを実行する。 スーパーユーザ権限で実行する理由は、OpenVPNの接続時において、トンネルインターフェイスを作成するためである。
#: <code>sudo ./install.sh</code>
# /etc/openvpn/privatvpn.confファイルを編集して、接続先のVPNサーバを変更することができる。 サーバリストの詳細は、https://privatevpn.com/serverlist を参照すること。
 

== WireGuardの使用 ==
# WireGuardの接続に必要なツールをインストールする。
#: <code>sudo zypper install wireguard-tools</code>
#: 
# [https://privatevpn.com/account/login PrivateVPNの公式Webサイト]にアクセスして、ログインする。
# [https://privatevpn.com/control-panel PrivateVPNのコントロールパネル]にアクセスする。
# コントロールパネル画面左にある[WireGuard Config]から、使用するVPNサーバを選択するため、[Generate Config]ボタンを押下する。
# コントロールパネルにWireGuardの設定が生成および表示されるので、ダウンロードアイコンを押下する。
#: 
# WireGuardを使用してVPNネットワークに接続する。
#: <code>sudo wg-quick up <WireGuardの設定ファイルのパス></code>
#: 
# 正常にVPNネットワークに接続しているかどうかを確認する。
#: <code>sudo wg show</code>
#: 
# VPNネットワークを切断する。
#: <code>sudo wg-quick down <WireGuardの設定ファイルのパス></code>
 

== DNSリーク ==
IPv6を使用する場合、DNSリークを起こす可能性がある。 
この時、IPv6を無効にすることにより、DNSリークを起こさないようにすることができる。 
 
ただし、WebブラウザがChromium系ブラウザ(Vivaldiも含む)の場合、以下の設定を行ってもDNSリークが起きることに注意すること。 
 
IPv6を無効にする手順を、以下に示す。 
# IPv6を無効にするため、/etc/sysctl.confファイルに以下に示す設定を追記する。
#: <code>sudo vi /etc/sysctl.d/00-ipv6.conf</code>
#: 
#: <code># /etc/sysctl.d/00-ipv6.confファイル</code>
#: 
#: <code>net.ipv6.conf.all.disable_ipv6 = 1</code>
#: <code>net.ipv6.conf.default.disable_ipv6 = 1</code>
#: <code>net.ipv6.conf.lo.disable_ipv6 = 1</code>
#: 
# 上記の設定を反映する。
#: <code>sudo sysctl -p</code>
#: 
# IPv6が正常に無効化されたかどうかを確認する。 <code>1</code>と表示される場合、IPv6は正常に無効化されている。
#: <code>cat /proc/sys/net/ipv6/conf/all/disable_ipv6</code>
#: 
# 以下に示すURLにアクセスして、IPv6が無効化されているかどうかを確認する。
#: https://www.whatismyip.com/
#: 
# 次に、Webブラウザのクッキーおよびキャッシュを削除する。
# 最後に、以下に示すURLにアクセスして、DNSリークを確認する。
#: https://www.dnsleaktest.com/
 
<code>sysctl</code>は、以下に示す場所から設定を読み込む。 
初期設定を無効化または上書きする場合は、/etc/sysctl.dディレクトリに同名のファイルを作成して配置する。 
* /boot/sysctl.conf-<kernelversion>
* /lib/sysctl.d/*.conf
* /usr/lib/sysctl.d/*.conf
* /usr/local/lib/sysctl.d/*.conf
* /etc/sysctl.d/*.conf
* /run/sysctl.d/*.conf
* /etc/sysctl.conf
 

== Torブラウザのプロキシ設定 ==
==== SOCKS5プロキシを使用する場合 ====
# Torブラウザを起動して、[Tor Network Settings]ボタンを押下する。
# [設定]画面の[Advanced]項目から、プロキシの設定を行う。
#* [I use a proxy to connect to the Internet]チェックボックス
#*: チェックを入力する。
#* [Proxy Type]プルダウン
#*: SOCKS 5
#* [Address]
#*: [https://privatevpn.com/serverlist PrivateVPNのサーバリスト]から、任意のプロキシサーバのアドレスを入力する。
#*: 例. se-sto.pvdata.host
#* [Port]
#*: 1080
#* [Username]
#*: ユーザ名は、[https://privatevpn.com/account/login PrivateVPNの公式Webサイト]にログインして、[https://privatevpn.com/control-panel コントロールパネル]に進むと表示される。
#* [Password]
#*: パスワードは、[https://privatevpn.com/account/login PrivateVPNの公式Webサイト]にログインして、[https://privatevpn.com/control-panel コントロールパネル]に進むと表示される。
# Torブラウザにある[Connect]ボタンを押下して、Torネットワークに接続する。
 
==== HTTP / HTTPSプロキシを使用する場合 ====
# Torブラウザを起動して、[Tor Network Settings]ボタンを押下する。
# [設定]画面の[Advanced]項目から、プロキシの設定を行う。
#* [I use a proxy to connect to the Internet]チェックボックス
#*: チェックを入力する。
#* [Proxy Type]プルダウン
#*: HTTP / HTTPS
#* [Address]
#*: [https://privatevpn.com/serverlist PrivateVPNのサーバリスト]から、任意のプロキシサーバのアドレスを入力する。
#*: 例. se-sto.pvdata.host
#* [Port]
#*: 8080
#* [Username]
#*: ユーザ名は、[https://privatevpn.com/account/login PrivateVPNの公式Webサイト]にログインして、[https://privatevpn.com/control-panel コントロールパネル]に進むと表示される。
#* [Password]
#*: パスワードは、[https://privatevpn.com/account/login PrivateVPNの公式Webサイト]にログインして、[https://privatevpn.com/control-panel コントロールパネル]に進むと表示される。
# Torブラウザにある[Connect]ボタンを押下して、Torネットワークに接続する。
 

== VPN over Tor ==
VPNサーバへの接続にTorネットワークを使用することができる。 
これを、VPN over Tor、あるいは、VPN through Torと呼ぶ。 
 
Torネットワークがブリッジとして機能するため、自宅のIPをPrivateVPNに公開することなく、PrivateVPNに接続することを意味する。 
したがって、プライバシー、セキュリティ、匿名性への2重層を提供する。 
 
# [https://www.torproject.org/download/ Torブラウザの公式Webサイト]にアクセスして、Torブラウザをダウンロードおよびインストールする。
# Torブラウザを起動して、Torネットワークに接続する。
# Torブラウザで任意のWebサイトを開いて、Torブラウザのアドレスバーの左側にある鍵アイコンを選択する。
# "ガードノード(エントリーノード)"、"中間"、"出口ノード"を含むTorネットワークの現在の回線情報が表示される。 この時、ガードノード(エントリーノード)のIPアドレスをコピーする。 最初のノードは、ガードノード(エントリーノード)と呼ばれており、これは頻繁に変更されない。 ただし、暫く時間が経って変更された場合、または、Torブラウザをアップデートした場合は、ガードノード(エントリーノード)のIPアドレスが変更されるため、 都度、OpenVPN設定ファイル内の値を変更する必要がある。
# [https://privatevpn.com/client/PrivateVPN-TUN.zip PrivateVPNの公式Webサイト]にアクセスして、PrivateVPNのOpenVPN設定ファイルをダウンロードする。 ダウンロードしたファイルを解凍する。 TorブラウザはTCPプロトコル(443番ポート)のみで動作するため、TCPディレクトリからPrivatVPN-<国名>-<都市名>-TUN-443.ovpnを使用する必要がある。
#: 
# 使用するOpenVPN設定ファイルを開いて、以下に示す内容を追記する。
#: <syntaxhighlight lang="text">
# Windowsの場合
# tor options
socks-proxy 127.0.0.1 9150
route <TorブラウザのガードノードのIPアドレス> 255.255.255.255 net_gateway
</syntaxhighlight>
#: 
#: <syntaxhighlight lang="text">
# Linuxの場合
# tor options
socks-proxy 127.0.0.1 9150
route <TorブラウザのガードノードのIPアドレス> 255.255.255.255 <自宅のデフォルトゲートウェイのIPアドレス>
</syntaxhighlight>
#: 
# Torネットワーク経由でPrivateVPNのOpenVPNサーバに接続する。 上記で編集したOpenVPN設定ファイルをOpenVPNクライアントにインポートして接続する。 Torブラウザが起動していることを確認して、問題なく動作しているかどうかを確認する。
 

== Tor over VPN ==
VPNネットワーク経由でTorに接続する方法であり、Torは終了ノードになる。(Tor over VPN) 
 
# PrivateVPN CLIまたはNetworkManager等を使用して、VPNに接続する。
# [https://www.torproject.org/download/ Torブラウザの公式Webサイト]にアクセスして、Torブラウザをダウンロードおよびインストールする。
# Torブラウザを起動して、[Connect]ボタンを押下する。 Torブラウザの設定はデフォルトのままでよい。
 

== Torrentとの連携 ==
# まず、PrivateVPNサーバに接続する。 この時、[Port forwarding]項目に記載されているポート番号をコピーする。
# 次に、qBittorrentを起動して、[設定] - 画面左の[接続] - [受信接続に使用するポート]において、上記でコピーしたポート番号を入力する。
# 最後に、[ツール] - [設定] - [設定]画面左ペインにある[高度]を選択する。 [設定]画面右ペインにある[ネットワークインターフェイス]を、使用しているソフトウェアとプロトコルに応じて、次のいずれかに変更する。
#* PrivateVPNソフトウェアからOpenVPNで接続している場合
#*: tun0
#* NetworkManagerからOpenVPNで接続している場合
#*: tun0
#* PrivateVPNソフトウェアからWireGuardで接続している場合
#*: 
# [OK]ボタンを押下する。
# [ファイル] - [終了]を選択して、qBittorrentを再起動する。
 
qBittorrentの推奨設定を、以下に示す。 
# qBittorrentを起動して、[ツール］ - [設定]を選択する。
# [設定]画面左ペインにある[BitTorrent]を選択する。
# [設定]画面右ペインにある[匿名モードを有効にする]を選択する。
# [DHT(分散ネットワーク)を有効にする]チェックボックスのチェックを外す。
# [ピア交換(PeX)を有効にする]チェックボックスのチェックを外す。
# [ローカルピア検出(LSD)を有効にする]チェックボックスのチェックを外す。
# [設定]画面左ペインにある[接続]を選択して、[ピア接続プロトコル]プルダウンから[TCP]を選択する。
 

== VPNのログ ==
VPN接続に問題がある場合は、接続ログを送信することにより、問題を迅速に特定して、適切な解決策を得られる場合がある。 
 
==== Network Manager ====
# VPN接続のログを表示して、生成されたログをコピーする。
#: <code>sudo grep VPN /var/log/syslog</code>
#: または
#: <code>sudo grep VPN /var/log/syslog > <任意のログファイルのパス></code>
#: 
# [https://privatevpn.com/chat PrivateVPNの公式Webサイトにあるチャット]にアクセスして、チャットボックスから[Send us a message]ボタンを押下する。
# 上記で取得したVPN接続のログをチャットに貼り付けて、ユーザのEメールアドレスを入力する。
# [send]ボタンを押下する。
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:PinePhone]][[カテゴリ:Windows7]][[カテゴリ:Windows10]][[カテゴリ:Windows11]]

VPN - Mullvad

2026-03-24T15:10:56Z

Wiki:

== 概要 ==
Mullvadは、AirVPNと同様に、プライバシーと技術に非常に強い焦点を当てている、スウェーデンに拠点を置くログなしのVPNサービスである。 
プライバシーと技術に非常に強い関心を寄せており、他のプラットフォームのユーザが利用できる完全なオープンソースのGUI Linux VPNクライアントを提供している。 
(14日間の返金保証も付いている) 
 
これらの機能には、完全なDNS保護(IPv6サポート付き)、キルスイッチ、ポートフォワーディングが含まれる。 
Torを介したVPNは、手動設定によりサポートされている。
 
DEB形式とRPM形式のインストールファイルは、Mullvadの公式Webサイトからダウンロードできる。 
また、ビルド手順を含むソースコードは、[https://github.com/mullvad/mullvadvpn-app MullvadのGitHub]から入手可能である。 
 
Windows、MacOS、Linux、Android、iOSに対応しており、最大5台のデバイスを同時に接続することができる。 
 
Mullvadは、以下に示す特徴がある。 
 
<center>
{| class="wikitable"
|+ Mullvad VPNの主な特徴
|-
! 特徴 !! 説明
|-
| 匿名アカウント || 個人情報 (Eメールさえも) を求めず、現金や暗号通貨による匿名での支払いを推奨している。
|-
| ノーログ || ユーザのプライバシーを守るために、Mullvadはユーザの行動を記録しない。 Mullvadの長期的な目標は、支払いの詳細も保存しないことである。
|-
| 外部監査 || Mullvadは、透明性を提供し、セキュリティの慣行を改善するために、 Mullvadのソフトウェアとインフラストラクチャの独立した監査を要求する。
|-
| 安全な司法権 || スウェーデンに拠点を置くVPNプロバイダとして、 Mullvadに関連する法律は、Mullvadの場所とユーザのプライバシーにとって安全な場所となっている。
|-
| 内蔵キルスイッチ || Mullvadがオンの状態で接続に問題が発生した場合、 内蔵のキルスイッチが自動的に全てのネットワークトラフィックを停止する。
|-
| 有料レビューは存在しない || Mullvadは、有料レビューやアフィリエイトを排除している。
|-
| 自社サポートチーム || Mullvadは、ユーザの問題を外部に委託することはない。 専任のサポートチームが開発者とともに回答する。
|-
| アーリーアダプタ || VPNサービスの標準とされている多くの技術やセキュリティ機能を、常に先駆けて導入している。
|-
| 簡単設定 || 初めて使用するユーザでも安心して使用できるように、ソフトウェアの設定は簡単である。
|}
</center>
 
デメリットとしては、以下のことが挙げられる。 
* サーバの種類が少ない。
* 無料トライアルが非常に限定的である。
* 競合他社に比べ少し高価である。
 

== Mullvadのノーログポリシーと信頼性 ==
==== ノーログポリシーの技術的実装 ====
Mullvadは、ユーザのプライバシーを保護するために、以下に示す技術的な仕組みを採用している。 
 
* RAMオンリーサーバー
*: 2024年9月に全サーバーで完全移行した。
*: 揮発性メモリのみで動作し、電源オフでデータが消滅する。
*: ディスクにデータが残らない仕組みである。
* 匿名アカウント制
*: 16桁のランダムなアカウント番号のみで利用できる。
*: メールアドレス、名前、パスワードは一切不要である。
* 匿名支払い対応
*: 現金 (10通貨対応)、Monero、Bitcoin、Bitcoin Cash等による匿名支払いが可能である。
*: 暗号通貨での支払いは10%割引が適用される。
* オープンソース
*: VPNクライアントソフトウェアはGPLv3ライセンスで全コードが公開されている (GitHub)。
*: バックドアやセキュリティ脆弱性がないことを誰でも検証できる。
* ワラント・カナリー
*: 定期的に更新されるページで、秘密の捜査令状が存在しないことを示唆する仕組みを採用している。
 
==== 第三者セキュリティ監査 ====
Mullvadは、透明性の確保とセキュリティの改善のために、定期的に第三者機関による独立した監査を受けている。 
 
<center>
{| class="wikitable"
|+ Mullvad セキュリティ監査実績
! 年月 !! 監査機関 !! 対象 !! 結果
|-
| 2020年 || Cure53 || インフラ || 問題なし
|-
| 2023年 || Cure53 || インフラ || 問題なし
|-
| 2024年6月 || Cure53 || インフラ (4回目) || ユーザの匿名性を損なう問題なし
|-
| 2024年10月-11月 || X41 D-Sec || 全プラットフォーム || 脆弱性6件 (重大なし)。良好なセキュリティレベルと評価
|-
| 2025年3月 || NCC Group || Androidアプリ || 修正不要で全基準クリア
|-
| 2025年8月 || Assured Security || Webアプリ || 重大・高度・中度の脆弱性なし。ノーログ再確認
|}
</center>
 
全ての監査報告書は、Mullvad公式Webサイトで公開されている。 
 
==== 捜査機関への対応事例 ====
Mullvadのノーログポリシーは、実際の捜査機関との対応においても有効性が確認されている。 
 
* 2023年4月18日の家宅捜索
*: ドイツの恐喝事件に関連した国際司法共助要請を受けたスウェーデン警察国家作戦部門 (NOA) が、6名以上でゴーテンボルグのMullvadオフィスを家宅捜索した。
*: 目的は、顧客データを含むコンピュータの押収であった。
*: 結果として、警察は何も押収できなかった。
*: Mullvadがノーログの仕組みを実地で説明し、検事と協議の上、捜査官は手ぶらで帰った。
*: Mullvadの弁護士は、"見つかると期待する理由がないものを押収することはスウェーデン法に違反する" と主張した。
*: これは、創業14年間で初めての捜査令状であった。
* ユーザデータ提供実績
*: 2024年〜2026年を含む全期間を通じて、ユーザデータの捜査機関への提出事例はゼロである。
* Mullvadの公式方針
*: 政府がユーザを秘密裏に監視するよう強制することに成功した場合、その司法管轄区域でのサービス停止を宣言している。
 
==== 最新動向 (2024年〜2026年) ====
* OpenVPN廃止
*: 2026年1月15日にOpenVPNサポートを完全廃止した。
*: 全ユーザをWireGuardに統一した。廃止時点で利用者の93%以上が既にWireGuardを使用していた。
* DAITA (Defense Against AI-guided Traffic Analysis)
*: AIによるトラフィック分析に対抗する防御機能である。
*: パケットサイズの統一、ダミートラフィックの挿入、トラフィックパターンの歪曲を行う。
*: 2025年3月にv2をリリースした。Windows、Linux、macOS、iOS、Androidに対応している。
* Mullvad Browser
*: Tor Projectとの共同開発ブラウザである。
*: Tor Browserのプライバシー強化技術を搭載しつつ、Tor Networkは使用しない。
*: VPN契約不要で無料利用可能であり、オープンソースである。
 
==== 留意点 ====
* スウェーデン会計法により、決済記録は会計年度終了から7年間の保持が義務付けられている。これはVPN活動ログではなく、あくまで会計上の記録である。
* 従来型の定期的な透明性レポートは未発行である。重大事件のみ公式ブログで公開されている。
 

== Mullvadの契約 ==
Mullvadの契約手順を以下に記載する。 
 
# [https://mullvad.net/ja/ Mullvadの公式Webサイト]へアクセスして、ページ右上にある[使用開始]を選択する。
# [Mullvadの使用開始手順]ページが開くので、アカウント番号を生成および取得する。 アカウント番号は、ユーザが大切に保管すること。
# クレジットカード、PayPal、ビットコイン等のいずれかを選択して、金額を支払う。
# [https://mullvad.net/ja/download/linux/ Mullvadの公式Webサイト]にアクセスして、Mullvadソフトウェアをダウンロードする。 Mullvadソフトウェアは、Windows、macOS、Linux、Android、iOSに対応している。
 
Mullvadでは、1ヶ月5ユーロの料金である。(2026年3月現在) 
 

== Mullvad GUIのインストール ==
==== Mullvad GUIの概要 ====
Systemdを搭載したLinux (x64) ディストリビューションの多くで動作する。 
ただし、Linuxカーネル 4.19以降が必要となる。 
 
==== GPGキーの署名 (RPMファイルから直接インストールする場合) ====
署名キーをダウンロードする。 
Mullvadの署名キーのフィンガープリントは、<code>A1198702FC3E0A09A9AE5B75D5A1D4F266DE8DDF</code>であり、 
これは、キーサーバまたはMullvadの公式webサイトから直接ダウンロードすることができる。 
wget https://mullvad.net/media/mullvad-code-signing.asc
gpg --import mullvad-code-signing.asc
 
署名鍵の信頼設定
署名キーをダウンロードしたら、信頼レベルを<code>ultimate</code>に設定して、署名キーにより署名された全ての鍵を自動的に検証できるようにする必要がある。 
この設定は省略可能であるが、省略する場合は、各ファイルの検証時にその鍵が信頼できる署名で認証されていないことを示す警告が表示される。 
 
GnuPGを実行して、鍵の編集を行う。 
gpg --edit-key A1198702FC3E0A09A9AE5B75D5A1D4F266DE8DDF

# 出力例
gpg (GnuPG) 2.1.13; Copyright (C) 2016 Free Software Foundation, Inc.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

pub rsa4096/D5A1D4F266DE8DDF
created: 2016-10-27 expires: never usage: SC
trust: unknown validity: unknown
sub rsa4096/C187D22C089EF64E
created: 2016-10-27 expires: never usage: E
sub rsa4096/A26581F219C8314C
created: 2016-10-27 expires: never usage: S
[ unknown] (1). Mullvad (code signing) <admin@mullvad.net>
 
鍵の信頼設定を入力する。 
gpg> trust

# 出力例
pub rsa4096/D5A1D4F266DE8DDF
created: 2016-10-27 expires: never usage: SC
trust: unknown validity: unknown
sub rsa4096/C187D22C089EF64E
created: 2016-10-27 expires: never usage: E
sub rsa4096/A26581F219C8314C
created: 2016-10-27 expires: never usage: S
[ unknown] (1). Mullvad (code signing) <admin@mullvad.net>

Please decide how far you trust this user to correctly verify other users' keys
(by looking at passports, checking fingerprints from different sources, etc.)

1 = I don't know or won't say
2 = I do NOT trust
3 = I trust marginally
4 = I trust fully
5 = I trust ultimately
m = back to the main menu
 
信頼レベルを<code>Ultimate</code>に設定する。 
Your decision? 5
Do you really want to set this key to ultimate trust? (y/N) y

# 出力例
pub rsa4096/D5A1D4F266DE8DDF created: 2016-10-27 expires: never usage: SC
trust: ultimate validity: unknown
sub rsa4096/C187D22C089EF64E
created: 2016-10-27 expires: never usage: E
sub rsa4096/A26581F219C8314C
created: 2016-10-27 expires: never usage: S
[ unknown] (1). Mullvad (code signing) <admin@mullvad.net>
Please note that the shown key validity is not necessarily correct
unless you restart the program.
 
GnuPGを終了する。 
gpg> q
 
==== Mullvadソフトウェアのインストール ====
===== RPMファイルから直接インストールする場合 =====
[https://mullvad.net/ja/download/linux/ Mullvadの公式Webサイト]から、Mullvad GUIをダウンロードする。 
ダウンロードしたファイルをインストールする。 
sudo zypper install ./MullvadVPN-<バージョン>_x86_64.rpm
 
===== RPMファイルを展開して手動でインストールする場合 (SUSE推奨) =====
[https://mullvad.net/ja/download/linux/ Mullvadの公式Webサイト]から、Mullvad GUIをダウンロードする。
ダウンロードしたRPMファイルを展開する。
rpm2cpio MullvadVPN-<バージョン>_x86_64.rpm | cpio -id
 
展開したディレクトリを任意のインストールディレクトリに配置する。 
mv MullvadVPN-<バージョン>_x86_64 Mullvad_VPN
mv Mullvad_VPN <Mullvadソフトウェアのインストールディレクトリ>
 
Mullvadソフトウェアのmullvad-problem-report実行ファイルのシンボリックリンクを変更する。 
cd <Mullvadソフトウェアのインストールディレクトリ>
ln -sf /<Mullvadソフトウェアのインストールディレクトリ>/opt/'Mullvad VPN'/resources/mullvad-problem-report \
/<Mullvadソフトウェアのインストールディレクトリ>/usr/bin/mullvad-problem-report
 
Mullvadソフトウェアのデーモンファイルを作成する。 
sudo vi /etc/systemd/system/mullvad-daemon.service
 
<syntaxhighlight lang="ini">
# /etc/systemd/system/mullvad-daemon.serviceファイル

# Systemd service unit file for the Mullvad VPN daemon
# testing if new changes are added

[Unit]
Description=Mullvad VPN daemon
Before=network-online.target
After=mullvad-early-boot-blocking.service NetworkManager.service systemd-resolved.service

StartLimitBurst=5
StartLimitIntervalSec=20
RequiresMountsFor=/<Mullvadソフトウェアのインストールディレクトリ>/opt/Mullvad\x20VPN/resources/

[Service]
Restart=always
RestartSec=1
ExecStart=/<Mullvadソフトウェアのインストールディレクトリ>/usr/bin/mullvad-daemon -v --disable-stdout-timestamps
Environment="MULLVAD_RESOURCE_DIR=/<Mullvadソフトウェアのインストールディレクトリ>/opt/Mullvad VPN/resources/"

[Install]
WantedBy=multi-user.target
</syntaxhighlight>
 
sudo vi /etc/systemd/system/mullvad-early-boot-blocking.service
 
<syntaxhighlight lang="ini">
# /etc/systemd/system/mullvad-early-boot-blocking.serviceファイル

# Systemd service unit file to block all traffic during early boot.
# This is required since almost no distributions use a `network-pre.target`,
# which implies it's difficult to ensure that the daemon will start and block
# traffic before any network configuration will be applied.
#
[Unit]
Description=Mullvad early boot network blocker
DefaultDependencies=no
Before=basic.target mullvad-daemon.service

[Service]
Type=oneshot
ExecStart=/<Mullvadソフトウェアのインストールディレクトリ>/usr/bin/mullvad-daemon --initialize-early-boot-firewall

[Install]
WantedBy=mullvad-daemon.service
</syntaxhighlight>
 
デーモンファイルを再読み込みする。 
sudo systemctl daemon-reload
 
Mullvadソフトウェアのデスクトップエントリファイルを作成する。 
vi ~/.local/share/applications/Mullvad_VPN.desktop
 
<syntaxhighlight lang="ini">
# ~/.local/share/applications/Mullvad_VPN.desktopファイル

[Desktop Entry]
Type=Application
Name=Mullvad VPN
Comment=Mullvad VPN client
Exec="/<Mullvadソフトウェアのインストールディレクトリ>/opt/Mullvad VPN/mullvad-vpn" %U
Icon=/<Mullvadソフトウェアのインストールディレクトリ>/usr/share/icons/hicolor/128x128/apps/mullvad-vpn.png
Categories=Network;
Keywords=internet;security;vpn;
Terminal=false
StartupWMClass=Mullvad VPN
</syntaxhighlight>
 
~/.profileファイル等に、環境変数<code>PATH</code>を追記する。 
vi ~/.profile
 
<syntaxhighlight lang="sh">
# ~/.profileファイル

export PATH="/<Mullvadソフトウェアのインストールディレクトリ>/usr/bin:$PATH"
</syntaxhighlight>
 
Mullvadソフトウェアが正常に起動するかどうかを確認する。 
まず、Mullvadソフトウェアのデーモンを起動する。 
sudo systemctl start mullvad-daemon.service
 
最後に、Mullvadソフトウェアを起動して、任意のMullvadのVPNサーバに接続する。 
 
==== Mullvadソフトウェアのアンインストール ====
===== RPMファイルから直接インストールしている場合 =====
Mullvad GUIをアンインストールする。 
sudo zypper remove mullvad-vpn
 
===== RPMファイルを展開して手動でインストールしている場合 =====
Mullvadソフトウェアおよび設定ファイル等を削除する。 
sudo rm -r /etc/mullvad-vpn /etc/resolv.conf.mullvadbackup /etc/systemd/system/mullvad-daemon.service \
/<Mullvadソフトウェアのインストールディレクトリ> \
~/.local/share/applications/Mullvad_VPN.deskop
 
==== mullvad-daemonが起動しない場合 ====
まず、mullvad-daemonを起動する。 
sudo systemctl start mullvad-daemon
 
mullvad-daemonが起動しない場合、mullvad-daemonファイルに<code>-v</code>オプションを付加して実行する。 
sudo /opt/'Mullvad VPN'/resources/mullvad-daemon -v
 
==== mullvad-daemon.serviceが見つからない場合 ====
これは、/optディレクトリを独自のパーティションにインストールした場合に発生する可能性がある。 
この場合、/opt/Mullvad VPN/resources/mullvad-daemon.serviceファイルを、/etc/systemd/systemディレクトリにコピーする。 
 
# シンボリックリンクを削除する
sudo rm /etc/systemd/systemmullvad-daemon.service

# mullvad-daemon.serviceファイルをコピーする
sudo cp /opt/'Mullvad VPN'/resources/mullvad-daemon.service /etc/systemd/system
 

== Mullvadの使用手順 : NetworkManagerを使用する場合 ==
※注意 
Mullvadは2026年1月15日にOpenVPNサポートを廃止して、WireGuardに完全移行した。 
 
以下に示す手順は、OpenVPN廃止以前の情報であり、現在はMullvadソフトウェアからWireGuardで接続することを推奨する。 
 
Mullvad(OpenVPN)を設定するには、以下の手順に従う。 
 
* GNOME / KDE 共通
# [https://mullvad.net/account/#/openvpn-config/?platform=android Mullvadの公式Webサイト]にアクセスして、ログインする。 ※注意 プラットフォームは、"Android"を選択する必要があることに注意する。
# [OpenVPN 設定ファイルジェネレーター]ページが開くので、プラットフォーム、使用するサーバがある国名および都市名、ポートを選択する。
# [zipアーカイブをダウンロード]を選択して、OpenVPNファイルをダウンロードする。
# ダウンロードしたファイルを解凍する。
#: <pre>unzip config.zip</pre>
# OpenVPNの設定ファイルは、以下に示すファイルを含む。 接続先の国を変更する場合、再度、アカウントページで使用する場所を設定して、新しいOpenVPNの設定ファイルをダウンロードする必要がある。
#* mullvad_<接続先コード名>.ovpn
 
* GNOMEの場合
# OpenVPNの設定ファイルをインポートして使用するために必要な依存関係のライブラリをインストールする。
#: <pre>sudo zypper install openvpn NetworkManager-openvpn NetworkManager-openvpn-gnome</pre>
# GNOMEのホーム画面右上にある[ネットワーク]アイコンをクリックして、[設定]アイコンを選択する。
# [設定]画面が開くので、画面左にある[ネットワーク] - 画面右の[VPN]項目の右にある[＋]ボタンを押下する。
# [VPNの追加]画面が開くので、[ファイルからインポート...]を選択する。
# 上記で解凍したOpenVPN設定ファイルを選択して、画面右上にある[開く]ボタンを押下する。 ここで、OpenVPNファイルの命名形式は、国-場所-サーバアドレスである。 例. UnitedStates.ovpn
# 選択したOpenVPN設定ファイルが未保存のセッションとしてNetworkManagerにインポートされるので、[VPNの追加]画面から以下に示す項目を入力および設定する。
#* [Gateway]
#*: サーバのアドレスを確認する。
#*: 例. <接続先コード名>.mullvad.net
#* [ユーザ名]
#*: Mullvadアカウント番号を（スペースなしで）入力する。
#* [パスワード]
#*: <code>m</code>　と入力する。
#*: ［このユーザにのみパスワードを保存する(暗号化済み）]を選択する。
#* [CA証明書]
#*: <code>ca.crt</code>　とラベル付けされていることを確認する。
#* [ユーザ証明書]
#*: <code>client.crt</code>　とラベル付けされていることを確認する。
# [VPNの追加]画面右上にある[追加]ボタンを押下する。
# 上記で追加したMullvadのOpenVPN設定が作成されて、MullvadのOpenVPNセッションが[VPN]項目の選択エリアにリストされていることを確認する。 これは、[VPN]項目の選択エリアにあるスライダースイッチを押下することにより、接続および切断を切り替えることができる。 また、GNOMEのホーム画面右上にある[ネットワーク]アイコンをクリックして、VPNの接続および切断を切り替えることができる。
# IPアドレスが匿名かつプライベートなMullvadに変更されたことを確認する場合は、http://www.iplocation.net/ にアクセスする。 IPロケーションオンラインサービスにアクセスする前に、Webブラウザのキャッシュとクッキーを削除することを推奨する。
 
* KDEの場合
# OpenVPNの設定ファイルをインポートして使用するために必要な依存関係のライブラリをインストールする。
#: <pre>sudo zypper install openvpn NetworkManager-openvpn plasma-nm5-openvpn</pre>
# [KDEシステム設定]を起動して、[接続]を選択する。
# [接続]画面が開くので、画面左下(接続先リストの下)にある[+]を押下する。
# [接続タイプの選択]画面が開くので、リストの最下行にある[VPN接続をインポート...]オプションを選択して[作成]ボタンを押下する。
# [VPN接続をインポート]画面が開くので、解凍したディレクトリ内にあるOpenVPNファイル(VPNサーバ)を選択する。 例. mullvad_<接続先コード名>.ovpn
# 証明書をコピーするよう求められたら、[はい]ボタンを押下する。
# [接続]画面左にMullvadのVPN接続が表示されるので、MullvadのVPN接続を選択する。
# [接続]画面右にある[VPN(openvpn)]タブを選択して、以下に示す項目を入力および設定する。
#* [Gateway]
#*: サーバのアドレスを確認する。
#*: 例. <接続先コード名>.mullvad.net
#* [ユーザ名]
#*: Mullvadアカウント番号を（スペースなしで）入力する。
#* [パスワード]
#*: <code>m</code>と入力する。
#*: ［このユーザにのみパスワードを保存する(暗号化済み）]を選択する。
#* [CA証明書]
#*: <code>ca.crt</code>とラベル付けされていることを確認する。
# [接続画面]右下にある[適用]ボタンを押下する。
# タスクバーにあるネットワークアイコンをクリックすると、MullvadのOpenVPNが表示されるので、[接続]ボタンを押下する。
 
もし、接続に問題がある場合、/etc/NetworkManager/NetworkManager.conf ファイルを開いて、<code>dns=dnsmasq</code>　の行をコメントする。 
sudo vi /etc/NetworkManager/NetworkManager.conf
 
# /etc/NetworkManager/NetworkManager.confファイル

# 編集前
dns=dnsmasq

# 編集後
#dns=dnsmasq
 
Network Managerを再起動する。 
sudo systtemctl restart network-manager
 

== Mullvadのコマンド ==
ターミナルを起動して、<code>mullvad</code> コマンドを実行することにより、サブコマンドの全リストとその使用法が表示される。 
 
Mullvadの一般的なコマンドを、以下に示す。 
 
==== Mullvadアカウントの指定 ====
また、<code>mullvad account</code> コマンドを実行することにより、他のアカウント関連コマンドの一覧が表示される。 
mullvad account <Mullvadアカウント>
 
==== アカウント情報の表示 ====
ユーザのアカウント番号とアカウントの有効期限が表示する。 
mullvad account get
 
==== サーバロケーションの一覧表示 ====
利用可能な国および都市のリストを表示する。 
mullvad relay list
 
==== 接続先の選択 ====
mullvad relay set location <国名> <都市名>

# 例. スウェーデン（se）のマルメ市（mma）にあるサーバに接続
mullvad relay set location se mma
 
==== 特定のサーバの選択する ====
mullvad relay set location <国名> <都市名> <都市のグループに所属するサーバ名>
または
mullvad relay set hostname <都市のグループに所属するサーバ名>

# 例. スウェーデン（se）のマルメ市（mma）にあるse-mma-001サーバに接続
mullvad relay set location se mma se-mma-001
または
mullvad relay set hostname se-mma-001
 
==== VPNに接続 ====
選択したサーバに接続する。 
mullvad connect
 
==== VPNの切断 ====
mullvad disconnect
 
==== サーバリストの強制更新 ====
mullvad relay update
 
==== 接続状態の確認 ====
mullvad status
 
==== PCの起動時に自動接続する ====
PCの起動時にMullvadを起動および接続する。 
mullvad auto-connect set on
 
自動接続の設定を無効にする。 
mullvad auto-connect set off
 
==== LANアクセスを有効にする ====
mullvad lan set allow
 
==== 問題を報告する ====
まず、匿名化されたログファイルを作成する。 
Mullvad社に送信する前に、ログファイルを見ることができるオプションがある。 
mullvad-problem-report collect --output report.log
 
次に、ログファイルを送信する。 
mullvad-problem-report send --report report.log --email your@email.address --message "Write a description of your problem."
 
任意ではあるが、問題の詳細を記入されることを強く推奨する。 
また、メールアドレスの記入は必要無いが、Mullvad社からの返信を希望する場合は、メールアドレスの記入が必要となる。 
 
==== スプリットトンネリング (Linuxのみ) ====
スプリットトンネリングは、一部のソフトウェアをVPNから除外して、通常のインターネット接続を使用するものである。 
これにより、例えば、VPNサービスをブロックしている一部のWebサイトにアクセスできるようになる。 
 
* mullvad-excludeを使用する場合
*: Mullvadから除外された新しいプロセスを開始する場合、以下のコマンドを実行する。
*: <pre>mullvad-exclude <プログラム名></pre>
*: 
* mullvad split-tunnelを使用する場合
*: これは、プログラムのPID(プロセスID)を使用して動作する。
*: 実行中のプログラムのPIDを調べる場合、<code>pgrep</code> コマンドを実行する。
** 既に実行中のプロセスをMullvadから除外する。
**: <pre>mullvad split-tunnel pid add <PID></pre>
** 現在除外されている全てのPIDの一覧を表示する。
**: <pre>mullvad split-tunnel pid list</pre>
** 以前に除外したプロセスを復元する。
**: <pre>mullvad split-tunnel pid delete <PID></pre>
** 以前に除外したプロセスを全て復元する。
**: <pre>mullvad split-tunnel pid clear</pre>
 
==== 広告、トラッカー、マルウェアをブロックする ====
広告、トラッカー、マルウェアのDNSフィルタリングを有効にする。 
 
ヘルプを表示する。 
mullvad dns set default --help
 
全てのフィルタを有効にする。 
いくつかのフィルターのみを有効にする場合、引数のいくつかを削除する。 
mullvad dns set default --block-ads --block-malware --block-trackers
 
フィルタリングをリセットする。 
mullvad dns set default
 
==== カスタムDNSサーバを使用する ====
カスタムDNSサーバを設定すると、広告、トラッカー、マルウェアのブロックが上書きできる。 
パブリックDNSサーバは、WireGuardプロトコルを使用している場合のみ使用できる。 
 
カスタムDNSサーバを設定するには、1.1.1.1(Cloudfrare)を使用するサーバIPに置き換える。 
mullvad dns set custom 1.1.1.1
 
カスタムDNSサーバの設定をリセットする。 
mullvad dns set default
 
==== Mullvadの設定のリセット ====
これは、全ての設定を工場出荷時の状態に戻して、ソフトウェアのログとキャッシュファイルを削除する。そして、VPNを切断して、ログアウトする。 
また、リセットする前に、確認画面が表示される。 
mullvad factory-reset
 

== VPN over Tor ==
※注意 
Mullvadは2026年1月15日にOpenVPNサポートを廃止した。 
 
以下に示す手順はOpenVPN廃止以前の情報であり、現在は使用できない可能性がある。 
 
他のソフトウェアがTorブラウザのプロキシ経由でインターネットに接続できるように連携する。 
これは、Tor経由でMullvadに接続するTor経由のVPNであり、Mullvadは終了ノードになる。 
 
ただし、MullvadのSOCKS5プロキシを使用するように設定されていないソフトウェアは、VPNやTorを全く使用せずに直接インターネットに接続される。 
 
# OpenVPNをインストールする。
#: <pre>sudo zypper install openvpn</pre>
# [https://www.torproject.org/download/ Torブラウザの公式Webサイト]にアクセスして、Torブラウザをダウンロードおよびインストールする。
# TorブラウザのインストールディレクトリにあるTor/TorBrowser/Data/Tor/torrc-defaultsファイルを開いて、 <code>CookieAuthentication 1</code> を <code>CookieAuthentication 0</code> に編集する。
#: <syntaxhighlight lang="text">
cd /<Torブラウザのインストールディレクトリ>/Tor/TorBrowser/Data/Tor

vi torrc-defaults

# 編集前
CookieAuthentication 1

# 編集後
CookieAuthentication 0
</syntaxhighlight>
#: 
# MullvadのOpenVPN設定ファイルを[https://mullvad.net/account/#/openvpn-config/?platform=linux Mullvadの公式Webサイト]からダウンロードする。 この時、プラットフォームはLinux、ポートはTCP 443番を選択する。 これは、TorはTCPでのみ動作するためである。
# ダウンロードしたファイルを解凍して、OpenVPN設定ファイルに以下に示す内容を追記する。 この時、OpenVPN設定ファイルをmullvad_tor.confのような一意の名前に変更することを推奨する。
#: <pre>vi mullvad_XX.conf</pre>
#: 
#: <syntaxhighlight lang="text">
route-nopull
route 10.8.0.1 255.255.255.255
socks-proxy 127.0.0.1 9150
</syntaxhighlight>
#: 
# ダウンロードしたMullvadのOpenVPN設定ファイルにある update-resolv-conf ファイルを、/etc/openvpn ディレクトリにコピーする。
#: <pre>sudo cp update-resolv-conf /etc/openvpn</pre>
#: 
# Torブラウザを起動する。
# 上記で編集したOpenVPN設定ファイルを使用して、OpenVPNをコマンドから起動する。
#: <syntaxhighlight lang="text">
sudo openvpn --config <OpenVPNの設定ファイル>
# 例. <code>sudo openvpn --config mullvad_sg_sin_tor.conf
</syntaxhighlight>
#: 
# [https://mullvad.net/guides/socks5-proxy/ SOCKS5のガイド]に従って、FireFoxのSocks5プロキシを設定する。
# Firefox (Torブラウザではないことに注意する) から[https://mullvad.net/check Connection check]にアクセスして、自身のIPアドレスがMullvadのIPアドレスを示していることを確認する。
 
VivaldiからVPN over Tor接続を行う場合の手順を、以下に示す。 
ただし、この方法は、VPN over Tor接続を切断した後、ネットワークマネージャを再起動する手順が必要となることに注意する。 
# まず、<code>resolvconf</code> コマンドをインストールする。 
#: <pre>sudo zypper install openresolv</pre>
#: 
# 次に、ダウンロードしたMullvadのOpenVPN設定ファイルにあるupdate-resolv-confファイルを編集する。 
#: <pre>sed -e "s/\/sbin\/resolvconf/\/usr\/sbin\/resolvconf/g" update-resolv-conf</pre>
#: 
# update-resolv-conf ファイルを /etc/openvpn ディレクトリにコピーする。
#: <pre>sudo cp update-resolv-conf /etc/openvpn</pre>
#: 
# Vivaldiに拡張機能である[https://chrome.google.com/webstore/detail/proxy-switchyomega/padekgcemlokbadohgkifijomclgjgif?hl=ja Proxy SwitchyOmega]をインストールする。
# Proxy SwitchyOmegaのアイコンから[Options]を選択する。
# Proxy SwitchyOmegaの設定ページ左にある[proxy] - 設定ページ右にある[Proxy servers]から、以下に示す設定を行う。
#* [Protocol]プルダウン
#*: SOCKS5
#* [Server]
#*: 10.8.0.1
#* [Port]
#*: 1080
# Proxy SwitchyOmegaの設定ページ左にある[Apply changes]を選択する。
# Proxy SwitchyOmegaのアイコンから[proxy]を選択する。
# [https://mullvad.net/check Connection check]にアクセスして、自身のIPアドレスがMullvadのIPアドレスを示していることを確認する。
# VPN over Tor接続を切断した後、ネットワークマネージャを再起動する。
 

== Tor over VPN ==
VPNネットワーク経由でTorに接続する方法であり、Torは終了ノードになる。(Tor over VPN) 
 
# MullvadソフトウェアまたはNetworkManager等を使用して、VPNに接続する。
# [https://www.torproject.org/download/ Torブラウザの公式Webサイト]にアクセスして、Torブラウザをダウンロードおよびインストールする。
# Torブラウザを起動して、[Connect]ボタンを押下する。 Torブラウザの設定はデフォルトのままでよい。
 

== Torrentの使用 ==
==== 設定 ====
Torrentプロトコルは、以下の手順でより安全に使用できる。 
 
qBittorrentクライアントの設定のみ記載する。 
これは、uTorrent、Vuze、BitComet等のクライアントは、オープンソースではなく、アドウェアやジャンクウェアが含まれていたり、優れたプライバシー設定が施されていないためである。 
 
※注意 
WireGuardとOpenVPNを切り替えた場合、ネットワークインターフェイスを再バインドして、qBittorrentを再起動する必要がある。 
また、SOCKS5を使用している場合は、WireGuardまたはOpenVPNの使用に応じて、IPアドレスを変更する必要がある。 
 
# Mullvadアプリを起動して、VPNを接続する。
# qBittorrentを起動して、[ツール] - [設定] - [設定]画面左ペインにある[高度]を選択する。
# [設定]画面右ペインにある[ネットワークインターフェイス]を、使用しているソフトウェアとプロトコルに応じて、次のいずれかに変更する。
#* OpenVPNを使用したMullvadソフトウェア (MullvadソフトウェアからOpenVPNで接続している場合)
#*: tun0
#* OpenVPNスタンドアロン (NetworkManagerからOpenVPNで接続している場合)
#*: tun0
#* WireGuardを使用したMullvadソフトウェア (MullvadソフトウェアからWireGuardで接続している場合)
#*: wg-mullvad
#* WireGuardユーザ空間を使用したMullvadソフトウェア
#*: tun0
#* WireGuardスタンドアロン
#*: mlvd-xx
# [OK]ボタンを押下する。
# [ファイル] - [終了]を選択して、qBittorrentを再起動する。
 
qBittorrentの推奨設定を、以下に示す。 
# qBittorrentを起動して、[ツール］ - [設定]を選択する。
# [設定]画面左ペインにある[BitTorrent]を選択する。
# [設定]画面右ペインにある[匿名モードを有効にする]を選択する。
# [DHT(分散ネットワーク)を有効にする]チェックボックスのチェックを外す。
# [ピア交換(PeX)を有効にする]チェックボックスのチェックを外す。
# [ローカルピア検出(LSD)を有効にする]チェックボックスのチェックを外す。
# [設定]画面左ペインにある[接続]を選択して、[ピア接続プロトコル]プルダウンから[TCP]を選択する。
 
Mullvad GUIを使用している場合は、Mullvad GUIのメイン画面から[設定] - [詳細設定]から、[常にVPNを必要とする]を有効にする。 
これにより、誤って接続を解除した場合、インターネットを遮断することができる。 
 
==== インターネットリークの確認 ====
[https://mullvad.net/ja/check/ Mullvadの接続確認ページ]にアクセスして、[Torrentチェック]タブを選択する。 
[UDP］および［HTTP］を選択して、インターネットリークのテストを開始する。 
ただし、Bittorrentクライアントにおいて、SOCKS5を使用している場合、このテストは機能しないことに注意する。 
 
==== ポートフォワーディング (ポート転送) ====
qBittorrentを起動して、[接続] - [受信接続に使用するポート]にポートを追加する。 
これにより、シードが向上する可能性がある。 
 
ただし、SOCKS5が有効な場合、この機能は無効になることに注意する。 
 
Bittorrentクライアントへのポートフォワーディングの詳細を知りたい場合は、ポートフォワードガイドを参照すること。 
 
==== その他のエラー ====
qBittorrentにおいて、SOCKS5プロキシを有効にした場合、qBittorrentがオフラインと表示される場合がある。 
 
SOCKS5プロトコルはポートフォワーディングをサポートしないため、トラッカーレスのTorrentを使用する場合は、DHTを有効にする必要があるかもしれない。 
そうでない場合は、SOCKS5プロキシを無効にする必要がある。 
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:PinePhone]][[カテゴリ:Windows10]][[カテゴリ:Windows11]]

VPN - Ivacy VPN

2026-03-24T14:47:22Z

Wiki:

== 概要 ==
Ivacy VPNは、2007年にシンガポールの企業PMG Pte. Ltd.により創業されたVPNサービスである。 
2010年にはVPN業界の定番となったスプリットトンネリングのような優れたセキュリティ機能を提供していた。 
 
Ivacy VPNは、100以上のロケーションに5700以上のサーバを提供しており、ユーザはセキュリティや匿名性を損なうことなく、オンライン上のあらゆるコンテンツにアクセスすることができた。 
 
2024年8月、Ivacy VPNはPureVPNに買収・統合され、現在はIvacy Powered by PureVPNとして運営されている。 
これに伴い、Ivacy VPN単体での新規契約は終了しており、新規ユーザはPureVPNを通じて契約する形となっている。 
既存のIvacyユーザはPureVPNの機能にアクセス可能であるが、ライフタイム購読を持つユーザは5年プランへの移行を求められている。 
 
なお、IvacyとPureVPNは、元々パキスタンの企業Gaditekが親会社であり、両社は以前から同じグループ企業として運営されていた。 
PMG Pte. Ltd.はシンガポール登記であるが、LinkedInに掲載されている従業員の大多数はパキスタン在住であり、実質的な運営拠点はパキスタンであるとの指摘がある。 
 
<center>
{| class="wikitable"
|+ Ivacy VPNの主な特徴
|-
! 特徴 !! 説明
|-
| 256ビット暗号化 || 最大256ビットの暗号化を提供し、セキュリティの侵入を不可能にする。 インターネットトラフィックを暗号化し、サイバー犯罪者を寄せ付けないセキュリティプロトコルを楽しむことができる。
|-
| ノーログポリシー || オンライン上のプライバシーを守るために、ログを残さないという明確なポリシーを持つ。
|-
| ISPスロッティングの回避 || ISPスロッティングを回避するため、IvacyはユーザのIPアドレスをマスクし、ISPスロットリングを回避する。
|-
| インターネットキルスイッチ || インターネットキルスイッチ機能は、接続が切断されたことを検出すると、直ちにインターネットを停止する。 これにより、常にプライベートな状態を保つことができる。
|-
| 専用IP || 専用IPでは、IPアドレスをホワイトリストに登録できる。 企業アカウントや一般的なオンラインアカウントへの不正アクセスを防止し、セキュリティを強化する。
|-
| スプリット・トンネリング || Ivacy VPNはスプリット・トンネリングのパイオニアである。 ローカルと海外のコンテンツに同時にアクセスできる。 ローカルLANを経由しながら、VPN経由でコンテンツにアクセスできる。
|}
</center>
 

== ノーログポリシーの検証 ==
Ivacy VPNはゼロログポリシーを掲げており、オンライン上のプライバシーを守るために一切のログを残さないと主張している。 
しかし、その信頼性には複数の懸念事項が存在する。 
 
==== 公式のノーログポリシー ====
Ivacy VPNの公式プライバシーポリシーでは、以下に示すデータを記録しないと明記している。 
 
* オンラインブラウジング活動
* 接続ログ
* 割り当てられたVPN IPアドレス
* 元のIPアドレス
* ブラウジング履歴
* 送受信トラフィック
* 接続時間
* DNSクエリ
 
==== 実際に収集されるデータ ====
一方、プライバシーポリシーでは以下に示すデータを収集すると明記されている。 
 
* 氏名、メールアドレス、支払い情報
* 接続元の国
* クラッシュレポートおよびパフォーマンスデータ (Firebase / Crashlytics経由)
* 合計帯域幅使用量
* ログイン失敗の試み
* Webサイトアクセスに関するGoogle Analyticsデータ
 
Firebase / Crashlyticsを経由したデータは米国に送信される可能性があり、Google Analyticsも米国法の対象となるため、 
完全なプライバシー保護とは言えない状況である。 
 
==== 独立監査の欠如 ====
Ivacy VPNは公式サイトで定期的に監査を受けていると主張しているが、公開された独立監査報告書は一切存在しない。 
複数のレビューサイトがIvacyに直接問い合わせたところ、監査の詳細や実施者の開示を拒否している。 
 
下表に、競合VPNとの比較を示す。 
 
<center>
{| class="wikitable"
|+ ノーログ監査の比較
! VPNプロバイダ !! 独立監査 !! ワラントカナリー !! 透明性レポート
|-
| Ivacy VPN || なし || なし || なし
|-
| ExpressVPN || あり (KPMG) || なし || あり
|-
| Private Internet Access || あり (Deloitte) || なし || あり
|-
| Mullvad || あり || あり || あり
|-
| Proton VPN || あり || なし || あり
|}
</center>
 
なお、Ivacy VPNはIoXT (Internet of Secure Things) の認証を受けているが、これはAndroidアプリのセキュリティ基準の確認に限定されており、ノーログポリシーの検証ではない。 
 
==== 2017年: PureVPNによるFBIへのログ提供事件 ====
Ivacy VPNの親会社グループであるPureVPNは、2017年にノーログポリシーに反してFBIにユーザログを提供した前科がある。 
 
事件の概要を以下に示す。 
* 2017年10月、米国マサチューセッツ州のRyan S. Linがサイバーストーキング罪で逮捕された。
* PureVPNは「ノーログポリシー」を掲げていたにもかかわらず、FBIの捜査に対してユーザのアクセスログを提供した。
* 具体的には、接続時刻、VPN接続元のIPアドレス、2つの異なる元IPアドレスから同一アカウントでアクセスされたことの確認情報が提出された。
* PureVPNは後に、"ユーザアクティビティはログしないが、IPアドレスは記録する" と弁明した。
 
IvacyとPureVPNは元々同じ親会社 (Gaditek) 傘下であり、同じサーバインフラを共有していたことが研究者により確認されている。 
2024年8月にIvacyがPureVPNに正式に買収・統合されたことで、PureVPNのデータ管理ポリシーがIvacyユーザにも適用される可能性がある。 
 
==== 2023年: コード署名証明書の盗用事件 ====
2023年5月、Ivacy VPNの運営元であるPMG Pte. Ltd.のコード署名証明書が中国のAPTグループ Bronze Starlight により盗用されていることが判明した。 
 
* 盗用された証明書は、東南アジアのギャンブル業界を標的としたマルウェア配布に使用された。
* SentinelLabsの分析によれば、PMG Pte. Ltd.の署名キーがどの時点かで盗まれたと推測されている。
* Ivacy VPNおよびPMG Pte. Ltd.は、この事件についていかなる公式声明も発表しておらず、証明書がどのように盗まれたかは不明のままである。
* 証明書はDigiCertにより無効化された。
 
この事件は、Ivacy VPNのセキュリティ管理能力そのものに疑問を投げかけるものである。 
 
==== 所有権の不透明性 ====
Ivacy VPNの企業構造には透明性の問題が指摘されている。 
 
* 公式にはシンガポールのPMG Pte. Ltd.が運営元と主張しているが、実質的にはパキスタンの企業Gaditek (またはDisrupt.com) が支配していた。
* GaditekはIvacy VPNとの関係をWebサイトから意図的に削除している。
* 2019年にIvacy VPNが公開した透明性ページは、架空のPRマネージャーとジャーナリストの対話を記載したものであり、セキュリティ専門家やレビューサイトから "明らかに虚構" と批判された。
* Ivacy VPNが複数のVPNレビューサイトを運営し、有利な評価と引き換えにライフタイム契約を提供していた疑惑も存在する。
 
==== 5 Eyes同盟との関係 ====
Ivacy VPNの本社所在地であるシンガポールは、Five Eyes / Nine Eyes / Fourteen Eyes同盟の正式なメンバーではない。 
 
しかし、スノーデンによるリーク文書により、シンガポールはFive Eyesとの実質的な情報共有協力を行っている第三者貢献国であることが示唆されている。 
そのため、シンガポールの法的管轄権に基づく情報開示要求に対して、完全な独立性は期待できない可能性がある。 
 
==== 総合評価 ====
以上に示す調査結果から、Ivacy VPNのノーログポリシーの信頼性には重大な懸念がある。 
 
* 独立した第三者監査が一切公開されておらず、ノーログポリシーの検証が不可能である。
* 親会社グループのPureVPNが「ノーログ」を偽りFBIにログを提供した前科がある。
* 企業構造の不透明性と所有権の隠蔽が指摘されている。
* ワラントカナリーおよび透明性レポートが存在しない。
* コード署名証明書の盗用事件により、セキュリティ管理能力に疑問がある。
 
プライバシーを重視する場合は、独立監査済みかつ透明性の高い代替VPN (Mullvad、Proton VPN、ExpressVPN等) の検討を推奨する。 
 

== Ivacy VPNの契約 ==
※注意 
2024年8月のPureVPNとの統合により、Ivacy VPN単体での新規契約は終了している。 
 
そのため、新規ユーザはPureVPN (https://www.purevpn.com/) を通じて契約する必要がある。 
以下に示す契約手順は、統合前の契約手順を参考として記載するものである。 
 
Ivacy VPNの契約手順を以下に示す。 
 
# [https://www.ivacy.com/ Ivacy VPNの公式Webサイト]へアクセスして、ページにある[GET STARTED]を選択する。
# [Select Ivacy's exclusive pricing plan]では、月間または年間のプランを選択する。
# [Create Your Account]では、Eメールアドレスを入力する。
# [Security Add-Ons]はオプションである。飛ばしても構わない。
# [Select Payment Method]では、支払い方法 (クレジットカード、PayPal、Bitpay等) を入力して、[PROCEED TO PAYMENT]を選択する。
 
Ivacy VPNの料金は、年間47.76ドル(更新時も同様)、5年60ドル、1ヶ月9.95ドルであった。(2023年7月時点) 
 
なお、既存のIvacyユーザはPureVPNへの移行が行われており、ライフタイム購読を持つユーザは5年プランへの移行を求められている。 
 

== Ivacy VPNの設定 ==
※注意 
2024年8月のPureVPNとの統合により、以下の設定手順やダウンロードURLが変更されている可能性がある。 
 
最新の設定方法はPureVPNの公式サイトを確認すること。 
 
Ivacy VPN (OpenVPN) を設定するには、以下に示す手順に従う。 
 
==== NetworkManagerを使用する場合 ====
===== GNOMEの場合 =====
# [https://www.ivacy.com/ Ivacy VPNの公式Webサイト]にアクセスして、OpenVPN設定ファイルをダウンロードする。
#: <pre>wget https://ivacy.s3.amazonaws.com/support/OpenVPN-Configs-with-certificate.rar</pre>
# ダウンロードしたファイルを解凍する。
#: <pre>unrar OpenVPN-Configs-with-certificate.rar</pre>
# OpenVPNの設定ファイルをインポートして使用するために必要な依存関係のライブラリをインストールする。
#: <syntaxhighlight lang="text">
# RHEL
sudo dnf install openvpn NetworkManager-openvpn NetworkManager-openvpn-gnome

# SUSE
sudo zypper install openvpn NetworkManager-openvpn NetworkManager-openvpn-gnome
</syntaxhighlight>
# GNOMEのホーム画面右上にある[ネットワーク]アイコンをクリックして、[有線接続]プルダウンから[有線設定]を選択する。
# [設定]画面が開くので、画面左にある[ネットワーク] - 画面右の[VPN]項目の右にある[＋]ボタンを押下する。
# [VPNの追加]画面が開くので、[ファイルからインポート...]を選択する。
# 上記で解凍したOpenVPN設定ファイルを選択して、画面右上にある[開く]ボタンを押下する。
#: OpenVPNファイルの命名形式は、国-<TCP>、または、国-OB-<UDP>である。
#: 例. SG_TCP.ovpn
# 選択したOpenVPN設定ファイルが未保存のセッションとしてNetworkManagerにインポートされるので、[VPNの追加]画面から以下に示す項目を入力および設定する。
#* [接続名]
#*: IvacyVPN OpenVPN
#* [Gateway]
#*: [https://support.ivacy.com/servers-list/ Ivacy VPNの公式Webサイト]を確認して、ゲートウェイを入力する。(例: de2-ovpn-udp.dns2use.com)
#* [接続タイプ]
#*: [パスワード]を選択する。
#* [ユーザ名]
#*: Ivacy VPNのログインユーザ名を入力する。
#* [パスワード]
#*: Ivacy VPNのログインパスワードを入力する。
#* [CA証明書]
#*: 自動的に入力される。
# [VPNの追加]画面にある[IPv6]タブを選択して、[無効]ボタンを選択する。
# [VPNの追加]画面右上にある[追加]ボタンを押下する。
# 上記で選択したIvacy VPNのOpenVPN設定が作成されて、Ivacy VPNのOpenVPNセッションが[VPN]項目の選択エリアにリストされていることを確認する。 これは、[VPN]項目の選択エリアにあるスライダースイッチを押下することにより、接続および切断を切り替えることができる。 また、GNOMEのホーム画面右上にある[ネットワーク]アイコンをクリックして、VPNの接続および切断を切り替えることができる。
# IPアドレスが匿名かつプライベートなIvacy VPNに変更されたことを確認する場合は、http://ipchicken.com にアクセスする。
# 次に、Webブラウザのクッキーおよびキャッシュを削除する。
# 最後に、以下に示すURLにアクセスして、DNSリークを確認する。
#: https://www.dnsleaktest.com/
 
===== KDEの場合 =====
# [https://support.ivacy.com/vpnusecases/openvpn-files-windows-routers-ios-linux-and-mac/ Ivacy VPNの公式Webサイト]にアクセスして、 OpenVPN設定ファイル (OpenVPN Files with Certificates) をダウンロードする。
#: <pre>wget https://ivacy.s3.amazonaws.com/support/OpenVPN-Configs-with-certificate.rar</pre>
# ダウンロードしたファイルを解凍する。
#: <pre>unrar OpenVPN-Configs-with-certificate.rar</pre>
# OpenVPNの設定ファイルをインポートして使用するために必要な依存関係のライブラリをインストールする。
#: <syntaxhighlight lang="text">
# RHEL
sudo dnf install openvpn NetworkManager-openvpn plasma-nm-openvpn

# SUSE
sudo zypper install openvpn NetworkManager-openvpn plasma-nm5-openvpn
</syntaxhighlight>
# [KDEシステム設定]を起動して、[接続]を選択する。
# [接続]画面が開くので、画面左下(接続先リストの下)にある[+]を押下する。
# [接続タイプの選択]画面が開くので、リストの最下行にある[VPN接続をインポート...]オプションを選択して[作成]ボタンを押下する。
# [VPN接続をインポート]画面が開くので、解凍したディレクトリ内にあるOpenVPNファイル(VPNサーバ)を選択する。 例. SG_TCP.ovpn
# 証明書をコピーするよう求められたら、[はい]ボタンを押下する。
# [接続]画面左にIvacy VPNのVPN接続が表示されるので、IvacyVPNと入力する。
#: 
# [接続]画面右にある[VPN(openvpn)]タブを選択して、以下に示す設定を行う。
#* [Gateway]
#*: 自動的に入力される。
#* [接続タイプ]
#*: [パスワード]を選択する。
#* [ユーザ名]
#*: Ivacy VPNのログインユーザ名を入力する。
#*: これは、登録したメールアドレスではなく、ivacy0s〇〇〇〇のような名前のユーザ名であることに注意する。
#*: もし、ユーザ名が分からない場合は、[https://www.ivacy.com/ Ivacy VPNの公式Webサイト]にアクセスして、ライブチャット (画面右下に表示される) で問い合わせること。
#*: または、https://member.ivacy.com/manual-configration にアクセスして、各ファイルのダウンロード時に表示されるユーザ名を使用する。
#* [パスワード]
#*: Ivacy VPNのログインパスワードを入力する。
#*: これは、アカウント開設時のパスワードである。
#*: [このユーザーのみにパスワードを保存する]、または、[すべてのユーザーにパスワードを保存]を選択する。
#* [CA証明書]
#*: Ivacy VPNのOpenVPNファイルをインポートした時に自動生成されるpemファイルを選択する。(OpenVPNファイルごとにpemファイルが生成されることに注意する)
#*: このファイルは、~/.cert/nm-openvpn/ ディレクトリに存在し、<接続先ロケーション>_TCP-ca.pem という名前のファイルである。
#: 
# [Advanced]ボタンを押下して、[OpenVPN Advanced Options]画面を開く。
#* [General]タブを選択する。
#*: [カスタムゲートウェイポートを使用する]をチェックする。
#*: TCPの場合は、80番、または、1194番を入力する。
#*: ただし、1194番を入力する場合は、[VPN (openvpn)]タブの[ゲートウェイ]項目のサフィックスを":1194"へ変更すること。
#*: UDPの場合は、53番を入力する。
#*: ※注意
#*: TCP接続の場合は、[Use a TCP Connection......]を選択する。
#* [セキュリティ］タブを選択して、以下に示すオプションを選択する。
#*: [暗号]プルダウンから[AES-256-CBC]を選択する。
#*: [HMAC認証]プルダウンから[SHA-1]、または、[Default]を選択する。
#* [TLS認証]タブを選択する。
#*: [Verify peer (server) certificate usage signature]チェックボックスにチェックを入力する。
#*: [Remote peer certificate TLS type]プルダウンから[Server]を選択する。
#*: [Mode:]プルダウンから[TLS-Auth]を選択する。
#*: [キーファイル]には、OpenVPNファイルを追加した時に自動生成されるtls-auth.pemファイルを選択する。
#*: このファイルは、~/.cert/nm-openvpn/<接続先ロケーション>_TCP-tls-auth.pemファイルである。
#*: [Key Direction]プルダウンから[Client (1)]を選択する。
#: 
# [接続]画面右にある[IPv6]タブを選択して、[この接続には IPv6 が必要]チェックボックスのチェックを外す。
# [接続画面]右下にある[適用]ボタンを押下する。
# タスクバーにあるネットワークアイコンをクリックすると、上記のセクションで作成したOpenVPNが表示されるので、[接続]ボタンを押下する。
# [VPN secrets (openvpn) dialog]ダイアログが表示されてパスワードの入力を促される場合は、再度、Ivacy VPNのパスワードを入力する。
#: 
# IPアドレスが匿名かつプライベートなIvacy VPNに変更されたことを確認する場合は、http://ipchicken.com にアクセスする。
# 次に、Webブラウザのクッキーおよびキャッシュを削除する。
# 最後に、以下に示すURLにアクセスして、DNSリークを確認する。
#: https://www.dnsleaktest.com/
 
==== OpenVPNコマンドを使用する場合 ====
# [https://support.ivacy.com/vpnusecases/openvpn-files-windows-routers-ios-linux-and-mac/ Ivacy VPNの公式Webサイト]にアクセスして、OpenVPN設定ファイルをダウンロードする。
#: <pre>wget https://ivacy.s3.amazonaws.com/support/OpenVPN-Configs.rar</pre>
# ダウンロードしたファイルを解凍する。 解凍したディレクトリには、OpenVPNファイルと証明書ファイル(.crt拡張子)の2つがある。
#: 
# 上記で編集したOpenVPN設定ファイルを使用して、OpenVPNをコマンドから起動する。
#: <syntaxhighlight lang="text">
cd <OpenVPNの設定ファイルがあるディレクトリ>

sudo openvpn --config <OpenVPNの設定ファイルのパス>
# または
sudo openvpn --config <OpenVPNの設定ファイルのパス> --ca <証明書ファイルのパス>
</syntaxhighlight>
 

== VPN over Tor ==
Ivacy VPNは、VPN over TORをサポートしていない。 
 
VPN接続、または、Tor over VPN接続のみが使用できることに注意する。 
 

== Tor over VPN ==
VPNネットワーク経由でTorに接続する方法であり、Torは終了ノードになる。 
 
# [[VPN_-_Ivacy_VPN#Ivacy_VPNの設定|"Ivacy VPNの設定"]]セクションを参照して、VPNに接続する。
# [https://www.torproject.org/download/ Torブラウザの公式Webサイト]にアクセスして、Torブラウザをダウンロードおよびインストールする。
# Torブラウザを起動して、[Connect]ボタンを押下する。 Torブラウザの設定はデフォルトのままでよい。
 

== Torrentの使用 ==
==== 設定 ====
Torrentプロトコルは、以下の手順でより安全に使用できる。 
 
qBittorrentクライアントの設定のみ記載する。 
これは、uTorrent、Vuze、BitComet等のクライアントは、オープンソースではなく、アドウェアやジャンクウェアが含まれていたり、優れたプライバシー設定が施されていないためである。 
 
※注意 
WireGuardとOpenVPNを切り替えた場合、ネットワークインターフェイスを再バインドして、qBittorrentを再起動する必要がある。 
また、SOCKS5を使用している場合は、WireGuardまたはOpenVPNの使用に応じて、IPアドレスを変更する必要がある。 
 
# Ivacy VPNを接続する。
# qBittorrentを起動して、[ツール]メニューバー - [設定]メニューを選択する。
# [設定]画面左ペインにある[高度]を選択する。
# [設定]画面右ペインにある[ネットワークインターフェイス]を、使用しているソフトウェアとプロトコルに応じて、次のいずれかに変更する。
#* OpenVPNを使用したIvacy VPNソフトウェア (Ivacy VPNソフトウェアからOpenVPNで接続している場合)
#*: tun0
#* OpenVPNスタンドアロン (NetworkManagerからOpenVPNで接続している場合)
#*: tun0
#* WireGuardを使用したIvacy VPNソフトウェア (Ivacy VPNソフトウェアからWireGuardで接続している場合)
#*: 
# [バインドする任意のIPアドレス]プルダウンから、Ivacy VPNで接続しているIPアドレスを選択する。
# [OK]ボタンを押下する。
# [ファイル] - [終了]を選択してqBittorrentを終了して、qBittorrentを再起動する。
 
qBittorrentの推奨設定を、以下に示す。 
# qBittorrentを起動して、[ツール］ - [設定]を選択する。
# [設定]画面左ペインにある[BitTorrent]を選択する。
# [設定]画面右ペインにある[匿名モードを有効にする]を選択する。
# [DHT(分散ネットワーク)を有効にする]チェックボックスのチェックを外す。
# [ピア交換(PeX)を有効にする]チェックボックスのチェックを外す。
# [ローカルピア検出(LSD)を有効にする]チェックボックスのチェックを外す。
# [設定]画面左ペインにある[接続]を選択して、[ピア接続プロトコル]プルダウンから[TCP]を選択する。
 
==== ポートフォワーディング (ポート転送) ====
qBittorrentを起動して、[接続] - [受信接続に使用するポート]にポートを追加する。 
これにより、シードが向上する可能性がある。 
 
ただし、SOCKS5が有効な場合、この機能は無効になることに注意する。 
 
Bittorrentクライアントへのポートフォワーディングの詳細を知りたい場合は、ポートフォワードガイドを参照すること。 
 
==== その他のエラー ====
qBittorrentにおいて、SOCKS5プロキシを有効にした場合、qBittorrentがオフラインと表示される場合がある。 
 
SOCKS5プロトコルはポートフォワーディングをサポートしないため、トラッカーレスのTorrentを使用する場合は、DHTを有効にする必要があるかもしれない。 
そうでない場合は、SOCKS5プロキシを無効にする必要がある。 
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:Windows7]][[カテゴリ:Windows10]][[カテゴリ:Windows11]]

VPN - Nord VPN

2026-03-24T14:24:14Z

Wiki:

== 概要 ==
NordVPNは、通信に関するログを取らないVPNサービスであり、ユーザが使用したローカルまたは割り当てられたIPアドレス、接続履歴、トラフィックログ、DNSクエリを保持しない。 
ただし、アカウント管理目的でメールアドレスおよび支払い情報は保持される。 
 
NordVPNの特徴を、以下に示す。 
* ロケーション
*: NordVPNは、プライバシーの安全な場所であるパナマに本社を構えており、パナマには、EU、イギリス、オーストラリアのようなデータを保持する法律がない。
*: また、パナマは5つの目、9つの目、または14の目の国のメンバーではない。
* セキュリティ
*: NordVPNは、256ビットAESのデータ暗号化を提供している。
*: これは、優れたファイアウォールと保護されたサーバと一緒に、NordVPNの安全性を最高級に保護している。
* 通信速度
*: 以前、通信速度がNordVPNの弱点であったが、現在は最速のVPNサービスの1つになってきている。
*: また、P2PやTorrentの速度も非常に優れており、Netflixのようなコンテンツをアンロックすることも可能である。
* 契約
*: Eメール、支払い方法、パスワードのみで、アカウントを作成することができる。
*: つまり、ProtonMailのような匿名のメールサービスとBitcoinのような安全な支払い方法を用いることにより、NordVPNは完全な匿名性を求める人に提供できる可能性がある。
*: クレジットカードや銀行振込等、別の支払い方法を利用する場合は、個人の銀行情報を提供する必要がある。
 

== ノーログポリシーの検証 ==
==== 記録しないデータ ====
NordVPNが記録しないとしているデータは、以下の通りである。 
* ユーザの実際のIPアドレス
* インターネットアクティビティログ (訪問したWebサイト、ダウンロード内容)
* トラフィックデータ (通信内容)
* DNS照会記録
* VPN接続ログ (接続先サーバ、接続時刻等)
 
このノーログポリシーは、Standard VPN、Double VPN、Onion Over VPN、難読化サーバ、P2Pサーバの全てのサーバタイプに適用される。 
 
==== 記録するデータ ====
一方、アカウント管理目的で以下のデータは保持される。 
* メールアドレス
* 支払い情報
 
したがって、NordVPNは一切のデータを保持しないわけではなく、通信に関するログを保持しない という意味でのノーログVPNである。 
 
==== 技術的な裏付け - RAMオンリーサーバ ====
NordVPNは全サーバをRAMオンリー (ディスクレス) 構成に移行済みである。 
* メモリ (RAM) 上でのみデータを処理し、ハードディスクにはデータを保存しない
* サーバがシャットダウンまたは再起動された時点で、全てのデータが自動削除される
* 不正アクセスやハードウェア押収が発生した場合でも、データ抽出が不可能
 
==== 第三者監査の実施状況 ====
NordVPNのノーログポリシーは、以下の通り複数回の独立した第三者監査で検証されている。 
 
<center>
{| class="wikitable"
|+ ノーログポリシー監査履歴
! 回 !! 年 !! 監査機関 !! 結果
|-
| 第1回 || 2018年 || PricewaterhouseCoopers AG Switzerland (PwC) || ノーログポリシーの遵守を確認
|-
| 第2回 || 2020年 || PricewaterhouseCoopers AG Switzerland (PwC) || ノーログポリシーの遵守を確認
|-
| 第3回 || 2022年 || Deloitte Audit Lithuania || ノーログポリシーの遵守を確認
|-
| 第4回 || 2023年 || Deloitte Audit Lithuania || ノーログポリシーの遵守を確認
|-
| 第5回 || 2024年 || Deloitte Audit Lithuania || ノーログポリシーの遵守を確認
|-
| 第6回 || 2025年 || Deloitte Audit Lithuania || ノーログポリシーの遵守を確認
|}
</center>
 
2024年の第5回監査 (2024年11月18日〜12月20日) では、ISAE 3000基準に基づき、ユーザの活動をユーザ個人に関連付けることが不可能な状態であることが検証された。 
 
==== 法的立場 ====
NordVPNはパナマに本社 (Nordvpn S.A.) を置いており、以下の法的優位性を持つ。 
* パナマにはVPNプロバイダに対する強制的なデータ保持法が存在しない
* パナマは5 Eyes、9 Eyes、14 Eyesのいずれの国際情報共有同盟にも属していない
* 他国政府がNordVPNに対してデータ提供を強制するための法的メカニズムが制限されている
 
ただし、パナマの検察官から法的拘束力のある令状が発行された場合は、保持しているデータの開示に応じる。 
 
==== 捜査機関へのデータ提出事例 ====
NordVPNが法執行機関にデータを提出した事例と、他社VPNの事例を以下に整理する。 
 
===== 2024年10月: パナマ検察からの令状 =====
NordVPNはパナマの検察官から法的拘束力のある令状を受け、ユーザデータの開示に応じた。 
* 提供されたデータは、支払い情報およびアカウント存在確認のみ
* トラフィックログ、接続ログ等は保持していないため提供不可能であった。
* この事例を契機に、Warrant CanaryからTransparency Report (透明性レポート) への移行を開始
 
===== 2024年1月〜4月の統計 =====
* 政府機関からの問い合わせ: 81件
* DMCA請求: 約242万件
* いずれもユーザ情報の開示には至らなかったと報告されている。
 
===== 他社VPNの事例との比較 =====
<center>
{| class="wikitable"
|+ 他社VPNのログ提出事例との比較
! プロバイダ !! 事例 !! 実態
|-
| PureVPN (2017年) || FBIにサイバーストーキング事件のログを提供 || ノーログと謳いながら詳細な接続ログを保持していた。
|-
| HideMyAss (2011年) || FBIにLulzSecハッカーの接続データを提供 || 同様にログを保持していた。
|-
| NordVPN (2024年) || パナマ検察に支払い情報のみ提供 || トラフィックログは実際に存在せず提供不可能であった。
|}
</center>
 
PureVPNやHideMyAssは、ノーログを謳いながら実際には詳細なログを保持していたのに対し、 
NordVPNは第三者監査および実際の法的事例により、トラフィックログを保持していないことが裏付けられている。 
 
==== セキュリティインシデント ====
===== 2019年: サーバ侵害事件 =====
2018年3月、フィンランドのCreanova Datacenterから借用していた約3,000台中1台のサーバが侵害された。 
* 原因
*: データセンター側がIPMI (Intelligent Platform Management Interface) アカウントを未開示のまま放置していた。
* ユーザのパスワード、課金情報、VPNログの流出はなし
* 侵害の発見は2019年4月 (事件発生から約1年後)、公開は2019年10月 (発見からさらに6ヶ月後)
 
この事件を受けて、NordVPNは以下の改善策を実施した。 
* Creanovaとの契約を即座に解除
* 全サーバをRAMオンリー (ディスクレス) 構成に移行
* 自社管理コロケーションサーバの導入 (2020年10月〜)
* バグバウンティプログラムの開始 (2019年10月〜)
* VPN Trust Initiativeの創設メンバーとして参加
 
===== 親会社に関する懸念 =====
NordVPNの親会社であるNord Security (リトアニア) は、Tesonetというスタートアップインキュベーターの傘下にある。 
* Tesonetはデータ収集企業Oxylabsも保有しており、利益相反の可能性が指摘されている。
* 企業構造の不透明さが批判されることがある。
* ただし、複数の独立監査によりユーザデータが外部と共有されていないことは検証されている。
 
==== 総合評価 ====
下表に、NordVPNのノーログポリシーに関する総合評価を示す。 
 
<center>
{| class="wikitable"
|+ ノーログポリシー総合評価
! 観点 !! 評価
|-
| ノーログの真正性 || 6回の独立監査で検証済み。 2024年の令状事例でも実際にログが存在しないことが裏付けられた。
|-
| 捜査機関への対応 || 法的令状には応じるが、提供可能データは支払い情報のみ
|-
| 他社VPNとの違い || PureVPN、HideMyAssはノーログを詐称していたが、NordVPNは監査で裏付けあり
|-
| 懸念事項 || 親会社Tesonetの企業構造の不透明さ、2019年侵害事件の公表遅延
|}
</center>
 

== Nord VPNの契約 ==
Nord VPNの契約方法を以下に示す。 
 
# まず、Nord VPNの公式Webサイトへアクセスして、画面上にある[価格]を選択する。
# 価格画面からプランを選択する。
#: プランはスタンダード、プラス、コンプリートの3つのティアがあり、それぞれ1ヶ月、1年、2年の契約期間を選択できる。
#: 最もコストパフォーマンスが良いのは2年プランである。(3年プランは廃止されている)
#: プランを選択後、アカウントの作成と支払い方法の選択をする。
#: 
#: ※注意
#: NordVPNはパナマ所在の企業であるため、クレジットカード会社が海外購入として制限を掛け、否決される可能性がある。
#: PayPalまたは暗号通貨 (ビットコイン、イーサリアム、ライトコイン) での支払いを推奨する。
#: 
# 次に、[消費税適用外]項目から[日本]を選択して、[続ける]ボタンを押下する。
# ここでは、PayPalで決済するため、[Pay with PayPal]を選択して支払いを進める。 支払いが完了すると、支払い受付画面に移動する。
# Nord VPNからE-mailが3通届くので、アカウントを有効化するために"NordVPN account activation"という件名のメールを開く。
# [Set Password and Activate Account]ボタンを押下すると、Nord VPNのWebサイトへ移動するので、パスワード設定とアカウントの有効化を行う。 ここで入力するパスワードは、VPN接続する時のパスワードとなる。
# パスワードを設定すると、自動的にNord VPNソフトウェアのダウンロードが開始される。 または、[https://nordvpn.com/ja/download/ Nord VPNの公式Webサイト]でも個別にダウンロードできる。
 

== Nord VPNソフトウェアのインストール ==
===== RHEL =====
ターミナルを起動して、以下のコマンドを実行する。 
sudo wget -qnc https://repo.nordvpn.com/yum/nordvpn/centos/noarch/Packages/n/nordvpn-release-1.0.0-1.noarch.rpm
sudo dnf update
 
Nord VPNソフトウェアをインストールするため、以下のコマンドを実行する。 
sudo dnf install nordvpn
 
自分のNord VPNアカウントにログインする。 
nordvpn login
 
Nord VPNサーバに接続する。 
nordvpn connect
または
nordvpn c
 
===== SUSE =====
ターミナルを起動して、以下のコマンドを実行する。 
sudo rpm -v --import https://repo.nordvpn.com/gpg/nordvpn_public.asc
sudo zypper install https://repo.nordvpn.com/yum/nordvpn/centos/noarch/Packages/n/nordvpn-release-1.0.0-1.noarch.rpm
sudo zypper addrepo /etc/yum.repos.d/nordvpn.repo
 
Nord VPNソフトウェアをインストールするため、以下のコマンドを実行する。 
sudo zypper install nordvpn
 
自分のNord VPNアカウントにログインする。 
nordvpn login
 
Nord VPNサーバに接続する。 
nordvpn connect
または
nordvpn c
 
===== LinuxにおけるNord VPNコマンド =====
nordvpn login - ログイン
nordvpn login --token [トークン] - トークンを使用してログイン (GUI無し環境用)
nordvpn connect or nordvpn c - VPNに接続する。特定のサーバに接続する場合は nordvpn connect <country_code server_number> (例: nordvpn connect uk715)
nordvpn disconnect or nordvpn d - VPNから切断する
 
nordvpn set or nordvpn s - 設定オプション:
nordvpn set threatprotectionlite on or off - Threat Protection Lite (DNSフィルタリング・広告ブロック) の有効化/無効化 (旧: cybersec)
nordvpn set killswitch on or off - Kill Switchの有効化/無効化
nordvpn set autoconnect on or off - 自動接続の有効化/無効化。特定サーバの自動接続: nordvpn set autoconnect on us2435
nordvpn set dns 1.1.1.1 1.0.0.1 - カスタムDNSの設定 (1つまたは2つ指定可能)
nordvpn set technology nordlynx or openvpn - VPNプロトコルの切り替え
nordvpn set obfuscate on or off - 難読化サーバの有効化/無効化
nordvpn set firewall on or off - ファイアウォールの有効化/無効化
nordvpn set ipv6 on or off - IPv6サポートの有効化/無効化
nordvpn set lan_discovery on or off - LANデバイス検出の有効化/無効化
nordvpn set post_quantum_vpn on or off - ポスト量子暗号の有効化/無効化
nordvpn set notify on or off - 通知の有効化/無効化
nordvpn set tray on or off - システムトレイアイコンの有効化/無効化
nordvpn set defaults - デフォルト設定にリセット
 
nordvpn allowlist add port 22 - ポート22をVPN例外リストに追加 (旧: whitelist)
nordvpn allowlist add port 22 protocol TCP - プロトコル指定でポートを追加
nordvpn allowlist remove port 22 - ポート22のルールを削除
nordvpn allowlist add subnet 192.168.0.0/16 - サブネットをVPN例外リストに追加
nordvpn allowlist remove subnet 192.168.0.0/16 - サブネットのルールを削除
nordvpn allowlist remove all - VPN例外リストの全ルールを削除
 
nordvpn settings - 現在の設定を表示
nordvpn status - 接続状態を表示
nordvpn account - アカウント情報を表示
nordvpn countries - 利用可能な国一覧を表示
nordvpn cities - 利用可能な都市一覧を表示
nordvpn groups - 利用可能なサーバグループ一覧を表示
nordvpn version - アプリケーションバージョンを表示
nordvpn logout - ログアウト
nordvpn help or nordvpn h - コマンド一覧またはヘルプを表示
 
<code>man nordvpn</code>コマンドを使用して、コマンドの全リストを見ることができる。 
 
===== Windows =====
Nord VPNソフトウェアのインストール手順を記載する。 
# 上記セクションでダウンロードしたNordVPNSetup.exeを実行する。
# インストール先を選択するダイアログが表示されるので、必要であればフォルダを変更して[Next]ボタンを押下する。
# [Install]ボタンを押下してインストールを始める。
# [Finish]ボタンを押下してインストールを完了する。
 
Nord VPNソフトウェアを起動手順を記載する。 
# Nord VPNソフトウェアの起動後、ログイン画面が表示されるので、Nord VPNで登録したメールアドレスとパスワードを入力して[Sign In]ボタンを押下する。
# ログインに成功すると、VPNサーバを選択する画面が表示される。 メイン画面下の[Quick connect]ボタンを押下すると、近距離にあるVPNサーバが選択される。(日本国内から接続すれば、日本のVPNサーバが選択される)
# 接続したい国があれば、世界地図の上から選択する事もできる。 例えば、ブラジルのVPNサーバに接続する場合、ブラジルを選択してから[Quick connect]ボタンを押下する。 あるいは、メイン画面左から接続したい国を選択して接続することもできる。
# 接続が成功すると、国のアイコンが緑色に変化する。また、接続状態も[UNCONECTED]から[PROTECTED]に変化して[Connected to Brazil]と表示される。
# 切断する場合は、[Disconnect]ボタンを押下する。
 

== Network Managerを使用したNord VPNの接続 ==
# Nord VPNの公式Webサイトから、[https://downloads.nordcdn.com/configs/archives/servers/ovpn.zip OpenVPN構成ファイルパッケージ]をダウンロードして解凍する。
# Network Managerの設定画面を起動する。(GNOMEの場合は、[VPNオフ]を選択後、ドロップダウンから[VPN設定]を選択する)
# 設定画面下にある[+]ボタンを押下する。(GNOMEの場合は、 [VPN]項目横にある[+]ボタンを押下する)
# 接続タイプは、[VPN接続をインポート...]を選択する。(GNOMEの場合は、[ファイルからインポート...]を選択する)
# 上記でダウンロードしたファイルから1つを選択して、[開く]ボタンを押下する。
# ポップアップウィンドウにNord VPNで取得したのユーザ名とパスワードを入力して、[追加]ボタンを押下する。
# 追加したNord VPNサービスの資格情報は、Nordアカウントダッシュボードで確認できる。右側のボタンを使用して認証情報をコピーします。
# 最後に、Network Managerの設定画面から、VPNオプションの下のスライダーを押下して、Nord VPNサーバに接続する。 VPN接続が開始されると、スライダーは緑色に変化する。
 

== Nord VPNソフトウェアの設定 ==
Nord VPNソフトウェアのメイン画面右上にある歯車のアイコンを選択する。 
設定項目は、[General]、[Auto Connect]、[Advanced]がある。 
 
===== General =====
Nord VPNの[General]項目において、重要な項目は以下の2つである。 
* Start NordVPN on startup
* Internet Kill Switch
 
[Start NordVPN on startup]項目は、初期設定で有効化されている。 
OS起動時にNordVPNを動作させるため、[オン]にする。 
 
[Internet Kill Switch]項目は、VPNを経由しない通信をすべて遮断する。匿名性を向上させるため、[オン]に設定する。 
注意点として、Nord VPNに接続していない状態では、一切ネットワーク接続できなくなる点である。 
VPNを切断してVPN非経由でインターネット接続する場合は、[Internet Kill Switch]項目を[オフ]に設定する必要がある。 
 
===== Auto Connect =====
Nord VPNの[Auto Connect]項目では、自動接続設定を行う。 
VPNクライアントを起動した際、自動的にVPN接続する場合は、[Connect when app starts]項目を[オン]に設定する。 
 
また、外出先でWi-Fiに接続する可能性がある場合は、[Connect on insecure wireless]項目を[オン]に設定するとよい。 
 
自動接続する国を選択したい場合は、[Auto connect to]項目で選択して、更に細かく指定する場合は[Preferred region]項目で指定する。 
通常は、[Preferred region]項目は[Automatically pick best]に設定することを推奨する。 
 

== Double VPNで接続する ==
NordVPNのメリットの1つに、匿名性を高めるDouble VPNが存在する。 
Double VPNを利用するとVPNサーバを2つ経由する。 
ユーザが利用するISPには、1つ目のVPNサーバと通信している記録が残るが、最終的な接続先から見ると2つ目のVPNサーバから接続している記録が残る。 
そして1つ目と2つ目のVPNサーバ間は通信を中継しているだけであるため、VPNサーバ間の通信記録にユーザの情報は残らない。 
そのため極めて高い匿名性が確保される。 
 
極めて高い匿名性を提供するDouble VPNであるが、利用方法は簡単である。 
# Nord VPNのソフトウェアを起動する。 メイン画面左にある[Double VPN]を選択すると、自動的にDouble VPNで接続できる。
# 接続するVPNサーバを指定する場合は、[Double VPN]の右側にある[...]を選択する。
# [Double VPN]画面が開くので、[Country:]プルダウンと[Server:]プルダウンを選択する。 初期設定では、最適な国とサーバが自動的に選択される。
# [Country:]プルダウンでは1番目のサーバを選択して、[Server:]プルダウンでは2番目のサーバを選択する。 
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:Windows7]][[カテゴリ:Windows10]][[カテゴリ:Windows11]]

VPN - AirVPN

2026-03-24T14:00:02Z

Wiki:

== 概要 ==
AirVPNは、イタリアのペルージャを拠点とするプライバシー重視のVPNサービスである。 
 
2010年にアクティビスト、ハッカー、弁護士からなるグループによって設立され、2012年に専用企業「Air」として法人化された。 
現在の代表はPaolo Briniが務めている。 
 
2026年3月現在、23カ国に514台以上のサーバを展開しており、OpenVPN および WireGuard (2024年よりデフォルト) に対応している。 
暗号化方式はAES-256-GCMおよびChaCha20-Poly1305を採用している。 
 
クライアントソフトウェアであるEddieは、オープンソース (GPLv3ライセンス) として公開されており、VPN over Torに対応した数少ないVPNサービスの1つである。 
全てのサーバはRAMベースで動作しており、再起動時にデータが完全に削除される設計となっている。 
 
AirVPNのメリットは以下の通りである。 
* オープンソースのEddieクライアント (GPLv3)
*: クライアントのソースコードが公開されており、第三者によるコード監査が可能。
* VPN over Tor対応
*: Torネットワーク経由でVPNに接続することで、さらに高い匿名性を実現できる。
* RAMベースのサーバ設計
*: サーバ再起動時に全データが物理的に消去される。
* ノーログポリシー
*: 接続ログやIPアドレスを記録しない設計。
* ポートフォワーディング対応
*: P2P接続やリモートアクセス用途に使用できる。
* 暗号資産での支払いに対応
*: ビットコインその他の暗号資産で匿名支払いが可能。
* 検閲回避機能 (OpenVPN over SSH/SSL)
*: 深刻な検閲環境下でもVPN通信を偽装して接続できる。
 
AirVPNのデメリットは以下の通りである。 
* 14 Eyes同盟加盟国 (イタリア) に拠点
*: 情報共有の枠組みを持つ同盟加盟国に管轄されている。
* 独立した第三者監査が未実施
*: ノーログポリシーの技術的実装が外部から検証されていない。
* サーバ数が少ない (514台、大手は数千台以上)
*: 他の大手VPNサービスと比較してサーバ数が限られる。
* iOSの公式アプリが無い
*: iPhone / iPadユーザはOpenVPN Connectなどのサードパーティアプリを使用する必要がある。
* ライブチャットサポートが無い
*: サポートはフォーラムまたはチケット制のみとなる。
* ストリーミング対応が限定的
*: NetflixやDisney+などの地域制限コンテンツへのアクセスが保証されていない。
 

== 技術仕様 ==
==== 暗号化とプロトコル ====
AirVPNは、AES-256-GCM および ChaCha20-Poly1305による強力な暗号化を採用している。 
 
OpenVPNの仕様は以下の通りである。 
* TLS制御チャネルで強力な暗号化を実装している
* 対応TLS暗号スイート
*: TLS-DHE-RSA-WITH-CHACHA20-POLY1305-SHA256
*: TLS-DHE-RSA-WITH-AES-256-GCM-SHA384
* AES-128は非対応であり、デフォルトのOpenVPN設定よりも強力な暗号強度を維持している
* Diffie-Hellman鍵交換 (DHE) を採用し、4096ビットのDH/RSA鍵を使用している
* Perfect Forward Secrecy (PFS) を実装しており、60分ごとに鍵を再生成 (rekeying) する
 
WireGuardの仕様は以下の通りである。 
* 2021年10月にベータ版として導入された。
* 2024年2月にデフォルトプロトコルへ昇格した。
* ChaCha20-Poly1305による高速かつ強力な暗号化を提供する。
 
==== サーバ構成 ====
AirVPNのサーバ構成の詳細は以下の通りである。 
 
<center>
{| class="wikitable"
|+ AirVPNのサーバ構成
|-
! 項目 !! 詳細
|-
| 展開規模 || 23カ国に514台以上のサーバ(2026年3月現在)
|-
| RAMベース設計 || 全サーバがRAM上でのみ動作し、再起動時に全データが物理的に消去される。
|-
| サーバ形態 || 物理サーバのみを使用し、仮想サーバは使用しない。
|-
| 接続ポート || 53, 80, 443, 1194, 2018等に対応
|-
| プロトコル || OpenVPN TCP/UDPの両方に対応
|-
| 追加トンネル層 || SSL、SSHによる追加カプセル化に対応 (検閲回避機能)
|}
</center>
 
==== Eddieクライアントの機能 ====
下表に、Eddieクライアントが提供する主な機能を示す。 
 
<center>
{| class="wikitable"
! 機能名 !! 説明
|-
| Network Lock (キルスイッチ) || VPN接続が確立されていない場合、デバイスのインターネット通信を完全にブロックする。 意図しないIPアドレスの漏洩を防止する。
|-
| DNS保護 || AirVPNが管理するDNSサーバにリクエストを送信する。 第三者のDNSサーバは関与しない。
|-
| DNS漏洩検出 || システムが正しくDNSサーバをクエリしているかを確認し、DNS漏洩が発生していないことを検証する。
|-
| スプリットトンネリング || 特定のアプリケーションまたはドメインをVPN経由ではなく直接接続するよう設定できる。
|-
| ポートフォワーディング || P2P接続やリモートアクセスのためにポートを開放する設定が可能
|}
</center>
 
Eddieクライアントの対応プラットフォームは以下の通りである。 
* デスクトップ
*: Windows、MacOS、Linux
*: 最新バージョン
*: 2.24.6 (2025年1月)
* モバイル
*: Android 5.1以上
*: 最新バージョン: 3.3.0
* iOS
*: 公式アプリなし
*: OpenVPN Connectなどのサードパーティアプリを使用する必要がある
 

== AirVPNのノーログポリシーと信頼性 ==
==== ノーログポリシーの内容 ====
AirVPNが記録しないデータは以下の通りである。 
* VPN接続ログ
* ユーザのIPアドレス
* VPN IPアドレス
* 閲覧履歴
* トラフィック宛先
* データ内容
* DNSクエリ
 
技術的な設計の詳細は以下の通りである。 
* 接続に必要な技術データはRAMのみに一時保存され、接続終了時に自動削除される。
* マスストレージデバイス (SSD、HDD等) への記録は一切行わない。
* サーバ再起動時に全データが物理的に削除される。
 
独立監査については、現時点では未実施である。 
第三者による検証がなく、ノーログポリシーの技術的実装は外部から確認されていない。 
 
ワラントカナリアについては非公開となっている。 
ユーザからの導入要望はあるが、2026年3月現在も未実装である。 
 
==== 捜査機関へのデータ提供事例 ====
下表に、AirVPNに関連する捜査機関によるデータ提供の事例を示す。 
 
<center>
{| class="wikitable"
! 年 !! 事件 !! 結果
|-
| 2015年 || トロント警察サーバ押収 || 押収されたサーバからデータ回収なし。 ただし顧客への通知が大幅に遅延し、関連フォーラムスレッドが後に削除された。
|-
| 2020年 || FBIペンレジスター事件 || United States v. Klyushin事件で、FBIがAirVPNサーバにペンレジスター (接続記録装置) を設置した。 法廷証拠として使用された。
|-
| 2024年 || Piracy Shield拒否 || イタリアの海賊版対策規制 (Piracy Shield) への準拠を拒否し、イタリア市場から自発的に撤退した。 CEO Paolo Brini氏は「適切な司法命令なしに通信原則を侵害すべきではない」と明言した。
|}
</center>
 
==== イタリアの法的管轄 ====
AirVPNがイタリアに拠点を置くことによる法的管轄の影響は以下の通りである。 
* イタリアは14 Eyes同盟に加盟しており、他の加盟国 (米国等) と情報共有の枠組みがある。
* イタリアのISPは検索履歴を最大6年間保存する義務がある。
* AirVPNはGDPRに完全準拠する義務を負う。
* AirVPNは「政府要求に対してはEU裁判所に提訴する」と公言しているが、実際の訴訟実績は確認されていない。
* ノーログ設計のため、サーバ押収が発生しても提供可能なデータは存在しない可能性が高い。
 
==== 他のノーログVPNとの比較 ====
下表に、AirVPNと他の主要ノーログVPNサービスとの比較を示す。(2026年3月現在) 
 
<center>
{| class="wikitable"
! サービス名 !! 拠点 !! 情報共有同盟 !! 独立監査 !! 信頼性の根拠
|-
| Mullvad || スウェーデン || 9 Eyes || あり (2025年) || 警察捜索でデータなしを実証 (最強の実証)
|-
| Proton VPN || スイス || 非加盟 || あり (4年連続) || Securitumによる本番サーバ検査で準拠確認
|-
| NordVPN || パナマ || 非加盟 || あり (5回) || Deloitte等による監査
|-
| AirVPN || イタリア || 14 Eyes || なし || オープンソースだが外部検証なし
|}
</center>
 
==== 総合評価 ====
AirVPNのノーログポリシーに関する総合評価は以下の通りである。(2026年3月現在) 
 
信頼性を支持する要素は以下の通りである。 
* RAMベースのサーバ設計により、物理的にログ保存が困難な構造となっている。
* 完全オープンソースのクライアントにより、コード監査が可能
* 2015年のサーバ押収時にデータ回収不可だった実績がある。
 
信頼性を損なう要素は以下の通りである。 
* 14 Eyes加盟国 (イタリア) に拠点を置いている。
* 独立した第三者監査が実施されていない。
* 透明性レポートが公開されていない。
* ワラントカナリアが実装されていない。
* 2020年にFBIがサーバにペンレジスターを設置した事例がある。
 

== AirVPNの契約 ==
AirVPNの料金プランは以下の通りである。(2026年3月現在、支払いはユーロ建て) 
 
<center>
{| class="wikitable"
! プラン期間 !! 料金
|-
| 3日 || 2ユーロ
|-
| 1ヶ月 || 7ユーロ
|-
| 3ヶ月 || 15ユーロ
|-
| 1年 || 49ユーロ
|-
| 2年 || 79ユーロ
|-
| 3年 || 99ユーロ
|}
</center>
 
支払い方法はクレジットカード、PayPal、Stripe、Amazon Pay、ビットコインおよびその他暗号資産に対応している。 
また、30日間の返金保証が設けられている。 
 
AirVPNの契約手順を以下に記載する。 
 
# [https://airvpn.org AirVPNの公式Webサイト]へアクセスして、[Get AirVPN]を選択する。
# もし、アカウントを持っている場合はログインする。アカウントが無ければ、[Create an account]を選択してアカウントを作成する。
# アカウントの作成後、再度、[Get AirVPN]を選択して、[Subscribe]を選択する。
# プランを選択する画面に遷移するので、プランを選択して[Proceed to Checkout]を選択する。 支払いは円やドルではなくてユーロとなることに注意すること。
# 支払い画面に遷移するので、支払い方法を選択する。 ※注意 クレジットカードは否決される可能性があるため、PayPalか仮想通貨での支払いを推奨する。 
# 各OS用のAirVPNソフトウェアをダウンロードする。 32ビットまたは64ビットの選択、インストーラまたはポータブル、GUIまたはCUIを選択して、[DOWNLOAD]を選択する。 または、[https://airvpn.org/download/ 公式Webサイト]から個別にダウンロードすることもできる。
 

== AirVPNソフトウェアのインストール ==
AirVPNソフトウェアのインストール手順を以下に記載する。 
 
# 上記のセクションでダウンロードしたAirVPNソフトウェアをインストールおよび実行する。
#: Eddie-UIファイルがAirVPNソフトウェアである。
# AirVPNソフトウェアを実行すると、ログイン名とパスワードを入力する画面が表示される。
#: ログイン情報を入力して、[Login]ボタンを押下する。
# 利用規約が表示されるので、了承する場合はチェックボックスにチェックを入力して、[Accept]ボタンを押下する。
# メイン画面左にある[Servers]タブを選択すると、利用可能なVPNサーバが表示される。([Letency]でソートすると日本のサーバが一番上に現れる)
# メイン画面左にある[Countries]タブを選択すると、VPNサーバのロケーションからも選択することができる。
 

== AirVPNの設定 ==
AirVPNには、最初からVPN over Torおよび検閲回避機能のための設定項目がある。 
 
==== VPN over Torの設定 ====
VPN over Torとは、Torネットワーク経由でVPNサーバに接続する方式である。 
通常のVPN接続では「ユーザ → VPN → インターネット」の経路となるが、VPN over Torでは「ユーザ → Tor → VPN → インターネット」の経路となる。 
これにより、VPNプロバイダであるAirVPNに対してもユーザの実際のIPアドレスを隠すことができる。 
 
VPN over Torの設定手順は以下の通りである。 
 
# AirVPNソフトウェアのメイン画面左下にある設定アイコンを選択する。
# 設定画面左にある[Proxy / Tor]タブを選択して、[Type:]プルダウンから[Tor]を選択する。
# 設定画面下にある[Save]ボタンを押下して、設定を保存する。
# 設定の保存後、[Test]ボタンを押下して、"Successfull test"メッセージが出力されれば正常に動作している。
 
==== 検閲回避機能 (OpenVPN over SSH/SSL) の設定 ====
OpenVPN over SSH/SSL は、VPN通信をSSHまたはSSLトンネルでカプセル化することで、深刻な検閲環境下でもVPN接続を維持するための機能である。 
VPNポートをブロックするファイアウォールやDPI (Deep Packet Inspection) を回避する目的で使用する。 
 
設定手順は以下の通りである。 
 
# AirVPNソフトウェアのメイン画面左下にある設定アイコンを選択する。
# 設定画面左にある[Protocols]タブを選択する。
# 接続プロトコルの一覧から、[OpenVPN over SSH] または [OpenVPN over SSL]を選択する。
# 設定画面下にある[Save]ボタンを押下して、設定を保存する。
# メイン画面から任意のサーバを選択して接続し、正常に接続できることを確認する。
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,Podman,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:Windows7]][[カテゴリ:Windows10]][[カテゴリ:Windows11]]

VPN - Windscribe VPN

2026-03-24T13:30:11Z

Wiki:

== 概要 ==
Windscribe VPNは、カナダに本社があり、プライバシーを守りながらインターネットを利用できるようにサポートすると約束している。 
また、無料版のVPNサービスも提供しており、毎月のデータ通信量が10[GB]なので多数のユーザが使用している。 
 
Pro版(有料版)では、データ通信量に制限が無く、サーバは69か国以上、115都市以上に配置されている。 
また、Pro版では、ポートフォワーディング機能も利用できる。 
 
R.O.B.E.R.Tという高度な機能も存在しており、ドメインを任意のIPアドレスに変更でき、信頼できないIPアドレスやIPネットワークをブロックすることができる。 
 
TorrentやTor over VPNも使用でき、アメリカのNetflixをストリーミングすることもできる。 
 
Netflixのストリーミングについては、以前はアメリカのNetflixのみ対応していたが、2026年現在では32以上のNetflix地域に対応している。 
 
下表に、Windscribe VPNの特徴を示す。 
 
<center>
{| class="wikitable"
|+ Windscribe VPNの主な機能
|-
! 機能 !! 説明
|-
| 大規模ネットワーク || 69カ国以上、115都市以上にサーバを設置
|-
| R.O.B.E.R.T. || 全てのデバイスで選択したIPとドメイン (広告) をブロック
|-
| ノーログポリシー || IPとタイムスタンプから個人を特定することはできない。 2025年4月のギリシャ法廷において、ノーログポリシーが法的に実証されている。 詳細は、[[VPN_-_Windscribe_VPN#ノーログポリシーの検証|"ノーログポリシーの検証"]]セクションを参照すること。
|-
| 暗号化 || AES 256暗号とSHA512認証、4096ビットのRSA鍵を使用している。
|-
| 設定ジェネレータ || 全てのデバイス用にOpenVPN、IKEv2、WireGuard設定を生成する。
|-
| ポートフォワード || 社内リソースに安全にアクセスする。
|-
| スプリットトンネリング || VPNを経由するアプリと経由しないアプリを選択が可能である。
|}
</center>
 
Windscribeが収集している情報は以下の通りである。 
* 30日間で送受信されたデータ量(バイト)
* Windscribeネットワークでの最後の利用のタイムスタンプ
 
このようなデータが収集される理由は、無料ユーザの通信量を制限するためとネットワークの悪用を防ぐためである。(標準的なプライバシーポリシー) 
また、Windscribeは、個人を特定できる情報を入力しなくてもいいようにしており、アカウント作成に必要な情報はユーザ名とパスワードのみである。 
 
2021年以降、Windscribeは全サーバをRAM-only構成 (FreshScribeインフラ) に移行しており、 
サーバが押収または再起動された場合、全てのデータが自動的に消去される設計となっている。 
 

== ノーログポリシーの検証 ==
Windscribe VPNはノーログVPNを謳っているが、その信頼性は複数の観点から検証されている。 
 
==== 記録するデータと記録しないデータ ====
Windscribeの公式プライバシーポリシーでは、以下に示すデータを記録しないと宣言している。 
* 接続ログ (Connection logs)
* IPアドレスとタイムスタンプ (IP timestamps)
* セッションログ (Session logs)
* 閲覧履歴 (Browsing history)
* 個人識別情報 (Personally identifiable information)
 
一方、以下の最小限のデータのみを保持している。 
* 30日間で送受信されたデータ量 (バイト)
*: 無料プランのデータ制限を実施するために必要である。
* 最終アクセス日時
*: アカウント管理目的で使用される。
 
VPN接続中は、サーバ側で接続ユーザ名、接続時間、データ転送量を一時的に保有するが、接続が切断された直後に即座に破棄される。 
 
==== 法廷での実証 (2025年4月ギリシャ) ====
2025年4月、ギリシャのアテネ裁判所において、Windscribeのノーログポリシーが法的に実証された。 
 
この事件では、未知のユーザがWindscribeのフィンランドサーバを使用してギリシャ国内のWebサイトに不正アクセスおよびスパムメール送信を行った疑いがあり、 
WindscribeのCEOであるYegor Sakが告発された。 
 
2年間の訴訟の結果、WindscribeがユーザのIPアドレスやアクティビティのログを保持しておらず、ユーザを特定するデータが存在しないことが証明され、ケースは却下された。 
これにより、ノーログポリシーが有効な法的防御として機能することが法的に検証された画期的な判例となった。 
 
==== 透明性レポート ====
Windscribeは、リアルタイムで更新される[https://windscribe.com/transparency 透明性レポート]を公開している。 
 
2018年以降、100件以上の法執行機関からのデータ要求を受領しているが、ユーザデータの提出実績は0件である。 
これは、記録していないデータを提供することが不可能であるためである。 
DMCA (デジタルミレニアム著作権法) に基づくデータ要求に対しても、同様に0件の提出実績である。 
 
なお、Windscribeはワラントカナリーを採用しておらず、代わりにリアルタイムの透明性レポートで対応している。 
 
==== 第三者監査 ====
Windscribeは複数の第三者監査を実施しており、結果は公開されている。 
 
<center>
{| class="wikitable"
|+ Windscribeの第三者監査実績
! 実施時期 !! 監査機関 !! 対象 !! 結果
|-
| 2021年9月 || Leviathan Security Group || デスクトップアプリケーション || 指摘事項5件 - 全て解決済み
|-
| 2022年3月 || Leviathan Security Group || モバイルアプリケーション (Android / iOS) || 指摘事項あり - 全て解決済み
|-
| 2024年6月 || Packetlabs || FreshScribeインフラ (約80,000行のコード、20のリポジトリ) || ノーログポリシーへの意図的な破壊は検出されず
|}
</center>
 
全アプリケーションのソースコードは[https://github.com/Windscribe GitHub]で公開されており、透明性が確保されている。 
 
==== セキュリティインシデント ====
===== ウクライナサーバ押収 (2021年6月) =====
2021年6月、ウクライナ当局がWindscribeのウクライナ拠点のVPNサーバ2台を押収した。 
 
この事件では、以下の深刻なセキュリティ上の欠陥が明らかになった。 
* サーバディスク上にOpenVPN秘密鍵が平文で保存されていた。
* X.509証明書検証が未実装であり、攻撃者が任意のWindscribeサーバになりすまし可能な状態であった。
* サーバ自体のディスク暗号化が実装されていなかった。
 
ユーザデータそのものはノーログポリシーにより危険にさらされなかったが、特定の条件下では通信内容のリアルタイム傍受が可能な状態であったことが問題視された。 
 
Windscribeはインシデント後4週間以内に以下の改善措置を実施した。 
* 全VPNサーバをRAM-only (メモリのみ) 構成に移行
* 新しいOpenVPN認証局 (CA) の導入
* サーバ証明書の有効期限を90日に短縮し、75日ごとにローテーション
* X.509拡張キー属性検証をクライアントレベルで実装
 
===== オランダサーバ押収 (2026年2月) =====
2026年2月、オランダ当局がWindscribeのサーバ1台を令状なしで押収した。 
2021年の事件とは異なり、RAM-onlyサーバ構成であったため、押収されたサーバから回収されたデータは標準的なUbuntuインストールのみであった。 
ユーザデータの漏洩は確認されていない。 
 
ただし、Citizen Labのセキュリティ研究者は、RAM-onlyサーバの技術的限界として、 
ホットプラグインターフェースを使用すれば電源を遮断せずにサーバを押収でき、メモリダンプによりセッションデータを抽出できる可能性を指摘している。 
 
==== Five Eyes同盟国としてのカナダ管轄 ====
Windscribeはカナダ (オンタリオ州) に本社を置いており、カナダはFive Eyes (米国、カナダ、英国、オーストラリア、ニュージーランド) 同盟国の1つである。 
 
Five Eyesに関する懸念と、Windscribeの公式見解を以下に示す。 
* カナダの法律はVPNプロバイダにデータ保持を義務付けていない。
*: Five Eyes加盟国のデータ保持指令はISPに適用されるものであり、VPNプロバイダには適用されない。
* データが存在しなければ提供不可能
*: ノーログポリシーの実装により、法的要求があってもユーザデータを提供できない。
* 法律が変更される可能性
*: CEO自身が「プライバシーポリシーを維持できなければカナダを離れる」と述べている。
 
なお、最高レベルのプライバシーを求める場合は、5 Eyes管轄外のVPN (例: Mullvad / スウェーデン、ProtonVPN / スイス) も選択肢として検討する価値がある。 
 
==== 他社VPNのノーログ違反事例との比較 ====
VPN業界では、ノーログを謳いながら実際に法執行機関にユーザデータを提供した事例が複数存在する。 
Windscribeはこれらの事例には含まれておらず、法廷でノーログが証明された数少ないVPNの1つである。 
 
<center>
{| class="wikitable"
|+ ノーログ違反が確認されたVPN事例
! VPN !! 年 !! 事件概要
|-
| PureVPN || 2017年 || FBIにサイバーストーカー容疑者のIP・接続ログを提供
|-
| IPVanish || 2016年 || 米国国土安全保障省に児童ポルノ容疑者の接続ログ・メール・氏名を提供
|-
| HideMyAss || 2012年 || 英国法院命令によりLulzSecメンバーの接続ログを提供
|-
| EarthVPN || 2014年 || オランダ警察がデータセンターのIP転送ログから爆弾脅迫犯を特定
|-
| UFO VPN || 2020年 || 数百万件のユーザログ (IPアドレス、メール、パスワード) がオンラインに露出
|}
</center>
 

== Windscribe VPNの契約方法 ==
Windscribe VPNの契約手順を以下に記載する。 
 
# [https://windscribe.com/ Windscribe VPNの公式Webサイト]へアクセスして、アカウント作成またはログインする。
# トップページ上部にある[Pricing]を選択する。
# 月間または年間のプランを選択して、[Buy Now]を選択する。
# [Select Payment Method]では、支払い方法(クレジットカード、PayPal、仮想通貨等)を選択して、[Continue]を選択する。
 
Windscribe VPNの料金は、年間69ドル (月額換算で約5.75ドル)、1ヶ月9ドルである。(2026年3月現在) 
また、カスタムプラン (Build A Plan) として、1ロケーションあたり月額1ドルで最低3ドルから購入可能なプランも存在する。 
 

== Windscribe VPNの返金保証 ==
Windscribe VPNの返金保証は他社と比較するとかなり制限が厳しい。 
サービスに加入してから3日以内に返金を請求しないといけない。 
 
返金を請求するにはプランを購入してから3日以内にサポートデスクからリクエストを送信する必要がある。 
また、10[GB]以上データ通信してしまうと返金の対象外になるので注意が必要である。 
 

== Windscribe VPNソフトウェアのインストール ==
==== RPMファイルから直接インストールする場合 ====
[https://windscribe.com/guides/linux/ Windscribe VPNの公式Webサイト]から、GUIソフトウェアをダウンロードする。 
ダウンロードしたファイルをインストールする。 
 
# RHEL
sudo dnf install ./windscribe_<バージョン>_x86_64.rpm

# SUSE
sudo zypper install ./windscribe_<バージョン>_x86_64.rpm
 
==== ソースコードからインストールする場合 ====
Windscribe VPNのGUIソフトウェアのビルドに必要なライブラリをインストールする。 
 
RHELでは、一部のパッケージがCRB (Code Ready Builder) リポジトリに含まれるため、事前にリポジトリを有効化する必要がある。 
 
# RHEL
## RHEL 9
sudo subscription-manager repos --enable codeready-builder-for-rhel-9-x86_64-rpms

## RHEL 10
sudo subscription-manager repos --enable codeready-builder-for-rhel-10-x86_64-rpms

sudo dnf install make cmake pkg-config autoconf libtool fakeroot golang python3 python3-pip python3-colorama python3-pyyaml \
libcap-ng-devel fontconfig-devel freetype-devel libnl3-devel pam-devel mesa-libGL-devel \
libX11-devel libXext-devel libXfixes-devel libXi-devel libXrender-devel libxcb-devel libXcursor-devel xcb-util-cursor-devel \
xcb-util-keysyms-devel xcb-util-image-devel xcb-util-wm-devel libXfixes-devel libXrandr-devel xcb-util-renderutil-devel xcb-util-devel \
libXinerama-devel libxkbcommon-devel libxkbcommon-x11-devel

# SUSE
sudo zypper install make cmake pkg-config autoconf libtool fakeroot go python3 python3-pip python3-colorama python3-PyYAML \
libcap-ng-devel fontconfig-devel freetype2-devel libnl3-devel pam-devel Mesa-libGL-devel \
libX11-devel libXext-devel libXfixes-devel libXi-devel libXrender-devel libxcb-devel libXcursor-devel xcb-util-cursor-devel \
xcb-util-keysyms-devel xcb-util-image-devel xcb-util-wm-devel libXfixes-devel libXrandr-devel xcb-util-renderutil-devel xcb-util-devel \
libXinerama-devel libxkbcommon-devel libxkbcommon-x11-devel
 
[https://github.com/Windscribe/Desktop-App/ Windscribe VPNのGithub]にアクセスして、GUIソフトウェアのソースコードをダウンロードする。 
ダウンロードしたファイルを解凍する。 
tar xf Desktop-App-<バージョン>.tar.gz
cd Desktop-App-<バージョン>
 
tools/depsに移動して、以下に示すシェルスクリプトを実行する。 
ビルドされたライブラリは build-libsディレクトリに配置される。 
Qt 6をビルドする場合、check_for_ulimitに関するエラーが発生する場合は、CMakeのバージョンを3.24にダウングレードすること。 
install_openssl_ech_draft
install_qt
install_cares
install_curl
install_boost
install_lzo
install_openvpn
install_wireguard
install_stunnel
 
toolsディレクトリに移動して、build_allファイルを実行する。ビルドされたインストーラがbuild-exeディレクトリに配置される。 
その他のビルドオプションについては、<code>build_all --help</code>コマンドを実行して参照すること。 
 
Windscribe VPNのGUIソフトウェアは、/opt/windscribeディレクトリにインストールされる。 
 
このソフトウェアの動作ログは ~/.local/share/Windscribe/Windscribe2ディレクトリに保存されている。 
 

== WireGuard ==
WireGuardは、プロ版の機能である。 
[https://nld.windscribe.com/getconfig/wireguard Windscribeの公式Webサイト]にあるページ上部からログインすること。 
 

== ポートフォワーディング ==
ポートフォワーディング機能により、Windscribeに接続したまま、ユーザのデバイスやホームネットワーク上のサービスにリモートでアクセスすることができる。 
これには以下のようなものが含まれる。 
* Plexサーバ
* ホームセキュリティカメラ
* NAS
* Torrentクライアント
* Webサーバ
 
ポートフォワーディングには複数のメリットがある。 
* ユーザの接続の保護
*: ユーザは、Windscribeのクライアントに接続したままで、全てのメリットを得ることができる。
* 外部IPが公開されない
*: リソースにアクセスするためにISPから割り当てられたIPを使用する必要がない。
*: これらのIPは常に変更される。静的IPはそうではない。
* 無料のDDoS保護
*: DDoS攻撃を受けても、Windscribeのサーバが攻撃を防御する。
* Torrentシーディング
*: 最適なアップロード速度を得るには、ポートフォワーディング機能が必要である。
 
全てのプロ版ユーザは、一時的なポートフォワーディングを利用できる。 
恒久的なポートフォワーディングを利用するには、[https://windscribe.com/staticips 静的IP]または[https://windscribe.com/staticips レジデンシャルIP]を購入する必要がある。 
その後、Windscribe VPNのCUI / GUIソフトウェアを使用するか、または、手動で設定するかの2つの方法がある。 
 
ポートフォワーディング機能の設定の詳細を知りたい場合は、[https://windscribe.com/knowledge-base/articles/setting-up-port-forwarding Windscribeの公式Webサイト]を参照すること。 
 
※免責事項 
設定したIPとポートにアクセスできるのは、許可された当事者だけであることを確認するのはユーザの責任である。 
ローカルデバイスで認証を行わずにポート転送を使用した場合、単純なポートスキャンによってインターネット上の誰でもデバイスにアクセスすることができる。 
Windscribeは、ユーザの内部サービスにおいて、認証が不十分であることにより発生する損失や損害に対して責任を負わない。 
 

== Tor over VPN ==
VPNネットワーク経由でTorに接続する方法であり、Torは終了ノードになる。(Tor over VPN) 
 
# [[VPN_-_Windscribe_VPN#Windscribe_VPNの設定|"Windscribe VPNの設定"]]セクションを参照して、VPNに接続する。
# [https://www.torproject.org/download/ Torブラウザの公式Webサイト]にアクセスして、Torブラウザをダウンロードおよびインストールする。
# Torブラウザを起動して、[Connect]ボタンを押下する。 Torブラウザの設定はデフォルトのままでよい。
 

== VPN over Tor ==
Windscribe VPNは、VPN over TORをサポートしていない。 
VPN接続、または、Tor over VPN接続のみが使用できることに注意する。 
 

== Torrentの使用 ==
Windscribe VPNは、ほとんどの接続先サーバでトレントを許可している。 
サーバ選択メニューでは、P2Pファイル共有に使用してはいけないサーバが明記されており、このようなサーバはP2PアイコンにX印が付いている。 
 
==== 設定 ====
Torrentプロトコルは、以下の手順でより安全に使用できる。 
 
qBittorrentクライアントの設定のみ記載する。 
これは、uTorrent、Vuze、BitComet等のクライアントは、オープンソースではなく、アドウェアやジャンクウェアが含まれていたり、優れたプライバシー設定が施されていないためである。 
 
※注意 
WireGuardとOpenVPNを切り替えた場合、ネットワークインターフェイスを再バインドして、qBittorrentを再起動する必要がある。 
また、SOCKS5を使用している場合は、WireGuardまたはOpenVPNの使用に応じて、IPアドレスを変更する必要がある。 
 
# Windscribe VPNを接続する。
# qBittorrentを起動して、[ツール]メニューバー - [設定]メニューを選択する。
# [設定]画面左ペインにある[高度]を選択する。
# [設定]画面右ペインにある[ネットワークインターフェイス]を、使用しているソフトウェアとプロトコルに応じて、次のいずれかに変更する。
#* OpenVPNを使用したWindscribe VPNソフトウェア (Windscribe VPNソフトウェアからOpenVPNで接続している場合)
#*: tun0
#* OpenVPNスタンドアロン (NetworkManagerからOpenVPNで接続している場合)
#*: tun0
#* WireGuardを使用したWindscribe VPNソフトウェア (Windscribe VPNソフトウェアからWireGuardで接続している場合)
#*: 
# [バインドする任意のIPアドレス]プルダウンから、Windscribe VPNで接続しているIPアドレスを選択する。
# [OK]ボタンを押下する。
# [ファイル] - [終了]を選択してqBittorrentを終了して、qBittorrentを再起動する。
 
qBittorrentの推奨設定を、以下に示す。 
# qBittorrentを起動して、[ツール］ - [設定]を選択する。
# [設定]画面左ペインにある[BitTorrent]を選択する。
# [設定]画面右ペインにある[匿名モードを有効にする]を選択する。
# [DHT(分散ネットワーク)を有効にする]チェックボックスのチェックを外す。
# [ピア交換(PeX)を有効にする]チェックボックスのチェックを外す。
# [ローカルピア検出(LSD)を有効にする]チェックボックスのチェックを外す。
# [設定]画面左ペインにある[接続]を選択して、[ピア接続プロトコル]プルダウンから[TCP]を選択する。
 
==== ポートフォワーディング (ポート転送) ====
qBittorrentを起動して、[接続] - [受信接続に使用するポート]にポートを追加する。 
これにより、シードが向上する可能性がある。 
 
ただし、SOCKS5が有効な場合、この機能は無効になることに注意する。 
 
Bittorrentクライアントへのポートフォワーディングの詳細を知りたい場合は、ポートフォワードガイドを参照すること。 
 

== その他 ==
==== Windscribe VPNは中国で利用可能 ====
近年では、中国政府は中国国内でのVPNの使用を厳しく取り締まっており、結果的に中国のファイアウォールを通過できるVPNは少なくなっている。 
多くのユーザから、Windscribeは中国で利用できるという声が届いており、中国のような規制の厳しい環境でも接続できる機能がある。 
 
Windscribeは、OpenVPN通信を安全なTLSで隠すステルスVPNモードがあり、中国で利用する場合はこのモードを有効にする。 
中国で他のプロトコルが利用できない場合、WindscribeはWstunnelモードがあり、これはOpenVPN通信をWebソケットで覆うモードである。 
 
2026年2月には、ディープパケット検査 (DPI) を迂回するために設計された新しいステルスVPNアプリが開発されている。 
このアプリはAmneziaWG (Amnezia WireGuard) のネイティブサポートを採用しており、イランやロシア等の検閲が厳しい地域での利用を主な目的としている。 
2026年3月現在、Androidベータ版として提供されている段階である。 
 
WindscribeのFAQでは、中国でVPNが使用できない場合は、サポートに問い合わせるように推奨している。 
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:Windows7]][[カテゴリ:Windows10]][[カテゴリ:Windows11]]

VPN - Proton VPN

2026-03-24T12:55:09Z

Wiki:

== 概要 ==
Proton VPNは、プライバシーを重視した多彩なアーキテクチャ、高度なセキュリティ特性、確かな性能を備えた機能豊富なVPNである。 
 
WindowsおよびMac OSと同様、Linux向けにもGUIソフトウェアを提供しており、機能の有効化とサーバへの接続を簡単に行うことができる。 
GUIソフトウェアは、全ての主要なLinuxディストリビューション（RedHat系、Debian系、Manjaro、Arch系）に対応している。 
 
2026年3月現在、Proton VPNは、110カ国以上で18,000台以上のサーバを提供しており、プライバシーに配慮したスイスに拠点を置いている。 
それは、トラフィックが厳格なプライバシー法で保護されている多数の厳しいサーバを通過することを意味する安全な接続を提供している。 
 
それらの機能には、厳格なノーログポリシー、キルスイッチ、広告ブロッカー等も含まれている。
 
高レベルのセキュリティとともに、Proton VPNは、ユーザのオンラインアクティビティを傍受しないことを確認する暗号化の業界標準形式であるAES-256暗号を実装している。 
これは、ユーザの匿名性を維持するだけでなく、地理的に制限されたストリーミングプラットフォームや他のコンテンツのブロックを解除するのに役立つ。 
 
Proton VPNのメリットを以下に示す。 
* 直感的なユーザインターフェイス
* 広告ブロック機能(NetShield)
* 厳格なノーログポリシー
* DNSリーク防止機能
* キルスイッチ
* 30日間返金保証
 
Proton VPNのデメリットを以下に示す。 
* ライブチャットは有料プランのみ対応 (無料プランは非対応)
* 無料サーバはTorrentをサポートしない。
 

== Proton VPNのノーログポリシーと信頼性 ==
Proton VPNは厳格なノーログポリシーを掲げており、独立した第三者機関による監査によってその実態が検証されている。 
ここでは、ノーログポリシーの内容、捜査機関への対応実績、法的管轄の特性、および他社との比較について記載する。 
 
==== ノーログポリシーの内容 ====
Proton VPNが記録しないデータを以下に示す。 
* VPN接続ログ
* ユーザのIPアドレス
* セッション長
* 位置情報
* ネットワークトラフィック内容
 
例外的に記録される可能性があるデータを以下に示す。 
* 不正行為対策の一時的IPログ (期間限定)
* 利用規約違反 (DDoS、スパム等) 検出時のIPアドレス (永続的)
* ユーザが自ら有効化した認証ログ (デフォルトOFF)
 
独立監査については、Securitum (ポーランド) による4年連続の監査に合格している。(最新: 2025年8月) 
本番サーバへの直接アクセスによる技術検証で ノーログポリシーに完全準拠 と結論付けられた。 
 
監査で確認された管理体制を以下に示す。 
* 自動化検出ツール (Infra Auditシステム)
* デュアルコントロール変更管理 (2名のシニアエンジニア承認必須)
* 自動構成管理
 
==== 捜査機関へのデータ提供事例 ====
重要な前提として、問題が起きたのは全てProton Mail側であり、Proton VPN側では提供できるデータがないため事例は報告されていない。 
 
下表に、Proton Mail側の事例を示す。 
 
<center>
{| class="wikitable"
! 年 !! 事件名 !! 概要
|-
| 2021年 || フランス活動家事件 || ProtonMailユーザのIPアドレスを提供 フランス警察→Europol→スイス当局→Protonの経路で法的命令。 事件後、Protonは「IPアドレスを記録しない」という記載をWebサイトから削除
|-
| 2024年 || カタルーニャ独立活動家事件 || 復旧用メールアドレス (Apple iCloud) を提供 Apple経由で本名・住所が特定された。
|-
| 2024年 || Stop Cop City事件 (米国) || 支払いデータ (クレジットカード識別子) を提供 MLAT (相互法的支援条約) 経由でFBIが身元特定
|}
</center>
 
Proton VPN側の実績として、2025年6月までに29件の法執行機関からの要求があったが、全て 提供できるデータなし として却下している。 
 
透明性レポートによると、2017〜2025年の累計で45,667件の要求を受け、40,389件に対応している (対応率約90%)。 
ただし対応したのはメール等のメタデータであり、VPN接続ログは含まれない。 
 
==== スイスの法的管轄 ====
スイスの法的管轄に関する特性を以下に示す。 
* スイスは14 Eyes同盟に非加盟
* 現行スイス法ではVPNプロバイダーにデータ保持義務なし
* スイス当局からの正式な法的命令には従う義務あり (スイス刑法第271条)
* ただしスイス連邦情報局 (NDB) は100以上の国際情報機関と接触を保有
 
==== VÜPF改正 ====
スイス司法警察省が推進中の郵便・電気通信トラフィック監視令 (VÜPF) の改正が、現在最大の懸念事項となっている。 
 
提案内容を以下に示す。 
* ユーザ数5,000人以上のVPN / メールサービスに対して以下を義務化
*: IPアドレスログの6ヶ月保持
*: ユーザ識別
*: 当局要請時の復号化能力 (バックドア) 構築
* 議会での標準的な議論をスキップし行政令として推進
 
Protonの対応として、国連フォーラムで本改正案を批判するとともに、インフラの大部分をスイス国外へ移転する段階的計画を2025年に開始している。 
 
==== 他のノーログVPNとの比較 ====
下表に、主要なノーログVPNの比較を示す。 
 
<center>
{| class="wikitable"
! サービス名 !! 拠点 !! 信頼性の根拠
|-
| Mullvad || スウェーデン || 2023年に警察が本社を強制捜索 データ一切なし (最強の実証)
|-
| Proton VPN || スイス || 4年連続の第三者監査合格 ただしVÜPF改正リスクあり
|-
| NordVPN || パナマ || 複数回の独立監査合格 14 Eyes同盟の影響外
|-
| ExpressVPN || 英領ヴァージン諸島 || 2016年トルコ政府のサーバ押収時にデータ提供不可を実証
|}
</center>
 
==== 総合評価 ====
Proton VPNに関する総合評価を以下に示す。(2026年3月現在の情報) 
 
* Proton VPNは、現時点では、本当のノーログVPNと言える。
* 4年連続の独立監査で検証済み、VPN側で捜査機関にデータを提供した事例なし
* Proton MailとVPNは別サービス (Mailでは複数回データ提供実績あり)
* スイスのVÜPF改正法が最大のリスク (施行されればノーログポリシー維持が法的に不可能)
* メタデータ (支払い情報、復旧メール等) は保護対象外
* 最強の実績を求めるならMullvad VPNが最も実証済み
 

== Proton VPNの契約 ==
Proton VPNの契約手順を以下に記載する。 
 
# [https://protonvpn.com Proton VPNの公式Webサイト]へアクセスして、ページ右上にある[Create free account]を選択する。
# VPNのプランを選択する。
# Protonのアカウントを作成する。
# クレジットカード、PayPal、ビットコイン等のいずれかを選択して、金額を支払う。
# Eメールアドレスを入力して、[購入を完了]または[〜へ進む]を選択する。
# 支払いが完了した後、遷移先のページにユーザ名とパスワードが表示される。 入力したEメールアドレスがアカウントのIDとして登録される。 また、Eメールアドレスにサブスクリプションを回復する時のトークンが送付されるので、大切に保管すること。
# アカウントのパスワードの変更画面が自動的に立ち上がるため、任意のパスワードに変更する。
#: パスワードにおいて、$、*、%、[、] の文字は使用できない。
# 自動的にアカウントページに遷移するので、[アプリをダウンロード]を選択して、Proton VPNソフトウェアをダウンロードする。
#: Proton VPNソフトウェアは、Windows、MacOS、Linux、Android、iOSに対応している。
#: また、ブラウザの拡張機能はChrome、Firefoxが対応している。
 
Proton VPNでは、1ヶ月9.99ドル、1年間47.88ドル (月あたり3.99ドル)、2年間71.76ドル (月あたり2.99ドル) の料金である。(2026年3月現在) 
 

== Proton VPNのインストール ==
==== ビルドに必要なライブラリのインストール ====
# RHEL
sudo dnf install gtk3-devel gobject-introspection-devel python3-devel libsecret-devel systemd-devel \
libappindicator-gtk3 gnome-keyring \
python3-requests python3-pyOpenSSL python3-bcrypt python3-cairo python3-gobject \
python3-psutil python3-pyxdg \
python3-keyring python3-jinja2 python3-distro python3-gnupg python3-dbus python3-systemd

# SUSE
sudo zypper install gtk3-devel gobject-introspection-devel python3-devel libsecret-devel systemd-devel \
libappindicator3-1 gnome-keyring \
python3-requests python3-pyOpenSSL python3-bcrypt python3-pycairo python3-gobject \
python3-gobject-cairo python3-psutil python3-dataclasses python3-pyxdg \
python3-keyring python3-Jinja2 python3-distro python3-python-gnupg python3-dbus-python python3-systemd
 
==== Proton VPNの実行に必要なライブラリのインストール ====
# RHEL
sudo dnf install gtk3 dbus-x11 xdg-utils libsecret \
python3-requests python3-pyOpenSSL python3-bcrypt python3-cairo python3-gobject \
python3-psutil python3-pyxdg \
python3-keyring python3-jinja2 python3-distro python3-gnupg python3-dbus python3-systemd
# Proton VPN GUIの動作に必要
webkit2gtk3

# SUSE
sudo zypper install libgtk-3-0 dbus-1-x11 xdg-utils libsecret-1-0 \
python3-requests python3-pyOpenSSL python3-bcrypt python3-pycairo python3-gobject \
python3-gobject-cairo python3-psutil python3-dataclasses python3-pyxdg \
python3-keyring python3-Jinja2 python3-distro python3-python-gnupg python3-dbus-python python3-systemd
# Proton VPN GUIの動作に必要
libwebkit2gtk-4_0-37 webkit2gtk-4_0-injected-bundles typelib-1_0-WebKit2-4_0
 
==== 前提条件 ====
<code>pip3</code>コマンドを使用せずにインストールする場合、先にインストールディレクトリを作成する必要がある。 
この時、インストールディレクトリ名は、/<Proton VPNのインストールディレクトリ>/lib/python<Pythonのバージョン>/site-packages としなければならない。 
mkdir -p /<Proton VPNのインストールディレクトリ>/lib/python<Pythonのバージョン>/site-packages
例. mkdir -p /<Proton VPNのインストールディレクトリ>/lib/python3.6/site-packages
 
インストールディレクトリを作成していない場合は、ビルドエラーが起きる。 
 
==== Proton VPNクライアントのインストール ====
[https://github.com/ProtonMail/proton-python-client Proton VPNクライアントのGithub]にアクセスして、ソースコードをダウンロードする。 
ダウンロードしたファイルを解凍する。 
tar xf proton-python-client-<バージョン>.tar.gz
cd proton-python-client-<バージョン>
 
または、<code>git clone</code>を使用して、ソースコードをダウンロードする。 
git clone https://github.com/ProtonMail/proton-python-client.git
cd proton-python-client
 
Proton VPNクライアントをインストールする。 
export PYTHONPATH="/<Proton VPNのインストールディレクトリ>/lib/python<Pythonのバージョン>/site-packages:$PYTHONPATH"
python3 ./setup.py build
python3 ./setup.py install --prefix=<Proton VPN GUIのインストールディレクトリ>

# または

sudo pip3 install -e .
 
==== Proton VPNライブラリのインストール ====
[https://github.com/ProtonVPN/protonvpn-nm-lib Proton VPNライブラリのGithub]にアクセスして、ソースコードをダウンロードする。 
ダウンロードしたファイルを解凍する。 
tar xf protonvpn-nm-lib-<バージョン>.tar.gz
cd protonvpn-nm-lib-<バージョン>
 
または、<code>git clone</code>を使用して、ソースコードをダウンロードする。 
git clone https://github.com/ProtonVPN/protonvpn-nm-lib.git
cd protonvpn-nm-lib
 
Proton VPNライブラリをインストールする。 
export PYTHONPATH="/<Proton VPNのインストールディレクトリ>/lib/python<Pythonのバージョン>/site-packages:$PYTHONPATH"
python3 ./setup.py build
python3 ./setup.py install --prefix=<Proton VPN GUIのインストールディレクトリ>

# または

sudo pip3 install -e .
 
==== Proton VPN CLIのインストール ====
Proton VPN CLIを使用する場合のみインストールする。 
 
[https://github.com/ProtonVPN/linux-cli Proton VPN CLIのGithub]にアクセスして、ソースコードをダウンロードする。 
ダウンロードしたファイルを解凍する。 
tar xf linux-cli-<バージョン>.tar.gz
cd linux-cli-<バージョン>
 
または、<code>git clone</code>を使用して、ソースコードをダウンロードする。 
git clone https://github.com/ProtonVPN/linux-cli.git
cd linux-cli
 
Proton VPN CLIをインストールする。 
export PYTHONPATH="/<Proton VPNのインストールディレクトリ>/lib/python<Pythonのバージョン>/site-packages:$PYTHONPATH"
python3 ./setup.py build
python3 ./setup.py install --prefix=<Proton VPN GUIのインストールディレクトリ>

# または

sudo pip3 install -e .
 
==== Proton VPN GUIのインストール ====
Proton VPN GUIを使用する場合のみインストールする。 
 
[https://github.com/ProtonVPN/linux-app Proton VPN GUIのGithub]にアクセスして、ソースコードをダウンロードする。 
ダウンロードしたファイルを解凍する。 
tar xf linux-app-<バージョン>.tar.gz
cd linux-app-<バージョン>
 
または、<code>git clone</code>を使用して、ソースコードをダウンロードする。 
git clone https://github.com/ProtonVPN/linux-app.git
cd linux-app
 
Proton VPN GUIをインストールする。 
export PYTHONPATH="/<Proton VPNのインストールディレクトリ>/lib/python<Pythonのバージョン>/site-packages:$PYTHONPATH"
python3 ./setup.py build
python3 ./setup.py install --prefix=<Proton VPN GUIのインストールディレクトリ>

# または

sudo pip3 install -e .
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:PinePhone]][[カテゴリ:Windows10]][[カテゴリ:Windows11]]

VPN - CyberGhost

2026-03-24T11:52:13Z

Wiki:

== 概要 ==
CyberGhostは、2011年にルーマニアで設立された企業であり、プライバシーに関して徹底したコミットメントを実践している。 
ルーマニア(本社)とドイツに拠点があり、EUのデータ保持法やスパイ法の対象とならないため、ユーザが影響を受けることはない。 
 
CyberGhostの特徴を、以下に示す。 
* 暗号化
*: 256ビットのAES暗号化アルゴリズム(財務、軍事、政府等の機密扱いの分野で使用されるのと同じ暗号化)を使用している。
* OpenVPNプロトコル
*: 高度なセキュリティや最高のパフォーマンスを実現するため、CyberGhost VPNソフトウェアはOpenVPNプロトコルを使用している。
* WireGuardプロトコル
*: 速度向上と最新の暗号化を希望されるユーザは、WireGuardプロトコルを選択すること。
*: OpenVPNより最大4倍高速であり、モバイルデバイスではデフォルトプロトコルとなっている。
* IKEv2プロトコル
*: MicrosoftおよびCiscoが開発した軽量プロトコルであり、モバイルおよび物理的に近いサーバとの接続に最適化されている。
* 厳格なノーログポリシー
*: CyberGhostのVPNサーバは、RAMのみで動作する構成を採用しており、ユーザのデータを一切保管しない。
*: Deloitteによる独立監査(2022年および2024年実施)において、ノーログポリシーへの準拠が確認されている。
*: 詳細については、後述の「ノーログポリシーと信頼性」セクションを参照すること。
* インターネットの制限無し
*: Netflix、HBO Now、Amazonプライム、、その他のサービスに無制限にアクセスできる。
*: CyberGhostでIPアドレスを変更することにより、地域的制限を迂回して、お気に入りのコンテンツやソーシャルメディアプラットフォーム、ゲーミングサイトのブロックを解除できる。
* 最大7台のデバイスを保護
*: CyberGhostは、全ての主要OSに対して最適化されている。1つのプランに契約するだけで、インターネットに接続するデバイスを最大7台まで保護できる。
* 24時間365日のライブチャットサポート
*: CyberGhostでは、ライブチャットまたはメールを通じて1日24時間 / 週7日のサポートを提供している。
*: なお、対応言語は、英語、ドイツ語、フランス語、ルーマニア語である。
 
CyberGhostが提供しているもう1つの便利な機能は、地域制限を回避できることである。 
世界中40以上のストリーミングサービスへアクセスすることができるため、BBC iPlayerやHuluを簡単に閲覧することができる。 
Cyber Ghostの最大の特徴は、100%機能するという保証があることである。 
通常、ストリーミングサービスはVPNサーバのIPアドレスをブロックしてコンテンツへのアクセスを制限しているが、CyberGhostは、閲覧したいWebサイトのブロックを解除をできるよう保証している。 
 
また、CyberGhostのP2Pポリシーは、ファイル共有やTorrent等にも利用できるが、匿名トレントに最適化された指定サーバのみで使用できる。 
 
Linux向けのCyberGhost VPNソフトウェアは、Ubuntu 20.04 / 22.04、Fedora 29〜31、Linux Mint 19、Kali Linux、CentOS 7、PoP!_OSに対応している。 
なお、SUSE向けの公式インストールパッケージは提供されていないが、OpenVPN接続を手動で設定することにより使用可能である。 
 
※注意 
CyberGhostは、Kape Technologies (旧Crossrider) というイスラエル出身の経営陣が率いる企業によって運営されていることに注意すること。 
Kape Technologiesの経歴および懸念事項の詳細については、後述の [[#ノーログポリシーと信頼性]]セクションを参照すること。 
 

== ノーログポリシーと信頼性 ==
==== ノーログポリシーの技術的裏付け ====
CyberGhostは、以下のデータを一切保持しないことを公式に明記している。 
* 受信および送信IPアドレス
* 閲覧履歴およびDNSクエリ
* データ転送量
* VPNサーバの使用記録
* 接続日時および接続時間
* ダウンロードされたファイル
 
技術的な対策として、CyberGhostはRAMのみで動作するサーバ(RAMディスクサーバ)を採用しており、 
サーバの再起動時に全てのデータが自動的に消去される仕組みとなっている。 
これにより、閲覧活動がハードディスクに書き込まれることはなく、データ保持のリスクを最小化している。 
 
また、国際的な監査企業であるDeloitteを招請して、サーバおよび管理システムの検査を実施している。 
Deloitteは2022年と2024年にそれぞれ監査を行い、CyberGhostのサーバがノーログポリシーに準拠していることを確認している。 
 
CyberGhostがルーマニアを拠点としていることには、プライバシー保護の観点から以下の意義がある。 
* ルーマニア法では、VPNプロバイダーにユーザの閲覧活動をログに記録する法的義務がない。
* ルーマニアは5Eyes、9Eyes、14Eyesといった国際情報共有同盟に属していない。
* EUのGDPR、E-Privacy法、E-Commerce法により、厳格なデータ保護規制が存在する。
 
==== 透明性レポートと捜査機関への対応 ====
CyberGhostは、VPN業界で初めて四半期ごとの透明性レポートを発行している。 
 
2019年第1四半期(1月〜3月)の透明性レポートでは、以下の法的要求を受けている。 
* 総請求件数 : 22,595件
*: DMCA著作権侵害申し立て : 18,972件 (84%)
*: 悪意あるサイバー活動フラグ(DDoS、ボットネット、詐欺、不正アクセス報告) : 3,602件 (16%)
*: 警察および法執行機関からの要求 : 21件 (1%未満)
 
これらの警察からの要求に対して、CyberGhostは全件「ユーザ情報を提供できない」と回答している。 
ノーログポリシーにより提供すべきデータが存在しないためである。 
 
なお、ドイツ連邦刑事警察庁(BKA)からCyberGhostに対する具体的なデータ提出事例は、公開情報の範囲では確認されていない。 
 
==== 親会社 Kape Technologies の経歴 ====
CyberGhostの親会社であるKape Technologies (旧Crossrider) には、以下の懸念事項が指摘されている。 
 
Crossrider時代 (2011年〜2018年) の問題点 : 
* Crossriderは、ブラウザ拡張機能の開発および配布プラットフォームを提供していた企業である。
* 一部の悪質なアクターがプラットフォームを悪用して、マルウェアおよびアドウェアの開発に利用した。
* SymantecやMalwarebytes等のセキュリティ企業が、CrossriderのSDKで作成されたソフトウェアをマルウェアと判定した。
* 問題の内容として、広告インジェクション、ユーザデータ収集、ブラウザハイジャッキングが挙げられている。
* Crossriderは2016年にプラットフォームを完全にシャットダウンした。
 
VPN企業の買収戦略 : 
* 2017年
*: CyberGhostを買収、その後、社名をKape Technologiesに改名した。
* 2018年
*: ZenMateを買収 (550万ドル)
* 2019年
*: Private Internet Access (PIA) を買収 (1億2,600万ドル)
* 2021年
*: ExpressVPNを買収 (9億3,600万ドル)
 
経営陣の経歴 : 
* 創業者Koby Menachemi(元CEO) : イスラエル軍情報機関Unit 8200(イスラエルのNSA相当)出身
* 実質的支配者Teddy Sagi : 1996年に収賄および証券詐欺で有罪、マン島のシェルカンパニー経由で同社を支配
 
レビューサイトの利益相反 : 
* KapeはVPN評価サイトであるVPN Mentor、Wizcase、Safety Detectivesも所有している。
* これらのレビューサイトが自社VPN製品を高く評価する利益相反の構造が指摘されている。
 
==== セキュリティインシデント ====
CyberGhostに関連する主なセキュリティインシデントを以下に示す。 
 
* 2018年6月 : Typeformデータ漏洩
*: 第三者サービスプロバイダーであるTypeformのバックアップサーバが侵害された。
*: CyberGhostユーザのメールアドレス120件およびユーザ名14件が流出した。
*: パスワード、支払い情報、IPアドレスは流出していない(CyberGhostがこれらを第三者サーバに保存していないため)。
* 2024年 : パスワード漏洩
*: 83,600件のCyberGhostアカウントのパスワードが流出したと報告された。
*: 調査の結果、これらのパスワードは外部マルウェア攻撃によりユーザのデバイスから窃取されたものであり、CyberGhostのインフラストラクチャ自体の侵害ではないことが確認されている。
 
==== 2026年の民営化と透明性の変化 ====
Kape Technologiesは2026年1月1日から完全に民営化され、ロンドン証券取引所での上場が廃止された。 
これにより、以下の懸念が生じている。 
* 企業のファイリング情報が公開されなくなった。
* 透明性レポートの公開状況が不確定となった。
* アナリストおよび一般市民が企業動向を監視できなくなった。
 
==== 信頼性の総合評価 ====
<center>
{| class="wikitable"
|+ CyberGhost VPNの信頼性評価
! 評価項目 !! 状況
|-
| ノーログポリシーの技術的裏付け || Deloitte監査あり、RAMサーバ採用
|-
| 捜査機関へのデータ提出 || 確認された事例なし
|-
| 親会社の信頼性 || マルウェア企業からの転身、軍情報機関との関連
|-
| 透明性 || 2026年の民営化により大幅に低下
|}
</center>
 
CyberGhostは技術的にはノーログを実現しており、実際にデータを提出した事例も確認されていない。 
 
ただし、親会社Kape Technologiesの過去の経歴、経営陣の情報機関との関連、レビューサイト支配による利益相反、 
および2026年の民営化による透明性の喪失は、プライバシーを重視するユーザにとって無視できない懸念事項である。 
 

== CyberGhostの契約 ==
CyberGhostの契約手順を以下に記載する。 
 
# [https://www.cyberghostvpn.com/ja_JP/ CyberGhostの公式Webサイト]へアクセスして、ページ中央にある[今すぐ購入]を選択する。
# VPNのプランを選択する。
# [お支払い方法]では、クレジットカード、PayPal、ビットコインのいずれかを選択する。 なお、28ヶ月および6ヶ月プランでは45日間の返金保証があり、1ヶ月プランでは14日間の返金保証がある。
# Eメールアドレスを入力して、[購入を完了]または[〜へ進む]を選択する。
# 支払いが完了した後、遷移先のページにユーザ名とパスワードが表示される。 入力したEメールアドレスがアカウントのIDとして登録される。 また、Eメールアドレスにサブスクリプションを回復する時のトークンが送付されるので、大切に保管すること。
# アカウントのパスワードの変更画面が自動的に立ち上がるため、任意のパスワードに変更する。 パスワードにおいて、<code>$</code>、<code>*</code>、<code>%</code>、<code>[</code>、<code>]</code>の文字は使用できない。
# 自動的にアカウントページに遷移するので、[アプリをダウンロード]を選択して、CyberGhost VPNソフトウェアをダウンロードする。 CyberGhost VPNソフトウェアは、Windows、macOS、Linux、Android、iOSに対応している。 また、ブラウザの拡張機能はChrome、Firefoxが対応している。
 
CyberGhostでは、1ヶ月1,790円、6ヶ月1,000円/月(合計6,000円)、28ヶ月290円/月(初回合計8,120円)の料金である。(2026年3月現在) 
なお、28ヶ月および6ヶ月プランでは45日間の返金保証があり、1ヶ月プランでは14日間の返金保証がある。 
 

== 依存関係のライブラリのインストール ==
Cyber Ghost VPNソフトウェアを実行するために必要な依存関係のライブラリをインストールする。 
 
# RHEL
sudo dnf install python3 openvpn NetworkManager-openvpn \
NetworkManager-openvpn-gnome # GNOMEを使用する場合
plasma-nm-openvpn # KDEを使用する場合

# SUSE
sudo zypper install python3 openvpn NetworkManager-openvpn \
NetworkManager-openvpn-gnome # GNOMEを使用する場合
plasma-nm5-openvpn # KDEを使用する場合
 

== CyberGhostの使用手順 : CyberGhost CLIを使用する場合 ==
==== CyberGhost CLIのインストール ====
CyberGhost CLIで必要なのものは、CyberGhostのユーザ名とパスワードのみである。 
 
# [https://www.cyberghostvpn.com/ja_JP/ CyberGhostの公式Webサイト]にアクセスして、ページ右上にある[マイアカウント]からログインする。 
# アカウントページ左にある[Donwload Hub] - アカウントページ右にある[CyberGhost VPN for Linux] - [Configure]を選択する。
# [SERVER DISTRIBUTION]プルダウンは[Fedora 32]を選択して、[Download App]を選択する。
# CyberGhost CLIをダウンロードする。
# ダウンロードしたファイルを解凍して、必要であれば、任意の名前に変更する。
#: <code>unzip cyberghostvpn-<ディストリビューション名>-<バージョン>.zip</code>
#: <code>mv cyberghostvpn-<ディストリビューション名>-<バージョン> CyberGhost</code>
# CyberGhost CLIをインストールする。
## <code>sudo ./install.sh</code>
## SUSEを使用する場合、CyberGhost CLIの実行に必要な依存関係のライブラリは、事前にインストールしている必要がある。 そのため、Python 3とOpenVPNのインストールを求められたら、[N]を入力する。
## CyberGhost CLIのインストール時に、CyberGhostのユーザ名およびパスワードが求められるため、それぞれ入力する。
# インストールが正常に完了すると、"Install completed ..."というメッセージが表示される。
# <code>cyberghostvpn</code>コマンドを実行することにより、使用可能なコマンドのリストが表示される。
 
==== CyberGhost CLIのコマンド ====
接続先の全ての国(国のコード)を確認するには、以下のコマンドを実行する。 
cyberghostvpn --traffic --country-code
 
接続先の国の都市(都市のコード)を確認するには、以下のコマンドを実行する。 
sudo cyberghostvpn --traffic --country-code <国のコード>
 
1つの都市で利用可能なサーバ(接続先のサーバ名)のリストを取得するには、以下のコマンドを実行する。 
sudo cyberghostvpn --traffic --country-code <国のコード> --city "<都市のコード>"
 
接続先の国を選択するには、以下のコマンドを実行する。 
cyberghostvpn --country-code <国のコード>
例. cyberghostvpn --country-code DE
 
接続先の国の都市を選択するには、以下のコマンドを実行する。 
cyberghostvpn --country-code <国のコード> --city "<都市のコード>"
例. cyberghostvpn --country-code DE --city frankfurt
 
CyberGhost VPNに接続するには、以下のコマンドを実行する。 
デフォルトでは、OpenVPNプロトコルを使用して接続する。 
接続に成功すると、"VPN connection established"というメッセージが表示される。
sudo cyberghostvpn --connect
# または
sudo cyberghostvpn --country-code <国のコード> --city "<都市のコード>" --connect
例. sudo cyberghostvpn --country-code DE --city frankfurt --connect
 
また、接続先のサーバ名を知っている場合、特定のサーバに直接接続することができる。 
接続に成功すると、"VPN connection established"というメッセージが表示される。
sudo cyberghostvpn --server <サーバ名> --connect
例. sudo cyberghostvpn --server frankfurt-s402-i01 --connect
 
VPN接続が有効かどうかを確認するには、以下のコマンドを実行する。 
cyberghostvpn --status
 
VPN接続を終了するには、以下のコマンドを実行する。 
sudo cyberghostvpn --stop
 
IPアドレスが匿名かつプライベートなCyberGhostに変更されたことを確認する場合は、http://www.iplocation.net/ にアクセスする。 
IPロケーションオンラインサービスにアクセスする前に、Webブラウザのキャッシュとクッキーを削除することを推奨する。 
 

==== CyberGhost CLIのアンインストール ====
CyberGhost CLIをアンインストールする。 
sudo cyberghostvpn --uninstall
 
==== ストリーミングを視聴する場合 ====
CyberGhostでは、ストリーミングに最適化されたVPNサーバを使用して、 
Netflix、Amazonプライムビデオ、BBC iPlayer等の地域制限のあるコンテンツにアクセスすることが可能である。 
 
これらのサービスのために、最適化されたVPNサーバの1つに接続する必要がある。 
これは、CyberGhost CLIにストリーミング向けVPNサーバを経由して接続するよう指示することにより行われる。 
 
まず、サポートされているストリーミングサービス(Netflix DE、Hulu、Youtube等)のリストと国名(国のコード)を取得する。 
cyberghostvpn --streaming --country-code
 
以下の例では、サーバータイプ"Streaming"、サービス"Netflix DE"、国(国コード)"DE"を指定して、VPN接続している。 
sudo cyberghostvpn --streaming 'Netflix DE' --country-code DE --connect
 
※注意 
例えば、フランスで利用可能な全てのストリーミングサービスを確認する場合は、以下のコマンドを実行する。 
cyberghostvpn --streaming --country-code FR
 
対応するフランスのストリーミングサービスが全て表示されるので、希望するストリーミングサービスに接続する。 
以下の例では、Canal+(フランスの有料民間テレビ局)向けに最適化されたVPNサーバに接続している。
sudo cyberghostvpn --streaming 'Canal+' --country-code FR --connect
 

==== Torrentを使用する場合 ====
CyberGhost CLIは、安全にTorrentを使用できる幅広いP2P Torrentサーバを提供している。 
 
※注意 
シードキューにあるTorrentは、メイン接続にトラフィックを発生させて追跡される可能性があるため、VPNサーバに接続するまではTorrentクライアントを起動しないこと。 
 
まず、P2Pファイル共有をサポートしている国のリストを取得する。
（各国の様々な法律や政策のため、全ての国やサーバがP2Pファイル共有をサポートしているわけではない）
cyberghostvpn --torrent --country-code
 
P2Pファイル共有に対応している国のリストを確認した後、接続先の国のコードを入力してVPNサーバに接続する。 
sudo cyberghostvpn --torrent --country-code <国のコード> --connect
 
VPNサーバに接続されていることを確認するには、以下のコマンドを実行する。 
cyberghostvpn --status
 
IPアドレスが匿名かつプライベートなCyberGhostに変更されたことを確認する場合は、http://www.iplocation.net/ にアクセスする。 
IPロケーションオンラインサービスにアクセスする前に、Webブラウザのキャッシュとクッキーを削除することを推奨する。 
 
最後に、Torrentクライアントを起動する。 
 

== CyberGhostの使用手順 : NetworkManagerを使用する場合 ==
Cyber Ghost(OpenVPN)を設定するには、以下の手順に従う。 
 
* GNOME / KDE 共通
# [https://www.cyberghostvpn.com/ja_JP/ CyberGhostの公式Webサイト]にアクセスして、ページ右上にある[マイアカウント]からログインする。 
# アカウントページ左にある[VPN] - アカウントページ右にある[Manage Devices] - [Configure Device]を選択する。
# 使用するプロトコル（OpenVPN等）、使用するサーバがある国名、サーバグループを選択する。
#* プロトコル
#*: OpenVPN等を選択する。
#* サーバグループ
#*: サーバグループとOpenVPNプロトコル（UDPまたはTCP）を選択する。
#*: UDPは、TCPより高速に通信できるが、場合によってはダウンロード等の処理において、中断されることがある。
#*: TCPは、UDPよりも安定した接続が可能であるが、若干通信速度が遅くなる。突然の切断等、接続に関する問題が頻繁に発生する場合は、TCPを選択する。
#* 使用するサーバがある国名
#*: ネイティブプロトコルの接続は、1つのサーバーとしか使用できないため、接続したい国を選択する。選択した該当国内のサーバは、CyberGhostにより自動的に選択される。
# [Save Configuration]を選択する。
# 上記の設定で生成されたOpenVPNの認証情報を見るには、[View Configuration]を選択する。
# [Save Configuration]を選択した後、接続認証情報が生成されて、新しいページに遷移する。 ※重要 : この時、以下に示す情報を保存すること。(ユーザ名とパスワードは、後で入力を求められる)
#* サーバグループ
#*: 接続先の国にあるサーバのアドレスである。(例. 12345-1-ca.cg-dialup.net)
#*: このアドレスは、上記で選択した国ごとに変わる。
#* ユーザ名
#*: このプロトコルのみで生成されるユーザ名である。
#*: これは、CyberGhostのアカウントのユーザ名ではなく、手動設定によりCyberGhostのサーバと認証するためにのみ使用される。
#* パスワード (表示するには、[Show Password]オプションにチェックを入力する必要がある)
#*: プロトコルを使用するためにのみ生成されたパスワードである。
#*: これは、CyberGhostのアカウントのパスワードではなく、手動設定によりCyberGhostのサーバで認証するためにのみ使用される。
#* 事前共有キー
# [Download Configuration]を選択して、OpenVPNの設定ファイルをダウンロードする。 ダウンロードしたファイルを解凍する。
#: <code>unzip config.zip</code>
# OpenVPNの設定ファイルは、以下に示すファイルを含む。 接続先の国を変更する場合、再度、アカウントページで使用する場所を設定し直して、新しいOpenVPNの設定ファイルをダウンロードする必要がある。
#* ca.crt
#*: 認証局の証明書
#* client.crt
#*: ユーザ証明書ファイル
#* client.key
#*: 秘密鍵ファイル
#* openvpn.ovpn
#*: OpenVPNの設定ファイル
 
* GNOMEの場合
# OpenVPNの設定ファイルをインポートして使用するために必要な依存関係のライブラリをインストールする。
#: <code>sudo zypper install openvpn NetworkManager-openvpn NetworkManager-openvpn-gnome</code>
# GNOMEのホーム画面右上にある[ネットワーク]アイコンをクリックして、[設定]アイコンを選択する。
# [設定]画面が開くので、画面左にある[ネットワーク] - 画面右の[VPN]項目の右にある[＋]ボタンを押下する。
# [VPNの追加]画面が開くので、[ファイルからインポート...]を選択する。
# 上記で解凍したOpenVPN設定ファイルを選択して、画面右上にある[開く]ボタンを押下する。 ここで、OpenVPNファイルの命名形式は、国-場所-サーバアドレスである。 例. UnitedStates.ovpn
# 選択したOpenVPN設定ファイルが未保存のセッションとしてNetworkManagerにインポートされるので、[VPNの追加]画面から以下に示す項目を入力および設定する。
#* [Gateway]
#*: サーバのアドレスを確認する。
#* [ユーザ名]
#*: 上記で保存した該当プロトコルのみで生成されるユーザ名を入力する。
#* [パスワード]
#*: 上記で保存した該当プロトコルのみで生成されるパスワードを入力する。
#*: ［Store the password for all users（すべてのユーザーのパスワードを保存する）]を選択する。
#* [CA証明書]
#*: <code>ca.crt</code>とラベル付けされていることを確認する。
#* [ユーザ証明書]
#*: <code>client.crt</code>とラベル付けされていることを確認する。
#* ユーザーキーパスワード
#*: 上記で保存した該当プロトコルのみで生成されるユーザーキーパスワードを入力する。
# [VPNの追加]画面にある[IPv6]タブを選択して、[無効]ボタンを選択する。
# [VPNの追加]画面右上にある[追加]ボタンを押下する。
# 上記で追加したCyberGhostのOpenVPN設定が作成されて、CyberGhostのOpenVPNセッションが[VPN]項目の選択エリアにリストされていることを確認する。 これは、[VPN]項目の選択エリアにあるスライダースイッチを押下することにより、接続および切断を切り替えることができる。 また、GNOMEのホーム画面右上にある[ネットワーク]アイコンをクリックして、VPNの接続および切断を切り替えることができる。
# IPアドレスが匿名かつプライベートなCyberGhostに変更されたことを確認する場合は、http://www.iplocation.net/ にアクセスする。 IPロケーションオンラインサービスにアクセスする前に、Webブラウザのキャッシュとクッキーを削除することを推奨する。
 
* KDEの場合
# OpenVPNの設定ファイルをインポートして使用するために必要な依存関係のライブラリをインストールする。
#: <code>sudo zypper install openvpn NetworkManager-openvpn plasma-nm5-openvpn</code>
# [KDEシステム設定]を起動して、[接続]を選択する。
# [接続]画面が開くので、画面左下(接続先リストの下)にある[+]を押下する。
# [接続タイプの選択]画面が開くので、リストの最下行にある[VPN接続をインポート...]オプションを選択して[作成]ボタンを押下する。
# [VPN接続をインポート]画面が開くので、解凍したディレクトリ内にあるOpenVPNファイル(VPNサーバ)を選択する。 例. UnitedStates.ovpn
# 証明書をコピーするよう求められたら、[はい]ボタンを押下する。
# [接続]画面左にCyberGhostのVPN接続が表示されるので、CyberGhostのVPN接続を選択する。
# [接続]画面右にある[VPN(openvpn)]タブを選択して、以下に示す項目を入力および設定する。
#* [Gateway]
#*: サーバのアドレスを確認する。
#* [ユーザ名]
#*: 上記で保存した該当プロトコルのみで生成されるユーザ名を入力する。
#* [パスワード]
#*: 上記で保存した該当プロトコルのみで生成されるパスワードを入力する。
#* [CA証明書]
#*: <code>ca.crt</code>ファイルのパスが表示されていることを確認する。
#* [クライアント証明書]
#*: <code>client.crt</code>ファイルのパスが表示されていることを確認する。
#* 秘密鍵のパスワード
#*: 上記で保存した該当プロトコルのみで生成される秘密鍵のパスワードを入力する。
#* 画面右のプルダウン
#*: ［すべてのユーザーのパスワードを保存する]を選択する。
# [接続]画面右にある[IPv6]タブを選択して、[この接続には IPv6 が必要]チェックボックスのチェックを外す。
# [接続画面]右下にある[適用]ボタンを押下する。
# タスクバーにあるネットワークアイコンをクリックすると、CyberGhostのOpenVPNが表示されるので、[接続]ボタンを押下する。
 

== CyberGhostの解約 ==
# [https://www.cyberghostvpn.com/ja_JP/ CyberGhostの公式Webサイト]にアクセスして、ページ右上にある[マイアカウント]からログインする。 
# アカウントページ左にある[ご契約] - アカウントページ右にある[自動更新をオフにする]を選択する。
# 自動更新をしない場合、次回の支払い期限での契約が更新されないため、実質解約となる。
 

== CyberGhostの返金 ==
返金において、申し込みから14日以内または45日以内にする必要がある。 
 
# [https://www.cyberghostvpn.com/ja_JP/ CyberGhostの公式Webサイト]にアクセスして、ページ右下にある[ヘルプ]を選択する。 
# 検索窓が表示されるので、refundと入力して検索する。
# 名前、Eメールアドレス、言語、メッセージを入力して、検索窓の右下にある[チャットを開始]を選択する。 なお、メッセージ欄には、"I would like to receive refund"のように入力する。
# チャットが開始されて、アカウントの確認のためにReference NumberまたはOrder IDが要求される。 Reference NumberまたはOrder IDは、CyberGhostの契約(または解約)時に受信したEメールに記載されている。
# チャットにて、VPNを解約する理由等を質問されるため、"I don't need to use VPN anymore."等と入力する。
# チャットを終了するには、チャット画面下部にある[送信]を選択する。
# 翌日以降に返金されるはずである。 後日、正常に返金されているかどうかを確認すること。
 

== CyberGhostのアカウントの削除 ==
返金期間内の場合、アカウントの削除は返金処理をした後に行うこと。 
 
# [https://www.cyberghostvpn.com/ja_JP/ CyberGhostの公式Webサイト]にアクセスして、ページ右上にある[マイアカウント]からログインする。 
# アカウントページ左にある[設定] - アカウントページ右下にある[マイアカウントを削除]を選択する。
# パスワードまたはPUKを入力して、[保存]を選択する。
# アカウントが削除される。
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:Windows7]][[カテゴリ:Windows10]][[カテゴリ:Windows11]]

VPN - PIA VPN

2026-03-24T11:36:12Z

Wiki:

== 概要 ==
PIA VPN(Private Internet Access VPN)は、91か国に約35,000台以上のサーバを所有しており、各サーバはRAMベースであるため、安心して利用することができる。 
他のVPNサービスのサーバの一部はレンタルサーバである場合が多いが、全てを所有することにより、サーバを危険にさらす可能性のある仲介者を排除することができる。 
 
さらに、RAMベースのサーバは、全ての匿名化されたデータを、スイッチを押すように簡単に削除することができる。 
実際に、IP / DNSリーク保護のおかげで、20台の別々のサーバでのテスト中、ユーザのIPが明らかになることはなかった。 
 
また、ポートフォワーディングや、難読化を伴う2重VPN接続によるSOCKS5およびShadowsocksプロキシへのアクセス等、安全にTorrentを実行するためのいくつかの機能も備えている。 
 
小さな問題として、アメリカに拠点を置いていることである。 
アメリカは、侵襲的なプライバシー法を持っていることで知られており、5アイズ、9アイズ、14アイズアライアンスの一員でもある。 
このため、一部のプライバシー擁護派は神経質になっている。 
また、理論的には、FBIやNSAのような強引な機関は、裁判所命令を使って、疑わしいと思われるアメリカのユーザを監視することができる。 
しかし、米国にはデータ保持に関する法律がないため、ヨーロッパでよくあるように、PIAには情報を一定期間保存する義務はない。 
また、PIAは何年も前から存在しており、そのプライバシーポリシーは常に守られているため、プライバシーの面ではPIAを推奨することができる。 
 
PIA VPNは、個人を特定できるログを一切保持しないことを約束している。 
例えば、2016年にFBIが加入者の1人のデータを求めたが共有できるものは何も無かった。 
別の例では、2016年7月にロシア政府がPIA VPNのロシア国内サーバの一部を押収したが、ログが存在しなかったため全く何も見つからなかった。 
この事件を受けて、PIAはロシアのゲートウェイを直ちに廃止し、ロシア領内でのサーバ運営を終了した。 
 
Linux向けのPIA VPNソフトウェアは、ネイティブアプリとしてUbuntu (64ビット)、Linux Mint、Debianに対応している。 
また、OpenVPNによる手動セットアップにより、Fedora、Arch、Slackware等のほぼ全てのLinuxディストリビューションで利用可能であり、SUSEにおいても問題なく使用できる。 
 
PIAは、WireGuard (推奨)、OpenVPN、IPSec/IKEv2の3つのVPNプロトコルに対応している。 
また、SOCKS5プロキシも備えている。 
 
料金は、1ヶ月1,304円、1年間4,359円(更新時は5,230円/年)、3年間 + 4ヶ月ボーナスで8,152円である。(2026年3月現在) 
 
PIA VPNの特徴を、以下に示す。 
* ノーログポリシー
*: インターネットトラフィックに関するデータを記録または保存することはない。
*: これについては、裁判所の記録によって実証されている。
* 強力な暗号化機能
*: OpenVPNやWireGuard等の信頼できるオープンソースのVPNプロトコルで、個人データの安全を保つ。
* 広告トラッカーやマルウェアに対する保護機能
*: PIAのMACEは、DNSベースの広告ブロッカーであり、オンライン広告、トラッカー、マルウェアからユーザを保護する。
* PIAのスプリットトンネリング
*: VPNトンネルを自動的に使用またはバイパスするように個々のソフトウェアまたはウェブサイトのカスタムルールを設定することができる。
* データ漏洩の防止
*: キルスイッチがあるため、VPN接続が突然切断された場合でも、ファイアウォールベースのキルスイッチ機能により、データが漏洩することがない。
* 仮想通貨での決済
*: 仮想通貨や第三者のギフトカードで決済可能であるため、匿名で決済でき、身元情報をさらに保護することができる。
* 速度
*: 速度テストではあまり良い結果を出していないが、他のVPNと比較して上位にランクインしている。
*: ただし、遠く離れたVPNサーバを使用する時に速度低下を示すことがある。
 

== ノーログポリシーの検証 ==
PIA VPNは、個人を特定できるログを一切保持しないノーログポリシーを掲げている。 
このポリシーは、法廷での立証、第三者監査、透明性レポートの3つの観点から検証されている。 
 
==== 記録しないデータ ====
PIAが記録しないデータを以下に示す。 
 
* ユーザのIPアドレス
* 接続したVPNサーバ
* 訪問したWebサイトとドメイン
* 使用したアプリとオンラインサービス
* 検索クエリ
* DNSリクエスト
* VPN帯域幅使用量
* セッションタイムスタンプ (接続 / 切断時間)
 
PIAが保有するのは、サインアップに使用したメールアドレス、課金用の決済情報、ZIP code (米国の税務目的、暗号通貨での支払いで回避可能)のみである。 
 
また、サーバはRAM専用インフラストラクチャで実行され、ハードドライブを持たない。 
メモリはシステム再起動時にクリアされるため、ログは永続的に保存されない。 
 
さらに、VPNサーバ上の全てのサービスに対してエラーログとデバッグ情報が無効化されている。 
 
==== 法廷での立証事例 ====
PIAのノーログポリシーは、複数の法廷事例で実証されている。 
 
===== 2016年: FBI爆弾脅迫事件 (Preston McWaters事件) =====
2016年3月、FBIが偽の爆弾脅迫事件に関連して、PIAに召喚状を発行した。 
PIAは東海岸からのIPアドレスクラスタのみを報告でき、容疑者特定に繋がる情報は提供できなかった。 
 
===== 2018年: メディアサイトハッキング事件 (Ross M. Colby事件) =====
2015年7月から9月にかけて、PIA IPアドレスを使用してサンフランシスコのメディアサイトがハッキングされた事件について、2018年5月にサンノゼの連邦裁判所で審理が行われた。 
PIAは容疑者のIPアドレスを違法活動と結び付けることができず、ノーログポリシーが法廷で再び立証された。 
 
===== 2016年: ロシア政府によるサーバ押収 =====
2016年7月、ロシアのデータ保持法に関連して、ロシア当局がPIAのロシア国内サーバの一部を予告なく押収した。 
しかし、PIAがユーザトラフィックやセッションデータをログ記録していなかったため、当局は何も取得できなかった。 
PIAはこの事件を受けて、ロシアのゲートウェイを直ちに廃止し、以降ロシア領内でのサーバ運営を行っていない。 
 
==== 第三者監査 (Deloitte) ====
PIAのノーログポリシーは、Big Four監査法人の1つであるDeloitte Audit Romaniaにより、複数回の独立監査が実施されている。 
監査は国際監査・保証基準委員会 (IAASB) が確立したISAE 3000 (Revised) に準拠して行われている。 
 
<center>
{| class="wikitable"
|+ Deloitte独立監査の実績
! 時期 !! 監査結果
|-
| 2022年6月 || サーバ構成は内部プライバシーポリシーに適合、ユーザ識別やアクティビティ特定は設計されていないことを確認
|-
| 2024年4月 || VPNサーバインフラストラクチャとIT管理システムの調査でゼロログを再確認
|-
| 2025年Q4 || 第三回監査完了、プライバシーへのコミットメントを再確認
|}
</center>
 
==== 透明性レポート (2025年) ====
PIAは四半期ごとに透明性レポートを公開しており、政府からの情報開示要請とその対応結果を開示している。 
 
<center>
{| class="wikitable"
|+ 2025年の政府情報開示要請
! 四半期 !! 要請件数 !! ユーザデータ開示
|-
| Q2 2025 || 46件 || ゼロ
|-
| Q3 2025 || 19件 || ゼロ
|-
| Q4 2025 || 30件 || ゼロ
|}
</center>
 
全案件において、PIAのシステムは活動ログを保持していないため、提供できる情報がないとの回答が行われている。 
 
==== Kape Technologies買収に関する懸念 ====
2019年11月、PIAはKape Technologies (旧Crossrider、英国・イスラエル系企業) に約9,550万ドルで買収された。 
 
Kape Technologies (旧Crossrider)には、以下の懸念事項が指摘されている。 
* ブラウザハイジャッキングおよび潜在的に望ましくないソフトウェア (PUP)の配布に関与していた過去がある。
* 創業者のKoby MenachemiはUnit 8200 (イスラエルのNSAに相当する機関) の出身
* 主要投資家のTeddy SagiはPanama Papersに記載されている。
 
ただし、買収後もPIAのノーログポリシーは維持されている。 
 
買収時に、PIAとKape Technologiesは8つの法的拘束力を持つ原則に合意しており、プライバシーとセキュリティが最優先事項であることが公言されている。 
さらに、買収後の2022年、2024年、2025年のDeloitte監査で、ノーログポリシーの遵守が繰り返し確認されている。 
 

== PIA VPNの契約 ==
PIA VPNの契約手順を以下に記載する。 
 
# [https://jpn.privateinternetaccess.com/download/linux-vpn PIA VPNの公式Webサイト]へアクセスして、ページ右上にある[PIA VPNを入手]を選択する。
# VPNのプランを選択する。
# 支払いオプションでは、クレジットカード、PayPal、仮想通貨のいずれかを選択する。
# [今すぐ支払う]を選択する。
# 支払いが完了した後、PIAアカウントを作成するためのログイン情報（後に変更可能）と、VPNソフトウェアをダウンロードするためのリンクが記載されたメールが届く。
# PIAアカウントを作成する。
 
PIA VPNでは、1ヶ月1,304円、1年間4,359円(更新時は5,230円/年)、3年間+4ヶ月ボーナスで8,152円の料金である。(2026年3月現在) 
全てのプランに30日間の返金保証が付帯している。 
 

== PIA VPNソフトウェアのインストール ==
PIA VPNを設定するには、以下の手順に従う。 
 
# [https://jpn.privateinternetaccess.com/download/linux-vpn PIA VPNの公式Webサイト]から、VPNソフトウェアをダウンロードする。
# ダウンロードしたファイルに実行権限を付加する。
#: <code>chmod u+x pia-linux-<バージョン>.run</code>
# VPNソフトウェアをインストールする。
#: <code>./pia-linux-<バージョン>.run --target <VPNソフトウェアのインストールディレクトリ></code>
# インストール完了後、VPNソフトウェアのログイン画面が表示されるので、ログインを選択して、サインアップ時に使用したEメールアドレスへ送信されたログイン情報を入力する。
# ログイン後、認証情報を保存する必要がある。 初期状態では、メイン画面の電源アイコンが黄色になっており、接続が切断されていることを意味する。
# 電源アイコンをクリックして接続を確立する。 接続を確立するのに時間が掛かることがあることに注意する。 もし、接続できない場合は、[https://www.privateinternetaccess.com/helpdesk/kb/articles/i-have-trouble-connecting-or-the-connection-drops-frequently-changing-ports-5 公式Webサイトにある接続に関する問題の記事]を参照すること。
# 正常に接続が確立する時、電源アイコンが緑色に変わり、メイン画面にVPNサーバのIPが表示される。
 
VPNソフトウェアの設定について詳しく知りたい場合は、[https://www.privateinternetaccess.com/helpdesk/kb/articles/understanding-basic-settings-on-the-pia-client Understanding the PIA App's Basic Settings]および[https://www.privateinternetaccess.com/helpdesk/kb/articles/understanding-advanced-settings-on-the-pia-client Understanding the PIA App's Advanced Settings]を参照すること。 
 

== VPN over Tor ==
PIA VPNは、サードパーティ製のサポート対象外のハードウェアやOSを使用しているため、VPN over Torはサポートしていない。 
よりセキュリティを強固にする場合、最も簡単な方法は、PIA VPNサーバに接続した状態で、PORTAL、Whonix、TAILSのいずれかを使用して設定することである。 
 
VPN接続、または、Tor over VPN接続のみが使用できることに注意する。 
 

== Tor over VPN ==
VPNネットワーク経由でTorに接続する方法であり、Torは終了ノードになる。(Tor over VPN) 
 
# [[VPN - PIA VPN#PIA VPNソフトウェアのインストール|"PIA VPNソフトウェアのインストール"]]セクションを参照して、VPNに接続する。
# [https://www.torproject.org/download/ Torブラウザの公式Webサイト]にアクセスして、Torブラウザをダウンロードおよびインストールする。
# Torブラウザを起動して、[Connect]ボタンを押下する。 Torブラウザの設定はデフォルトのままでよい。
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:Windows7]][[カテゴリ:Windows10]][[カテゴリ:Windows11]]

VPN - PureVPN

2026-03-24T11:18:57Z

Wiki:

== 概要 ==
PureVPNは、イギリス領バージン諸島 (BVI) に本社を置くVPNサービスプロバイダーである。 
元々は香港を拠点としていたが、香港の法制度の変化に伴い、2021年後半から2024年1月にかけてBVIへ本社を移転した。 
BVIはファイブアイズ等の情報共有同盟外であり、ユーザデータの強制保管義務がない。 
 
また、2025年現在、PureVPNは一部のサーバにおいてOpenVPNプロトコル経由でQuantum耐性暗号化 (ポスト量子暗号) に対応している。 
対応地域は、米国、英国、オーストラリア、ドイツ、カナダ、オランダの6か所である。 
 

== ノーログポリシーの信頼性 ==
PureVPNはノーログVPNを謳っているが、過去に捜査機関へユーザ情報を提供した事例が存在する。 
現在はシステムアーキテクチャの改善と第三者監査により信頼性の向上を図っているが、過去の事例を踏まえた上で利用を検討する必要がある。 
 
==== 2017年 FBI協力事件 ====
2017年、サイバーストーキング事件 (Ryan S. Lin被告) の捜査において、PureVPNはFBIにユーザ情報を提供した。 
 
* 事件の概要
*: 被告は元ルームメイトの女性に対して、オンラインアカウントへのハッキング、個人写真や医療情報の窃取および数百人への配布等のサイバーストーキング行為を行った。
* PureVPNが提供した情報
*: ユーザのIPアドレスおよび接続タイムスタンプ
*: FBIの報告書では「PureVPNが同じ顧客が2つの異なる発信元IPアドレスからサービスにアクセスしたことを確認できた」と記載されている。
* 問題点
*: PureVPNは当時「NO browsing logs, browsing habits or anything else was, or ever will be shared」と主張していた。
*: しかし、実際にはIPアドレスと接続タイムスタンプを記録・提供しており、「ノーログポリシーの虚偽」として大きな批判を受けた。
*: PureVPNは「ブラウジングログ」と「接続ログ」は別であると弁明したが、接続ログだけでも個人の特定に十分な情報であった。
 
==== 現在のノーログポリシー ====
2017年の事件以降、PureVPNはノーログポリシーを改定し、現在は以下の項目について記録していないと公式に主張している。 
 
* ブラウジングアクティビティ
* 接続ログ
* VPNに割り当てられたIPレコード
* ユーザの元のIP
* 接続タイムスタンプ
* ブラウジング履歴および訪問サイト
* アウトバウンドトラフィック
* ユーザが生成したDNSクエリ
 
==== 第三者監査の実績 ====
PureVPNは複数の独立したセキュリティ監査機関によりノーログポリシーの検証を受けている。 
 
<center>
{| class="wikitable"
|+ ノーログポリシー監査実績
! 監査機関 !! 時期 !! 結果
|-
| Altius IT || 2019年 || 合格
|-
| Cure53 || 2020年, 2023年 || 合格
|-
| KPMG || 2021年以降 (最終: 2023年4月) || 合格
|}
</center>
 
Altius ITの監査では、特定の個人を識別したり、PureVPNサービス使用時の当該個人のアクティビティを識別できるシステム構成またはシステム/サービスログファイルの証拠は見つからなかった と結論付けられている。 
 
また、PureVPNは常時監査ポリシー (Always-On Audit Policy) を採用しており、大手監査機関に事前通告なしでいつでも監査を実施する権限を付与している。 
 
==== 透明性レポート (2025年上半期) ====
PureVPNが公開している2025年上半期 (1月〜6月) の透明性レポートの概要を以下に示す。 
 
* 法執行機関からのデータリクエスト : 43,358件 (前年同期比100%増加)
* 提供したユーザデータ : 0件
* 内訳
*: 法廷命令 (court orders) : 8件
*: 緊急開示要求 (emergency disclosure requests) : 4件
*: サブポエナ (subpoenas) : 2件
 
PureVPNはシステムアーキテクチャの特性により、全てのデータリクエストへの対応が物理的に不可能であると主張している。 
 
==== 過去のセキュリティ脆弱性 ====
ノーログポリシーとは別に、PureVPNクライアントにおいて以下のセキュリティ脆弱性が報告されている。 
 
* 2023年 : Linuxクライアントにおいて、DNSリーク脆弱性が発見された。(パッチ適用済み)
* 2024年 : Linuxクライアントにおいて、リモートコード実行 (RCE) 脆弱性が発見された。(パッチ適用済み)
 
==== 総合的な評価 ====
* 信頼できる側面
*: 複数の独立した第三者監査機関がノーログポリシーを検証済み
*: 4万件超のデータリクエストに対してゼロ開示を実現
*: 常時監査ポリシーおよびシステムアーキテクチャレベルでデータ保有を不可能にする設計への移行
* 懸念される側面
*: 2017年にノーログと謳いながらFBIへ情報提供を行った前科がある
*: Linuxクライアントにおいて重大なセキュリティ脆弱性が複数回報告されている
*: プライバシーを最重要視するユーザには、過去に信頼違反のないVPN (MullvadやProtonVPN等) を推奨するセキュリティ専門家が多い
 

== 契約手順 ==
PureVPNの契約手順を以下に記載する。 
 
# [https://www.purevpn.com/ PureVPNの公式Webサイト]へアクセスして、ページ上部にある[Get PureVPN]を選択する。
# [注文ページ]では、プラン層を選択する。
#* Standard
#*: VPN機能のみ
#* Plus
#*: VPN + パスワードマネージャー + クラウドストレージ
#* Max
#*: Plus機能 + パーソナルプライバシーマネージャー
# 契約期間を選択する。(1ヶ月、1年、2年、5年)
# メールアドレスを入力して、パスワードを設定する。
# 支払い方法を選択する。(クレジットカード、PayPal、Google Pay、暗号通貨)
# 購入内容を確認して、支払いを完了する。
 
PureVPN Standardプランの料金は、2年プランで合計54.95ドル (平均2.03ドル/月) である。(2026年時点) 
1ヶ月プランでは、11.95ドル/月である。 
 
全てのプランに31日間の返金保証が付帯している。 
 

== 依存関係のライブラリのインストール ==
PureVPNソフトウェアを実行するために必要な依存関係のライブラリをインストールする。 
# RHEL
sudo dnf install python3 curl openvpn NetworkManager-openvpn \
NetworkManager-openvpn-gnome # GNOMEを使用する場合
plasma-nm5-openvpn # KDEを使用する場合

# SUSE
sudo zypper install python3 curl openvpn NetworkManager-openvpn \
NetworkManager-openvpn-gnome # GNOMEを使用する場合
plasma-nm5-openvpn # KDEを使用する場合
 

== PureVPN GUIの使用 ==
PureVPN GUIは、debパッケージまたはSnapストア経由でインストールすることができる。 
 
debパッケージは、Debian / Ubuntuに対応している。 
Snapストアは、Ubuntu、Debian、Fedora、Arch Linux、Manjaro、Kali Linux、RHEL 7.6以降等の多くのLinuxディストリビューションに対応している。 
 
==== debパッケージを使用する場合 ====
PureVPN GUIの実行に必要なライブラリをインストールする。 
# Debian / Ubuntu
sudo apt install libgtk-3-0 libnotify4 libnss3 libxss1 libxtst6 \
xdg-utils libatspi2.0-0 libuuid1 libsecret-1-0 libappindicator3-1 \
wireguard-tools
 
[PureVPNの公式Webサイト https://www.purevpn.com/download/linux-vpn]にアクセスして、PureVPNをダウンロードする。 
ダウンロードしたファイルをインストールする。 
sudo apt install ./PureVPN_amd64.deb
# または
sudo dpkg -i PureVPN_amd64.deb
 
==== Snapストアを使用する場合 ====
Snapストア経由でPureVPN GUIをインストールする。 
sudo snap install purevpn
 
PureVPN GUIは、以下に示すディレクトリにインストールされる。 
* Systemdサービスユニット
*: /etc/systemd/system/pured.service
* PureVPN実行バイナリファイル
*: /opt/PureVPNディレクトリ
 

== PureVPN CLIの使用 ==
PureVPN CLIを使用して、オンラインのプライバシーとセキュリティを完全に制御することもできる。 
CLIは、Ubuntu、Debian、Mint等のLinuxディストリビューションに対応している。 
 
==== PureVPN CLIのインストール ====
PureVPN CLIをインストールする。 
curl https://apps.purevpn-tools.com/cross-platform/linux-cli/production/cli-install.sh | sudo bash
 
インストールが完了した後、PureVPN CLIの環境変数<code>PATH</code>を設定する。 
<syntaxhighlight lang="sh">
export PATH="/etc/pure-linux-cli:/etc/pure-linux-cli:$PATH"
</syntaxhighlight>
 
==== PureVPNへログイン ====
purevpn-cli --login
# または
purevpn-cli -i
 
==== PureVPNのログアウト ====
PureVPN CLIを使用して、ログアウトする。 
 
※注意 
ログアウトする前に、PureVPNが切断されていることを確認する。 
 
purevpn-cli --logout
# または
purevpn-cli -o
 
==== 接続 ====
任意のロケーションに接続する場合は、<code>--connect</code>オプションまたは<code>-c</code>オプションを付加して国名を指定する。 
# 例: USに接続する場合

purevpn-cli --connect "United States"
# または
purevpn-cli -c "US"
 
推奨サーバを使用する場合は、<code>--recommended</code>オプションまたは<code>-r</code>オプションを付加する。 
推奨サーバとは、スマートアルゴリズム (地理的距離に基づいて) により提案された国 / サーバに自動的に接続する。 
purevpn-cli --recommended
# または
purevpn-cli -r
 
==== 切断 ====
PureVPNを切断する。 
purevpn-cli --disconnect
# または
purevpn-cli -d
 
==== ロケーションの確認 ====
ロケーションおよびロケーションコードのリストを確認することもできる。 
purevpn-cli --location
# または
purevpn-cli -l
 
==== プロトコルの切り替え ====
VPNプロトコルの選択は、接続のパフォーマンスと安定性に大きく影響する。 
VPNサーバに接続する場合は、正しいプロトコルを選択することが重要である。 
 
PureVPNでは、自動プロトコルを使用することを推奨している。 
ただし、自動プロトコルオプションが機能しない場合は、必要に応じて異なるプロトコルを切り替えることができる。 
 
* WireGuard (推奨)
*: WireGuardは、高速で安全なVPN接続を提供しており、ブラウジングやストリーミングに使用される。
* UDP
*: UDPは、主にストリーミングやダウンロードに使用される。
* TCP
*: TCPはより信頼性が高いですが、やや遅く、ブラウジングに使用される。
 
プロトコルを切り替えるコマンドを以下に示す。 
# 自動プロトコルを使用
purevpn-cli --protocol auto
# または
purevpn-cli -p auto

# WireGuardを使用
purevpn-cli --protocol wireguard
# または
purevpn-cli -p wireguard
 
現在選択されているプロトコルを表示することもできる。 
purevpn-cli --protocol
# または
purevpn-cli -p
 
==== アカウントの確認 ====
PureVPN CLIを使用して、アカウントの詳細を表示する。 
purevpn-cli --account
# または
purevpn-cli -a
 

== NetworkManagerの使用 ==
RHELおよびSUSE等では、NetworkManagerおよびOpenVPN / WireGuard設定ファイルを使用して手動で設定する必要がある。 
openSUSE Tumbleweed / Leapについては、PureVPN公式のセットアップガイドも提供されている。 
 
PureVPNのOpenVPNファイルは不定期で更新されるため、その都度、新しいOpenVPNファイルを使用・設定する必要がある。 
 
==== GNOMEの場合 ====
# まず、VPN認証情報を確認するため、PureVPNメンバーエリアにログインする。
#: URL : https://my.purevpn.com/v2/dashboard/subscriptions
# 画面左にある[サブスクリプション]タブを選択する。
# 下にスクロールして、VPN認証情報を確認する。
# PureVPNのユーザ名とパスワードをコピーする。
# [https://support.purevpn.com/purevpn/openvpn-files PureVPNの公式Webサイト]にアクセスして、OpenVPN設定ファイルをダウンロードする。
# ダウンロードしたファイルを解凍する。
#: <code>unzip Recommended-CA2.zip</code>
 
NetworkManagerを使用して、OpenVPNを設定する。 
 
# OpenVPNの設定ファイルをインポートして使用するために必要な依存関係のライブラリをインストールする。
#: <code>sudo zypper install openvpn NetworkManager-openvpn NetworkManager-openvpn-gnome</code>
# GNOMEのホーム画面右上にある[ネットワーク]アイコンをクリックして、[有線接続]プルダウンから[有線設定]を選択する。
# [設定]画面が開くので、画面左にある[ネットワーク] - 画面右の[VPN]項目の右にある[＋]ボタンを押下する。
# [VPNの追加]画面が開くので、[ファイルからインポート...]を選択する。
# 上記で解凍したOpenVPN設定ファイルを選択して、画面右上にある[開く]ボタンを押下する。 ここで、OpenVPNファイルの命名形式は、<ロケーション>-ovpn-tcp、または、<ロケーション>-ovpn-udpである。 例: hu2-ovpn-tcp.ovpn
# 選択したOpenVPN設定ファイルが未保存のセッションとしてNetworkManagerにインポートされるので、[VPNの追加]画面から以下に示す項目を入力および設定する。
#* [接続名]
#*: 任意の名前 (例: PureVPN)
#* [Gateway]
#*: 自動的に入力される。
#* [接続タイプ]
#*: [パスワード]を選択する。
#* [ユーザ名]
#*: 上記でコピーしたユーザ名を入力する。
#* [パスワード]
#*: 上記でコピーしたパスワードを入力する。
#* [CA証明書]
#*: 自動的に入力される。
#*: もし、自動入力されない場合は、~/.cert/nm-openvpnディレクトリの<ロケーション>-ovpn-ca.pemファイルを指定する。
# [VPNの追加]画面にある[IPv6]タブを選択して、[無効]ボタンを選択する。
# [VPNの追加]画面右上にある[追加]ボタンを押下する。
# 上記で選択したPureVPNのOpenVPN設定が作成されて、PureVPNのOpenVPNセッションが[VPN]項目の選択エリアにリストされていることを確認する。
 
[VPN]項目の選択エリアにあるスライダースイッチを押下することにより、接続および切断を切り替えることができる。 
 
また、GNOMEのホーム画面右上にある[ネットワーク]アイコンをクリックして、VPNの接続および切断を切り替えることができる。 
 

==== KDEの場合 ====
# まず、VPN認証情報を確認するため、PureVPNメンバーエリアにログインする。
#: URL : https://my.purevpn.com/v2/dashboard/subscriptions
# 画面左にある[サブスクリプション]タブを選択する。
# 下にスクロールして、VPN認証情報を確認する。
# PureVPNのユーザ名とパスワードをコピーする。
# [https://support.purevpn.com/purevpn/openvpn-files PureVPNの公式Webサイト]にアクセスして、OpenVPN設定ファイルをダウンロードする。
# ダウンロードしたファイルを解凍する。
#: <code>unzip Recommended-CA2.zip</code>
 
NetworkManagerを使用して、OpenVPNを設定する。 
# OpenVPNの設定ファイルをインポートして使用するために必要な依存関係のライブラリをインストールする。
#: <code>sudo zypper install openvpn NetworkManager-openvpn plasma-nm5-openvpn</code>
# [KDEシステム設定]を起動して、[接続]を選択する。
# [接続]画面が開くので、画面左下(接続先リストの下)にある[+]を押下する。
# [接続タイプの選択]画面が開くので、リストの最下行にある[VPN接続をインポート...]オプションを選択して[作成]ボタンを押下する。
# [VPN接続をインポート]画面が開くので、解凍したディレクトリ内にあるOpenVPNファイル(VPNサーバ)を選択する。
#: 例: hu2-ovpn-tcp.ovpn
# 証明書をコピーするよう求められたら、[はい]ボタンを押下する。
# [接続]画面左にPureVPNのVPN接続が表示されるので、任意の名前 (PureVPN) と入力する。
# [接続]画面右にある[VPN(openvpn)]タブを選択して、以下に示す設定を行う。
#* [接続名]
#*: 任意の名前 (例: PureVPN)
#* [Gateway]
#*: 自動的に入力される。
#* [接続タイプ]
#*: [パスワード]を選択する。
#* [ユーザ名]
#*: 上記でコピーしたユーザ名を入力する。
#* [パスワード]
#*: 上記でコピーしたパスワードを入力する。
#* [CA証明書]
#*: 自動的に入力される。
#*: もし、自動入力されない場合は、~/.cert/nm-openvpnディレクトリの<ロケーション>-ovpn-ca.pemファイルを指定する。
 

== 接続の確認 ==
IPアドレスが匿名かつプライベートなPureVPNに変更されたことを確認する場合は、まず、Webブラウザのクッキーおよびキャッシュを削除する。 
 
* IPv6のリークの確認
*: https://www.purevpn.com/ipv6-leak-test
*: 
* DNSリークの確認
*: https://www.purevpn.com/dns-leak-test
 

== WireGuardの使用 ==
PureVPNは、WireGuardの手動設定をサポートしている。 
ユーザは、WireGuard VPN接続を手動で設定して、強化された暗号化と高速パフォーマンスを活用することができる。 
 
WireGuardのサポートを追加することにより、VPN接続の設定に関してより多くのオプションと柔軟性をユーザに提供することができる。 
 
※注意 
WireGuardの設定を行うには、Ubuntu 21.04以降、Fedora 35以降が必要となる。 
 
==== WireGuardのインストール ====
WireGuardの設定に必要なライブラリをインストールする。 
# RHEL
sudo dnf install wireguard-tools

# SUSE
sudo zypper install wireguard-tools
 
==== WireGuardの設定 ====
WireGuard設定ファイルをダウンロードする。 
 
# まず、VPN認証情報を確認するため、PureVPNメンバーエリアにログインする。
#: URL : https://my.purevpn.com/v2/dashboard/subscriptions
# 画面左にある[Manual Configuration]タブを選択する。
# 接続するロケーションを選択して、[ダウンロード]ボタンを押下する。
# 必要な情報を選択するポップアップウインドウが表示される。
## [プロトコルを選択]プルダウンから[WireGuard]を選択する。
## [Select Device]プルダウンから[Linux] (Linuxを使用している場合) を選択する。
## [Generate Configration]ボタンを押下する。
## [WireGuard Configuration:]の設定をコピーする。 または、.confファイルをダウンロードする。
※注意 
WireGuardの設定ファイルをダウンロードした後、必ず30分以内にファイルをコピーして接続を有効にする必要がある。 
 
WireGuard VPN接続を設定するため、コピーまたはダウンロードしたファイル内容を書き込む。 
sudo vi /etc/wireguard/wg0.conf
 
==== WireGuardの接続 ====
WireGuard接続を有効にする。 
sudo wg-quick up wg0
 
==== WireGuardの切断 ====
WireGuard接続を切断する。 
sudo wg-quick down wg0
 

== DNSリーク ==
IPv6を使用する場合、DNSリークを起こす可能性がある。 
この時、IPv6を無効にすることにより、DNSリークを起こさないようにすることができる。 
 
ただし、WebブラウザがChromium系ブラウザ(Vivaldiも含む)の場合、以下の設定を行ってもDNSリークが起きることに注意すること。 
 
IPv6を無効にするため、/etc/sysctl.dディレクトリに設定ファイルを作成する。 
sudo vi /etc/sysctl.d/99-ipv6.conf
 
# /etc/sysctl.d/99-ipv6.confファイル

net.ipv6.conf.all.disable_ipv6 = 1
net.ipv6.conf.default.disable_ipv6 = 1
net.ipv6.conf.lo.disable_ipv6 = 1
 
上記の設定を反映する。 
sudo sysctl -p
# または
sudo sysctl -p /etc/sysctl.d/99-ipv6.conf
 
IPv6が正常に無効化されたかどうかを確認する。 
<code>1</code>と表示される場合、IPv6は正常に無効化されている。 
cat /proc/sys/net/ipv6/conf/all/disable_ipv6
 
以下に示すURLにアクセスして、IPv6が無効化されているかどうかを確認する。 
* https://www.whatismyip.com/
 
次に、Webブラウザのクッキーおよびキャッシュを削除して、DNSリークを確認するため、以下に示すURLにアクセスする。 
* https://www.purevpn.com/dns-leak-test
 
<code>sysctl</code>コマンドは、以下に示す場所から設定を読み込む。 
初期設定を無効化または上書きする場合は、/etc/sysctl.dディレクトリに同名のファイルを作成して配置する。 
* /boot/sysctl.conf-<kernelversion>
* /lib/sysctl.d/*.conf
* /usr/lib/sysctl.d/*.conf
* /usr/local/lib/sysctl.d/*.conf
* /etc/sysctl.d/*.conf
* /run/sysctl.d/*.conf
* /etc/sysctl.conf
 

== VPN over Tor ==
PureVPNは、VPN over TORをサポートしていない。 
VPN接続、または、Tor over VPN接続のみが使用できることに注意する。 
 

== Tor over VPN ==
VPNネットワーク経由でTorに接続する方法であり、Torは終了ノードになる。(Tor over VPN) 
 
# PureVPN GUI / CLI または NetworkManagerを使用して、VPNに接続する。
# [https://www.torproject.org/download/ Torブラウザの公式Webサイト]にアクセスして、Torブラウザをダウンロードおよびインストールする。
# Torブラウザを起動して、[Connect]ボタンを押下する。 Torブラウザの設定はデフォルトのままでよい。
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:PinePhone]][[カテゴリ:Windows7]][[カテゴリ:Windows10]][[カテゴリ:Windows11]]

VPN - PrivateVPN

2026-03-24T11:04:16Z

Wiki: /* ノーログポリシーの実態 */

== 概要 ==
PrivateVPNは、200以上のサーバからなる小規模なネットワークを運営しており、これらは63カ国以上に配置されている。 
さらに、ラグフリーストリーミングのための高速な接続を提供している。 
 
256ビットAES暗号化、DNSリークからの保護、キルスイッチが用意されており、その厳格なノーログポリシーによって、ユーザのプライバシーを保護する。 
 
Linuxにおいて、PrivateVPNの設定に問題がある場合、ライブチャットと電子メールサポートを利用することができる。 
また、無料のリモートヘルプとインストールも利用できる。 
 
PrivateVPNは、現在、Linux向けのCLIソフトウェアをサポートしている。 
高速で安定した接続と、地理的制限のあるコンテンツの確実なブロック解除が可能である。 
 
Linuxの他にも、Windows、MacOS、Android、iOS、Amazon Fire TV用のPrivateVPNソフトウェアが存在する。 
また、個別の無線ルータで動作するように手動で設定することも可能である。 
 
なお、PrivateVPNは2009年にMartin Muller氏によりスウェーデンで設立された。(運営会社: Privat Kommunikation Sverige AB) 
2022年6月にWebホスティング企業であるMiss Groupに買収されており、創業者は離任している。 
 
* PrivateVPNの長所
** セットアップガイドとカスタマーサポートでユーザフレンドリーである。
** ストリーミングとトレント用の高速サーバーが存在する。
** 人気のあるストリーミングプラットフォームの一貫したブロック解除ができる。
** 厳格なノーログポリシーによるオンラインの匿名性。
** 30日間返金保証。
*: 
* PrivateVPNの短所
** サーバのネットワークが小さい。(全部で200程度しかない)
** ライブチャットが24時間利用できない。
 
PrivateVPNの特徴を以下に示す。 
* ノーログポリシー
*: スウェーデンに会社があり、スウェーデンの個人情報保護法では、政府によって押収されるようなトラフィックログを保存することはない。
* 無制限の帯域幅と速度
*: 他のVPNで見られるような、ビデオのバッファリング、低速なダウンロード、ルーティングホップによるタイムアウトは無い。
* 無料リモートヘルプとインストール
*: サービスに関する問題やヘルプが必要な場合、リモートサポートは無料で行うことができる。
* 10台同時接続
*: 最大10台のデバイスを同時に接続できるVPNであり、全て固有のIPアドレスで接続できる。
* ポートフォワード
*: Torrentに不可欠なオープンポートを少なくとも1つ提供している。
* AES-256による2048ビットの暗号化
*: 軍事でも使用されている最高レベルの暗号化技術を使用している。
 
PrivateVPNの料金は、月額2.00ドルからである。(2025年時点、30日間返金保証付き) 
 

== ノーログポリシーの実態 ==
PrivateVPNはノーログVPNを標榜しており、スウェーデンの強力なプライバシー法を根拠として、データログを保存または共有する法的義務がないと主張している。 
 
==== 公式ノーログポリシーの内容 ====
PrivateVPNの公式プライバシーポリシーでは、以下のデータを一切保存しないと明記している。 
 
* ブラウジング履歴およびトラフィック宛先
* 接続タイムスタンプ
* DNSクエリ
* IPアドレス (割り当てIP、接続IP両方)
* データコンテンツ
* 帯域幅使用量
 
収集されるデータは、ログインメールアドレス、パスワード、支払い方法情報等のアカウント管理に必要な最小限の情報のみである。 
 
==== 過去の捜査機関へのデータ提供 ====
2025年時点の公開情報において、PrivateVPNが法執行機関にユーザデータを提供した具体的な事例、裁判記録、またはリークは確認されていない。 
 
PrivateVPNは "ノーログポリシーを採用しているため、有事の場合でも提出できるデータが存在しない" という立場をとっている。 
ただし、この主張は第三者監査によって検証されていないことに注意する必要がある。 
 
==== 第三者監査の状況 ====
PrivateVPNは、独立した外部監査を一度も受けていない。 
これは業界内での重大な弱点と見なされている。 
 
競合他社との比較として、NordVPNはDeloitteによる監査 (2024年)、IPVanishはSchellman Compliance LLCによる監査 (2025年) を受けており、 
ノーログポリシーの検証において、PrivateVPNは遅れをとっている状況である。 
 
==== 管轄法域に関する懸念 ====
PrivateVPNの拠点であるスウェーデンは、14 Eyes監視協定に加盟している。 
14 Eyes構成国間では、情報機関が収集した情報を共有する枠組みが存在する。 
 
ただし、スウェーデンのプライバシー法により、ノーログポリシーを採用しているVPNプロバイダに対するデータ保持義務は課されていない。 
したがって、ノーログポリシーが正しく実装されている場合、14 Eyesの影響は限定的であると考えられる。 
 
==== 運営体制の変遷 ====
<center>
{| class="wikitable"
|+ PrivateVPNの運営体制の変遷
! 時期 !! 出来事
|-
| 2009年 || Martin Muller氏によりスウェーデンで設立 (運営会社: Privat Kommunikation Sverige AB)
|-
| 2022年6月 || Webホスティング企業のMiss Groupが買収。創業者Martin Muller氏は離任
|-
| 現在 || Miss Group傘下で運営。Miss GroupはPerwyn (プライベートエクイティ企業) が支援
|}
</center>
 
==== 専門家の評価 ====
2025年から2026年時点における専門家の評価は以下の通りである。 
 
<center>
{| class="wikitable"
|+ PrivateVPNの専門家評価
! 評価サイト !! スコア !! 備考
|-
| VPNMentor || 9.2/10 (193中7位) || ストリーミング性能、価格を評価
|-
| Trustpilot || 4.9/5 || 高い顧客満足度
|-
| TechRadar || 非推奨 || 投資不足による遅れを指摘
|-
| TheBestVPN || 30中22位 || 非推奨
|}
</center>
 
主な強みとして、価格競争力 (月額 $2.00から)、ストリーミング性能、基本的なプライバシー保護が挙げられる。 
一方、主な弱みとして、第三者監査の欠落、限定されたサーバネットワーク、Linuxアプリの未提供、スプリットトンネリングおよび二重VPN機能の未対応が指摘されている。 
 

== 契約手順 ==
# [https://privatevpn.com/prices/comparitech PrivateVPNの公式Webサイト]にアクセスする。
# 1ヶ月、3ヶ月、3年のいずれかのプランを選択する。
# E-mailアドレスおよびパスワードを入力してログイン、または、PrivateVPNのアカウントを作成する。
# 支払い方法を選択する。 クレジットカード、Paypal、Bitcoinが使用できる。
 

== 依存関係のライブラリのインストール ==
PrivateVPNソフトウェアを実行するために必要な依存関係のライブラリをインストールする。 
 
# RHEL
sudo dnf install python3 curl openvpn NetworkManager-openvpn \
NetworkManager-openvpn-gnome # GNOMEを使用する場合
plasma-nm-openvpn # KDEを使用する場合

# SUSE
sudo zypper install python3 curl openvpn NetworkManager-openvpn \
NetworkManager-openvpn-gnome # GNOMEを使用する場合
plasma-nm5-openvpn # KDEを使用する場合
 

== ネットワークマネージャトンネルを使用する場合 (推奨) ==
まず、以下に示す2つのファイルをダウンロードする。 
* 証明書ファイル
*: http://privatevpn.com/client/ca.crt
* 鍵ファイル
*: http://privatevpn.com/client/ta.key
 
* GNOMEの場合
# GNOMEのホーム画面右上にある[ネットワーク]アイコンをクリックして、[設定]アイコンを選択する。
# [設定]画面が開くので、画面左にある[ネットワーク] - 画面右の[VPN]項目の右にある[＋]ボタンを押下する。
# [VPNの追加]画面が開くので、[OpenVPN]を選択して、[Create]ボタンを押下する。
# 以下に示す情報を入力する。 もし、Linuxの起動時にVPNを自動的に接続する場合は、[自動的に接続する]を選択する。
#* 接続名
#*: PrivateVPN
#* ゲートウェイ
#*: 接続先サーバが存在する国のアドレスを入力する。
#*: スウェーデンの場合 : se-sto.privatevpn.host
#*: サーバリストの詳細は、https://privatevpn.com/serverlist を参照すること。
#* タイプ
#*: [パスワード]を選択する。
#* ユーザ名
#*: PrivateVPNアカウントのメールアドレスを入力する。
#* パスワード
#*: PrivateVPNアカウントのパスワードを入力する。
#* CA証明書
#*: 上記でダウンロードした証明書ファイル(ca.crtファイル)を選択する。
# [Advanced]ボタンを押下して、[OpenVPN Advanced Options]画面を開く。
#* [General]タブを選択する。
#*: [LZOデータ圧縮を使用する]チェックボックスにチェックを入力する。
#*: [仮想デバイスの種類を設定]チェックボックスにチェックを入力して、[TUN]を選択する。
#*: [IPv6 tun link]チェックボックスにチェックを入力する。
#* [セキュリティタブ]を選択する。
#*: [暗号]プルダウンから[AES-256-CBC]を選択する。
#*: [HMAC認証]プルダウンから[SHA-256]を選択する。
#* [TLS認証]タブを選択する。
#*: [相手（サーバ）の証明書使用状況の署名を確認する]チェックボックスにチェックを入力して、プルダウンから[サーバ]を選択する。
#*: [追加のTLS認証を使用する]チェックボックスにチェックを入力する。
#*: [キーファイル]を、上記でダウンロードした鍵ファイル(ta.keyファイル)を選択する。
#*: [Key Direction]プルダウンから[1]を選択する。
# GNOMEのホーム画面右上にある[ネットワーク]アイコンをクリックして、[VPN接続] - [PrivateVPN]を選択する。
 
* KDEの場合
# [KDEシステム設定]を起動して、[接続]を選択する。
# [接続]画面が開くので、画面左下(接続先リストの下)にある[+]を押下する。
# [接続タイプの選択]画面が開くので、リストから[OpenVPN]を選択して[作成]ボタンを押下する。
# [新しい接続]画面が開くので、以下に示す情報を入力する。
#* [接続名]
#*: 任意でよい。
#*: 例. PrivateVPN
#* [ゲートウェイ]
#*: 接続先サーバが存在する国のアドレスを入力する。
#*: サーバリストの詳細は、https://privatevpn.com/serverlist を参照すること。
#*: 例. スウェーデンの場合 : se-sto.privatevpn.host
#* [接続タイプ]
#*: パスワードを選択する。
#* [CA証明書]
#*: 上記でダウンロードした証明書ファイル(ca.crtファイル)を選択する。
#* [ユーザ名]
#*: PrivateVPNアカウントのメールアドレスを入力する。
#* [パスワード]
#*: PrivateVPNアカウントのパスワードを入力する。
# [Advanced]ボタンを押下して、[OpenVPN Advanced Options]画面を開く。
#* [General]タブを選択する。
#*: [Use Compression]チェックボックスにチェックを入力して、プルダウンから[LZO]を選択する。
#*: [Set virtual device type:]チェックボックスにチェックを入力して、プルダウンから[TUN]を選択する。
#*: [IPv6 tun link]チェックボックスにチェックを入力する。
#* [Security]タブを選択する。
#*: [Cipher:]プルダウンから[AES-256-CBC]を選択する。
#*: [HMAC Authentication:]プルダウンから[SHA-256]を選択する。
#* [TLS Settings]タブを選択する。
#*: [Verify peer（server） certificate usage signature]チェックボックスにチェックを入力して、プルダウンから[Server]を選択する。
#*: [Mode:]プルダウンから[TLS-Auth]を選択する。
#*: [Key File:]を、上記でダウンロードした鍵ファイル(ta.keyファイル)を選択する。
#*: [Key Direction:]プルダウンから[Client(1)]を選択する。
# [OK]ボタンを押下して、[OpenVPN Advanced Options]画面を閉じる。
# [接続]画面右にある[IPv6]タブを選択して、[この接続には IPv6 が必要]チェックボックスのチェックを外す。(この設定は不要の可能性あり)
# [接続画面]右下にある[適用]ボタンを押下する。
# タスクバーにあるネットワークアイコンをクリックすると、PrivateVPNのOpenVPNが表示されるので、[接続]ボタンを押下する。
 

== PrivateVPN CLIを使用する場合 ==
# [https://privatevpn.com/client/install.sh PrivateVPNの公式Webサイト]から、CLIソフトウェアのインストーラをダウンロードする。 または、<code>wget</code>コマンド等を使用してダウンロードする。
#: <code>wget https://privatevpn.com/client/install.sh</code>
# ダウンロードしたインストーラに実行権限を付加する。
#: <code>chmod u+x install.sh</code>
# スーパーユーザ権限でインストーラを実行する。 スーパーユーザ権限で実行する理由は、OpenVPNの接続時において、トンネルインターフェイスを作成するためである。
#: <code>sudo ./install.sh</code>
# /etc/openvpn/privatvpn.confファイルを編集して、接続先のVPNサーバを変更することができる。 サーバリストの詳細は、https://privatevpn.com/serverlist を参照すること。
 

== WireGuardの使用 ==
# WireGuardの接続に必要なツールをインストールする。
#: <code>sudo zypper install wireguard-tools</code>
#: 
# [https://privatevpn.com/account/login PrivateVPNの公式Webサイト]にアクセスして、ログインする。
# [https://privatevpn.com/control-panel PrivateVPNのコントロールパネル]にアクセスする。
# コントロールパネル画面左にある[WireGuard Config]から、使用するVPNサーバを選択するため、[Generate Config]ボタンを押下する。
# コントロールパネルにWireGuardの設定が生成および表示されるので、ダウンロードアイコンを押下する。
#: 
# WireGuardを使用してVPNネットワークに接続する。
#: <code>sudo wg-quick up <WireGuardの設定ファイルのパス></code>
#: 
# 正常にVPNネットワークに接続しているかどうかを確認する。
#: <code>sudo wg show</code>
#: 
# VPNネットワークを切断する。
#: <code>sudo wg-quick down <WireGuardの設定ファイルのパス></code>
 

== DNSリーク ==
IPv6を使用する場合、DNSリークを起こす可能性がある。 
この時、IPv6を無効にすることにより、DNSリークを起こさないようにすることができる。 
 
ただし、WebブラウザがChromium系ブラウザ(Vivaldiも含む)の場合、以下の設定を行ってもDNSリークが起きることに注意すること。 
 
IPv6を無効にする手順を、以下に示す。 
# IPv6を無効にするため、/etc/sysctl.confファイルに以下に示す設定を追記する。
#: <code>sudo vi /etc/sysctl.d/00-ipv6.conf</code>
#: 
#: <code># /etc/sysctl.d/00-ipv6.confファイル</code>
#: 
#: <code>net.ipv6.conf.all.disable_ipv6 = 1</code>
#: <code>net.ipv6.conf.default.disable_ipv6 = 1</code>
#: <code>net.ipv6.conf.lo.disable_ipv6 = 1</code>
#: 
# 上記の設定を反映する。
#: <code>sudo sysctl -p</code>
#: 
# IPv6が正常に無効化されたかどうかを確認する。 <code>1</code>と表示される場合、IPv6は正常に無効化されている。
#: <code>cat /proc/sys/net/ipv6/conf/all/disable_ipv6</code>
#: 
# 以下に示すURLにアクセスして、IPv6が無効化されているかどうかを確認する。
#: https://www.whatismyip.com/
#: 
# 次に、Webブラウザのクッキーおよびキャッシュを削除する。
# 最後に、以下に示すURLにアクセスして、DNSリークを確認する。
#: https://www.dnsleaktest.com/
 
<code>sysctl</code>は、以下に示す場所から設定を読み込む。 
初期設定を無効化または上書きする場合は、/etc/sysctl.dディレクトリに同名のファイルを作成して配置する。 
* /boot/sysctl.conf-<kernelversion>
* /lib/sysctl.d/*.conf
* /usr/lib/sysctl.d/*.conf
* /usr/local/lib/sysctl.d/*.conf
* /etc/sysctl.d/*.conf
* /run/sysctl.d/*.conf
* /etc/sysctl.conf
 

== Torブラウザのプロキシ設定 ==
==== SOCKS5プロキシを使用する場合 ====
# Torブラウザを起動して、[Tor Network Settings]ボタンを押下する。
# [設定]画面の[Advanced]項目から、プロキシの設定を行う。
#* [I use a proxy to connect to the Internet]チェックボックス
#*: チェックを入力する。
#* [Proxy Type]プルダウン
#*: SOCKS 5
#* [Address]
#*: [https://privatevpn.com/serverlist PrivateVPNのサーバリスト]から、任意のプロキシサーバのアドレスを入力する。
#*: 例. se-sto.pvdata.host
#* [Port]
#*: 1080
#* [Username]
#*: ユーザ名は、[https://privatevpn.com/account/login PrivateVPNの公式Webサイト]にログインして、[https://privatevpn.com/control-panel コントロールパネル]に進むと表示される。
#* [Password]
#*: パスワードは、[https://privatevpn.com/account/login PrivateVPNの公式Webサイト]にログインして、[https://privatevpn.com/control-panel コントロールパネル]に進むと表示される。
# Torブラウザにある[Connect]ボタンを押下して、Torネットワークに接続する。
 
==== HTTP / HTTPSプロキシを使用する場合 ====
# Torブラウザを起動して、[Tor Network Settings]ボタンを押下する。
# [設定]画面の[Advanced]項目から、プロキシの設定を行う。
#* [I use a proxy to connect to the Internet]チェックボックス
#*: チェックを入力する。
#* [Proxy Type]プルダウン
#*: HTTP / HTTPS
#* [Address]
#*: [https://privatevpn.com/serverlist PrivateVPNのサーバリスト]から、任意のプロキシサーバのアドレスを入力する。
#*: 例. se-sto.pvdata.host
#* [Port]
#*: 8080
#* [Username]
#*: ユーザ名は、[https://privatevpn.com/account/login PrivateVPNの公式Webサイト]にログインして、[https://privatevpn.com/control-panel コントロールパネル]に進むと表示される。
#* [Password]
#*: パスワードは、[https://privatevpn.com/account/login PrivateVPNの公式Webサイト]にログインして、[https://privatevpn.com/control-panel コントロールパネル]に進むと表示される。
# Torブラウザにある[Connect]ボタンを押下して、Torネットワークに接続する。
 

== VPN over Tor ==
VPNサーバへの接続にTorネットワークを使用することができる。 
これを、VPN over Tor、あるいは、VPN through Torと呼ぶ。 
 
Torネットワークがブリッジとして機能するため、自宅のIPをPrivateVPNに公開することなく、PrivateVPNに接続することを意味する。 
したがって、プライバシー、セキュリティ、匿名性への2重層を提供する。 
 
# [https://www.torproject.org/download/ Torブラウザの公式Webサイト]にアクセスして、Torブラウザをダウンロードおよびインストールする。
# Torブラウザを起動して、Torネットワークに接続する。
# Torブラウザで任意のWebサイトを開いて、Torブラウザのアドレスバーの左側にある鍵アイコンを選択する。
# "ガードノード(エントリーノード)"、"中間"、"出口ノード"を含むTorネットワークの現在の回線情報が表示される。 この時、ガードノード(エントリーノード)のIPアドレスをコピーする。 最初のノードは、ガードノード(エントリーノード)と呼ばれており、これは頻繁に変更されない。 ただし、暫く時間が経って変更された場合、または、Torブラウザをアップデートした場合は、ガードノード(エントリーノード)のIPアドレスが変更されるため、 都度、OpenVPN設定ファイル内の値を変更する必要がある。
# [https://privatevpn.com/client/PrivateVPN-TUN.zip PrivateVPNの公式Webサイト]にアクセスして、PrivateVPNのOpenVPN設定ファイルをダウンロードする。 ダウンロードしたファイルを解凍する。 TorブラウザはTCPプロトコル(443番ポート)のみで動作するため、TCPディレクトリからPrivatVPN-<国名>-<都市名>-TUN-443.ovpnを使用する必要がある。
#: 
# 使用するOpenVPN設定ファイルを開いて、以下に示す内容を追記する。
#: <code># Windowsの場合</code>
#: <code># tor options</code>
#: <code>socks-proxy 127.0.0.1 9150</code>
#: <code>route <TorブラウザのガードノードのIPアドレス> 255.255.255.255 net_gateway</code>
#: 
#: <code># Linuxの場合</code>
#: <code># tor options</code>
#: <code>socks-proxy 127.0.0.1 9150</code>
#: <code>route <TorブラウザのガードノードのIPアドレス> 255.255.255.255 <自宅のデフォルトゲートウェイのIPアドレス></code>
#: 
# Torネットワーク経由でPrivateVPNのOpenVPNサーバに接続する。 上記で編集したOpenVPN設定ファイルをOpenVPNクライアントにインポートして接続する。 Torブラウザが起動していることを確認して、問題なく動作しているかどうかを確認する。
 

== Tor over VPN ==
VPNネットワーク経由でTorに接続する方法であり、Torは終了ノードになる。(Tor over VPN) 
 
# PrivateVPN CLIまたはNetworkManager等を使用して、VPNに接続する。
# [https://www.torproject.org/download/ Torブラウザの公式Webサイト]にアクセスして、Torブラウザをダウンロードおよびインストールする。
# Torブラウザを起動して、[Connect]ボタンを押下する。 Torブラウザの設定はデフォルトのままでよい。
 

== Torrentとの連携 ==
# まず、PrivateVPNサーバに接続する。 この時、[Port forwarding]項目に記載されているポート番号をコピーする。
# 次に、qBittorrentを起動して、[設定] - 画面左の[接続] - [受信接続に使用するポート]において、上記でコピーしたポート番号を入力する。
# 最後に、[ツール] - [設定] - [設定]画面左ペインにある[高度]を選択する。 [設定]画面右ペインにある[ネットワークインターフェイス]を、使用しているソフトウェアとプロトコルに応じて、次のいずれかに変更する。
#* PrivateVPNソフトウェアからOpenVPNで接続している場合
#*: tun0
#* NetworkManagerからOpenVPNで接続している場合
#*: tun0
#* PrivateVPNソフトウェアからWireGuardで接続している場合
#*: 
# [OK]ボタンを押下する。
# [ファイル] - [終了]を選択して、qBittorrentを再起動する。
 
qBittorrentの推奨設定を、以下に示す。 
# qBittorrentを起動して、[ツール］ - [設定]を選択する。
# [設定]画面左ペインにある[BitTorrent]を選択する。
# [設定]画面右ペインにある[匿名モードを有効にする]を選択する。
# [DHT(分散ネットワーク)を有効にする]チェックボックスのチェックを外す。
# [ピア交換(PeX)を有効にする]チェックボックスのチェックを外す。
# [ローカルピア検出(LSD)を有効にする]チェックボックスのチェックを外す。
# [設定]画面左ペインにある[接続]を選択して、[ピア接続プロトコル]プルダウンから[TCP]を選択する。
 

== VPNのログ ==
VPN接続に問題がある場合は、接続ログを送信することにより、問題を迅速に特定して、適切な解決策を得られる場合がある。 
 
==== Network Manager ====
# VPN接続のログを表示して、生成されたログをコピーする。
#: <code>sudo grep VPN /var/log/syslog</code>
#: または
#: <code>sudo grep VPN /var/log/syslog > <任意のログファイルのパス></code>
#: 
# [https://privatevpn.com/chat PrivateVPNの公式Webサイトにあるチャット]にアクセスして、チャットボックスから[Send us a message]ボタンを押下する。
# 上記で取得したVPN接続のログをチャットに貼り付けて、ユーザのEメールアドレスを入力する。
# [send]ボタンを押下する。
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:PinePhone]][[カテゴリ:Windows7]][[カテゴリ:Windows10]][[カテゴリ:Windows11]]

VPN - PrivateVPN

2026-03-24T11:02:59Z

Wiki:

== 概要 ==
PrivateVPNは、200以上のサーバからなる小規模なネットワークを運営しており、これらは63カ国以上に配置されている。 
さらに、ラグフリーストリーミングのための高速な接続を提供している。 
 
256ビットAES暗号化、DNSリークからの保護、キルスイッチが用意されており、その厳格なノーログポリシーによって、ユーザのプライバシーを保護する。 
 
Linuxにおいて、PrivateVPNの設定に問題がある場合、ライブチャットと電子メールサポートを利用することができる。 
また、無料のリモートヘルプとインストールも利用できる。 
 
PrivateVPNは、現在、Linux向けのCLIソフトウェアをサポートしている。 
高速で安定した接続と、地理的制限のあるコンテンツの確実なブロック解除が可能である。 
 
Linuxの他にも、Windows、MacOS、Android、iOS、Amazon Fire TV用のPrivateVPNソフトウェアが存在する。 
また、個別の無線ルータで動作するように手動で設定することも可能である。 
 
なお、PrivateVPNは2009年にMartin Muller氏によりスウェーデンで設立された。(運営会社: Privat Kommunikation Sverige AB) 
2022年6月にWebホスティング企業であるMiss Groupに買収されており、創業者は離任している。 
 
* PrivateVPNの長所
** セットアップガイドとカスタマーサポートでユーザフレンドリーである。
** ストリーミングとトレント用の高速サーバーが存在する。
** 人気のあるストリーミングプラットフォームの一貫したブロック解除ができる。
** 厳格なノーログポリシーによるオンラインの匿名性。
** 30日間返金保証。
*: 
* PrivateVPNの短所
** サーバのネットワークが小さい。(全部で200程度しかない)
** ライブチャットが24時間利用できない。
 
PrivateVPNの特徴を以下に示す。 
* ノーログポリシー
*: スウェーデンに会社があり、スウェーデンの個人情報保護法では、政府によって押収されるようなトラフィックログを保存することはない。
* 無制限の帯域幅と速度
*: 他のVPNで見られるような、ビデオのバッファリング、低速なダウンロード、ルーティングホップによるタイムアウトは無い。
* 無料リモートヘルプとインストール
*: サービスに関する問題やヘルプが必要な場合、リモートサポートは無料で行うことができる。
* 10台同時接続
*: 最大10台のデバイスを同時に接続できるVPNであり、全て固有のIPアドレスで接続できる。
* ポートフォワード
*: Torrentに不可欠なオープンポートを少なくとも1つ提供している。
* AES-256による2048ビットの暗号化
*: 軍事でも使用されている最高レベルの暗号化技術を使用している。
 
PrivateVPNの料金は、月額2.00ドルからである。(2025年時点、30日間返金保証付き) 
 

== ノーログポリシーの実態 ==
PrivateVPNはノーログVPNを標榜しており、スウェーデンの強力なプライバシー法を根拠として、データログを保存または共有する法的義務がないと主張している。 
 
==== 公式ノーログポリシーの内容 ====
PrivateVPNの公式プライバシーポリシーでは、以下のデータを一切保存しないと明記している。 
 
* ブラウジング履歴およびトラフィック宛先
* 接続タイムスタンプ
* DNSクエリ
* IPアドレス (割り当てIP、接続IP両方)
* データコンテンツ
* 帯域幅使用量
 
収集されるデータは、ログインメールアドレス、パスワード、支払い方法情報等のアカウント管理に必要な最小限の情報のみである。 
 
==== 過去の捜査機関へのデータ提供 ====
2025年時点の公開情報において、PrivateVPNが法執行機関にユーザデータを提供した具体的な事例、裁判記録、またはリークは確認されていない。 
 
PrivateVPNは「ノーログポリシーを採用しているため、有事の場合でも提出できるデータが存在しない」という立場をとっている。 
ただし、この主張は第三者監査によって検証されていないことに注意する必要がある。 
 
==== 第三者監査の状況 ====
PrivateVPNは、独立した外部監査を一度も受けていない。 
これは業界内での重大な弱点と見なされている。 
 
競合他社との比較として、NordVPNはDeloitteによる監査 (2024年)、IPVanishはSchellman Compliance LLCによる監査 (2025年) を受けており、 
ノーログポリシーの検証において、PrivateVPNは遅れをとっている状況である。 
 
==== 管轄法域に関する懸念 ====
PrivateVPNの拠点であるスウェーデンは、14 Eyes監視協定に加盟している。 
14 Eyes構成国間では、情報機関が収集した情報を共有する枠組みが存在する。 
 
ただし、スウェーデンのプライバシー法により、ノーログポリシーを採用しているVPNプロバイダに対するデータ保持義務は課されていない。 
したがって、ノーログポリシーが正しく実装されている場合、14 Eyesの影響は限定的であると考えられる。 
 
==== 運営体制の変遷 ====
<center>
{| class="wikitable"
|+ PrivateVPNの運営体制の変遷
! 時期 !! 出来事
|-
| 2009年 || Martin Muller氏によりスウェーデンで設立 (運営会社: Privat Kommunikation Sverige AB)
|-
| 2022年6月 || Webホスティング企業のMiss Groupが買収。創業者Martin Muller氏は離任
|-
| 現在 || Miss Group傘下で運営。Miss GroupはPerwyn (プライベートエクイティ企業) が支援
|}
</center>
 
==== 専門家の評価 ====
2025年から2026年時点における専門家の評価は以下の通りである。 
 
<center>
{| class="wikitable"
|+ PrivateVPNの専門家評価
! 評価サイト !! スコア !! 備考
|-
| VPNMentor || 9.2/10 (193中7位) || ストリーミング性能、価格を評価
|-
| Trustpilot || 4.9/5 || 高い顧客満足度
|-
| TechRadar || 非推奨 || 投資不足による遅れを指摘
|-
| TheBestVPN || 30中22位 || 非推奨
|}
</center>
 
主な強みとして、価格競争力 (月額2.00ドルから)、ストリーミング性能、基本的なプライバシー保護が挙げられる。 
一方、主な弱みとして、第三者監査の欠落、限定されたサーバネットワーク、Linuxアプリの未提供、スプリットトンネリングおよび二重VPN機能の未対応が指摘されている。 
 

== 契約手順 ==
# [https://privatevpn.com/prices/comparitech PrivateVPNの公式Webサイト]にアクセスする。
# 1ヶ月、3ヶ月、3年のいずれかのプランを選択する。
# E-mailアドレスおよびパスワードを入力してログイン、または、PrivateVPNのアカウントを作成する。
# 支払い方法を選択する。 クレジットカード、Paypal、Bitcoinが使用できる。
 

== 依存関係のライブラリのインストール ==
PrivateVPNソフトウェアを実行するために必要な依存関係のライブラリをインストールする。 
 
# RHEL
sudo dnf install python3 curl openvpn NetworkManager-openvpn \
NetworkManager-openvpn-gnome # GNOMEを使用する場合
plasma-nm-openvpn # KDEを使用する場合

# SUSE
sudo zypper install python3 curl openvpn NetworkManager-openvpn \
NetworkManager-openvpn-gnome # GNOMEを使用する場合
plasma-nm5-openvpn # KDEを使用する場合
 

== ネットワークマネージャトンネルを使用する場合 (推奨) ==
まず、以下に示す2つのファイルをダウンロードする。 
* 証明書ファイル
*: http://privatevpn.com/client/ca.crt
* 鍵ファイル
*: http://privatevpn.com/client/ta.key
 
* GNOMEの場合
# GNOMEのホーム画面右上にある[ネットワーク]アイコンをクリックして、[設定]アイコンを選択する。
# [設定]画面が開くので、画面左にある[ネットワーク] - 画面右の[VPN]項目の右にある[＋]ボタンを押下する。
# [VPNの追加]画面が開くので、[OpenVPN]を選択して、[Create]ボタンを押下する。
# 以下に示す情報を入力する。 もし、Linuxの起動時にVPNを自動的に接続する場合は、[自動的に接続する]を選択する。
#* 接続名
#*: PrivateVPN
#* ゲートウェイ
#*: 接続先サーバが存在する国のアドレスを入力する。
#*: スウェーデンの場合 : se-sto.privatevpn.host
#*: サーバリストの詳細は、https://privatevpn.com/serverlist を参照すること。
#* タイプ
#*: [パスワード]を選択する。
#* ユーザ名
#*: PrivateVPNアカウントのメールアドレスを入力する。
#* パスワード
#*: PrivateVPNアカウントのパスワードを入力する。
#* CA証明書
#*: 上記でダウンロードした証明書ファイル(ca.crtファイル)を選択する。
# [Advanced]ボタンを押下して、[OpenVPN Advanced Options]画面を開く。
#* [General]タブを選択する。
#*: [LZOデータ圧縮を使用する]チェックボックスにチェックを入力する。
#*: [仮想デバイスの種類を設定]チェックボックスにチェックを入力して、[TUN]を選択する。
#*: [IPv6 tun link]チェックボックスにチェックを入力する。
#* [セキュリティタブ]を選択する。
#*: [暗号]プルダウンから[AES-256-CBC]を選択する。
#*: [HMAC認証]プルダウンから[SHA-256]を選択する。
#* [TLS認証]タブを選択する。
#*: [相手（サーバ）の証明書使用状況の署名を確認する]チェックボックスにチェックを入力して、プルダウンから[サーバ]を選択する。
#*: [追加のTLS認証を使用する]チェックボックスにチェックを入力する。
#*: [キーファイル]を、上記でダウンロードした鍵ファイル(ta.keyファイル)を選択する。
#*: [Key Direction]プルダウンから[1]を選択する。
# GNOMEのホーム画面右上にある[ネットワーク]アイコンをクリックして、[VPN接続] - [PrivateVPN]を選択する。
 
* KDEの場合
# [KDEシステム設定]を起動して、[接続]を選択する。
# [接続]画面が開くので、画面左下(接続先リストの下)にある[+]を押下する。
# [接続タイプの選択]画面が開くので、リストから[OpenVPN]を選択して[作成]ボタンを押下する。
# [新しい接続]画面が開くので、以下に示す情報を入力する。
#* [接続名]
#*: 任意でよい。
#*: 例. PrivateVPN
#* [ゲートウェイ]
#*: 接続先サーバが存在する国のアドレスを入力する。
#*: サーバリストの詳細は、https://privatevpn.com/serverlist を参照すること。
#*: 例. スウェーデンの場合 : se-sto.privatevpn.host
#* [接続タイプ]
#*: パスワードを選択する。
#* [CA証明書]
#*: 上記でダウンロードした証明書ファイル(ca.crtファイル)を選択する。
#* [ユーザ名]
#*: PrivateVPNアカウントのメールアドレスを入力する。
#* [パスワード]
#*: PrivateVPNアカウントのパスワードを入力する。
# [Advanced]ボタンを押下して、[OpenVPN Advanced Options]画面を開く。
#* [General]タブを選択する。
#*: [Use Compression]チェックボックスにチェックを入力して、プルダウンから[LZO]を選択する。
#*: [Set virtual device type:]チェックボックスにチェックを入力して、プルダウンから[TUN]を選択する。
#*: [IPv6 tun link]チェックボックスにチェックを入力する。
#* [Security]タブを選択する。
#*: [Cipher:]プルダウンから[AES-256-CBC]を選択する。
#*: [HMAC Authentication:]プルダウンから[SHA-256]を選択する。
#* [TLS Settings]タブを選択する。
#*: [Verify peer（server） certificate usage signature]チェックボックスにチェックを入力して、プルダウンから[Server]を選択する。
#*: [Mode:]プルダウンから[TLS-Auth]を選択する。
#*: [Key File:]を、上記でダウンロードした鍵ファイル(ta.keyファイル)を選択する。
#*: [Key Direction:]プルダウンから[Client(1)]を選択する。
# [OK]ボタンを押下して、[OpenVPN Advanced Options]画面を閉じる。
# [接続]画面右にある[IPv6]タブを選択して、[この接続には IPv6 が必要]チェックボックスのチェックを外す。(この設定は不要の可能性あり)
# [接続画面]右下にある[適用]ボタンを押下する。
# タスクバーにあるネットワークアイコンをクリックすると、PrivateVPNのOpenVPNが表示されるので、[接続]ボタンを押下する。
 

== PrivateVPN CLIを使用する場合 ==
# [https://privatevpn.com/client/install.sh PrivateVPNの公式Webサイト]から、CLIソフトウェアのインストーラをダウンロードする。 または、<code>wget</code>コマンド等を使用してダウンロードする。
#: <code>wget https://privatevpn.com/client/install.sh</code>
# ダウンロードしたインストーラに実行権限を付加する。
#: <code>chmod u+x install.sh</code>
# スーパーユーザ権限でインストーラを実行する。 スーパーユーザ権限で実行する理由は、OpenVPNの接続時において、トンネルインターフェイスを作成するためである。
#: <code>sudo ./install.sh</code>
# /etc/openvpn/privatvpn.confファイルを編集して、接続先のVPNサーバを変更することができる。 サーバリストの詳細は、https://privatevpn.com/serverlist を参照すること。
 

== WireGuardの使用 ==
# WireGuardの接続に必要なツールをインストールする。
#: <code>sudo zypper install wireguard-tools</code>
#: 
# [https://privatevpn.com/account/login PrivateVPNの公式Webサイト]にアクセスして、ログインする。
# [https://privatevpn.com/control-panel PrivateVPNのコントロールパネル]にアクセスする。
# コントロールパネル画面左にある[WireGuard Config]から、使用するVPNサーバを選択するため、[Generate Config]ボタンを押下する。
# コントロールパネルにWireGuardの設定が生成および表示されるので、ダウンロードアイコンを押下する。
#: 
# WireGuardを使用してVPNネットワークに接続する。
#: <code>sudo wg-quick up <WireGuardの設定ファイルのパス></code>
#: 
# 正常にVPNネットワークに接続しているかどうかを確認する。
#: <code>sudo wg show</code>
#: 
# VPNネットワークを切断する。
#: <code>sudo wg-quick down <WireGuardの設定ファイルのパス></code>
 

== DNSリーク ==
IPv6を使用する場合、DNSリークを起こす可能性がある。 
この時、IPv6を無効にすることにより、DNSリークを起こさないようにすることができる。 
 
ただし、WebブラウザがChromium系ブラウザ(Vivaldiも含む)の場合、以下の設定を行ってもDNSリークが起きることに注意すること。 
 
IPv6を無効にする手順を、以下に示す。 
# IPv6を無効にするため、/etc/sysctl.confファイルに以下に示す設定を追記する。
#: <code>sudo vi /etc/sysctl.d/00-ipv6.conf</code>
#: 
#: <code># /etc/sysctl.d/00-ipv6.confファイル</code>
#: 
#: <code>net.ipv6.conf.all.disable_ipv6 = 1</code>
#: <code>net.ipv6.conf.default.disable_ipv6 = 1</code>
#: <code>net.ipv6.conf.lo.disable_ipv6 = 1</code>
#: 
# 上記の設定を反映する。
#: <code>sudo sysctl -p</code>
#: 
# IPv6が正常に無効化されたかどうかを確認する。 <code>1</code>と表示される場合、IPv6は正常に無効化されている。
#: <code>cat /proc/sys/net/ipv6/conf/all/disable_ipv6</code>
#: 
# 以下に示すURLにアクセスして、IPv6が無効化されているかどうかを確認する。
#: https://www.whatismyip.com/
#: 
# 次に、Webブラウザのクッキーおよびキャッシュを削除する。
# 最後に、以下に示すURLにアクセスして、DNSリークを確認する。
#: https://www.dnsleaktest.com/
 
<code>sysctl</code>は、以下に示す場所から設定を読み込む。 
初期設定を無効化または上書きする場合は、/etc/sysctl.dディレクトリに同名のファイルを作成して配置する。 
* /boot/sysctl.conf-<kernelversion>
* /lib/sysctl.d/*.conf
* /usr/lib/sysctl.d/*.conf
* /usr/local/lib/sysctl.d/*.conf
* /etc/sysctl.d/*.conf
* /run/sysctl.d/*.conf
* /etc/sysctl.conf
 

== Torブラウザのプロキシ設定 ==
==== SOCKS5プロキシを使用する場合 ====
# Torブラウザを起動して、[Tor Network Settings]ボタンを押下する。
# [設定]画面の[Advanced]項目から、プロキシの設定を行う。
#* [I use a proxy to connect to the Internet]チェックボックス
#*: チェックを入力する。
#* [Proxy Type]プルダウン
#*: SOCKS 5
#* [Address]
#*: [https://privatevpn.com/serverlist PrivateVPNのサーバリスト]から、任意のプロキシサーバのアドレスを入力する。
#*: 例. se-sto.pvdata.host
#* [Port]
#*: 1080
#* [Username]
#*: ユーザ名は、[https://privatevpn.com/account/login PrivateVPNの公式Webサイト]にログインして、[https://privatevpn.com/control-panel コントロールパネル]に進むと表示される。
#* [Password]
#*: パスワードは、[https://privatevpn.com/account/login PrivateVPNの公式Webサイト]にログインして、[https://privatevpn.com/control-panel コントロールパネル]に進むと表示される。
# Torブラウザにある[Connect]ボタンを押下して、Torネットワークに接続する。
 
==== HTTP / HTTPSプロキシを使用する場合 ====
# Torブラウザを起動して、[Tor Network Settings]ボタンを押下する。
# [設定]画面の[Advanced]項目から、プロキシの設定を行う。
#* [I use a proxy to connect to the Internet]チェックボックス
#*: チェックを入力する。
#* [Proxy Type]プルダウン
#*: HTTP / HTTPS
#* [Address]
#*: [https://privatevpn.com/serverlist PrivateVPNのサーバリスト]から、任意のプロキシサーバのアドレスを入力する。
#*: 例. se-sto.pvdata.host
#* [Port]
#*: 8080
#* [Username]
#*: ユーザ名は、[https://privatevpn.com/account/login PrivateVPNの公式Webサイト]にログインして、[https://privatevpn.com/control-panel コントロールパネル]に進むと表示される。
#* [Password]
#*: パスワードは、[https://privatevpn.com/account/login PrivateVPNの公式Webサイト]にログインして、[https://privatevpn.com/control-panel コントロールパネル]に進むと表示される。
# Torブラウザにある[Connect]ボタンを押下して、Torネットワークに接続する。
 

== VPN over Tor ==
VPNサーバへの接続にTorネットワークを使用することができる。 
これを、VPN over Tor、あるいは、VPN through Torと呼ぶ。 
 
Torネットワークがブリッジとして機能するため、自宅のIPをPrivateVPNに公開することなく、PrivateVPNに接続することを意味する。 
したがって、プライバシー、セキュリティ、匿名性への2重層を提供する。 
 
# [https://www.torproject.org/download/ Torブラウザの公式Webサイト]にアクセスして、Torブラウザをダウンロードおよびインストールする。
# Torブラウザを起動して、Torネットワークに接続する。
# Torブラウザで任意のWebサイトを開いて、Torブラウザのアドレスバーの左側にある鍵アイコンを選択する。
# "ガードノード(エントリーノード)"、"中間"、"出口ノード"を含むTorネットワークの現在の回線情報が表示される。 この時、ガードノード(エントリーノード)のIPアドレスをコピーする。 最初のノードは、ガードノード(エントリーノード)と呼ばれており、これは頻繁に変更されない。 ただし、暫く時間が経って変更された場合、または、Torブラウザをアップデートした場合は、ガードノード(エントリーノード)のIPアドレスが変更されるため、 都度、OpenVPN設定ファイル内の値を変更する必要がある。
# [https://privatevpn.com/client/PrivateVPN-TUN.zip PrivateVPNの公式Webサイト]にアクセスして、PrivateVPNのOpenVPN設定ファイルをダウンロードする。 ダウンロードしたファイルを解凍する。 TorブラウザはTCPプロトコル(443番ポート)のみで動作するため、TCPディレクトリからPrivatVPN-<国名>-<都市名>-TUN-443.ovpnを使用する必要がある。
#: 
# 使用するOpenVPN設定ファイルを開いて、以下に示す内容を追記する。
#: <code># Windowsの場合</code>
#: <code># tor options</code>
#: <code>socks-proxy 127.0.0.1 9150</code>
#: <code>route <TorブラウザのガードノードのIPアドレス> 255.255.255.255 net_gateway</code>
#: 
#: <code># Linuxの場合</code>
#: <code># tor options</code>
#: <code>socks-proxy 127.0.0.1 9150</code>
#: <code>route <TorブラウザのガードノードのIPアドレス> 255.255.255.255 <自宅のデフォルトゲートウェイのIPアドレス></code>
#: 
# Torネットワーク経由でPrivateVPNのOpenVPNサーバに接続する。 上記で編集したOpenVPN設定ファイルをOpenVPNクライアントにインポートして接続する。 Torブラウザが起動していることを確認して、問題なく動作しているかどうかを確認する。
 

== Tor over VPN ==
VPNネットワーク経由でTorに接続する方法であり、Torは終了ノードになる。(Tor over VPN) 
 
# PrivateVPN CLIまたはNetworkManager等を使用して、VPNに接続する。
# [https://www.torproject.org/download/ Torブラウザの公式Webサイト]にアクセスして、Torブラウザをダウンロードおよびインストールする。
# Torブラウザを起動して、[Connect]ボタンを押下する。 Torブラウザの設定はデフォルトのままでよい。
 

== Torrentとの連携 ==
# まず、PrivateVPNサーバに接続する。 この時、[Port forwarding]項目に記載されているポート番号をコピーする。
# 次に、qBittorrentを起動して、[設定] - 画面左の[接続] - [受信接続に使用するポート]において、上記でコピーしたポート番号を入力する。
# 最後に、[ツール] - [設定] - [設定]画面左ペインにある[高度]を選択する。 [設定]画面右ペインにある[ネットワークインターフェイス]を、使用しているソフトウェアとプロトコルに応じて、次のいずれかに変更する。
#* PrivateVPNソフトウェアからOpenVPNで接続している場合
#*: tun0
#* NetworkManagerからOpenVPNで接続している場合
#*: tun0
#* PrivateVPNソフトウェアからWireGuardで接続している場合
#*: 
# [OK]ボタンを押下する。
# [ファイル] - [終了]を選択して、qBittorrentを再起動する。
 
qBittorrentの推奨設定を、以下に示す。 
# qBittorrentを起動して、[ツール］ - [設定]を選択する。
# [設定]画面左ペインにある[BitTorrent]を選択する。
# [設定]画面右ペインにある[匿名モードを有効にする]を選択する。
# [DHT(分散ネットワーク)を有効にする]チェックボックスのチェックを外す。
# [ピア交換(PeX)を有効にする]チェックボックスのチェックを外す。
# [ローカルピア検出(LSD)を有効にする]チェックボックスのチェックを外す。
# [設定]画面左ペインにある[接続]を選択して、[ピア接続プロトコル]プルダウンから[TCP]を選択する。
 

== VPNのログ ==
VPN接続に問題がある場合は、接続ログを送信することにより、問題を迅速に特定して、適切な解決策を得られる場合がある。 
 
==== Network Manager ====
# VPN接続のログを表示して、生成されたログをコピーする。
#: <code>sudo grep VPN /var/log/syslog</code>
#: または
#: <code>sudo grep VPN /var/log/syslog > <任意のログファイルのパス></code>
#: 
# [https://privatevpn.com/chat PrivateVPNの公式Webサイトにあるチャット]にアクセスして、チャットボックスから[Send us a message]ボタンを押下する。
# 上記で取得したVPN接続のログをチャットに貼り付けて、ユーザのEメールアドレスを入力する。
# [send]ボタンを押下する。
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:PinePhone]][[カテゴリ:Windows7]][[カテゴリ:Windows10]][[カテゴリ:Windows11]]

VPN - IP VANISH

2026-03-24T10:51:01Z

Wiki:

== 概要 ==
IP VANISHは、ログを一切取らないVPNサービスであり、インターネットのための安全な環境を提供している。 
VPN接続が確立すると、全てのオンライントラフィック（Webブラウジング、動画ストリーミング、ファイル共有等）は暗号化されたトンネルを通過して、識別IPアドレスは隠蔽される。 
 
また、122カ国以上にある150以上の場所に、3200台以上のVPNサーバを配置している。(2025年時点) 
 
IP VANISHは、電話、メール、ライブチャットによる年中無休のカスタマーサポートを行っている。 
 

== ノーログポリシーの実態 ==
IP VANISHはノーログVPNを標榜しているが、過去にはノーログの主張に反してユーザ情報を捜査機関に提供した事例が存在する。 
 
==== 2016年の捜査機関へのデータ提供事件 ====
2016年5月から6月にかけて、米国国土安全保障省 (DHS) が児童ポルノ関連事件を捜査する過程で、容疑者が使用したIPアドレスをIP VANISHまで追跡した。 
 
当時、IP VANISHは "ノーログポリシーを厳格に遵守" と公言していたにもかかわらず、以下に示す経緯でユーザ情報を提供した。 
 
# DHSからの最初の問い合わせに対して、IP VANISHは "ログは保持していない" と回答した。
# しかし、DHSがより詳細な捜査令状を発行した後、IP VANISHは方針を変更した。
# 接続ログを含む詳細な個人情報を当局に開示した。
 
当時の運営会社はHighwinds Network Group (Mudhook Media) であった。 
この事件は、IP VANISHのノーログ主張に対する重大な信頼性の問題を引き起こし、VPN業界全体の透明性向上への圧力につながった。 
 
==== 運営体制の変遷 ====
IP VANISHは設立以降、複数回の経営変更を経ている。 
 
<center>
{| class="wikitable"
|+ IP VANISHの運営体制の変遷
! 時期 !! 出来事
|-
| 2012年 || Mudhook Media Inc により設立 (Highwinds Network Groupの独立子会社)
|-
| 2016年 || DHS事件が発生 (上記参照)
|-
| 2017年2月 || StackPathが買収。買収時に独立監査を実施し、ログシステムが存在しないことを確認
|-
| 2019年4月 || J2 Global (現 Ziff Davis) がStackPathから買収
|-
| 2021年 || J2 Globalが企業分割し、デジタルメディアおよびサイバーセキュリティ部門がZiff Davisとして独立上場 (NASDAQ: ZD)
|-
| 現在 || Ziff Davis / NetProtect / VIPRE Security Group傘下で運営
|}
</center>
 
==== 第三者監査による検証 ====
2017年のStackPath買収以降、IP VANISHは独立した第三者機関による監査を実施している。 
 
* 2023年: Leviathan Security Groupによる監査
*: IP VANISHがプライバシーポリシーのノーログ主張に準拠していることを確認した。
* 2025年2月: Schellman Compliance LLCによる監査 (2025年4月に結果発表)
*: サーバ構成およびITシステム全体の技術的検証を実施した。
*: エンジニアリングチームおよびオペレーションチームへの無制限アクセスが許可された。
*: ログ構成の検査、サーバイメージの検査、シミュレートされたユーザセッション、テストトラフィックの実施、リアルタイム検証等が行われた。
*: 監査結果として、ユーザ活動またはメタデータのログ証拠なし、元々のIPアドレスの非記録確認、トラフィック検査なしが確認された。
 
==== 透明性への取り組み ====
現在のIP VANISHは、以下の取り組みにより透明性の向上を図っている。 
 
* 四半期ごとの透明性報告書を公開
*: 2025年Q4報告では、法的請求25件を受領したが0件のデータ提供、DMCA通知28,636件を受領したが0件のデータ提供であった。
* Trust Centerを開設し、全てのノーログ監査結果を公開
* VPN Trust Initiativeの創立メンバーとして、VPN業界全体のプライバシーおよびセキュリティ基準の向上に参加
 
==== 残る懸念点 ====
一方で、以下の懸念点が専門家から指摘されている。 
 
* 米国に拠点を置いているため、Five Eyes監視協定の対象国である。
* 2016年の信頼侵害は事実として消えず、経営体制が複数回変わっている。
* 現在の独立監査があっても根本的な信頼性の懸念が残るとする専門家の意見もある。
 

== IP VANISHの契約 ==
IP VANISHの契約手順を以下に記載する。 
 
# [https://support.ipvanish.com/hc/en-us IP VANISHの公式Webサイト]へアクセスして、ページ上部にある[Start Now]を選択する。
# [Pick your package]では、VPNのプランを選択する。
# [Select your plan]では、月間または年間のプランを選択する。
# [Create your account]では、新規アカウントを作成する。
# [Choose your payment method]では、支払い方法(クレジットカードまたはPayPal)を選択する。
# [I agree to the automatic renewal terms above.]チェックボックスにチェックを入力する。
# [Subscribe Now]を選択する。
 
IP VANISHの料金は、年間39.99ドル(更新時では、年間99.99ドル)である。(2025年時点) 
 

== IP VANISHの設定 ==
IP VANISH(OpenVPN)を設定するには、以下の手順に従う。 
 
==== NetworkManagerを使用する場合 ====
* GNOMEの場合
# [https://www.ipvanish.com/software/configs/configs.zip IP VANISHの公式Webサイト]から、OpenVPNファイルをダウンロードする。
#: <code>wget https://www.ipvanish.com/software/configs/configs.zip</code>
# ダウンロードしたファイルを解凍する。
#: <code>unzip config.zip</code>
# OpenVPNの設定ファイルをインポートして使用するために必要な依存関係のライブラリをインストールする。
#: <code>sudo zypper install openvpn NetworkManager-openvpn NetworkManager-openvpn-gnome</code>
# GNOMEのホーム画面右上にある[ネットワーク]アイコンをクリックして、[有線接続]プルダウンから[有線設定]を選択する。
# [設定]画面が開くので、画面左にある[ネットワーク] - 画面右の[VPN]項目の右にある[＋]ボタンを押下する。
# [VPNの追加]画面が開くので、[ファイルからインポート...]を選択する。
# 上記で解凍したOpenVPN設定ファイルを選択して、画面右上にある[開く]ボタンを押下する。 ここで、OpenVPNファイルの命名形式は、国-場所-サーバアドレスである。 例. ipvanish-AU-Sydney-syd-a01.ovpn
# 選択したOpenVPN設定ファイルが未保存のセッションとしてNetworkManagerにインポートされるので、[VPNの追加]画面から以下に示す項目を入力および設定する。
#* [Gateway]
#*: サーバのアドレスを確認する。
#* [ユーザ名]
#*: IP VANISHのユーザ名を入力する。
#* [パスワード]
#*: IP VANISHのパスワードを入力する。
#*: ［Store the password for all users（すべてのユーザーのパスワードを保存する）]を選択する。
#* [CA証明書]
#*: <code>ca.ipvanish.com.crt</code>とラベル付けされていることを確認する。
# [VPNの追加]画面にある[IPv6]タブを選択して、[無効]ボタンを選択する。
# [VPNの追加]画面右上にある[追加]ボタンを押下する。
# 上記で選択したIP VANISHのOpenVPN設定が作成されて、IP VANISHのOpenVPNセッションが[VPN]項目の選択エリアにリストされていることを確認する。 これは、[VPN]項目の選択エリアにあるスライダースイッチを押下することにより、接続および切断を切り替えることができる。 また、GNOMEのホーム画面右上にある[ネットワーク]アイコンをクリックして、VPNの接続および切断を切り替えることができる。
# IPアドレスが匿名かつプライベートなIP VANISHに変更されたことを確認する場合は、http://ipchicken.com にアクセスする。
 
* KDEの場合
# [https://www.ipvanish.com/software/configs/configs.zip IP VANISHの公式Webサイト]から、OpenVPNファイルをダウンロードする。 または、以下のコマンドを実行してダウンロードする。
#: <code>wget https://www.ipvanish.com/software/configs/configs.zip</code>
# ダウンロードしたファイルを解凍する。
#: <code>unzip config.zip</code>
# OpenVPNの設定ファイルをインポートして使用するために必要な依存関係のライブラリをインストールする。
#: <code>sudo zypper install openvpn NetworkManager-openvpn plasma-nm5-openvpn</code>
# [KDEシステム設定]を起動して、[接続]を選択する。
# [接続]画面が開くので、画面左下(接続先リストの下)にある[+]を押下する。
# [接続タイプの選択]画面が開くので、リストの最下行にある[VPN接続をインポート...]オプションを選択して[作成]ボタンを押下する。
# [VPN接続をインポート]画面が開くので、解凍したconfigディレクトリ内にあるOpenVPNファイル(VPNサーバ)を選択する。 例. ipvanish-UK-London-lon-a01.ovpn
# 証明書をコピーするよう求められたら、[はい]ボタンを押下する。
# [接続]画面左にIP VANISHのVPN接続が表示されるので、IP VANISHのVPN接続を選択する。
# [接続]画面右にある[VPN(openvpn)]タブを選択して、IP VANISHのユーザ名とパスワードを入力する。
# [接続]画面右にある[IPv6]タブを選択して、[この接続には IPv6 が必要]チェックボックスのチェックを外す。
# [接続画面]右下にある[適用]ボタンを押下する。
# タスクバーにあるネットワークアイコンをクリックすると、上記のセクションで作成したOpenVPNが表示されるので、[接続]ボタンを押下する。
# [https://www.ipvanish.com/what-is-my-ip-address/ IP Checker]にアクセスして、VPNを通して接続されているかどうかを確認する。
 
==== OpenVPNコマンドを使用する場合 ====
# IP VANISHのOpenVPN設定ファイルを[https://www.ipvanish.com/software/configs/configs.zip IP VANISHの公式Webサイト]からダウンロードする。
# ダウンロードしたファイルを解凍する。 解凍したディレクトリには、OpenVPNファイルと証明書ファイル(.crt拡張子)の2つがある。
#: 
# 上記で編集したOpenVPN設定ファイルを使用して、OpenVPNをコマンドから起動する。
#: <code>cd <OpenVPNの設定ファイルがあるディレクトリ></code>
#: <code>sudo openvpn --config <OpenVPNの設定ファイルのパス></code>
#: または
#: <code>sudo openvpn --config <OpenVPNの設定ファイルのパス> --ca <証明書ファイルのパス></code>
 

== WebブラウザからIP VANISHに接続する ==
# [https://support.ipvanish.com/hc/en-us/articles/360001410573-How-to-Configure-the-SOCKS5-Proxy-in-Firefox- SOCKS5のガイド]に従って、FireFoxのSocks5プロキシを設定する。 IPVanishは、Webトラフィックを匿名化するため、[https://addons.mozilla.org/ja/firefox/addon/foxyproxy-standard/?utm_source=addons.mozilla.org&utm_medium=referral&utm_content=search FoxyProxy Standardアドオン]をインストールしてSOCKS5プロキシを構成することを推奨している。
# Firefoxのアドオンページに移動して、検索ボックスで"FoxyProxy Standard"と検索する。
# FirefoxにFoxyProxy Standardアドオンをインストールする。
# FoxyProxy Standardのアイコンから[オプション]を選択して、FoxyProxy Standardの設定画面を表示する。
# 設定画面左にある[Add]ボタンを押下して、IP VanishのSOCKS5プロキシを設定する。
##* Title
##*: IPVanish Proxy
##* Proxy Type
##*: SOCKS5
##* Proxy IP address, DNS name
##*: SOCKS5プロキシのアドレス、SOCKS5プロキシのユーザ名およびパスワードは、[https://account.ipvanish.com/login IP Vanishのマイアカウントページ]にあるSOCKS5プロキシタブで見つけることができる。
##* Port
##*: 1080
##* Username
##*: IP Vanishのユーザ名
##* Password
##*: IP Vanishのパスワード
## 設定画面左にある全てのトグルスイッチを有効化する。
## [Save]ボタンを押下する。
## 新しいページに自動的に遷移するので、設定画面上部にあるプルダウンから[Turn Off（Use Firefox Settings）]を選択して、上記で追加したSOCKS5プロキシサーバを選択する。
## 設定画面左にある[What's My IP]を選択して、SOCKS5プロキシサーバ経由で接続されていることを確認する。
#: 
# [https://www.ipvanish.com/what-is-my-ip-address/ IP Checker]にアクセスして、VPNを通して接続されているかどうかを確認する。
 

== VPN over Tor ==
IP VANISHは、VPN over TORをサポートしていない。 
VPN接続、または、Tor over VPN接続のみが使用できることに注意する。 
 

== Tor over VPN ==
VPNネットワーク経由でTorに接続する方法であり、Torは終了ノードになる。(Tor over VPN) 
 
# [[VPN - IP VANISH#IP VANISHの設定|"IP VANISHの設定"]]セクションを参照して、VPNに接続する。
# [https://www.torproject.org/download/ Torブラウザの公式Webサイト]にアクセスして、Torブラウザをダウンロードおよびインストールする。
# Torブラウザを起動して、[Connect]ボタンを押下する。 Torブラウザの設定はデフォルトのままでよい。
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:Windows7]][[カテゴリ:Windows10]][[カテゴリ:Windows11]]

GitHub - API

2026-03-24T10:37:02Z

Wiki: ページの作成:「== 概要 == GitHub APIは、GitHubのデータやサービスにプログラムからアクセスするためのインターフェースである。 GitHub APIには2種類のAPIが提供されている。 <center> {| class="wikitable" |+ GitHub APIの種類 |- ! 種類 !! 説明 |- | REST API || ベースURL: https://api.github.com/ HTTPメソッド (GET、POST、PATCH、PUT、DELETE) を使用してリソースを操作する。 シンプ…」

== 概要 ==
GitHub APIは、GitHubのデータやサービスにプログラムからアクセスするためのインターフェースである。 
 
GitHub APIには2種類のAPIが提供されている。 
 
<center>
{| class="wikitable"
|+ GitHub APIの種類
|-
! 種類 !! 説明
|-
| REST API || ベースURL: https://api.github.com/ HTTPメソッド (GET、POST、PATCH、PUT、DELETE) を使用してリソースを操作する。 シンプルなリクエスト・レスポンスモデルで、幅広い用途に対応する。
|-
| GraphQL API || エンドポイント: https://api.github.com/graphql 必要なデータのみを指定して取得できる柔軟なクエリ言語を使用する。 複数リソースのデータを1回のリクエストで取得できるため、オーバーフェッチを防止できる。
|}
</center>
 
両APIとも認証が必要な操作と不要な操作があるが、認証を行うことでレート制限が緩和され、プライベートリポジトリにもアクセス可能になる。 
 

== 認証 ==
GitHub APIの認証方式は複数存在する。 
用途に応じて適切な認証方式を選択する。 
 
==== Personal Access Token ====
Personal Access Token (PAT) は、個人のGitHubアカウントの代わりにAPIリクエストを認証するためのトークンである。 
 
PATには2種類ある。 
 
===== Fine-grained Personal Access Token (推奨) =====
Fine-grained PATは、より細かい権限制御が可能な新しい形式のトークンである。 
 
* 特定のリポジトリに対してのみアクセス権を付与できる。
* 各操作 (エンドポイント) 単位で権限を設定できる。
* 有効期限の設定が必須である。
* GitHub.comの[Settings] - [Developer settings] - [Personal access tokens] - [Fine-grained tokens]から作成する。
 
===== Classic Personal Access Token =====
Classic PATは、従来のスコープベースのトークンである。 
 
* <code>repo</code>、<code>user</code>、<code>admin:org</code> 等のスコープ単位で権限を付与する。
* 全リポジトリへのアクセスが許可されるため、Fine-grained PATより権限が広くなりやすい。
* GitHub.comの[Settings] - [Developer settings] - [Personal access tokens] - [Tokens (classic)]から作成する。
 
PATを使用する時は、リクエストヘッダに以下に示す形式で指定する。 
 
Authorization: Bearer <YOUR_TOKEN>
または
Authorization: token <YOUR_TOKEN>
 
==== GitHub Apps ====
GitHub Appsは、GitHubプラットフォーム上に構築するアプリケーションのための認証方式である。 
 
GitHub Appsは2段階の認証方式を使用する。 
 
* JWT認証 (アプリ自身の認証)
*: アプリのプライベートキーを使用してJWT (JSON Web Token) を生成する。
*: JWTは10分間有効である。
*: インストールアクセストークンの取得に使用する。
* インストールアクセストークン
*: JWTを使用して <code>POST /app/installations/{installation_id}/access_tokens</code> に対してリクエストを送信することで取得する。
*: 短期間 (1時間) で自動失効する。
*: 実際のAPIリクエストにはインストールアクセストークンを使用する。
 
==== OAuth Apps ====
OAuth Appsは、ユーザの代わりにGitHub APIにアクセスするための認証方式である。 
 
* OAuthフローを通じてユーザの認可を得る。
* ユーザアクセストークンを取得してAPIリクエストに使用する。
* GitHub AppsのOAuth機能と比較して、権限管理の粒度が粗い。
* 新規の用途には、GitHub Appsの使用が推奨される。
 
==== GITHUB_TOKEN ====
<code>GITHUB_TOKEN</code> は、GitHub Actionsワークフロー内で自動的に生成されるシークレットトークンである。 
 
* ワークフロー実行ごとに自動生成される。
* ワークフローが完了すると自動的に失効する。
* リポジトリのActionsの設定でデフォルトの権限を調整できる。
* 外部リソースへのアクセスには別途認証が必要である。
 
GitHub Actionsのワークフロー内では以下に示すように使用する。 
 
<syntaxhighlight lang="yaml">
- name: GitHub APIを呼び出す
run: |
curl -H "Authorization: Bearer ${{ secrets.GITHUB_TOKEN }}" \
https://api.github.com/repos/${{ github.repository }}
</syntaxhighlight>
 
==== 認証方法の比較 ====
下表に、各認証方式の特徴を示す。 
 
<center>
{| class="wikitable"
|+ 認証方式の比較
! 認証方式 !! 用途 !! 権限の粒度 !! 有効期限
|-
| Fine-grained PAT || 個人の開発、スクリプト || リポジトリ単位・操作単位 || 設定必須 (最大1年)
|-
| Classic PAT || 個人の開発、スクリプト || スコープ単位 || 設定可能 (無期限も可)
|-
| GitHub Apps || サードパーティアプリ、CI/CD || リポジトリ単位・権限単位 || インストールトークンは1時間
|-
| OAuth Apps || ユーザ認可が必要なアプリ || スコープ単位 || 設定による
|-
| GITHUB_TOKEN || GitHub Actionsワークフロー || リポジトリ権限に準拠 || ワークフロー終了まで
|}
</center>
 

== REST API ==
==== エンドポイントの構造 ====
GitHub REST APIのベースURLは https://api.github.com/ である。 
 
エンドポイントは以下の形式で構成される。 
 
https://api.github.com/{リソースパス}
 
下表に、リソースパスの例を示す。 
 
<center>
{| class="wikitable"
|+ REST APIの主要なエンドポイント例
|-
! エンドポイント !! 説明
|-
| <code>/repos/{owner}/{repo}</code> || 特定リポジトリの情報
|-
| <code>/repos/{owner}/{repo}/issues</code> || リポジトリのIssue一覧
|-
| <code>/user</code> || 認証済みユーザの情報
|-
| <code>/orgs/{org}</code> || 組織の情報
|}
</center>
 
下表に、HTTPメソッドと操作の対応を示す。 
 
<center>
{| class="wikitable"
! HTTPメソッド !! 操作内容
|-
| GET || リソースの取得
|-
| POST || リソースの作成
|-
| PATCH || リソースの部分更新
|-
| PUT || リソースの置換・関連付け
|-
| DELETE || リソースの削除
|}
</center>
 
==== リクエストとレスポンス ====
GitHub REST APIのリクエストには、以下に示すヘッダを設定することが推奨される。 
 
<center>
{| class="wikitable"
|+ 主要なリクエストヘッダ
! ヘッダ名 !! 説明 !! 例
|-
| <code>Authorization</code> || 認証トークン || Bearer ghp_xxxxxxxxxxxx
|-
| <code>Accept</code> || レスポンス形式の指定 || application/vnd.github+json
|-
| <code>X-GitHub-Api-Version</code> || APIバージョンの指定 || 2022-11-28
|-
| <code>User-Agent</code> || アプリケーション識別子 || MyApp/1.0
|}
</center>
 
レスポンスは、JSON形式で返される。 
日時は、ISO 8601形式 (例: 2024-01-15T12:00:00Z) で表現される。 
 
==== ページネーション ====
複数件のリソースを返すエンドポイントでは、ページネーションが使用される。 
 
* <code>per_page</code> クエリパラメータでページあたりの件数を指定する。(最大100)
* <code>page</code> クエリパラメータでページ番号を指定する。
* レスポンスの <code>Link</code> ヘッダに次ページ、前ページ等のURLが含まれる。
 
<code>Link</code> ヘッダの例を以下に示す。 
 
Link: <https://api.github.com/repos/owner/repo/issues?page=2>; rel="next",
<https://api.github.com/repos/owner/repo/issues?page=10>; rel="last"
 
<code>rel</code> の値は next、prev、first、last の4種類がある。 
 
==== 主要なエンドポイント ====
下表に、よく使用される主要なエンドポイントを示す。 
 
<center>
{| class="wikitable"
|+ 主要エンドポイント一覧
! カテゴリ !! メソッド !! エンドポイント !! 説明
|-
| リポジトリ || GET || <code>/repos/{owner}/{repo}</code> || リポジトリ情報の取得
|-
| リポジトリ || POST || <code>/user/repos</code> || リポジトリの作成
|-
| リポジトリ || GET || <code>/repos/{owner}/{repo}/contents/{path}</code> || ファイル内容の取得
|-
| Issues || GET || <code>/repos/{owner}/{repo}/issues</code> || Issue一覧の取得
|-
| Issues || POST || <code>/repos/{owner}/{repo}/issues</code> || Issueの作成
|-
| Issues || PATCH || <code>/repos/{owner}/{repo}/issues/{issue_number}</code> || Issueの更新
|-
| Pull Requests || GET || <code>/repos/{owner}/{repo}/pulls</code> || PR一覧の取得
|-
| Pull Requests || POST || <code>/repos/{owner}/{repo}/pulls</code> || PRの作成
|-
| Pull Requests || PUT || <code>/repos/{owner}/{repo}/pulls/{pull_number}/merge</code> || PRのマージ
|-
| ユーザ || GET || <code>/user</code> || 認証済みユーザ情報の取得
|-
| ユーザ || GET || <code>/users/{username}</code> || 特定ユーザ情報の取得
|}
</center>
 
==== 使用例 ====
curlを使用したREST APIのリクエスト例を以下に示す。 
 
* リポジトリ情報の取得
*: <syntaxhighlight lang="text">
curl -L \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR_TOKEN>" \
-H "X-GitHub-Api-Version: 2022-11-28" \
https://api.github.com/repos/octocat/hello-world
</syntaxhighlight>
*: 
* Issueの作成
*: <syntaxhighlight lang="text">
curl -L \
-X POST \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR_TOKEN>" \
-H "X-GitHub-Api-Version: 2022-11-28" \
https://api.github.com/repos/octocat/hello-world/issues \
-d '{"title":"バグ報告","body":"バグの詳細説明","labels":["bug"]}'
</syntaxhighlight>
*: 
* Issue一覧の取得 (ページネーション使用)
*: <syntaxhighlight lang="text">
curl -L \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR_TOKEN>" \
-H "X-GitHub-Api-Version: 2022-11-28" \
"https://api.github.com/repos/octocat/hello-world/issues?per_page=50&page=1"
</syntaxhighlight>
 

== GraphQL API ==
==== GraphQLとは ====
GraphQLは、APIのためのクエリ言語であり、必要なデータのみを指定して取得できる仕組みである。 
 
REST APIと比較した時のGraphQL APIのメリットを以下に示す。 
 
<center>
{| class="wikitable"
|+ REST APIと比較したGraphQL APIのメリット
|-
! 観点 !! メリット
|-
| データ取得の効率性 || 必要なフィールドのみを指定して取得するため、不要なデータの転送を削減できる。
|-
| リクエスト回数の削減 || 複数のリソースに関するデータを1回のリクエストで取得できる。
|-
| APIの明確性 || 型システムによりAPIの構造が明確である。
|-
| クライアントの柔軟性 || クライアント側でデータ要件を柔軟に調整できる。
|}
</center>
 
==== エンドポイント ====
GitHub GraphQL APIのエンドポイントは以下の1つのみである。 
 
https://api.github.com/graphql
 
REST APIとは異なり、全てのリクエストは <code>POST</code> メソッドで送信する。 
リクエストボディにJSONとしてクエリを含める。 
 
curl -L \
-X POST \
-H "Authorization: Bearer <YOUR_TOKEN>" \
-H "Content-Type: application/json" \
https://api.github.com/graphql \
-d '{"query": "{ viewer { login } }"}'
 
==== クエリの基本 ====
GraphQLのクエリは、取得したいデータの構造を宣言的に記述する。 
 
* 認証済みユーザの情報を取得するクエリの例
*: <syntaxhighlight lang="json">
{
"query": "query { viewer { login name email } }"
}
</syntaxhighlight>
*: 
* 特定リポジトリの情報を取得するクエリの例
*: <syntaxhighlight lang="json">
{
"query": "query { repository(owner: \"octocat\", name: \"hello-world\") { name description stargazerCount forkCount } }"
}
</syntaxhighlight>
*: 
* 横断検索 (search) を使用したクエリの例
*: searchは最大1,000件の結果を返す。
*: <syntaxhighlight lang="json">
{
"query": "query { search(query: \"repo:octocat/hello-world is:issue is:open\", type: ISSUE, first: 10) { issueCount nodes { ... on Issue { title number } } } }"
}
</syntaxhighlight>
 
==== ミューテーション ====
GraphQLでデータを変更する操作には、ミューテーション (mutation) を使用する。 
 
Issueにリアクションを追加するミューテーションの例を以下に示す。 
 
<syntaxhighlight lang="json">
{
"query": "mutation { addReaction(input: {subjectId: \"MDU6SXNzdWUx\", content: THUMBS_UP}) { reaction { content } subject { id } } }"
}
</syntaxhighlight>
 
==== 変数の使用 ====
GraphQLでは、クエリと変数を分離して記述できる。 
変数を使用することにより、クエリの再利用性が向上して、特殊文字のエスケープが不要になる。 
 
<syntaxhighlight lang="json">
{
"query": "query GetRepository($owner: String!, $name: String!) { repository(owner: $owner, name: $name) { name description stargazerCount issues(first: 5, states: OPEN) { nodes { title number } } } }",
"variables": {
"owner": "octocat",
"name": "hello-world"
}
}
</syntaxhighlight>
 

== GitHub CLI (gh) ==
==== インストールと認証 ====
GitHub CLI (gh) は、コマンドラインからGitHubの操作を行うための公式ツールである。 
 
インストール方法を以下に示す。 
 
# MacOS (Homebrew)
brew install gh

# RHEL
sudo dnf install gh

# SUSE
sudo zypper install gh

# Debian / Ubuntu
sudo apt install gh
 
インストール後、認証を行う。 
 
# 対話的な認証フロー
gh auth login

# 認証状態の確認
gh auth status

# 環境変数を使用した認証 (CI/CD環境等)
export GH_TOKEN=<YOUR_TOKEN>
 
==== 主要コマンド ====
下表に、GitHub CLIで使用できる主要なコマンドを示す。 
 
<center>
{| class="wikitable"
|+ GitHub CLI 主要コマンド一覧
! コマンド !! 主なサブコマンド !! 説明
|-
| <code>gh repo</code> || <code>create</code> <code>clone</code> <code>fork</code> <code>view</code> <code>list</code> || リポジトリの管理
|-
| <code>gh issue</code> || <code>create</code> <code>list</code> <code>view</code> <code>close</code> <code>edit</code> || Issueの管理
|-
| <code>gh pr</code> || <code>create</code> <code>list</code> <code>view</code> <code>merge</code> <code>checkout</code> <code>review</code> || Pull Requestの管理
|-
| <code>gh release</code> || <code>create</code> <code>list</code> <code>download</code> <code>view</code> || リリースの管理
|-
| <code>gh workflow</code> || <code>run</code> <code>list</code> <code>view</code> <code>enable</code> <code>disable</code> || GitHub Actionsワークフローの管理
|-
| <code>gh api</code> || - || REST / GraphQL APIの直接呼び出し
|-
| <code>gh alias</code> || <code>set</code> <code>list</code> <code>delete</code> || コマンドエイリアスの管理
|}
</center>
 
使用例を以下に示す。 
 
# リポジトリのクローン
gh repo clone octocat/hello-world

# Issue一覧の表示
gh issue list --repo octocat/hello-world --state open

# Pull Requestの作成
gh pr create --title "機能追加" --body "機能の説明" --base main

# ワークフローの手動実行
gh workflow run deploy.yml --ref main
 
==== gh api ====
<code>gh api</code> コマンドを使用することにより、REST API および GraphQL APIを直接呼び出すことができる。 
 
# REST API (GET)
gh api repos/octocat/hello-world

# REST API (POST) : Issueの作成
gh api repos/octocat/hello-world/issues \
--method POST \
--field title="バグ報告" \
--field body="バグの詳細説明"

# GraphQL APIの呼び出し
gh api graphql \
--field query='query { viewer { login name } }'

# ページネーションを自動処理して全件取得
gh api --paginate repos/octocat/hello-world/issues
 
==== エイリアス ====
よく使用するコマンドにエイリアスを設定することができる。 
 
# エイリアスの設定
gh alias set prl 'pr list --state open'

# エイリアスの一覧表示
gh alias list

# エイリアスの削除
gh alias delete prl
 

== Octokit ==
Octokitは、GitHub APIの公式クライアントライブラリである。 
 
各言語向けに提供されており、APIの呼び出しを簡略化できる。 
 
==== Octokit.js ====
Octokit.jsは、JavaScript / TypeScript向けのGitHub APIクライアントライブラリである。 
Webブラウザ、Node.js、Denoの各環境で動作する。 
 
インストール方法を以下に示す。 
 
npm install @octokit/rest
# または
npm install octokit
 
基本的な使用例を以下に示す。 
 
<syntaxhighlight lang="javascript">
import { Octokit } from "@octokit/rest";

// インスタンスの作成
const octokit = new Octokit({
auth: "YOUR_TOKEN",
});

// リポジトリ情報の取得
const { data: repo } = await octokit.rest.repos.get({
owner: "octocat",
repo: "hello-world",
});
console.log(repo.name);

// Issueの作成
const { data: issue } = await octokit.rest.issues.create({
owner: "octocat",
repo: "hello-world",
title: "バグ報告",
body: "バグの詳細説明",
});
console.log(issue.number);
</syntaxhighlight>
 
ページネーションを自動処理する <code>paginate()</code> メソッドの使用例を以下に示す。 
 
<syntaxhighlight lang="javascript">
// 全Issue一覧の取得 (自動ページネーション)
const issues = await octokit.paginate(octokit.rest.issues.listForRepo, {
owner: "octocat",
repo: "hello-world",
state: "open",
per_page: 100,
});

console.log(`取得件数: ${issues.length}`);
</syntaxhighlight>
 
==== Octokit.rb ====
Octokit.rbは、Ruby向けのGitHub APIクライアントライブラリである。 
 
インストール方法を以下に示す。 
 
gem install octokit
 
基本的な使用例を以下に示す。 
 
<syntaxhighlight lang="ruby">
require "octokit"

# クライアントの作成
client = Octokit::Client.new(access_token: "YOUR_TOKEN")

# リポジトリ情報の取得
repo = client.repository("octocat/hello-world")
puts repo.name

# Issueの作成
issue = client.create_issue("octocat/hello-world", "バグ報告", "バグの詳細説明")
puts issue.number
</syntaxhighlight>
 

== Webhook ==
==== Webhookとは ====
WebhookはGitHub上でイベントが発生した時に、指定したURLに対してHTTP POSTリクエストを自動的に送信する仕組みである。 
 
Webhookを使用することにより、リポジトリへのプッシュ、IssueやPull Requestの作成・更新、デプロイイベントの発生等、様々なGitHubイベントに反応した自動化を実現できる。 
 
==== Webhookの設定 ====
Webhookは、リポジトリまたは Organizationの設定から作成できる。 
 
設定項目を以下に示す。 
 
<center>
{| class="wikitable"
|+ Webhookの設定項目
|-
! 項目 !! 説明
|-
| ペイロードURL || Webhookのイベント発生時にリクエストを受信するエンドポイントのURL 公開されたHTTPSのURLである必要がある。
|-
| コンテンツタイプ || <code>application/json</code> (推奨) または <code>application/x-www-form-urlencoded</code> を選択する。
|-
| シークレット || Webhookのペイロードを検証するための秘密の文字列 設定することでHTTPリクエストの正当性を確認できる。
|-
| イベントの選択 || 通知を受けたいイベントを個別に選択、または、全イベントを受信するかを設定する。
|}
</center>
 
==== イベントの種類 ====
GitHubでは、70以上のWebhookイベントが提供されている。 
 
下表に、主要なイベントを示す。 
 
<center>
{| class="wikitable"
|+ 主要Webhookイベント
! イベント名 !! 説明
|-
| <code>push</code> || リポジトリへのコミットのプッシュ
|-
| <code>pull_request</code> || Pull Requestの作成、更新、クローズ等
|-
| <code>issues</code> || Issueの作成、更新、クローズ等
|-
| <code>create</code> || ブランチやタグの作成
|-
| <code>delete</code> || ブランチやタグの削除
|-
| <code>release</code> || リリースの公開・更新等
|-
| <code>workflow_run</code> || GitHub Actionsワークフローの実行
|-
| <code>code_scanning_alert</code> || コードスキャンアラートの検出
|-
| <code>secret_scanning_alert</code> || シークレットスキャンアラートの検出
|}
</center>
 
==== シークレットによる検証 ====
Webhookのシークレットを設定している場合、GitHubはリクエストに <code>X-Hub-Signature-256</code> ヘッダを付与する。 
このヘッダの値はHMAC-SHA256アルゴリズムを使用して計算されたシグネチャである。 
 
受信側でシグネチャを検証することにより、リクエストが正当なGitHubからのものであることを確認できる。 
 
Node.jsでの検証例を以下に示す。 
 
<syntaxhighlight lang="javascript">
const crypto = require("crypto");

function verifyWebhookSignature(payload, signature, secret) {
const hmac = crypto.createHmac("sha256", secret);
const digest = "sha256=" + hmac.update(payload).digest("hex");
return crypto.timingSafeEqual(
Buffer.from(digest),
Buffer.from(signature)
);
}

// Express.jsでの使用例
app.post("/webhook", (req, res) => {
const signature = req.headers["x-hub-signature-256"];
const isValid = verifyWebhookSignature(
req.rawBody,
signature,
process.env.WEBHOOK_SECRET
);

if (!isValid) {
return res.status(401).send("Unauthorized");
}

// Webhookペイロードの処理
const event = req.headers["x-github-event"];
console.log(`イベント受信: ${event}`);
res.status(200).send("OK");
});
</syntaxhighlight>
 
下表に、配信時に付与される主要なヘッダを示す。 
 
<center>
{| class="wikitable"
|+ Webhookリクエストの主要なHTTPヘッダ
|-
! ヘッダー !! 説明
|-
| <code>X-GitHub-Event</code> || イベントの種類 (例: push、pull_request)
|-
| <code>X-GitHub-Delivery</code> || 配信を識別するUUID
|-
| <code>X-Hub-Signature-256</code> || HMAC-SHA256によるシグネチャ (シークレット設定時のみ)
|}
</center>
 
==== ペイロードの制限 ====
Webhookのペイロードには最大25[MB]の制限がある。 
 
ペイロードがこの制限を超える場合、GitHubはWebhookを送信せずに、配信履歴に記録される。 
 
大量のコミットを含むプッシュイベント等で発生する可能性があるため、注意が必要である。 
 

== GitHub Apps ==
==== GitHub Appsとは ====
GitHub Appsは、GitHubプラットフォーム上に構築するアプリケーションの形式であり、OAuth Appsより推奨される認証方式である。 
 
GitHub Appsの主な特徴を以下に示す。 
 
* Fine-grained permissionsにより、必要な権限のみを要求できる。
* 特定のリポジトリにのみインストールすることが可能である。
* ユーザの代わりではなく、アプリケーション自身として動作できる。
* SAML SSOが有効なOrganizationでは自動的に認可される。
 
==== OAuth Appsとの違い ====
下表に、GitHub AppsとOAuth Appsの主な違いを示す。 
 
<center>
{| class="wikitable"
|+ GitHub Apps vs OAuth Apps
! 比較項目 !! GitHub Apps !! OAuth Apps
|-
| 推奨度 || 推奨 || 非推奨 (新規用途)
|-
| 権限の粒度 || リポジトリ / 操作単位 || スコープ単位
|-
| インストール単位 || Organization またはユーザ || ユーザ
|-
| リポジトリの限定 || 特定リポジトリのみ可能 || 全リポジトリ対象
|-
| 動作主体 || アプリ自身またはユーザ || ユーザのみ
|-
| レート制限 || インストールごとにスケーリング || ユーザごと
|-
| SAML SSO対応 || 自動認可 || ユーザによる認可が必要
|}
</center>
 
==== GitHub Appの作成 ====
GitHub Appを新規作成する手順を以下に示す。 
 
# GitHub.comにログインして、[Settings]を開く。
# 左側のサイドバーから[Developer settings]を選択する。
# [GitHub Apps]を選択して、[New GitHub App]ボタンを押下する。
# アプリ名、ホームページURL、Webhook URL等の必須情報を入力する。
# 必要な権限 (Permissions) を設定する。
# サブスクライブするイベントを選択する。
# プライベートキーを生成してダウンロードする。
 
==== 認証方式 ====
GitHub Appsでは3種類の認証方式が提供されている。 
 
===== JWT認証 (アプリ自身の認証) =====
アプリ自身を認証するためにJWT (JSON Web Token) を使用する。 
 
* アプリのIDとプライベートキーを使用してJWTを生成する。
* JWTの有効期限は最大10分である。
* インストールアクセストークンの取得等、アプリレベルの操作に使用する。
 
<syntaxhighlight lang="javascript">
import jwt from "jsonwebtoken";
import fs from "fs";

const APP_ID = "YOUR_APP_ID";
const PRIVATE_KEY = fs.readFileSync("private-key.pem");

const payload = {
iat: Math.floor(Date.now() / 1000) - 60,
exp: Math.floor(Date.now() / 1000) + (10 * 60),
iss: APP_ID,
};

const token = jwt.sign(payload, PRIVATE_KEY, { algorithm: "RS256" });
</syntaxhighlight>
 
===== インストールアクセストークン =====
特定のインストールのリソースにアクセスするための短期トークンである。 
 
* JWTを使用して POST /app/installations/{installation_id}/access_tokens に対してリクエストを送信することで取得する。
* 有効期限は1時間で、自動的に失効する。
* 特定のリポジトリやリソースへのアクセスに使用する。
 
===== ユーザアクセストークン =====
ユーザがGitHub Appを認可した後に取得できるトークンであり、ユーザの代わりにAPIを呼び出す場合に使用する。 
 

== レート制限 ==
==== プライマリレート制限 ====
GitHub APIには、APIの悪用を防ぐためのレート制限が設けられている。 
 
下表に、プライマリレート制限の上限を示す。 
 
<center>
{| class="wikitable"
|+ プライマリレート制限
! 認証状態 !! 上限 !! 備考
|-
| 認証なし || 60リクエスト / 時間 || IPアドレスごとに適用
|-
| PAT認証済み || 5,000リクエスト / 時間 || ユーザごとに適用
|-
| GitHub Enterprise Cloud || 15,000リクエスト / 時間 || Organizationメンバー
|-
| GitHub Apps (インストール) || 最低5,000リクエスト / 時間 || リポジトリ数に応じてスケーリング
|-
| GITHUB_TOKEN (Actions) || 1,000リクエスト / 時間 || リポジトリごとに適用
|}
</center>
 
==== セカンダリレート制限 ====
プライマリレート制限に加えて、サーバへの過負荷を防ぐためのセカンダリレート制限が存在する。 
 
セカンダリレート制限の主な内容を以下に示す。 
 
* 同時接続数
*: 最大100接続まで
* REST API
*: 1分あたり900ポイントまで
* GraphQL API
*: 1分あたり2,000ポイントまで
* コンテンツ作成 (Issueの作成等)
*: 1時間あたり制限あり
 
セカンダリレート制限に達した場合、レスポンスに <code>retry-after</code> ヘッダが含まれる。 
このヘッダの値 (秒数) だけ待機してから再試行する必要がある。 
 
継続して制限に達する場合は指数バックオフを使用する。 
 
==== 確認方法 ====
現在のレート制限の状態は、レスポンスヘッダまたは専用のエンドポイントで確認できる。 
 
下表に、レスポンスヘッダで確認できる情報を示す。 
 
<center>
{| class="wikitable"
|+ レート制限関連レスポンスヘッダ
! ヘッダ名 !! 説明
|-
| <code>x-ratelimit-limit</code> || 時間あたりの最大リクエスト数
|-
| <code>x-ratelimit-remaining</code> || 現在の期間内の残りリクエスト数
|-
| <code>x-ratelimit-reset</code> || レート制限がリセットされるUNIXタイムスタンプ
|-
| <code>x-ratelimit-used</code> || 現在の期間内に使用したリクエスト数
|-
| <code>retry-after</code> || セカンダリレート制限に達した場合の待機秒数
|}
</center>
 
専用エンドポイントでレート制限を確認することもできる。 
このエンドポイントへのリクエスト自体はレート制限のカウントに含まれない。 
 
curl -L \
-H "Authorization: Bearer <YOUR_TOKEN>" \
https://api.github.com/rate_limit
 
レスポンスの例を以下に示す。 
 
<syntaxhighlight lang="json">
{
"resources": {
"core": {
"limit": 5000,
"remaining": 4999,
"reset": 1700000000,
"used": 1
},
"graphql": {
"limit": 5000,
"remaining": 4999,
"reset": 1700000000,
"used": 1
},
"search": {
"limit": 30,
"remaining": 29,
"reset": 1700000000,
"used": 1
}
},
"rate": {
"limit": 5000,
"remaining": 4999,
"reset": 1700000000,
"used": 1
}
}
</syntaxhighlight>
 

== 参考リンク ==
* [https://docs.github.com/ja/rest GitHub REST API公式ドキュメント]
* [https://docs.github.com/ja/graphql GitHub GraphQL API公式ドキュメント]
* [https://docs.github.com/ja/apps GitHub Apps公式ドキュメント]
* [https://docs.github.com/ja/webhooks GitHub Webhooks公式ドキュメント]
* [https://cli.github.com/manual/ GitHub CLI公式マニュアル]
* [https://github.com/octokit GitHub Octokit公式リポジトリ]
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,GitHub,API,REST API,GraphQL,GitHub Apps,OAuth,Webhook,Octokit,GitHub CLI,gh,Personal Access Token,PAT,Rate Limit,SUSE,Linux
|description={{PAGENAME}} - GitHub APIの使い方に関するリファレンスガイド | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:Git]]

GitHub - セキュリティ

2026-03-24T09:56:05Z

Wiki: ページの作成:「== 概要 == GitHubのセキュリティ機能は、ソフトウェアサプライチェーン全体を保護するための統合的なセキュリティプラットフォームである。 GitHubセキュリティは以下に示す3つの柱で構成されている。 * Secret Scanning *: APIキー、パスワード、トークンなどの認証情報がコードに混入することを検出・防止する機能である。 *: Git履歴全体お…」

== 概要 ==
GitHubのセキュリティ機能は、ソフトウェアサプライチェーン全体を保護するための統合的なセキュリティプラットフォームである。 
 
GitHubセキュリティは以下に示す3つの柱で構成されている。 
 
* Secret Scanning
*: APIキー、パスワード、トークンなどの認証情報がコードに混入することを検出・防止する機能である。
*: Git履歴全体およびIssues、PR、Discussions、Wikiもスキャン対象となる。
* Code Scanning
*: CodeQLをはじめとする静的解析エンジンによりコードの脆弱性を自動検出する機能である。
*: PR作成時にインライン表示でフィードバックを提供する。
* Supply Chain Security
*: Dependabotによる依存関係の脆弱性検出、自動修正PR作成、Dependency Graphによる依存関係の可視化を提供する機能である。
 
GitHub Advanced Security (GHAS) は、これらのセキュリティ機能を包括的に提供するアドオンである。 
GHASはGitHub Code Security (CodeQL、Dependabotの高度機能) とGitHub Secret Protectionの2つのプロダクトで構成される。 
 
公開リポジトリでは一部の機能が無料で利用できるが、プライベートリポジトリでの利用にはGitHub Enterprise Cloudまたはサーバライセンスが必要である。 
 

== Dependabot ==
==== Dependabotとは ====
Dependabotは、リポジトリの依存関係を継続的に監視し、脆弱性の検出・修正および最新バージョンへの更新を自動化するGitHubの機能である。 
 
Dependabotは、以下に示す3つのコンポーネントで構成される。 
 
<center>
{| class="wikitable"
|+ Dependabotのコンポーネント
|-
! 項目 !! 説明
|-
| Dependabot Alerts || 脆弱な依存関係を検出してアラートを通知する。
|-
| Dependabot Security Updates || セキュリティ上の脆弱性を修正するパッチを自動的にPRとして作成する。
|-
| Dependabot Version Updates || 依存関係を最新バージョンに更新するPRを定期的に作成する。
|}
</center>
 
==== Dependabot Alerts ====
Dependabot Alertsは、リポジトリで使用している依存関係にGitHub Advisory Databaseに登録された既知の脆弱性が含まれている場合に、自動でアラートを生成する機能である。 
 
脆弱性の検出時、書き込み権限 / メンテナンス権限 / 管理者権限を持つユーザに通知が送信される。 
通知の設定は個人レベル・リポジトリレベル・組織レベルのそれぞれで制御できる。 
 
アラートはリポジトリの[Security]タブからも確認でき、影響を受けるパッケージ名 / 脆弱性の種類 / 重大度 (Critical/High/Medium/Low) が表示される。 
 
==== Dependabot Security Updates ====
Dependabot Security Updatesは、Dependabot Alertsで脆弱性が検出された時に、脆弱性を修正したバージョンへの更新PRを自動的に作成する機能である。 
 
自動作成されるPRには、以下に示す情報が含まれる。 
* 変更対象のパッケージ名とバージョン
* 修正される脆弱性の内容 (CVE番号・説明)
* リリースノートおよびコミット履歴へのリンク
 
PRをマージすることにより、最小限の変更で脆弱性を解消できる。 
 
==== Dependabot Version Updates ====
Dependabot Version Updatesは、依存関係を定期的にチェックして、新しいバージョンが利用可能になった時にPRを作成する機能である。 
 
この機能を有効化するには、リポジトリに .github/dependabot.yml ファイルを作成して設定を記述する必要がある。 
 
==== dependabot.ymlの設定 ====
.github/dependabot.yml ファイルの基本的な設定項目を以下に示す。 
 
<syntaxhighlight lang="yaml">
version: 2
updates:
- package-ecosystem: "npm"
directory: "/"
schedule:
interval: "weekly"
allow:
- dependency-type: "direct"
ignore:
- dependency-name: "example-package"
versions: ["1.x", "2.x"]
commit-message:
prefix: "chore"
include: "scope"
</syntaxhighlight>
 
下表に、主要な設定項目を示す。 
 
<center>
{| class="wikitable"
|+ dependabot.ymlの主要な設定項目
|-
! 項目 !! 説明
|-
| <code>version</code> || 設定ファイルのバージョンを指定する。 現在は <code>2</code> のみ有効である。
|-
| <code>updates</code> || 更新設定のリストを記述する。 複数のエコシステムを対象にする場合は複数のエントリを記述する。
|-
| <code>package-ecosystem</code> || 監視対象のパッケージエコシステムを指定する。
|-
| <code>directory</code> || パッケージマニフェストファイルが存在するディレクトリを指定する。
|-
| <code>schedule.interval</code> || 更新チェックの頻度を指定する。 <code>daily</code> (毎日)、<code>weekly</code> (週次)、<code>monthly</code> (月次)から選択する。
|-
| <code>allow</code> || 更新を許可する依存関係の種類を制限する。 <code>direct</code> (直接依存)または <code>indirect</code> (間接依存)を指定できる。
|-
| <code>ignore</code> || 更新対象から除外するパッケージや特定バージョンを指定する。
|-
| <code>commit-message</code> || DependabotがPRを作成する時のコミットメッセージのプレフィックスを設定する。
|}
</center>
 
==== 対応パッケージエコシステム ====
下表に、Dependabotが対応しているパッケージエコシステムを示す。 
 
<center>
{| class="wikitable"
|+ Dependabot対応エコシステム一覧
! エコシステム !! package-ecosystemの値 !! マニフェストファイル
|-
| npm (Node.js) || <code>npm</code> || package.json
|-
| pip (Python) || <code>pip</code> || requirements.txt, Pipfile
|-
| Maven (Java) || <code>maven</code> || pom.xml
|-
| Gradle (Java/Kotlin) || <code>gradle</code> || build.gradle
|-
| Composer (PHP) || <code>composer</code> || composer.json
|-
| RubyGems (Ruby) || <code>bundler</code> || Gemfile
|-
| Cargo (Rust) || <code>cargo</code> || Cargo.toml
|-
| Go modules || <code>gomod</code> || go.mod
|-
| NuGet (.NET) || <code>nuget</code> || *.csproj, packages.config
|-
| Pub (Dart/Flutter) || <code>pub</code> || pubspec.yaml
|-
| GitHub Actions || <code>github-actions</code> || .github/workflows/*.yml
|-
| Docker || <code>docker</code> || Dockerfile
|-
| Terraform || <code>terraform</code> || *.tf
|}
</center>
 
==== Auto-Triage Rules ====
Auto-Triage Rulesは、Dependabot Alertsを自動で仕分けするルールを定義する機能である。 
この機能により、特定の条件に合致するアラートを自動で却下・スヌーズ・承認することができる。 
 
組織レベルまたはリポジトリレベルで設定でき、以下に示すような条件を組み合わせてルールを定義する。 
* 脆弱性の重大度 (Critical / High / Medium / Low)
* 脆弱性の種類 (CWEコード)
* 対象のスコープ (runtime / development)
* パッケージ名
 
例えば、開発依存関係 (devDependencies) の低・中程度の脆弱性を自動で却下するルールを設定することにより、アラートの過負荷を軽減できる。 
 

== Code Scanning ==
==== Code Scanningとは ====
Code Scanningは、コードに含まれるセキュリティ上の脆弱性やプログラミング上の問題を自動的に発見するGitHubの静的解析機能である。 
 
PRの作成 / プッシュのタイミングでスキャンが実行されて、検出された問題はPR上にインラインコメントとして表示される。 
また、全てのアラートは、リポジトリの[Security]タブでも管理できる。 
 
デフォルトの解析エンジンとしてCodeQLが使用されるが、SARIFファイルを通じてサードパーティの静的解析ツールとも統合できる。 
 
==== CodeQL ====
CodeQLは、GitHubが開発したセマンティックコード解析エンジンであり、コードをデータとして扱い、クエリによって脆弱性のパターンを検索する仕組みを持つ。 
 
CodeQLが対応している言語を以下に示す。 
* C / C++
* C#
* Go
* Java / Kotlin
* JavaScript / TypeScript
* Python
* Ruby
* Swift
 
CodeQLは、SQLインジェクション、クロスサイトスクリプティング、バッファオーバーフロー、安全でない暗号化処理等の脆弱性パターンを検出できる。 
ローカル環境での分析には、CodeQL CLIが利用できる。 
 
==== セットアップ ====
Code Scanningのセットアップ方法は、デフォルトセットアップと詳細セットアップの2種類がある。 
 
===== デフォルトセットアップ =====
デフォルトセットアップは、GitHubが自動的に解析設定を管理するセットアップ方式である。 
 
設定の手順を以下に示す。 
# リポジトリの[Security]タブを開く。
# [Code scanning]セクションの[Set up]ボタンを押下する。
# [Default]を選択して、セットアップを完了する。
 
リポジトリで使用されている言語が自動検出されて、適切なCodeQLクエリスイートが適用される。 
設定変更が不要な場合やすぐに利用を開始したい場合に適している。 
 
===== 詳細セットアップ =====
詳細セットアップは、GitHub Actionsのワークフローファイル (YAML) を自分でカスタマイズするセットアップ方式である。 
 
設定の手順を以下に示す。 
# リポジトリの[Security]タブを開く。
# [Code scanning]セクションの[Set up]ボタンを押下する。
# [Advanced]を選択する。
# 生成された .github/workflows/codeql.yml ファイルを編集して、コミットする。
 
カスタムクエリの追加、スキャン対象の絞り込み、スケジュールの変更等、詳細な制御が必要な場合に適している。 
 
.github/workflows/codeql.yml ファイルの基本的な構成例を以下に示す。 
 
<syntaxhighlight lang="yaml">
name: "CodeQL"

on:
push:
branches: [ "main" ]
pull_request:
branches: [ "main" ]
schedule:
- cron: '0 0 * * 1'

jobs:
analyze:
name: Analyze
runs-on: ubuntu-latest
permissions:
actions: read
contents: read
security-events: write

strategy:
matrix:
language: [ 'javascript', 'python' ]

steps:
- name: Checkout repository
uses: actions/checkout@v4

- name: Initialize CodeQL
uses: github/codeql-action/init@v3
with:
languages: ${{ matrix.language }}

- name: Perform CodeQL Analysis
uses: github/codeql-action/analyze@v3
</syntaxhighlight>
 
==== Code Scanning Alerts ====
Code Scanningで検出されたアラートは、以下に示す方法で確認・管理できる。 
 
* PRでのインライン表示
*: PRの差分ビューに対して、問題のある行に直接コメントとしてアラートが表示される。
*: 開発者がコードレビュー時にセキュリティ問題を認識できる。
* Securityタブでの管理
*: リポジトリの[Security]タブから全てのCode Scanningアラートを一覧表示できる。
*: 言語、ルール、重大度、ステータスでフィルタリングして管理できる。
*: アラートを Open、Fixed、Dismissed の状態で管理できる。
 
アラートを却下 (Dismiss) する時は、却下理由 (false positive / won't fix / used in tests等) を記録することが推奨される。 
 
==== SARIFとの統合 ====
SARIF (Static Analysis Results Interchange Format) は、静的解析ツールの結果を表現するためのJSONベースの標準フォーマットである。 
GitHub Code Scanningは、SARIFファイルのインポートに対応しており、CodeQL以外の静的解析ツールの結果もGitHub上で一元管理できる。 
 
SARIFファイルは、以下に示すGitHub Actionsアクションを使用してアップロードする。 
 
<syntaxhighlight lang="yaml">
- name: Upload SARIF file
uses: github/codeql-action/upload-sarif@v3
with:
sarif_file: results.sarif
</syntaxhighlight>
 
下表に、SARIFとの統合に対応した主なサードパーティツールを示す。 
 
<center>
{| class="wikitable"
|+ サードパーティ製静的解析ツールの例
|-
! ツール !! 説明
|-
| SonarQube / SonarCloud || オープンソースおよびプロプライエタリなコード品質・セキュリティ解析ツール
|-
| Fortify Static Code Analyzer || Micro Focusが提供するエンタープライズ向け静的解析ツール
|-
| Checkmarx || エンタープライズ向けアプリケーションセキュリティテストプラットフォーム
|-
| Semgrep || オープンソースの軽量静的解析ツール カスタムルールを記述しやすい特徴を持つ。
|}
</center>
 

== Secret Scanning ==
==== Secret Scanningとは ====
Secret Scanningは、APIキー、パスワード、トークン、証明書等の機密情報 (シークレット) がリポジトリに誤ってコミットされることを検出・防止する機能である。 
 
コードベース全体だけでなく、Git履歴全体も対象としてスキャンが実行される。 
 
==== 検出対象 ====
Secret Scanningが検出するシークレットのパターンは、以下に示す4種類に分類される。 
 
<center>
{| class="wikitable"
|+ Secret Scanningの検出パターン種別
|-
! 種別 !! 説明
|-
| Partner secrets || GitHubがパートナー企業と連携して定義したパターンである。 検出した場合、パートナー企業に対してシークレットの無効化を自動通知する。 AWS、Google、Azure、Slack、Stripe等、多数のサービスプロバイダーに対応している。
|-
| Non-provider patterns || 特定のサービスに紐付かない一般的なシークレットパターンである。 プライベートキー、汎用的なトークンパターン等が含まれる。
|-
| Custom patterns || ユーザが正規表現で定義した自社固有のシークレットパターンである。 リポジトリ、組織、エンタープライズの各レベルで設定できる。
|-
| AI-powered detection || 機械学習モデルを使用して、パターン定義のない未知のシークレットを検出する。
|}
</center>
 
==== スキャン対象 ====
下表に、Secret Scanningのスキャン対象範囲を示す。 
 
<center>
{| class="wikitable"
|+ Secret Scanningのスキャン対象
|-
! 対象 !! 説明
|-
| Gitコミット履歴全体 || リポジトリ作成時からの全コミット履歴をスキャンする。 過去に誤ってコミットされたシークレットも検出できる。
|-
| Issues || Issueのタイトル、本文、コメントをスキャンする。
|-
| Pull Requests || PRのタイトル、本文、コメント、レビューコメントをスキャンする。
|-
| Discussions || Discussionsの投稿内容をスキャンする。
|-
| Wiki || リポジトリのWikiページをスキャンする。
|}
</center>
 
==== Push Protection ====
Push Protectionは、シークレットを含むコミットをプッシュ時の段階でブロックする機能である。 
Push Protectionはコマンドライン (CLI)、GitHub WebUI、GitHub APIのいずれの方法でのプッシュに対しても機能する。 
 
シークレットが検出された場合、プッシュはブロックされて、開発者に警告が表示される。 
開発者はシークレットを除去してから再プッシュ、または、以下に示す理由を指定してブロックをバイパスすることができる。 
* これは偽陽性である (It's a false positive)
* 本番環境では使用しない (It's only used for tests)
* リスクを承知の上でプッシュする (I'll fix this later)
 
バイパスが実行された場合、その操作はログに記録されて、アラートが生成される。 
 
Push Protectionは、リポジトリ / ユーザ / 組織の各レベルで有効化・設定できる。 
 
==== カスタムパターン ====
カスタムパターンを使用することにより、自社固有のシークレット形式を正規表現で定義してスキャン対象に追加できる。 
 
設定手順を以下に示す。 
# リポジトリの[Settings] - [Advanced Security] - [Custom patterns]を開く。
# [New pattern]を選択する。
# パターン名、正規表現、サンプル文字列を入力する。
# [Save and dry run]でテストを実行して検出結果を確認する。
# 問題がなければパターンを公開する。
 
カスタムパターンはリポジトリレベル、組織レベル、エンタープライズレベルで設定でき、上位レベルで設定したパターンは下位レベルのリポジトリに継承される。 
 
ドライラン (dry run) 機能を使用することにより、実際にアラートを生成する前にパターンの検出精度を検証できる。 
 
==== Validity Checks ====
Validity Checksは、検出されたシークレットが実際に有効であるかどうかをサービスプロバイダーに問い合わせて確認する機能である。 
この機能により、既に無効化されたシークレットに関するアラートと今まさに有効なシークレットに関するアラートを区別して優先度を付けることができる。 
 
有効性のステータスは、Active、Inactive、Unknown の3種類で表示される。 
 
対応しているシークレットの種類は、GitHubが定義したPartner secretsの範囲内に限られる。 
 

== セキュリティポリシー ==
==== SECURITY.md ====
SECURITY.md ファイルは、脆弱性の報告方法を説明するセキュリティポリシー文書である。 
 
このファイルはリポジトリのルートディレクトリ・docs/、.github/ のいずれかに配置することにより、リポジトリのSecurityタブに自動的に表示される。 
 
SECURITY.md ファイルには、以下に示す情報を記載することが推奨される。 
* サポートしているバージョンの一覧
* 脆弱性の報告先 (メールアドレス・連絡フォーム等)
* 報告から対応完了までのプロセスと期待されるタイムライン
* 公開ポリシー (responsible disclosureポリシー)
 
==== セキュリティアドバイザリ ====
セキュリティアドバイザリは、リポジトリのセキュリティ上の問題を非公開で協議・修正して、修正後に公開するための機能である。 
 
リポジトリメンテナーは[Security]タブからドラフトアドバイザリを作成して、信頼できる協力者を招待して非公開の環境で脆弱性の詳細を共有できる。 
 
修正が完了した後、アドバイザリを公開することにより、CVE番号のリクエストやGitHub Advisory Databaseへの登録が行われる。 
 
==== プライベート脆弱性報告 ====
Private Vulnerability Reporting (プライベート脆弱性報告) は、セキュリティリサーチャーがリポジトリメンテナーに対して脆弱性を非公開で報告するための仕組みである。 
 
この機能を有効化すると、リポジトリの[Security]タブに[Report a vulnerability]ボタンが表示され、誰でも非公開の脆弱性報告フォームからメンテナーに連絡できる。 
 
報告内容はメンテナーとリポートした人だけが閲覧でき、修正作業を非公開の環境で進めることができる。 
 

== 依存関係のレビュー ==
==== Dependency Graph ====
Dependency Graphは、リポジトリで使用している全ての依存関係を自動的に解析して可視化する機能である。 
 
リポジトリのInsightsセクションから確認でき、直接依存関係だけでなく間接依存関係 (依存関係の依存関係) も表示される。 
 
Dependency Graphは以下に示す機能の基盤となっている。 
* Dependabot Alertsの脆弱性検出
* Dependabot Security UpdatesのPR作成
* Dependency ReviewのPRチェック
* SBOMの生成
 
対応しているマニフェストファイル形式は、npm、pip、Maven、Gradle、Composer、RubyGems、Cargo、Go modules、NuGet等、多数に及ぶ。 
 
==== Dependency Review ====
Dependency Reviewは、PRのマージ前に依存関係の変更内容をチェックする機能である。 
 
PRで追加 / 更新 / 削除される依存関係に対して、以下に示す情報を確認できる。 
* 追加されるパッケージに既知の脆弱性が含まれていないか
* ライセンスが組織のポリシーに適合しているか
* 旧バージョンや非推奨パッケージでないか
 
Dependency Reviewを自動化するには、<code>actions/dependency-review-action</code> を使用したGitHub Actionsワークフローを設定する。 
 
<syntaxhighlight lang="yaml">
name: Dependency Review

on:
pull_request:

jobs:
dependency-review:
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v4

- name: Dependency Review
uses: actions/dependency-review-action@v4
with:
fail-on-severity: moderate
deny-licenses: GPL-3.0, AGPL-3.0
</syntaxhighlight>
 
==== SBOM ====
SBOM (Software Bill of Materials、ソフトウェア部品表) は、ソフトウェアに含まれる全ての依存関係コンポーネントを一覧化した文書である。 
 
GitHubはDependency Graphの情報をもとに、SPDX形式またはCycloneDX形式のSBOMファイルを生成・エクスポートする機能を提供している。 
 
SBOMはコンプライアンス監査、サプライチェーンのリスク評価、インシデント対応において使用される。 
 
リポジトリの[Insights] - [Dependency Graph]ページからSBOMをダウンロードできる。 
 

== セキュリティ概要ダッシュボード ==
==== 組織レベル ====
組織のセキュリティ概要ダッシュボードは、組織内の全リポジトリのセキュリティ状況を一元的に把握するための機能である。 
 
ダッシュボードでは以下の情報を確認できる。 
* トレンド分析
*: 組織全体のアラート数の時系列推移を可視化する。
*: 特定の期間にアラートが急増したリポジトリを特定できる。
* カバレッジ監視
*: 各セキュリティ機能 (Code Scanning / Secret Scanning / Dependabot Alerts) の有効化状況を確認できる。
*: 未設定のリポジトリを特定して対応できる。
* Push Protectionの有効性
*: 組織全体でのPush Protectionのブロック状況、バイパス状況を確認できる。
* CodeQL PR分析
*: PRに対してCode Scanningが実行されているリポジトリの割合を確認できる。
 
このダッシュボードは、GitHub Enterprise CloudまたはGitHub Advanced Security (GHAS) ライセンスが必要である。 
 
==== リポジトリレベル ====
リポジトリレベルのセキュリティ情報は、各リポジトリのSecurityタブから確認できる。 
 
Securityタブでは、以下に示す情報を管理できる。 
 
<center>
{| class="wikitable"
|+ Securityタブの機能一覧
|-
! 項目 !! 説明
|-
| Overview || リポジトリのセキュリティ機能の有効化状況とアラートの概要を表示する。
|-
| Dependabot Alerts || 脆弱な依存関係のアラート一覧を表示・管理する。
|-
| Code Scanning Alerts || Code Scanningで検出されたアラート一覧を表示・管理する。
|-
| Secret Scanning Alerts || 検出されたシークレットのアラート一覧を表示・管理する。
|-
| Security policy || SECURITY.md ファイルの内容を表示する。
|-
| Security advisories || リポジトリのセキュリティアドバイザリを管理する。
|}
</center>
 

== GitHub Advisory Database ==
==== CVEデータベース ====
GitHub Advisory Databaseは、GitHubが管理するオープンソースソフトウェアの脆弱性データベースである。 
 
2026年3月時点で、レビュー済みのアドバイザリが27,583件、未レビューのアドバイザリが294,507件以上登録されている。 
 
データベースのコンテンツはCC-BY-4.0ライセンスの下で公開されており、オープンソースプロジェクトからの貢献も受け付けている。 
 
各アドバイザリには以下の情報が含まれる。 
* CVE識別子 (CVE番号)
* GHSA識別子 (GitHub独自の識別子)
* 影響を受けるパッケージ・バージョン範囲
* 脆弱性の種類 (CWEコード)
* 重大度スコア (CVSS)
* 修正バージョン
 
対応しているエコシステムは、npm、Maven、Composer、Go、pip、RubyGems、NuGet、Cargo、Pub、GitHubActions等、多岐にわたる。 
 
==== アドバイザリの検索 ====
GitHub Advisory Databaseは、[https://github.com/advisories GitHub Advisory Database]から検索できる。 
 
以下に示す条件でアドバイザリを検索およびフィルタリングできる。 
* エコシステム (npm / Maven / pip 等)
* 重大度 (Critical / High / Medium / Low)
* CWEコード (脆弱性の種類)
* CVE番号による直接検索
* キーワード検索
 
GitHub CLIを使用してアドバイザリを検索することも可能である。 
 
# 特定パッケージの脆弱性を検索する
gh api /advisories?affects=npm/lodash
 
また、GraphQL APIを使用することにより、プログラムからアドバイザリデータを取得して、独自のセキュリティダッシュボードを構築することも可能である。 
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:Git]]