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

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]]

GitHub - Copilot

2026-03-24T09:14:37Z

Wiki: ページの作成:「== 概要 == GitHub Copilotは、GitHubとOpenAIが共同開発したAI駆動のコード支援ツールである。 エディタ内でリアルタイムにコードの提案・補完・生成を行い、開発者の生産性を向上させる。 会話型インターフェース (Copilot Chat)、自律的なコード実装 (Agent Mode)、CLIサポート等、コーディング作業のあらゆる場面をカバーする機能を提供する。 <br…」

== 概要 ==
GitHub Copilotは、GitHubとOpenAIが共同開発したAI駆動のコード支援ツールである。 
エディタ内でリアルタイムにコードの提案・補完・生成を行い、開発者の生産性を向上させる。 
 
会話型インターフェース (Copilot Chat)、自律的なコード実装 (Agent Mode)、CLIサポート等、コーディング作業のあらゆる場面をカバーする機能を提供する。 
 
特に強力なサポートを提供するプログラミング言語は以下の通りである。 
* Python
* JavaScript / TypeScript
* Ruby
* Go
* C# / C++
 
対応IDEは以下の通りである。 
* VS Code
* Visual Studio
* JetBrains IDE
*: IntelliJ IDEA、PyCharm、WebStorm等
* Neovim
* Xcode
* Eclipse
 

== プラン ==
==== プランの種類 ====
GitHub Copilotは個人・組織の規模や用途に応じて複数のプランが提供されている。 
 
<center>
{| class="wikitable"
|+ GitHub Copilot プラン比較
! プラン !! 月額料金 !! 主な機能・制限
|-
| Free || 無料 || コード補完: 2,000回/月 Copilot Chat: 50メッセージ/月 基本的なコード提案
|-
| Pro || $10/ユーザ || コード補完: 無制限 Copilot Chat: 無制限 Code Review対応
|-
| Pro+ || $39/ユーザ || Proの全機能 プレミアムリクエスト: 1,500回/月 Coding Agent対応 最新モデルへの優先アクセス
|-
| Business || $19/ユーザ || Pro相当の機能 組織管理機能 コンテンツ除外設定 プロンプト・提案の非保持
|-
| Enterprise || $39/ユーザ || Businessの全機能 Coding Agent対応 カスタムモデル対応 高度なセキュリティ管理
|}
</center>
 
==== 学生向けプラン ====
GitHub Student Developer Packに登録している学生は、GitHub Copilotを無料で利用できる。 
 
提供内容はProプランと同等であり、コード補完やCopilot Chatが無制限で使用可能である。 
 
申請はGitHubの学生認証ページから行い、在学証明が必要となる。 
 

== コード補完 ==
==== インラインコード提案 ====
コード補完機能はエディタ内でリアルタイムに動作して、入力中のコードに対して続きを提案する。 
 
提案はグレイテキスト (ゴースト表示) でインライン表示され、開発者はそのまま受け入れるか却下するかを選択できる。 
 
提案の対象範囲は単一の記号から複数行にわたるブロックまで柔軟に対応する。 
コメントや関数シグネチャを記述するだけで、実装コード全体が提案されることもある。 
 
==== 複数行補完 ====
Copilotは関数、クラス、テストケース等、複数行に渡るコードブロック全体を一括で提案できる。 
 
この機能は、以下に示すような場面で有効である。 
* 関数のコメント (docstring) から実装コードを生成する。
* テストファイルでテストケースの雛型を一括生成する。
* 定型的なボイラープレートコードを自動補完する。
 
Next Edit Suggestions機能 (VS Code等でプレビュー提供) では、直前の編集内容をもとに、次に修正すべき箇所の提案も行う。 
 
==== 提案の操作 ====
下表に、提案を操作するキーボードショートカットを示す。 
 
<center>
{| class="wikitable"
|+ コード補完操作一覧
! 操作 !! キー !! 説明
|-
| 提案を受け入れる || [Tab]キー || 現在表示されている提案を全て適用する。
|-
| 提案を却下する || [Esc]キー || 現在の提案を非表示にする。
|-
| 次の提案へ切り替える || [Alt] + <nowiki>]</nowiki>キー || 複数ある提案の中で次の候補を表示する。
|-
| 前の提案へ切り替える || [Alt] + <nowiki>[</nowiki>キー || 複数ある提案の中で前の候補を表示する。
|-
| 単語単位で受け入れる || [Ctrl] + [→]キー || 提案を1単語ずつ受け入れる。(VS Code)
|}
</center>
 

== Copilot Chat ==
==== Copilot Chatとは ====
Copilot Chatは、コードについて自然言語で会話できるインターフェースである。 
 
IDE内のチャットパネル、GitHub.com上のWebインターフェース、モバイルアプリから利用できる。 
 
マルチモーダル対応により、テキストに加えて音声での入力も可能である。 
コードスニペット、エラーメッセージ、スクリーンショットを貼り付けて質問することもできる。 
 
==== チャットコンテキスト ====
Copilot Chatでは、チャット入力時に <code>@</code> 記号を使用してコンテキストを指定できる。 
 
* <code>@workspace</code>
*: 現在開いているワークスペース全体をコンテキストとして参照する。
*: プロジェクト全体に関わる質問や、複数ファイルにまたがる処理の相談に有効である。
* <code>@terminal</code>
*: ターミナルの出力内容やエラーをコンテキストとして参照する。
*: コマンドのエラー解決や、ビルドログの分析に使用する。
* <code>@github</code>
*: GitHub上のIssue、PR、コミット情報をコンテキストとして参照する。
*: リポジトリの履歴や議論の内容をもとにした回答が得られる。
 
また、<code>#file</code>, <code>#folder</code>, <code>#symbol</code> を使って特定のファイル・フォルダ・シンボルをピンポイントで参照することもできる。 
 
==== スラッシュコマンド ====
チャット入力欄では、<code>/</code> で始まるスラッシュコマンドを使用して特定の操作を素早く実行できる。 
 
<center>
{| class="wikitable"
|+ Copilot Chat スラッシュコマンド一覧
! コマンド !! 説明
|-
| <code>/explain</code> || 選択したコードや指定したコードの動作・意図を自然言語で説明する。
|-
| <code>/fix</code> || 選択したコードのバグや問題点を検出して、修正案を提示する。
|-
| <code>/tests</code> || 選択したコードに対するユニットテストを生成する。
|-
| <code>/doc</code> || 選択したコードのドキュメントコメント (docstring等) を生成する。
|-
| <code>/clear</code> || チャット履歴をクリアして新しい会話を開始する。
|}
</center>
 

== Agent Mode ==
==== Agent Modeとは ====
Agent Modeは2025年に導入された機能であり、Copilotが自律的にコードの実装、修正、検証を行うモードである。 
 
従来のコード補完およびチャットが人間の指示に対して1ステップで応答するのに対して、Agent Modeは複数のステップを自律的に実行して複雑なタスクを完遂する。 
 
複数ファイルにわたるコード変更、ターミナルコマンドの実行、エラーの自動修正ループ等を一連の処理として実施する。 
 
==== 動作フロー ====
Agent Modeは以下に示すフローで動作する。 
 
# コンテキストの特定
#: タスクに関連するファイルや依存関係を自動的に特定する。
# ファイルの読み取り
#: 関連ファイルの内容を読み込み、現在の実装状況を把握する。
# コードの変更
#: 必要な変更を複数ファイルに渡って実施する。
# ターミナルコマンドの実行
#: ビルド、テスト、依存パッケージのインストール等のコマンドを実行する。
# エラーの監視
#: 実行結果を監視して、エラーが発生した場合は原因を分析する。
# 自動修正
#: 検出したエラーを自動的に修正して、再度検証を行う。
 
このループは、タスクが完了するまで繰り返し実行される。 
 
==== 対応IDE ====
Agent Modeが完全に対応しているIDEを以下に示す。 
 
* VS Code (完全対応、推奨)
* Visual Studio
* JetBrains IDE (対応範囲は順次拡大中)
 

== Copilot Coding Agent ==
==== Coding Agentとは ====
Copilot Coding Agentは、GitHubがホストするAIエージェントであり、GitHub Issue の内容をもとに実装を自動的に行う機能である。 
 
開発者がIssueにCopilotをアサインするだけで、エージェントが実装、テスト、ドラフトPRの作成までを自動的に完了する。 
 
この機能はPro+プランおよびEnterpriseプランで利用できる。 
 
==== 起動方法 ====
Coding Agentを起動する手順は以下の通りである。 
 
# GitHubリポジトリ上でIssueを開く。
# Issueの右サイドバーにある[Assignees]セクションを開く。
# アサイン先として[Copilot]を選択する。
# Copilotがタスクを受け付け、自動的に実装を開始する。
 
実装が完了すると、ドラフトPRが自動的に作成される。 
開発者はドラフトPRを確認して、内容をレビューした上でマージ操作を行う。 
 
==== セッションログ ====
Coding Agentが実行する全ての処理は、セッションログとして記録される。 
 
* 実施したファイル変更の一覧
* 実行したターミナルコマンドとその出力
* 判断の根拠や思考プロセスの説明
 
開発者はセッションログをPR画面から参照でき、エージェントの動作を透明性高く追跡できる。 
 

== Copilot CLI ==
==== gh copilot suggest ====
<code>gh copilot suggest</code> コマンドは、自然言語で説明したタスクに対して、実行すべきシェルコマンドを提案する機能である。 
 
基本的な使用方法を以下に示す。 
 
gh copilot suggest "<タスクの説明>"
 
使用例を以下に示す。 
 
# Dockerコンテナの一覧を確認するコマンドを提案させる例
gh copilot suggest "実行中のDockerコンテナを一覧表示したい"

# ファイル圧縮のコマンドを提案させる例
gh copilot suggest "特定のディレクトリをtar.gzで圧縮したい"
 
==== gh copilot explain ====
<code>gh copilot explain</code> コマンドは、指定したシェルコマンドの動作・意味を自然言語で説明する機能である。 
 
基本的な使用方法を以下に示す。 
 
gh copilot explain "<コマンド>"
 
使用例を以下に示す。 
 
# コマンドの意味を説明させる例
gh copilot explain "grep -rn 'pattern' ./src --include='*.ts'"

# パイプラインの説明をさせる例
gh copilot explain "find . -name '*.log' | xargs rm -f"
 
==== エイリアス ====
頻繁に使用するコマンドのために、短縮エイリアスが提供されている。 
 
<center>
{| class="wikitable"
|+ Copilot CLI エイリアス一覧
! エイリアス !! 展開されるコマンド !! 説明
|-
| <code>ghcs</code> || <code>gh copilot suggest</code> || コマンド提案の短縮形
|-
| <code>ghce</code> || <code>gh copilot explain</code> || コマンド説明の短縮形
|}
</center>
 
エイリアスはシェルの設定ファイルに追加あるいは <code>gh copilot alias</code> コマンドで設定できる。 
 

== コードレビュー ==
==== Copilot Code Review ====
Copilot Code Reviewは、Pull Requestに対してAIが自動的にコードレビューを行う機能である。 
 
人間のレビュアーが確認する前に、潜在的な問題点や改善点をコメントとして提示する。 
 
対応プランはProプラン以上であり、BusinessおよびEnterpriseプランでも利用可能である。 
 
==== レビュー対象 ====
下表に、Copilot Code Reviewが検出する問題のカテゴリを示す。 
 
<center>
{| class="wikitable"
|+ コードスキャンの検出カテゴリ一覧
|-
! カテゴリ !! 説明
|-
| バグ || ロジックエラー、境界値問題、未処理の例外等、実行時に問題を引き起こす可能性のあるコードを検出する。
|-
| セキュリティ || SQLインジェクション、XSS、ハードコードされた認証情報等、セキュリティ上の脆弱性を検出する。
|-
| パフォーマンス || 非効率なループ、不要なデータベースクエリ、メモリリークの可能性があるコードを検出する。
|-
| ベストプラクティス || コーディング規約への準拠、命名規則、重複コードの排除等を提案する。
|}
</center>
 
==== 自動レビュー設定 ====
PRが作成されるたびに自動的にCopilotのレビューをリクエストする設定が可能である。 
 
設定手順は以下の通りである。 
 
# リポジトリの[Settings]を開く。
# [Branches]セクションで対象ブランチの保護ルールを選択または作成する。
# [Require reviewers]の設定で[Automatically request Copilot review]を有効にする。
 
この設定を有効にすると、PRが作成・更新されるたびにCopilotが自動的にレビューを実施する。 
 

== カスタマイズ ==
==== カスタム指示 ====
リポジトリ固有のコーディング規約、スタイル、要件をCopilotに事前に指示するために、カスタム指示ファイルを作成できる。 
 
* ファイルの配置場所
*: .github/copilot-instructions.md
*: 
*: リポジトリのルートに配置する。
*: Markdown形式で記述する。
*: Copilotがコード生成、チャット応答を行う時に自動的に参照される。
 
記述例を以下に示す。 
 
<syntaxhighlight lang="md">
# Copilot Instructions

## コーディング規約
- インデントはスペース3つを使用する
- 変数名はcamelCaseを使用する
- 関数には必ずJSDocコメントを記述する

## 使用技術スタック
- フロントエンド: React + TypeScript
- バックエンド: Node.js + Express
- データベース: PostgreSQL
</syntaxhighlight>
 
==== パス固有指示 ====
特定のファイルパターンに対してのみ適用される指示ファイルを作成できる。 
 
ファイル名の形式は *.instructions.md であり、対象パスのパターンをファイル内で指定する。 
 
<syntaxhighlight lang="md">
---
applyTo: "src/components/**"
---

## Reactコンポーネント向け指示
- 関数コンポーネントのみを使用する
- Propsは必ずTypeScriptのinterfaceで型定義する
- コンポーネントファイル内にスタイルを記述しない
</syntaxhighlight>
 
==== コンテンツ除外設定 ====
特定のファイルおよびディレクトリをCopilotの参照対象から除外する設定が可能である。 
 
Business / Enterpriseプランでは、リポジトリ管理者がコンテンツ除外設定を行える。 
 
除外設定の主な用途は以下の通りである。 
* 機密情報を含む設定ファイルの除外
* ライセンスの異なるサードパーティコードの除外
* テストデータや個人情報を含むファイルの除外
 
==== MCP統合 ====
GitHub CopilotはModel Context Protocol (MCP) をサポートしており、外部ツールやデータソースとの統合が可能である。 
 
MCPとは、AIアシスタントが外部のシステム、データベース、APIと標準化された方法で連携するためのプロトコルである。 
 
MCPサーバの種類は以下の通りである。 
 
* Local / STDIO
*: ローカルマシン上で動作するMCPサーバ
*: 標準入出力 (stdio) を通じてCopilotと通信する。
* HTTP / SSE
*: HTTPエンドポイントまたは Server-Sent Events (SSE) 経由で通信するMCPサーバ
*: リモートサービスや内部システムとの連携に使用する。
 
GitHub公式のMCP Serverも提供されており、GitHub上のIssue、PR、リポジトリ情報に直接アクセスできる。 
 
MCPを活用することにより、Copilotはデータベース、社内API、独自のドキュメントシステム等を参照した回答を生成できるようになる。 
 

== セキュリティとプライバシー ==
==== データ保持ポリシー ====
下表に、GitHub Copilotのプランごとのデータ保持ポリシーを示す。 
 
<center>
{| class="wikitable"
|+ データ保持ポリシー一覧
! プラン !! プロンプトの保持 !! 提案の保持 !! 学習への使用
|-
| Free / Pro / Pro+ || GitHubのポリシーに準拠 || GitHubのポリシーに準拠 || ユーザ設定による
|-
| Business || 保持しない || 保持しない || 使用しない
|-
| Enterprise || 保持しない || 保持しない || 使用しない
|}
</center>
 
BusinessおよびEnterpriseプランでは、入力したプロンプトと生成された提案はGitHubのサーバに保持されず、モデルの学習にも使用されない。 
 
==== Public Code Filter ====
Public Code Filterは、公開リポジトリのコードと類似した内容の提案をブロックする機能である。 
 
この機能を有効にすると、GitHubに公開されているコードと一定以上類似するコードブロックは提案されない。 
 
設定はGitHubのCopilot設定ページから変更できる。 
 
* 有効 (推奨)
*: 公開コードとの類似提案を除外する。
* 無効
*: 全ての提案を表示する。(デフォルト: 有効)
 
==== IP保護 ====
GitHubはCopilot Enterpriseプランのユーザを対象に、著作権侵害に関するIP保護および免責保証を提供している。 
 
主な保護内容は以下の通りである。 
* Copilotが生成したコードによる著作権侵害訴訟に対する費用の補償
* プライベートリポジトリのコードはモデルの学習に使用されない。
* 個人ユーザの入力データは他のユーザへの提案に使用されない。
 

== 推奨事項 ==
==== プロンプトの書き方 ====
Copilotから精度の高い提案を得るためのプロンプト作成のポイントを以下に示す。 
 
* 構造化して記述する、
*: タスクの目的、入力、出力、制約を明確に分けて記述する。
*: 箇条書きや番号付きリストを使用して、要件を整理する。
* 具体的な要件を記述する。
*: "ファイルを処理する関数" ではなく "CSVファイルを読み込み、年齢列が18以上の行だけを返す関数" のように具体的に記述する。
* タスクを分割する。
*: 複雑なタスクは複数の小さなタスクに分割して、段階的に実装を進める。
* コメントでプロンプトを記述する。
*: コードファイル内にコメントとして要件を記述し、コード補完の精度を向上させる。
 
==== コンテキストの提供 ====
Copilotはエディタで開いているファイルの内容をコンテキストとして参照する。 
 
* 隣接タブの活用
*: 関連するファイルを複数のタブで開いておくことで、Copilotが参照できるコンテキストが増加する。
*: 型定義ファイル、インターフェース定義、関連モジュールを開いておくと提案精度が向上する。
* ファイル参照の活用
*: Copilot Chatで <code>#file</code> を使用して、特定のファイルをピンポイントで参照する。
*: <code>#folder</code> でフォルダ全体を、<code>#symbol</code> で特定の関数やクラスを参照できる。
* ワークスペース参照
*: <code>@workspace</code> を使用してプロジェクト全体をコンテキストに含めることにより、プロジェクト構造を踏まえた提案が得られる。
 

{{#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]]

GitHub - Codespaces

2026-03-23T22:17:33Z

Wiki: ページの作成:「== 概要 == GitHub Codespacesは、クラウド上にホストされた開発環境を提供するGitHubの機能である。 Ubuntu Linux仮想マシン上のDockerコンテナとして動作し、ブラウザ版VS Code、デスクトップ版VS Code、またはGitHub CLIから接続して利用できる。 ローカル環境のセットアップ不要で即座に開発を開始でき、チームメンバー間で統一された開発環境を共…」

== 概要 ==
GitHub Codespacesは、クラウド上にホストされた開発環境を提供するGitHubの機能である。 
 
Ubuntu Linux仮想マシン上のDockerコンテナとして動作し、ブラウザ版VS Code、デスクトップ版VS Code、またはGitHub CLIから接続して利用できる。 
 
ローカル環境のセットアップ不要で即座に開発を開始でき、チームメンバー間で統一された開発環境を共有できることが主なメリットである。 
 
下表に、Codespacesが提供する主な機能を示す。 
 
<center>
{| class="wikitable"
|+ GitHub Codespacesの主な機能
! 機能 !! 説明
|-
| クラウド開発環境 || Ubuntu Linux仮想マシン上のDockerコンテナとして動作し、Webブラウザからすぐに利用できる。
|-
| Dev Container対応 || devcontainer.jsonで開発環境を定義して、チーム全体で同一の環境を再現できる。
|-
| 複数の接続方法 || ブラウザ版VS Code、デスクトップ版VS Code、GitHub CLI等の複数の方法で接続できる。
|-
| プリビルド機能 || 依存関係のインストールやビルドを事前に実行することにより、Codespace作成時間を短縮できる。
|-
| シークレット管理 || 環境変数としてシークレットを安全に注入して、APIキーや認証情報を管理できる。
|}
</center>
 

== Codespaceの作成 ==
==== リポジトリからの作成 ====
Codespaceはリポジトリのページから直接作成できる。 
 
Web UIからの作成手順を以下に示す。 
 
# [リポジトリ]ページを開く。
# 緑色の[Code]ボタンを押下する。
# [Codespaces]タブを選択する。
# [Create codespace on <ブランチ名>]を選択する。
 
VS Codeから作成する場合は、[Remote Explorer]パネルを開いて、[+]ボタンを押下する。 
 
GitHub CLIから作成するコマンドを以下に示す。 
 
gh codespace create -r OWNER/REPO -b BRANCH
 
リポジトリ名とブランチを指定しない場合は、対話形式で選択できる。 
 
==== ブランチ・PR・テンプレートからの作成 ====
特定のブランチやPull Request、テンプレートからもCodespaceを作成できる。 
 
* ブランチからの作成
*: [ブランチ]ページの[Code]ボタンから、そのブランチに対応したCodespaceを作成できる。
* Pull Requestからの作成
*: [PR]ページの[Code]ボタンから、PRのブランチに対応したCodespaceを作成できる。
*: PRの変更内容をレビューしながら動作確認する用途に適している。
* テンプレートからの作成
*: github.com/codespaces/templates から、Node.js、Python、JavaScript等のテンプレートを選択して空のCodespaceを作成できる。
 
==== マシンタイプの選択 ====
Codespaceのマシンタイプはコア数とメモリ容量によって異なる。 
 
下表に、利用可能なマシンタイプを示す。 
 
<center>
{| class="wikitable"
|+ Codespacesのマシンタイプと料金
! マシンタイプ !! メモリ !! ストレージ !! 料金 !! 用途
|-
| 2-core || 8[GB] || 32[GB] || $0.18/時間 || 軽量な開発、スクリプト作業
|-
| 4-core || 16[GB] || 32[GB] || $0.36/時間 || 一般的なWebアプリケーション開発
|-
| 8-core || 32[GB] || 64[GB] || $0.72/時間 || 中規模アプリケーション、複数サービスの並行起動
|-
| 16-core || 64[GB] || 128[GB] || $1.44/時間 || 大規模プロジェクト、重いビルド作業
|-
| 32-core || 128[GB] || 128[GB] || $2.88/時間 || 機械学習、大規模コンパイル作業
|}
</center>
 
マシンタイプは作成後も変更できる。 
 
* Web UIからの変更
*: [Your codespaces]ページで対象のCodespaceのメニューから[Change machine type]を選択する。
* VS Codeからの変更
*: コマンドパレットで Codespaces: Change Machine Type を実行する。
* CLIからの変更
*: 以下に示すコマンドを使用する。
*: <pre>gh codespace edit --machine MACHINE_TYPE</pre>
 
==== リージョンの選択 ====
Codespacesは複数のリージョンで利用できる。 
 
リージョンは、[Settings] - [Codespaces] - [Region]から選択できる。 
 
利用可能なリージョンを以下に示す。 
 
* United States East
* United States West
* Europe West
* Southeast Asia
 
レイテンシを最小化するために、物理的に近いリージョンを選択することを推奨する。 
 

== Dev Container ==
==== Dev Containerとは ====
Dev Containerは、開発環境をコードとして定義する仕組みである。 
 
devcontainer.jsonファイルにベースイメージ、インストールするツール、VS Code拡張機能、エディタ設定等を記述することで、チーム全員が同一の開発環境を利用できる。 
 
Dev Containerを使用することにより、以下に示すメリットが得られる。 
 
* 環境の再現性
*: 新しいメンバーが参加した際も、同一の開発環境を即座に構築できる。
* 依存関係の管理
*: 必要なツールやライブラリをコンテナ内に閉じ込め、ホスト環境との競合を防ぐ。
* CI/CDとの統合
*: 開発環境とCI環境を同一の定義で管理できる。
 
==== devcontainer.json ====
devcontainer.jsonはJSONC (コメント付きJSON) 形式で記述する設定ファイルである。 
 
配置場所を以下に示す。 
 
* .devcontainer/devcontainer.json
* .devcontainer.json (ルートディレクトリ直下)
 
複数のDev Container設定を持つ場合は、.devcontainer/<設定名>/devcontainer.json のようにサブディレクトリに配置できる。 
 
==== 主要な設定項目 ====
下表に、devcontainer.jsonの主要な設定項目を示す。 
 
<center>
{| class="wikitable"
|+ devcontainer.jsonの設定項目一覧
|-
! 設定項目 !! 説明
|-
| <code>image</code> || ベースとなるDockerイメージを指定する。 例: "image": "mcr.microsoft.com/devcontainers/javascript-node:18"
|-
| <code>features</code> || 追加する言語やツールを指定する。 Dev Container Featuresとして提供されているモジュールを使用する。 例: "features": {"ghcr.io/devcontainers/features/python:1": {"version": "3.11"}}
|-
| <code>customizations.vscode.extensions</code> || インストールするVS Code拡張機能のIDを配列で指定する。 例: "extensions": ["ms-python.python", "dbaeumer.vscode-eslint"]
|-
| <code>customizations.vscode.settings</code> || VS Codeのエディタ設定をキーと値のオブジェクトで指定する。 例: "settings": {"editor.tabSize": 2}
|-
| <code>forwardPorts</code> || コンテナ内のポートをホストに転送するポート番号の配列を指定する。 例: "forwardPorts": [3000, 5432]
|-
| <code>postCreateCommand</code> || Codespace作成後に自動実行するコマンドを指定する。 依存関係のインストール等に使用する。 例: "postCreateCommand": "npm install"
|-
| <code>remoteEnv</code> || コンテナ内に設定する環境変数をオブジェクトで指定する。
|-
| <code>remoteUser</code> || コンテナ内のデフォルトユーザを指定する。
|}
</center>
 
devcontainer.jsonの記述例を以下に示す。 
 
<syntaxhighlight lang="json">
{
// Node.js開発環境の例
"name": "Node.js Development",
"image": "mcr.microsoft.com/devcontainers/javascript-node:20",
"features": {
"ghcr.io/devcontainers/features/git:1": {}
},
"customizations": {
"vscode": {
"extensions": [
"dbaeumer.vscode-eslint",
"esbenp.prettier-vscode"
],
"settings": {
"editor.formatOnSave": true,
"editor.defaultFormatter": "esbenp.prettier-vscode"
}
}
},
"forwardPorts": [3000],
"postCreateCommand": "npm install"
}
</syntaxhighlight>
 
==== プリセット設定 ====
下表に、GitHubが公式に提供するプリセットのDev Container設定を示す。 
 
<center>
{| class="wikitable"
|+ Dev Containerプリセット一覧
! プリセット !! イメージ !! 主な用途
|-
| Node.js / JavaScript || mcr.microsoft.com/devcontainers/javascript-node || フロントエンド、Node.jsバックエンド
|-
| Python || mcr.microsoft.com/devcontainers/python || Python Webアプリ、データサイエンス
|-
| Java || mcr.microsoft.com/devcontainers/java || Javaアプリケーション、Spring Boot
|-
| PHP || mcr.microsoft.com/devcontainers/php || WordPressを含むPHPアプリケーション
|-
| C# / .NET || mcr.microsoft.com/devcontainers/dotnet || ASP.NET Core等のC#アプリケーション
|}
</center>
 
==== カスタムDockerfile ====
devcontainer.jsonからカスタムDockerfileを参照することにより、詳細な環境構築ができる。 
 
.devcontainer/ ディレクトリに Dockerfile を配置し、devcontainer.jsonで参照する。 
 
<syntaxhighlight lang="json">
{
"name": "Custom Environment",
"build": {
"dockerfile": "Dockerfile",
"context": ".."
},
"customizations": {
"vscode": {
"extensions": ["ms-python.python"]
}
}
}
</syntaxhighlight>
 
カスタムDockerfileの例を以下に示す。 
 
FROM mcr.microsoft.com/devcontainers/python:3.11

# 追加パッケージのインストール
RUN apt-get update && apt-get install -y \
postgresql-client \
redis-tools \
&& rm -rf /var/lib/apt/lists/*

# Pythonパッケージのインストール
COPY requirements.txt /tmp/
RUN pip install -r /tmp/requirements.txt
 
==== Docker Composeとの連携 ====
データベースや外部サービスを含む複数コンテナ構成には、Docker Composeと連携できる。 
 
devcontainer.jsonで <code>dockerComposeFile</code> と <code>service</code> を指定する。 
 
<syntaxhighlight lang="json">
{
"name": "Full Stack Application",
"dockerComposeFile": "docker-compose.yml",
"service": "app",
"workspaceFolder": "/workspace",
"customizations": {
"vscode": {
"extensions": ["ms-python.python"]
}
}
}
</syntaxhighlight>
 
対応する docker-compose.yml の例を以下に示す。 
 
<syntaxhighlight lang="yaml">
services:
app:
build: .
volumes:
- ../..:/workspace:cached
command: sleep infinity

db:
image: postgres:15
environment:
POSTGRES_PASSWORD: devpassword

redis:
image: redis:7
</syntaxhighlight>
 

== Codespace内での開発 ==
==== VS Code (ブラウザ版/デスクトップ版) ====
Codespaceには、WebブラウザおよびデスクトップのVS Codeから接続できる。 
 
* ブラウザ版VS Code
*: セットアップ不要でブラウザから直接利用できる。
*: 一部の機能 (ローカルファイルへのアクセス等) に制限がある。
* デスクトップ版VS Code
*: フルの機能を利用できる。
*: Codespace内で[F1]キーを押下してコマンドパレットを開いて、Open in VS Code Desktop を実行することで切り替えられる。
 
デスクトップ版への接続にはVS Codeと GitHub Codespaces拡張機能が必要である。 
 
==== ターミナル ====
Codespace内のターミナルはUbuntu Linux環境を提供する。 
 
ターミナルはVS Codeのメニューから[Terminal] - [New Terminal]で開くまたは [Ctrl] + [`]キーで開ける。 
 
デフォルトではbashが使用されるが、devcontainer.jsonの設定によりZshやFishに変更できる。 
 
==== Git操作 ====
CodespaceはGit操作に対応しており、GITHUB_TOKENによる自動認証が設定されている。 
 
HTTPS経由のGit操作は追加の認証設定なしで実行できる。 
 
VS Codeのソースコントロールビューから以下に示す操作が可能である。 
 
* ファイルのステージング ([+]ボタン)
* コミットメッセージの入力とコミット実行
* リモートへのプッシュ
* Pull Requestの作成 (GitHub Pull Requests拡張機能使用時)
 
CLIからのGit操作例を以下に示す。 
 
# ファイルのステージング
git add .

# コミット
git commit -m "<コミットメッセージ>"

# プッシュ
git push origin <ブランチ名>
 
==== ポートフォワーディング ====
Codespace内で起動したサービスのポートは、ポートフォワーディングによりブラウザからアクセスできる。 
 
下表に、ポートフォワーディングの方法を示す。 
 
<center>
{| class="wikitable"
|+ ポート転送の方法一覧
|-
! 方法 !! 説明
|-
| 自動転送 || アプリケーションがlocalhostのポートにバインドすると、 VS Codeが自動的に検出してポートを転送する。
|-
| 手動転送 || VS CodeのPORTSタブで[+]ボタンを押下して、 転送するポート番号を手動で入力する。
|-
| devcontainer.jsonでの事前定義 || <code>forwardPorts</code> フィールドに転送するポートを記述することにより、 Codespace起動時に自動的に設定される。
|}
</center>
 
転送されたポートのアクセス制御設定を以下に示す。 
 
<center>
{| class="wikitable"
|+ ポートアクセス制御の設定
! 設定 !! 説明 !! 用途
|-
| Private (デフォルト) || Codespacesの認証が必要 || 個人開発、機密情報を含む環境
|-
| Organization || 同一組織のメンバーのみアクセス可 || チーム内での共有、デモ
|-
| Public || 認証なしで誰でもアクセス可 || 外部へのデモ、一時的な公開
|}
</center>
 
==== Live Share ====
VS CodeのLive Share機能を使用することにより、Codespace内での共同編集が可能である。 
 
Live Shareを開始するには、VS CodeのLive Share拡張機能をインストールして、共有セッションを開始する。 
 
参加者はCodespaceのURLを持っていなくても、Live ShareのリンクからCodespace内のファイルを閲覧・編集できる。 
 

== 個人設定 ==
==== dotfiles ====
dotfilesリポジトリを使用することで、全てのCodespaceに個人の設定を自動的に適用できる。 
 
設定手順を以下に示す。 
 
# GitHubに <code>dotfiles</code> という名前のリポジトリを作成する。
# install.sh または bootstrap.sh 等のインストールスクリプトを配置する。
# [Settings] - [Codespaces] - [Dotfiles] - [Automatically install dotfiles from your dotfiles repository]を有効にする。
 
Codespaceが作成されるとdotfilesリポジトリが自動的にクローンされ、インストールスクリプトが実行される。 
 
dotfilesに含めると便利な設定ファイルの例を以下に示す。 
 
* .bashrc / .zshrc
*: シェルの設定とエイリアス
* .gitconfig
*: Gitのユーザ名、メールアドレス、エイリアス
* .vimrc
*: Vimの設定
 
==== Settings Sync ====
VS CodeのSettings Sync機能を使用することにより、デスクトップ版VS CodeとCodespace (Webブラウザ版) 間で設定を同期できる。 
 
同期される設定の種類を以下に示す。 
 
* キーボードショートカット
* インストール済み拡張機能
* UIの状態 (パネルの配置等)
* スニペット
* タスクとデバッグ設定
 
Settings Syncを有効にするには、VS Codeのアカウントメニューから[Sign in to Sync Settings]を選択する。 
 
==== デフォルトエディタ ====
Codespaceに接続する時のデフォルトエディタは、[Settings] - [Codespaces] - [Editor preference]から設定できる。 
 
選択可能なエディタを以下に示す。 
 
* Visual Studio Code (デスクトップ版)
* Visual Studio Code for the Web (Webブラウザ版)
* JetBrains Gateway (JetBrains製IDE向け)
 
==== GPGコミット署名 ====
CodespaceではGPGを使用したコミット署名をサポートしている。 
 
[Settings] - [SSH and GPG keys]からGPGキーを登録した後、Codespace内のgit設定でGPG署名を有効化することで署名付きコミットが可能になる。 
 
git config --global commit.gpgsign true
git config --global user.signingkey <GPGキーID>
 

== Codespaceの管理 ==
==== 起動・停止・削除 ====
作成済みのCodespaceは、github.com/codespaces (Your codespaces) ページで一覧表示・管理できる。 
 
各Codespaceに対して実行できる操作を以下に示す。 
 
* 起動 (Open)
*: CodespaceをWebブラウザで開く。
* 停止 (Stop codespace)
*: Codespaceを停止する。
*: 停止中はストレージのみ課金される。
* 削除 (Delete)
*: Codespaceを完全に削除する。
*: 保存されていない変更は失われる。
* 名前変更 (Rename)
*: Codespaceに任意の名前を付ける。
 
CLIからの管理コマンドを以下に示す。 
 
# Codespace一覧の表示
gh codespace list

# Codespaceの停止
gh codespace stop -c CODESPACE_NAME

# Codespaceの削除
gh codespace delete -c CODESPACE_NAME
 
==== タイムアウト設定 ====
一定時間操作がない場合、Codespaceは自動的に停止する。 
 
デフォルトのタイムアウト時間は30分であり、[Settings] - [Codespaces] - [Default idle timeout]から変更できる。 
 
選択可能なタイムアウト時間を以下に示す。 
 
* 5分
* 15分
* 30分 (デフォルト)
* 60分
 
組織の管理者はポリシーによってタイムアウトの最大値を制限できる。 
 
==== 自動削除 (リテンション) ====
停止状態のまま一定期間放置されたCodespaceは自動的に削除される。 
 
デフォルトのリテンション期間は30日であり、[Settings] - [Codespaces] - [Default retention period]から変更できる。 
 
設定可能な期間は1日から30日の範囲である。 
 
削除前にGitHubから通知メールが送信されるが、コミット・プッシュされていない変更は失われるため注意が必要である。 
 
==== リビルド ====
Dev Containerの設定を変更した時は、Codespaceをリビルドして変更を反映できる。 
 
リビルドの種類を以下に示す。 
 
* 通常リビルド
*: Dockerイメージのキャッシュを使用してリビルドする。
*: 変更のない層はキャッシュが再利用されるため高速に完了する。
* フルリビルド
*: キャッシュをクリアして最初からリビルドする。
*: キャッシュ起因の問題を解決する場合に使用する。
 
VS Codeからリビルドするには、コマンドパレットで以下に示すコマンドを実行する。 
 
* 通常リビルド
*: Codespaces: Rebuild Container
* フルリビルド
*: Codespaces: Full Rebuild Container
 
CLIからのリビルドコマンドを以下に示す。 
 
# 通常リビルド
gh codespace rebuild -c CODESPACE_NAME

# フルリビルド
gh codespace rebuild --full -c CODESPACE_NAME
 

== プリビルド ==
==== プリビルドとは ====
プリビルドは、大規模なリポジトリでのCodespace作成時間を短縮するための機能である。 
 
通常、Codespace作成時にDev Containerのセットアップ (依存関係のインストール、ビルド等) が実行されるため、時間が掛かる場合がある。 
 
プリビルドを設定すると、コードがプッシュされるたびにGitHub Actionsが自動的にDev Containerのセットアップを事前実行し、その結果をキャッシュする。 
 
プリビルドを使用することにより、新しいCodespaceを数分ではなく数秒で作成できる。 
 
==== プリビルドの設定 ====
プリビルドはリポジトリ単位で設定する。 
 
設定手順を以下に示す。 
 
# リポジトリの[Settings] - [Codespaces] - [Prebuild configuration]を開く。
# [Set up prebuild]を選択する。
# プリビルドを実行するブランチを選択する。
# マシンタイプを選択する。
# プリビルドをトリガーするイベントを選択する。(コードプッシュ時、スケジュール、手動)
# リージョンを選択する。
 
プリビルドには、GitHub Actionsの実行時間が消費されることに注意する。 
 
プリビルドが有効な場合、Codespace作成画面にプリビルドマークが表示される。 
 

== シークレット管理 ==
==== Codespaces用シークレット ====
APIキーや認証情報等のシークレットは、環境変数としてCodespaceに安全に注入できる。 
 
シークレットの設定方法を以下に示す。 
 
* リポジトリレベルのシークレット
*: [Settings] - [Secrets and variables] - [Codespaces] - [New repository secret]から設定する。
*: そのリポジトリのCodespaceにのみ適用される。
* ユーザレベルのシークレット
*: [Settings] - [Codespaces] - [Codespaces secrets] - [New secret]から設定する。
*: 複数のリポジトリで共有できる個人用シークレットである。
 
設定したシークレットはCodespace内で環境変数として自動的にエクスポートされる。 
 
# シークレットの確認例
echo $MY_API_KEY
 
==== 制限事項 ====
シークレット管理には、以下に示す制限事項がある。 
 
* シークレットの最大数
*: 1リポジトリまたはユーザあたり最大100個
* 各シークレットのサイズ
*: 最大48[KB]
* 名前の制限
*: GITHUB_ プレフィックスは使用禁止
* Dockerfile内での使用
*: Dockerfileのビルド時にはシークレットを参照できない。
*: postCreateCommandやアプリケーション実行時にのみ使用できる。
 

== 組織での管理 ==
==== Codespacesポリシー ====
組織の管理者はCodespacesのポリシーを設定して、メンバーの利用を制御できる。 
 
設定可能なポリシーを以下に示す。 
 
* アクセス制御
*: Codespacesを使用できるメンバーを制限する。
* リポジトリ制限
*: Codespacesを有効にするリポジトリを制限する。
* ネットワークポリシー
*: Codespace内からのネットワークアクセスを制限する。
 
ポリシーは、[Organization]の[Settings] - [Codespaces]から設定できる。 
 
==== マシンタイプの制限 ====
管理者はメンバーが選択できるマシンタイプを制限できる。 
 
例えば、コスト管理のためにメンバーが32-coreマシンを使用できないように制限することが可能である。 
 
[Organization] - [Settings] - [Codespaces] - [Machine type policies]から設定する。 
 
==== 課金管理 ====
組織のCodespaces利用費の負担先は、以下に示す2通りから選択できる。 
 
* 組織負担
*: 組織のメンバーが使用したCodespacesの費用を組織が負担する。
*: [Settings] - [Codespaces] - [Codespaces access] - [Enabled for all members] または特定のメンバーを選択する。
* メンバー負担
*: 各メンバーが個人アカウントで費用を負担する。
*: 組織のCodespaces機能を有効にしない場合のデフォルト動作である。
 
組織の利用状況は、[Organization] - [Billing]ページで確認できる。 
 
監査ログ (Audit Log) では、Codespaceの作成・削除・起動・停止等のイベントを追跡できる。 
 

== 課金 ==
==== 無料枠 ====
GitHubのプランに応じて毎月の無料枠が提供される。 
 
<center>
{| class="wikitable"
|+ GitHubプランごとの無料枠
! プラン !! コンピュート (コア時間) !! ストレージ
|-
| Free || 120コア時間/月 || 15[GB]/月
|-
| Pro || 180コア時間/月 || 20[GB]/月
|}
</center>
 
コア時間はCodespaceのコア数に使用時間を掛けた値である。 
 
例えば、2-coreのCodespaceを10時間使用した場合、20コア時間を消費する。 
 
無料枠を超えた分は従量課金となる。 
 
==== コンピュート料金 ====
下表に、無料枠を超えた場合のコンピュート料金を示す。 
 
<center>
{| class="wikitable"
|+ Codespacesのコンピュート料金
! マシンタイプ !! 料金
|-
| 2-core || $0.18/時間
|-
| 4-core || $0.36/時間
|-
| 8-core || $0.72/時間
|-
| 16-core || $1.44/時間
|-
| 32-core || $2.88/時間
|}
</center>
 
コンピュート料金はCodespaceが起動している時間にのみ発生する。 
停止中はコンピュート料金は発生しない。 
 
==== ストレージ料金 ====
Codespaceのストレージはコンテナの内容全体 (ソースコード、依存関係、ツール等) に対して課金される。 
 
ストレージ料金は $0.07/[GB]-月である。 
 
ストレージ料金はCodespaceが停止中であっても、Codespaceが存在する限り発生する。 
 
コストを抑えるために、使用しないCodespaceは削除することを推奨する。 
 

{{#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]]

GitHub - Packages

2026-03-23T21:46:46Z

Wiki: ページの作成:「== 概要 == GitHub Packagesは、GitHubが提供するソフトウェアパッケージホスティングサービスである。 ソースコードと同じリポジトリでパッケージを管理・公開・インストールできる。 GitHub Packagesが対応しているレジストリは以下の通りである。 <center> {| class="wikitable" |+ GitHub Packagesの対応レジストリ一覧 |- ! レジストリ !! 説明 |- | Containe…」

== 概要 ==
GitHub Packagesは、GitHubが提供するソフトウェアパッケージホスティングサービスである。 
ソースコードと同じリポジトリでパッケージを管理・公開・インストールできる。 
 
GitHub Packagesが対応しているレジストリは以下の通りである。 
 
<center>
{| class="wikitable"
|+ GitHub Packagesの対応レジストリ一覧
|-
! レジストリ !! 説明
|-
| Container Registry(ghcr.io) || Dockerコンテナイメージおよび OCIイメージをホスティングする。
|-
| npm || JavaScriptパッケージをホスティングする。
|-
| Maven / Gradle || Javaパッケージをホスティングする。
|-
| NuGet || .NETパッケージをホスティングする。
|-
| RubyGems || Rubyパッケージをホスティングする。
|}
</center>
 
GitHub Packagesを利用するメリットを以下に示す。 
 
* ソースコードとパッケージを同一リポジトリで管理できる。
* GitHubのアクセス制御と統合されており、チームの権限管理が一元化できる。
* GitHub Actionsとの連携により、CI/CDパイプラインにパッケージ公開を組み込める。
* プライベートパッケージをリポジトリのアクセス権限に基づいて保護できる。
 

== Container Registry (ghcr.io) ==
ghcr.ioはGitHubが提供するコンテナレジストリであり、DockerイメージおよびOCIイメージの管理に使用する。 
 
==== 認証 ====
ghcr.ioへの認証には個人アクセストークン (Personal Access Token) を使用する。 
 
下表に、必要なスコープを示す。 
 
<center>
{| class="wikitable"
|+ パーソナルアクセストークンのスコープ一覧
|-
! スコープ !! 説明
|-
| <code>read:packages</code> || パッケージのダウンロードとメタデータの読み取りに必要なスコープ
|-
| <code>write:packages</code> || パッケージのアップロードと公開に必要なスコープ
|-
| <code>delete:packages</code> || パッケージの削除に必要なスコープ
|}
</center>
 
個人アクセストークンは、GitHubの[Settings] - [Developer settings] - [Personal access tokens]から作成できる。 
 
==== Dockerログイン ====
ghcr.ioにログインする。 
 
echo $CR_PAT | docker login ghcr.io -u <ユーザ名> --password-stdin
 
<code>CR_PAT</code> には個人アクセストークン、<code><ユーザ名></code> にはGitHubのユーザ名を指定する。 
パスワードを標準入力から渡すことにより、コマンド履歴にトークンが残らないようにする。 
 
==== イメージのプッシュとプル ====
ビルド済みのイメージにghcr.ioのタグを付けてプッシュする手順を以下に示す。 
 
# イメージにタグを付ける
docker tag <イメージ名> ghcr.io/NAMESPACE/<イメージ名>:TAG

# イメージをプッシュする
docker push ghcr.io/NAMESPACE/<イメージ名>:TAG

# イメージをプルする
docker pull ghcr.io/NAMESPACE/<イメージ名>:TAG
 
<code>NAMESPACE</code> にはGitHubのユーザ名または Organization名を指定する。 
<code>TAG</code> には <code>latest</code> やバージョン番号を指定する。 
 
レイヤーの最大サイズは10[GB]、タイムアウトは10分である。 
 
==== リポジトリの関連付け ====
コンテナイメージを特定のGitHubリポジトリに関連付けるには、Dockerfile内に以下のラベルを追加する。 
 
LABEL org.opencontainers.image.source=https://github.com/OWNER/REPO
 
このラベルを追加すると、ghcr.io上のパッケージページから対象リポジトリへのリンクが表示される。 
また、リポジトリの可視性設定がパッケージに継承される。 
 
==== 可視性設定 ====
コンテナイメージの可視性は、GitHubのPackage settingsから設定できる。 
 
<center>
{| class="wikitable"
|+ パッケージの公開範囲一覧
|-
! 公開範囲 !! 説明
|-
| Public || 誰でもプルできる状態
|-
| Private || アクセス権限を持つユーザのみプルできる状態
|}
</center>
 
可視性をPublicからPrivateに変更することは、不可逆な操作であることに注意する。 
 

== npm レジストリ ==
GitHub Packagesのnpmレジストリを使用すると、スコープ付きnpmパッケージを公開・インストールできる。 
 
==== 認証と.npmrc設定 ====
npmレジストリへの認証には、.npmrc ファイルを使用する。 
 
プロジェクトルートに .npmrc ファイルを作成して、以下に示す内容を記述する。 
 
@NAMESPACE:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=TOKEN
 
<code>NAMESPACE</code> にはGitHubのユーザ名または Organization名を指定する。 
<code>TOKEN</code> には <code>read:packages</code> スコープを持つ個人アクセストークンを指定する。 
 
==== パッケージの公開 ====
GitHub Packagesのnpmレジストリでは、スコープ付きパッケージ名が必須である。 
 
package.json ファイル内の <code>name</code> フィールドを以下に示すように設定する。 
 
<syntaxhighlight lang="json">
{
"name": "@NAMESPACE/PACKAGE-NAME",
"version": "1.0.0",
"publishConfig": {
"registry": "https://npm.pkg.github.com"
}
}
</syntaxhighlight>
 
設定後、コマンドでパッケージを公開する。 
 
npm publish
 
==== パッケージのインストール ====
.npmrc ファイルにレジストリ設定を追加した後、以下のコマンドでパッケージをインストールする。 
 
npm install @NAMESPACE/PACKAGE-NAME
 

== Maven レジストリ ==
GitHub PackagesのMavenレジストリを使用すると、JavaのMavenパッケージを公開・インストールできる。 
 
==== 認証設定 ====
Mavenの認証情報は ~/.m2/settings.xml ファイルに設定する。 
 
<syntaxhighlight lang="xml">
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0">
<servers>
<server>
<id>github</id>
<username>USERNAME</username>
<password>TOKEN</password>
</server>
</servers>
</settings>
</syntaxhighlight>
 
<code>USERNAME</code> には GitHubのユーザ名、<code>TOKEN</code> には <code>read:packages</code> または <code>write:packages</code> スコープを持つ個人アクセストークンを指定する。 
 
==== パッケージの公開 ====
pom.xml ファイルの <code>distributionManagement</code> セクションにリポジトリURLを設定する。 
 
<syntaxhighlight lang="xml">
<distributionManagement>
<repository>
<id>github</id>
<name>GitHub OWNER Apache Maven Packages</name>
<url>https://maven.pkg.github.com/OWNER/REPO</url>
</repository>
</distributionManagement>
</syntaxhighlight>
 
設定後、パッケージをデプロイするため、以下に示すコマンドを実行する。 
 
mvn deploy
 
アーティファクトIDは、小文字のみが使用できることに注意する。 
 
==== Gradleでの使用 ====
Gradleを使用する場合は、build.gradle ファイルにリポジトリと認証情報を設定する。 
 
<syntaxhighlight lang="groovy">
repositories {
maven {
url = uri("https://maven.pkg.github.com/OWNER/REPO")
credentials {
username = project.findProperty("gpr.user") ?: System.getenv("USERNAME")
password = project.findProperty("gpr.key") ?: System.getenv("TOKEN")
}
}
}
</syntaxhighlight>
 

== NuGetレジストリ ==
GitHub PackagesのNuGetレジストリを使用すると、.NETのNuGetパッケージを公開・インストールできる。 
 
==== パッケージの公開 ====
NuGetパッケージを公開するため、以下に示すコマンドを実行する。 
 
dotnet nuget push PACKAGE_NAME.nupkg \
--api-key <TOKEN> \
--source "https://nuget.pkg.github.com/OWNER/index.json"
 
<code>TOKEN</code> には <code>write:packages</code> スコープを持つ個人アクセストークンを指定する。 
 
==== パッケージのインストール ====
nuget.config ファイルにGitHub Packagesのソースを追加する。 
 
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<packageSources>
<add key="github" value="https://nuget.pkg.github.com/OWNER/index.json" />
</packageSources>
<packageSourceCredentials>
<github>
<add key="Username" value="USERNAME" />
<add key="ClearTextPassword" value="TOKEN" />
</github>
</packageSourceCredentials>
</configuration>
</syntaxhighlight>
 
設定後、dotnetコマンドでパッケージをインストールできる。 
 
dotnet add package <パッケージ名>
 

== RubyGemsレジストリ ==
GitHub PackagesのRubyGemsレジストリを使用すると、RubyのGemパッケージを公開・インストールできる。 
 
==== パッケージの公開 ====
まず ~/.gem/credentials ファイルに認証情報を設定する。 
 
<syntaxhighlight lang="yaml">
:github: Bearer TOKEN
</syntaxhighlight>
 
次に、Gemをビルドして公開するため、以下に示すコマンドを実行する。 
 
# Gemのビルド
gem build PACKAGE_NAME.gemspec

# GitHub Packagesへのプッシュ
gem push --key github \
--host https://rubygems.pkg.github.com/NAMESPACE \
PACKAGE_NAME-VERSION.gem
 
==== パッケージのインストール ====
Bundlerを使用してインストールする場合は、Gemfile ファイルに以下の設定を追加する。 
 
<syntaxhighlight lang="ruby">
source "https://rubygems.pkg.github.com/NAMESPACE" do
gem "PACKAGE_NAME"
end
</syntaxhighlight>
 
設定後、以下に示すコマンドを実行して、インストールする。 
 
bundle install
 

== GitHub Actionsとの連携 ==
GitHub ActionsからGitHub Packagesへのアクセスには <code>GITHUB_TOKEN</code> を使用できる。 
 
<code>GITHUB_TOKEN</code> を使用することにより、個人アクセストークンを別途作成せずにパッケージを公開できる。 
 
==== Dockerイメージの自動公開 ====
Dockerイメージを自動的にghcr.ioに公開するワークフローの例を以下に示す。 
 
<syntaxhighlight lang="yaml">
name: Publish Docker Image

on:
push:
branches:
- main

jobs:
publish:
runs-on: ubuntu-latest
permissions:
contents: read
packages: write

steps:
- name: Checkout repository
uses: actions/checkout@v4

- name: Log in to the Container registry
uses: docker/login-action@v3
with:
registry: ghcr.io
username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }}

- name: Build and push Docker image
uses: docker/build-push-action@v5
with:
context: .
push: true
tags: ghcr.io/${{ github.repository }}:latest
</syntaxhighlight>
 
下表に、主なアクションを示す。 
 
<center>
{| class="wikitable"
|+ Docker関連アクション一覧
|-
! アクション !! 説明
|-
| <code>docker/login-action</code> || コンテナレジストリへのログインを行うアクション
|-
| <code>docker/build-push-action</code> || Dockerイメージのビルドとプッシュを行うアクション
|}
</center>
 
==== npmパッケージの自動公開 ====
npmパッケージを自動的に公開するワークフローの例を以下に示す。 
 
<syntaxhighlight lang="yaml">
name: Publish npm Package

on:
release:
types: [created]

jobs:
publish:
runs-on: ubuntu-latest
permissions:
contents: read
packages: write

steps:
- name: Checkout repository
uses: actions/checkout@v4

- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: '20'
registry-url: 'https://npm.pkg.github.com'
scope: '@NAMESPACE'

- name: Install dependencies
run: npm ci

- name: Publish package
run: npm publish
env:
NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
</syntaxhighlight>
 
環境変数 <code>NODE_AUTH_TOKEN</code> に <code>GITHUB_TOKEN</code> を設定することにより、認証を行う。 
 

== パッケージの管理 ==
GitHub Packagesのパッケージは、[リポジトリ]ページまたは [Organization]ページから管理できる。 
 
==== バージョン管理 ====
公開したパッケージは複数バージョンを保持できる。 
各バージョンは個別に管理・削除が可能である。 
 
バージョン一覧は、[リポジトリ]ページの[Packages]セクションまたは [Organization]ページの[Packages]ページから確認できる。 
 
==== アクセス権限 ====
パッケージのアクセス権限は以下に示す3段階で設定できる。 
 
<center>
{| class="wikitable"
|+ パッケージのアクセス権限
! 権限 !! 説明
|-
| Read || パッケージのダウンロードとメタデータの閲覧が可能
|-
| Write || パッケージの公開と新バージョンのアップロードが可能
|-
| Admin || 権限設定の変更、パッケージの削除、可視性の変更が可能
|}
</center>
 
デフォルトでは、リポジトリのアクセス権限がパッケージに継承される。 
 
リポジトリ権限の継承は、パッケージの設定から無効化することもできる。 
 
==== パッケージの削除と復元 ====
パッケージのバージョンは、GitHubのWeb UI または GraphQL APIを使用して削除できる。 
 
削除したパッケージは30日以内であれば復元できる。 
復元には以下の条件が必要である。 
 
* 同じ名前空間とバージョン番号が現在使用されていないこと。
* 削除から30日以内であること。
 
==== 可視性の変更 ====
パッケージの可視性変更に関して、以下に示す重要な制限がある。 
 
* PublicからPrivateへの変更は不可逆である。
*: 1度Privateに変更すると、同じパッケージ名でPublicに戻すことはできない。
* PrivateからPublicへの変更は可能である。
*: ただし、Publicにした場合は全員がアクセスできる状態になることに注意する。
 

== 課金 ==
GitHub Packagesの利用には、ストレージ容量とデータ転送量に応じた課金が発生する場合がある。 
 
==== 無料枠 ====
下表に、各プランの無料枠を示す。 
 
<center>
{| class="wikitable"
|+ GitHub Packages の無料枠
! プラン !! ストレージ !! データ転送 (月間)
|-
| Free || 500[MB] || 1[GB]
|-
| Pro || 2[GB] || 10[GB]
|-
| Team || 2[GB] || 10[GB]
|-
| Enterprise || 50[GB] || 100[GB]
|}
</center>
 
無料枠を超えた場合は追加費用が発生する。 
 
==== GITHUB_TOKENでのデータ転送 ====
GitHub Actionsワークフロー内で <code>GITHUB_TOKEN</code> を使用して GitHub Packages にアクセスする場合、データ転送量は無料枠の割当を消費しない。 
 
これは、以下のケースに該当する。 
 
* ワークフロー内での <code>GITHUB_TOKEN</code> を使用したパッケージのプッシュ
* ワークフロー内での <code>GITHUB_TOKEN</code> を使用したパッケージのプル
 
個人アクセストークンを使用した場合は、通常通り割当が消費されることに注意する。 
 

== 参考リンク ==
* [https://docs.github.com/ja/packages GitHub Packages 公式ドキュメント]
* [https://docs.github.com/ja/packages/working-with-a-github-packages-registry/working-with-the-container-registry Container Registry のドキュメント]
* [https://docs.github.com/ja/packages/working-with-a-github-packages-registry/working-with-the-npm-registry npm レジストリのドキュメント]
* [https://docs.github.com/ja/packages/working-with-a-github-packages-registry/working-with-the-apache-maven-registry Maven レジストリのドキュメント]
* [https://docs.github.com/ja/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry NuGet レジストリのドキュメント]
* [https://docs.github.com/ja/packages/working-with-a-github-packages-registry/working-with-the-rubygems-registry RubyGems レジストリのドキュメント]
 

{{#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]]

GitHub - Pages

2026-03-23T21:27:02Z

Wiki: ページの作成:「== 概要 == GitHub Pagesは、GitHubリポジトリから直接Webサイトを公開できる静的サイトホスティングサービスである。 HTML、CSS、JavaScriptで構成された静的ファイルをリポジトリに配置するだけで、インターネット上に公開されたWebサイトを無料で運営できる。 GitHub Pagesで公開できるサイトは以下に示す2種類に分類される。 <center> {| class="wi…」

== 概要 ==
GitHub Pagesは、GitHubリポジトリから直接Webサイトを公開できる静的サイトホスティングサービスである。 
HTML、CSS、JavaScriptで構成された静的ファイルをリポジトリに配置するだけで、インターネット上に公開されたWebサイトを無料で運営できる。 
 
GitHub Pagesで公開できるサイトは以下に示す2種類に分類される。 
 
<center>
{| class="wikitable"
|+ GitHub Pagesのサイト種別一覧
|-
! 種別 !! 説明
|-
| ユーザ・組織サイト || <code><ユーザ名または組織名>.github.io</code> という名前のリポジトリから公開するサイト アカウントごとに1つのみ作成できる。 公開URLは https://<ユーザ名または組織名>.github.io となる。
|-
| プロジェクトサイト || 既存のリポジトリから公開するサイト 1つのアカウントで複数作成できる。 公開URLは https://<オーナー名>.github.io/<リポジトリ名> となる。
|}
</center>
 
GitHub Pagesは、プロジェクトのドキュメント、個人ポートフォリオ、ブログ、ランディングページ等の幅広い用途で利用されている。 
 

== GitHub Pagesの作成 ==
==== ユーザ・組織サイト ====
ユーザサイトまたは組織サイトを作成するには、特定の命名規則に従ったリポジトリを作成する必要がある。 
 
リポジトリ名は <ユーザ名>.github.io (個人アカウントの場合) または <組織名>.github.io (組織の場合) とする。 
アカウントごとに作成できるユーザ・組織サイトは1つのみである。 
 
リポジトリを作成後、デフォルトブランチ (通常は main) のルートディレクトリに index.html ファイルを配置することにより、サイトが公開される。 
 
==== プロジェクトサイト ====
プロジェクトサイトは、既存のリポジトリに対してGitHub Pagesを有効化することで作成する。 
 
プロジェクトサイトの公開URLは https://<オーナー名>.github.io/<リポジトリ名> となる。 
<nowiki><オーナー名></nowiki> は、GitHubのユーザ名または組織名に対応する。 
 
==== 公開ソースの設定 ====
GitHub Pagesの公開ソースは、リポジトリの[Settings] - [Pages]から設定する。 
 
公開ソースには以下の2つの方式がある。 
 
* ブランチからの公開
*: 指定したブランチのルートディレクトリ (/) または /docs ディレクトリの内容を公開する。
*: 設定は [Settings] - [Pages] - [Branch]でブランチ名とディレクトリを選択して保存する。
* GitHub Actionsでの公開
*: カスタムワークフローを使用してビルド・デプロイを行う。
*: actions/upload-pages-artifact でアーティファクトをアップロードして、actions/deploy-pages でデプロイする。
*: ワークフローには <code>pages: write</code> および <code>id-token: write</code> の権限が必要である。
 
GitHub Actionsを使用したデプロイワークフローの基本構成を以下に示す。 
 
<syntaxhighlight lang="yaml">
name: Deploy GitHub Pages

on:
push:
branches: ["main"]

permissions:
contents: read
pages: write
id-token: write

jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Build
run: |
# ビルドコマンドをここに記述する
- uses: actions/upload-pages-artifact@v3
with:
path: ./dist

deploy:
needs: build
runs-on: ubuntu-latest
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- id: deployment
uses: actions/deploy-pages@v4
</syntaxhighlight>
 

== Jekyll ==
==== Jekyllとは ====
JekyllはRubyで実装された静的サイトジェネレータであり、GitHub Pagesに公式統合されている。 
MarkdownファイルをHTMLに変換して、Liquidテンプレートエンジンを使用してレイアウトやコンポーネントを管理する。 
 
ブランチからの公開を設定している場合、GitHub Pagesはリポジトリ内のファイルを自動的にJekyllでビルドする。 
 
Jekyllを使用しない場合は、リポジトリのルートディレクトリに .nojekyll という空ファイルを配置することにより、Jekyllビルドを無効化できる。 
 
==== _config.yml ====
_config.yml ファイルは、Jekyllサイトの主要な設定ファイルである。 
リポジトリのルートディレクトリに配置する。 
 
主要な設定項目を以下に示す。 
 
<syntaxhighlight lang="yaml">
# サイトの基本情報
title: サイトタイトル
description: サイトの説明文
url: "https://<username>.github.io"
baseurl: "" # プロジェクトサイトの場合は "/<repo>" を指定する

# テーマの設定
theme: minima

# プラグインの設定
plugins:
- jekyll-feed
- jekyll-sitemap

# 除外ファイルの設定
exclude:
- Gemfile
- Gemfile.lock
- README.md

# Markdownエンジンの設定
markdown: kramdown
</syntaxhighlight>
 
GitHub Pagesが自動的に上書きする設定項目があることに注意する。 
 
<center>
{| class="wikitable"
|+ GitHub Pagesが強制する設定
! 設定項目 !! 強制される値 !! 説明
|-
| <code>lsi</code> || false || 関連記事リストの生成を無効化する。
|-
| <code>safe</code> || true || ホワイトリスト外のプラグインを無効化する。
|-
| <code>highlighter</code> || rouge || シンタックスハイライトにRougeを使用する。
|}
</center>
 
==== テーマ ====
JekyllテーマはサイトのデザインとレイアウトをまとめたRuby Gemパッケージである。 
 
テーマの適用方法には以下の2つがある。 
 
* Web UIからの設定
*: リポジトリの[Settings] - [Pages] - [Choose a theme]から選択する。
*: 選択すると _config.yml ファイル内に <code>theme:</code> が自動的に追加される。
* _config.yml での設定
*: GitHub Pagesがサポートするテーマは <code>theme: テーマ名</code> で指定する。
*: GitHubホスト外のテーマは <code>remote_theme: owner/theme-repo</code> で指定する。
 
テーマのカスタマイズはリポジトリ内に _layouts ディレクトリを作成し、テーマのレイアウトファイルを上書きすることで行う。 
 
独自のCSSを追加する場合は、assets/css/style.scss に記述する。 
 
==== コンテンツ作成 ====
Jekyllのコンテンツはページとポストの2種類に分類される。 
 
* ページ
*: 独立したコンテンツ (About、Contact等) を作成する時に使用する。
*: リポジトリのルート直下または任意のディレクトリに .md または .html ファイルとして配置する。
* ポスト
*: ブログ記事等の時系列コンテンツを作成する時に使用する。
*: _posts/ ディレクトリに YYYY-MM-DD-タイトル.md という命名規則で配置する。
 
各コンテンツファイルの先頭には、YAMLフロントマターと呼ばれるYAML形式のメタデータブロックを記述する。 
 
<syntaxhighlight lang="yaml">
---
layout: post
title: "記事タイトル"
date: 2026-03-24 12:00:00 +0900
categories: [カテゴリ1, カテゴリ2]
permalink: /custom-url/
---

ここからMarkdownでコンテンツを記述する。
</syntaxhighlight>
 
下表に、YAMLフロントマターで指定できる主要な項目を示す。 
 
<center>
{| class="wikitable"
|+ Front Matterの主要項目
! 項目 !! 説明
|-
| <code>layout</code> || 使用するレイアウトテンプレート名 (例: page, post, default)
|-
| <code>title</code> || ページまたは記事のタイトル
|-
| <code>date</code> || 公開日時 (ポストのみ)
|-
| <code>categories</code> || カテゴリの配列
|-
| <code>permalink</code> || カスタムURL
|}
</center>
 
==== ローカルテスト ====
GitHub Pagesに公開する前に、ローカル環境でサイトを確認することを推奨する。 
 
ローカルテストには、Ruby 2.7以上とBundlerおよびJekyllが必要である。 
Ruby 3.0以上を使用している場合は、追加で webrick Gem のインストールが必要である。 
 
ローカルテストの手順を以下に示す。 
 
# リポジトリのルートディレクトリで依存Gemをインストールする。
#: <pre>bundle install</pre>
#: 
# Jekyll開発サーバを起動する。
#: <pre>bundle exec jekyll serve</pre>
#: 
# Ruby 3.0以上でwebrickエラーが発生した場合は、以下に示すコマンドを実行する。
#: <pre>bundle add webrick</pre>
 
Webブラウザから http://localhost:4000 にアクセスしてサイトを確認する。 
ファイルを変更すると自動的に再ビルドされる。 
 

== カスタムドメイン ==
==== DNSレコードの設定 ====
カスタムドメインをGitHub Pagesに設定するには、ドメインのDNS設定を変更する必要がある。 
 
ドメインの種類によって設定するDNSレコードが異なる。 
 
* Apexドメイン (例: example.com) の場合
*: ドメインのDNS設定に以下の4つのAレコードを追加する。
 
<center>
{| class="wikitable"
|+ GitHub Pages用 AレコードのIPアドレス
! タイプ !! 値
|-
| A || 185.199.108.153
|-
| A || 185.199.109.153
|-
| A || 185.199.110.153
|-
| A || 185.199.111.153
|}
</center>
 
IPv6に対応する場合は、上記に加えてAAAAレコードも追加する。 
 
* サブドメイン (例: www.example.com) の場合
*: ドメインのDNS設定にCNAMEレコードを追加し、<owner>.github.io を指定する。
 
==== リポジトリでのドメイン設定 ====
DNSレコードの設定後、GitHubリポジトリ側でカスタムドメインを設定する。 
 
設定手順を以下に示す。 
 
# リポジトリの[Settings] - [Pages] - [Custom domain]フィールドにカスタムドメインを入力する。
# [Save]ボタンを押下して保存する。
# リポジトリのルートディレクトリに CNAME ファイルが自動的に作成され、カスタムドメインが記載される。
 
CNAME ファイルはファイル名を大文字で記述して、ファイル内にはドメイン名を1行で記載する。 
 
==== HTTPS ====
GitHub Pagesではカスタムドメインに対してHTTPSを強制できる。 
 
HTTPS証明書はLet's Encryptによって自動的に発行される。 
証明書の発行には最大1時間掛かる場合がある。 
 
HTTPS設定の手順を以下に示す。 
 
# カスタムドメインのDNS設定とリポジトリのドメイン設定が完了していることを確認する。
# [Settings] - [Pages] - [Enforce HTTPS]のチェックボックスを有効にする。
 
Let's Encrypt証明書の自動更新を確実に行うため、ドメインのCAAレコードに letsencrypt.org を許可する設定を追加することを推奨する。 
 
==== ドメイン検証 ====
GitHub Pagesのドメイン検証機能を使用すると、他のGitHubユーザが自分のカスタムドメインをGitHub Pagesに設定することを防止できる。 
 
ドメイン検証はGitHubアカウントの[Settings] - [Pages] - [Verified domains]から設定する。 
検証はDNSのTXTレコードに指定の値を追加することで完了する。 
 

== 静的サイトジェネレータ ==
==== Jekyll以外のジェネレータ ====
GitHub PagesはJekyll以外の静的サイトジェネレータにも対応している。 
GitHub Actionsを使用してカスタムビルドワークフローを設定することにより、任意のジェネレータを使用できる。 
 
下表に、主要な静的サイトジェネレータを示す。 
 
<center>
{| class="wikitable"
|+ 主要な静的サイトジェネレータ
! ジェネレータ !! 言語 !! 特徴
|-
| Hugo || Go || 高速なビルド速度 大規模サイトに適している。
|-
| Next.js || JavaScript (React) || Reactベースのフレームワーク SSG (静的サイト生成) モードで使用する。
|-
| Gatsby || JavaScript (React) || Reactベースの静的サイトジェネレータ GraphQLによるデータ取得が特徴。
|-
| Nuxt || JavaScript (Vue.js) || Vue.jsベースのフレームワーク SSG (静的サイト生成) モードで使用する。
|-
| MkDocs || Python || Markdownベースのドキュメントサイト生成に特化している。
|-
| Sphinx || Python || Pythonプロジェクトのドキュメント生成に広く使用されている。
|-
| Eleventy (11ty) || JavaScript || シンプルで柔軟な静的サイトジェネレータ
|}
</center>
 
==== GitHub Actionsでのカスタムビルド ====
GitHub Actionsを使用したカスタムビルドワークフローの主要なアクションを以下に示す。 
 
* <code>actions/upload-pages-artifact</code>
*: ビルド済みの静的ファイルをGitHub Pages用のアーティファクトとしてアップロードする。
*: <code>path</code> パラメータで公開するディレクトリを指定する。
* <code>actions/deploy-pages</code>
*: アップロードされたアーティファクトをGitHub Pagesにデプロイする。
*: デプロイされたページのURLが出力パラメータ <code>page_url</code> として返される。
 
Hugoを使用したデプロイワークフローの例を以下に示す。 
 
<syntaxhighlight lang="yaml">
name: Deploy Hugo Site

on:
push:
branches: ["main"]

permissions:
contents: read
pages: write
id-token: write

jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
submodules: true
- name: Setup Hugo
uses: peaceiris/actions-hugo@v3
with:
hugo-version: "latest"
- name: Build
run: hugo --minify
- uses: actions/upload-pages-artifact@v3
with:
path: ./public

deploy:
needs: build
runs-on: ubuntu-latest
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- id: deployment
uses: actions/deploy-pages@v4
</syntaxhighlight>
 

== 制限事項 ==
==== 技術的な制限 ====
GitHub Pagesを使用する時は、以下に示す技術的な制限に注意が必要である。 
 
<center>
{| class="wikitable"
|+ GitHub Pagesの技術的な制限
! 項目 !! 制限値 !! 備考
|-
| リポジトリサイズ || 1[GB]推奨 || ソースリポジトリのサイズ上限の目安
|-
| 公開サイトのサイズ || 1[GB]以下 || デプロイされるサイトの合計サイズ
|-
| 帯域幅 || 100[GB] / 月 || 月間のデータ転送量上限
|-
| ビルド時間 || 10分 || Jekyll またはカスタムビルドの実行時間上限
|-
| アーティファクトサイズ || 10[GB] || GitHub Actionsアーティファクトのサイズ上限
|}
</center>
 
==== 禁止されている用途 ====
GitHub Pagesは静的サイトホスティングサービスであり、以下に示す用途での使用は禁止されている。 
 
* オンラインビジネス、eコマースサイト、商業目的のトランザクション処理を主目的とするサイト
* サーバサイドの処理が必要なWebアプリケーション (データベース接続、サーバサイドスクリプトの実行等)
* パスワードのクラッキング、ネットワーク攻撃等の不正行為に使用するサイト
* GitHubのサービス利用規約に違反するコンテンツの公開
 
GitHub PagesはGitHubの利用規約に従って運営されており、上記の禁止事項に違反した場合はサービスが停止される場合がある。 
 

== トラブルシューティング ==
==== Jekyllビルドエラー ====
Jekyllビルドで発生しやすいエラーとその対処法を以下に示す。 
 
* <code>_config.yml</code> 構文エラー
*: YAMLファイルにタブ文字を使用している場合はスペースに置き換える。
*: ファイルの文字エンコーディングがUTF-8であることを確認する。
*: コロン (<code>:</code>) の後には必ずスペースを入れる。
*: 文字列にコロンが含まれる場合は引用符で囲む。
* 非対応プラグインエラー
*: GitHub Pagesはセキュリティ上の理由から使用できるJekyllプラグインを制限している。
*: 使用できるプラグインは公式ドキュメントで確認する。
*: 非対応プラグインを使用する場合は、GitHub Actionsでのカスタムビルドに切り替える。
* Ruby 3.0以上での <code>webrick</code> エラー
*: <code>bundle add webrick</code> を実行して、<code>webrick</code> Gemを追加する。
 
==== カスタムドメインの問題 ====
カスタムドメイン設定で発生しやすい問題とその対処法を以下に示す。 
 
* DNS設定が反映されない。
*: DNS設定の変更が反映されるまで最大24時間かかる場合がある。
*: <code>dig</code> コマンドや [https://www.whatsmydns.net/ whatsmydns.net] 等のツールでDNS伝播状況を確認する。
* <code>CNAME</code> ファイルの形式エラー
*: ファイル名は大文字の CNAME とする。
*: ファイル内にはカスタムドメインを1行のみ記載する。
*: 余分な空行や文字が含まれていないことを確認する。
* HTTPS設定が有効にならない
*: Enforce HTTPSは、DNS設定が正しく完了してから有効にする。
*: 証明書の発行には最大1時間掛かる場合がある。
*: DNS設定後に1度カスタムドメインを削除して再設定すると解決することがある。
 

{{#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]]

GitHub - Actions

2026-03-23T21:09:18Z

Wiki: ページの作成:「== 概要 == GitHub Actionsは、GitHubリポジトリ内でCI/CD (継続的インテグレーション / 継続的デリバリー) ワークフローを構築・実行できる自動化プラットフォームである。 コードのプッシュやPullRequestの作成といったリポジトリのイベントをトリガーとして、テスト・ビルド・デプロイ等の処理を自動化できる。 ワークフローはYAML形式で定義さ…」

== 概要 ==
GitHub Actionsは、GitHubリポジトリ内でCI/CD (継続的インテグレーション / 継続的デリバリー) ワークフローを構築・実行できる自動化プラットフォームである。 
コードのプッシュやPullRequestの作成といったリポジトリのイベントをトリガーとして、テスト・ビルド・デプロイ等の処理を自動化できる。 
 
ワークフローはYAML形式で定義され、リポジトリの .github/workflows/ ディレクトリに配置する。 
 
GitHub Actionsを構成する主要な概念を以下に示す。 
 
* ワークフロー (Workflow)
*: 1つ以上のジョブで構成される自動化プロセス全体を指す。
*: YAMLファイルとして定義され、特定のイベントによってトリガーされる。
* ジョブ (Job)
*: ワークフロー内で並列または順次実行される処理単位である。
*: 各ジョブは独立したランナー環境で実行される。
* ステップ (Step)
*: ジョブ内で順次実行されるコマンドまたはアクションの単位である。
* アクション (Action)
*: 複雑な処理をカプセル化した再利用可能なコンポーネントである。
*: GitHubが提供する公式アクションの他、GitHub Marketplaceからサードパーティ製アクションを利用できる。
 

== ワークフローの基本 ==
==== ワークフローファイル ====
ワークフローファイルは、リポジトリの .github/workflows/ ディレクトリにYAML形式で配置する。 
1つのリポジトリに複数のワークフローファイルを配置することができる。 
 
ワークフローファイルの基本構造を以下に示す。 
 
<syntaxhighlight lang="yaml">
name: ワークフロー名

on:
push:
branches: [ "main" ]
pull_request:
branches: [ "main" ]

permissions:
contents: read

jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4

- name: ステップ名
run: echo "Hello, World!"
</syntaxhighlight>
 
下表に、ワークフローを構成する主要なキーを示す。 
 
<center>
{| class="wikitable"
|+ ワークフロー定義のトップレベルキー一覧
|-
! 設定項目 !! 説明
|-
| <code>name</code> || ワークフローの名称 GitHubのActionsタブに表示される。
|-
| <code>on</code> || ワークフローをトリガーするイベントを定義する。
|-
| <code>permissions</code> || GITHUB_TOKENに付与する権限を定義する。
|-
| <code>jobs</code> || 実行するジョブの定義を記述する。
|}
</center>
 
==== トリガー (イベント) ====
ワークフローのトリガーは <code>on</code> キーで定義する。 
 
下表に、主なトリガーイベントを示す。 
 
<center>
{| class="wikitable"
|+ 主なトリガーイベント
|-
! イベント !! 説明
|-
| <code>push</code> || コードがプッシュされた時にトリガーされる。
|-
| <code>pull_request</code> || Pull Requestが作成・更新・マージされた時にトリガーされる。
|-
| <code>schedule</code> || cron形式で指定したスケジュールに従い定期実行される。
|-
| <code>workflow_dispatch</code> || GitHub Web UI　または　APIから手動でトリガーできる。
|-
| <code>release</code> || リリースが作成・公開された時にトリガーされる。
|-
| <code>issues</code> || Issueが作成・編集・クローズされた時にトリガーされる。
|-
| <code>workflow_run</code> || 別のワークフローの完了をトリガーとして実行される。
|-
| <code>repository_dispatch</code> || 外部システムからのAPIリクエストによってトリガーされる。
|}
</center>
 
ブランチやパスでフィルタリングする例を以下に示す。 
 
<syntaxhighlight lang="yaml">
on:
push:
branches:
- main
- "release/**"
paths:
- "src/**"
- "!src/docs/**"
paths-ignore:
- "**.md"
pull_request:
types: [opened, synchronize, reopened]
branches:
- main
schedule:
- cron: "0 9 * * 1-5"
workflow_dispatch:
inputs:
environment:
description: "デプロイ先の環境"
required: true
default: "staging"
</syntaxhighlight>
 
下表に、フィルタリングに使用できるキーを以下に示す。 
 
<center>
{| class="wikitable"
|+ フィルタリング設定項目一覧
|-
! 設定項目 !! 説明
|-
| <code>branches</code> || 対象ブランチを指定する。 ワイルドカード (<code>*</code>, <code>**</code>) が使用できる。
|-
| <code>paths</code> || 指定したパスのファイルが変更された場合のみトリガーされる。 <code>!</code> プレフィックスで除外パスを指定できる。
|-
| <code>paths-ignore</code> || 指定したパスのファイルのみが変更された場合はトリガーされない。
|}
</center>
 

== ジョブとステップ ==
==== ジョブの定義 ====
ジョブは <code>jobs</code> キー配下に定義する。 
各ジョブは独立したランナー環境で実行され、デフォルトでは並列に実行される。 
 
下表に、ジョブ定義の主要なキーを示す。 
 
<center>
{| class="wikitable"
|+ ジョブレベルの設定項目一覧
|-
! 設定項目 !! 説明
|-
| <code>runs-on</code> || ジョブを実行するランナーを指定する。 必須項目である。
|-
| <code>timeout-minutes</code> || ジョブのタイムアウト時間を分単位で指定する。 デフォルトは360分である。
|-
| <code>permissions</code> || ジョブレベルでGITHUB_TOKENの権限を上書き設定できる。
|}
</center>
 
<syntaxhighlight lang="yaml">
jobs:
build:
runs-on: ubuntu-latest
timeout-minutes: 30
permissions:
contents: read
packages: write
steps:
- uses: actions/checkout@v4
</syntaxhighlight>
 
==== ジョブ間の依存関係 ====
<code>needs</code> キーを使用して、ジョブ間の依存関係を定義できる。 
<code>needs</code> キーに指定したジョブが全て正常に完了した後に、該当ジョブが実行される。 
 
<syntaxhighlight lang="yaml">
jobs:
build:
runs-on: ubuntu-latest
steps:
- run: echo "ビルド実行"

test:
runs-on: ubuntu-latest
needs: build
steps:
- run: echo "テスト実行"

deploy:
runs-on: ubuntu-latest
needs: [build, test]
steps:
- run: echo "デプロイ実行"
</syntaxhighlight>
 
==== マトリックスビルド ====
<code>strategy.matrix</code> を使用することにより、複数の環境や設定の組み合わせに対してジョブを並列実行できる。 
 
<syntaxhighlight lang="yaml">
jobs:
test:
runs-on: ${{ matrix.os }}
strategy:
matrix:
os: [ubuntu-latest, windows-latest, macos-latest]
node-version: [18, 20, 22]
max-parallel: 4
fail-fast: false
include:
- os: ubuntu-latest
node-version: 20
experimental: true
exclude:
- os: macos-latest
node-version: 18
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: ${{ matrix.node-version }}
- run: npm test
</syntaxhighlight>
 
マトリックスビルドに関連するキーを以下に示す。 
 
<center>
{| class="wikitable"
|+ strategyの設定項目一覧
|-
! 設定項目 !! 説明
|-
| <code>matrix</code> || 変数名と値のリストを定義する。 全ての組み合わせに対してジョブが実行される。
|-
| <code>max-parallel</code> || 同時に実行するジョブの最大数を指定する。
|-
| <code>fail-fast</code> || <code>true</code> の場合、いずれかのジョブが失敗すると残りのジョブをキャンセルする。 デフォルトは <code>true</code> である。
|-
| <code>include</code> || 既存の組み合わせに変数を追加または新しい組み合わせを追加する。
|-
| <code>exclude</code> || 特定の組み合わせを除外する。
|}
</center>
 
==== 条件付き実行 ====
<code>if</code> キーを使用して、ジョブまたはステップの実行条件を定義できる。 
 
<syntaxhighlight lang="yaml">
jobs:
deploy:
runs-on: ubuntu-latest
if: github.event_name == 'push' && github.ref == 'refs/heads/main'
steps:
- name: 成功時のみ実行
if: success()
run: echo "前のステップが成功しました"

- name: 失敗時のみ実行
if: failure()
run: echo "前のステップが失敗しました"

- name: 常に実行
if: always()
run: echo "常に実行されます"
</syntaxhighlight>
 
下表に、条件式でよく使用するステータス関数を示す。 
 
<center>
{| class="wikitable"
|+ ステータスチェック関数一覧
|-
! 関数 !! 説明
|-
| <code>success()</code> || 前の全てのステップが成功した場合に <code>true</code> を返す。
|-
| <code>failure()</code> || 前のステップのいずれかが失敗した場合に <code>true</code> を返す。
|-
| <code>always()</code> || 常に <code>true</code> を返す。 キャンセルされた場合も実行される。
|-
| <code>cancelled()</code> || ワークフローがキャンセルされた場合に <code>true</code> を返す。
|}
</center>
 
==== ステップの定義 ====
ステップは <code>steps</code> キー配下に定義する。 
各ステップはアクションの実行またはコマンドの実行のいずれかの形式で記述する。 
 
<syntaxhighlight lang="yaml">
steps:
- name: リポジトリのチェックアウト
uses: actions/checkout@v4

- name: Node.jsのセットアップ
uses: actions/setup-node@v4
with:
node-version: "20"

- name: 依存関係のインストール
run: npm ci
env:
NODE_ENV: production

- name: テストの実行
run: npm test
continue-on-error: true
working-directory: ./app

- name: マルチラインコマンド
shell: bash
run: |
echo "ステップ1"
echo "ステップ2"
</syntaxhighlight>
 
下表に、ステップ定義の主要なキーを示す。 
 
<center>
{| class="wikitable"
|+ ステップの設定項目一覧
|-
! 設定項目 !! 説明
|-
| <code>uses</code> || 実行するアクションを owner/repo@ref 形式で指定する。
|-
| <code>run</code> || 実行するシェルコマンドを記述する。
|-
| <code>with</code> || アクションに渡すパラメータを定義する。
|-
| <code>env</code> || ステップレベルで環境変数を設定する。
|-
| <code>continue-on-error</code> || <code>true</code> の場合、ステップが失敗してもジョブを継続する。
|-
| <code>working-directory</code> || コマンドを実行する作業ディレクトリを指定する。
|-
| <code>shell</code> || コマンドを実行するシェルを指定する。 デフォルトは <code>bash</code> (Linux / MacOS) または <code>pwsh</code> (Windows) である。
|}
</center>
 

== ランナー ==
==== GitHubホスト型ランナー ====
GitHubが提供・管理するランナーを使用する場合、<code>runs-on</code> に以下に示すラベルを指定する。 
 
<center>
{| class="wikitable"
|+ GitHubホスト型ランナーの主な種類とスペック
|-
! ラベル !! OS !! CPU !! RAM
|-
| <code>ubuntu-latest</code> || Ubuntu (最新LTS) || 2コア || 7[GB]
|-
| <code>ubuntu-24.04</code> || Ubuntu 24.04 || 2コア || 7[GB]
|-
| <code>ubuntu-22.04</code> || Ubuntu 22.04 || 2コア || 7[GB]
|-
| <code>windows-latest</code> || Windows Server (最新) || 2コア || 7[GB]
|-
| <code>macos-latest</code> || MacOS (最新) || 3コア || 14[GB]
|-
| <code>macos-14</code> || MacOS 14 (Apple Silicon) || 3コア || 7[GB]
|}
</center>
 
GitHubホスト型ランナーは、各ジョブ実行のたびに新しい仮想マシンが用意される。 
パブリックリポジトリではGitHubホスト型ランナーを無料で使用できる。 
 
==== セルフホスト型ランナー ====
自身で用意したマシンをランナーとして使用できる。 
 
<code>runs-on: self-hosted</code> または追加ラベルを指定して使用する。 
 
<syntaxhighlight lang="yaml">
jobs:
build:
runs-on: [self-hosted, linux, x64]
steps:
- uses: actions/checkout@v4
</syntaxhighlight>
 
セルフホスト型ランナーの主な特徴を以下に示す。 
 
* 使用時間に対する課金が発生しない。
* 専用のハードウェアやカスタム環境を利用できる。
* ジョブの実行環境を完全にコントロールできる。
* パブリックリポジトリでの使用にはセキュリティリスクが伴うため、推奨されない。
 

== アクション ==
==== アクションとは ====
アクションは、ワークフローのステップとして実行できる再利用可能なコンポーネントである。 
 
下表に、アクションの種類を以下に示す。 
 
<center>
{| class="wikitable"
|+ アクションの種類
|-
! 種類 !! 説明 !! 対応OS
|-
| Docker container || Dockerコンテナ内で処理を実行する。 || Linuxのみ
|-
| JavaScript || Node.jsを使用して処理を実行する。 || 全OS対応
|-
| Composite || 複数のステップを1つのアクションにまとめる。 || 全OS対応
|}
</center>
 
==== 公式アクション ====
下表に、GitHubが提供する主要な公式アクションを示す。 
 
<center>
{| class="wikitable"
|+ 主な公式アクション
|-
! アクション !! 説明
|-
| <code>actions/checkout@v4</code> || リポジトリのコードをランナーにチェックアウトする。
|-
| <code>actions/setup-node@v4</code> || Node.js環境をセットアップする。
|-
| <code>actions/setup-python@v5</code> || Python環境をセットアップする。
|-
| <code>actions/setup-java@v4</code> || Java環境をセットアップする。
|-
| <code>actions/cache@v4</code> || 依存関係等のファイルをキャッシュする。
|-
| <code>actions/upload-artifact@v4</code> || ファイルをアーティファクトとしてアップロードする。
|-
| <code>actions/download-artifact@v4</code> || アップロードしたアーティファクトをダウンロードする。
|}
</center>
 
==== アクションの参照方法 ====
アクションは以下の形式で参照できる。 
 
* GitHubリポジトリのアクション
*: <code>owner/repo@ref</code> 形式で指定する。
*: <code>ref</code> にはタグ (<code>v4</code>)、ブランチ名、または、SHA (コミットハッシュ) を指定できる。
*: セキュリティの観点から、SHA固定が推奨される場合がある。
* ローカルアクション
*: <code>./.github/actions/アクション名</code> 形式で同リポジトリ内のアクションを参照できる。
 
<syntaxhighlight lang="yaml">
steps:
# タグ指定
- uses: actions/checkout@v4

# SHA固定
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683

# ローカルアクション
- uses: ./.github/actions/my-action
</syntaxhighlight>
 
==== GitHub Marketplace ====
GitHub Marketplace (https://github.com/marketplace?type=actions) では、コミュニティが公開しているサードパーティ製アクションを検索・利用できる。 
 
サードパーティ製アクションを使用する時は、以下に示す点に注意する。 
 
* アクションのソースコードを確認して、悪意のあるコードが含まれていないことを確認する。
* SHAを固定することにより、意図しないコード変更の影響を防ぐ。
* 信頼できるベンダーが公開しているアクションを優先して使用する。
 

== 環境変数とシークレット ==
==== 環境変数 ====
環境変数はワークフロー全体、ジョブ、ステップの3つのレベルで定義できる。 
 
<syntaxhighlight lang="yaml">
# ワークフローレベル
env:
APP_ENV: production

jobs:
build:
# ジョブレベル
env:
BUILD_DIR: ./dist
steps:
- name: ビルド
# ステップレベル
env:
NODE_ENV: production
run: npm run build
</syntaxhighlight>
 
定義した環境変数は <code>${{ env.変数名 }}</code> または <code>$変数名</code> (Linux / MacOS) で参照できる。 
 
==== コンテキスト変数 ====
GitHub Actionsは、ワークフローの実行に関する情報にアクセスするためのコンテキストを提供する。 
 
下表に、主なコンテキスト変数を示す。 
 
<center>
{| class="wikitable"
|+ 主なコンテキスト変数
|-
! コンテキスト !! 主なプロパティ !! 説明
|-
| <code>github</code> || <code>github.event_name</code> <code>github.ref</code> <code>github.sha</code> <code>github.repository</code> <code>github.actor</code> || ワークフローのトリガーとなったイベントやリポジトリの情報
|-
| <code>job</code> || <code>job.status</code> || 現在のジョブの状態
|-
| <code>runner</code> || <code>runner.os</code> <code>runner.arch</code> || ランナーのOS情報
|-
| <code>steps</code> || <code>steps.ステップID.outputs</code> <code>steps.ステップID.outcome</code> || 前のステップの出力と実行結果
|-
| <code>matrix</code> || <code>matrix.変数名</code> || マトリックスビルドの現在の変数値
|}
</center>
 
==== シークレット ====
APIキーやパスワード等の機密情報はシークレットとして管理する。 
 
シークレットはリポジトリ、環境、またはOrganizationレベルで設定できる。 
 
* シークレットの設定場所
*: [リポジトリ]ページ - [Settings] - [Secrets and variables] - [Actions]
 
<syntaxhighlight lang="yaml">
steps:
- name: デプロイ
env:
API_KEY: ${{ secrets.API_KEY }}
DATABASE_URL: ${{ secrets.DATABASE_URL }}
run: ./deploy.sh
</syntaxhighlight>
 
シークレットに関する主な注意事項を以下に示す。 
 
* シークレットの値はログに自動的にマスキングされる。
* フォークされたリポジトリからのPull Requestでは、シークレットは渡されない。
* シークレットの値は設定後に再表示できない。
 
==== GITHUB_TOKEN ====
<code>GITHUB_TOKEN</code> は、各ワークフロー実行時にGitHubが自動的に生成するトークンである。 
リポジトリへのアクセス権限を持ち、API呼び出しやリポジトリ操作に使用できる。 
 
<code>permissions</code> キーを使用して、ワークフローまたはジョブレベルでGITHUB_TOKENの権限を制御できる。 
 
<syntaxhighlight lang="yaml">
permissions:
contents: read
issues: write
pull-requests: write
packages: write
deployments: write
</syntaxhighlight>
 
権限には <code>read</code>, <code>write</code>, <code>none</code> のいずれかを指定できる。 
最小権限の原則に従い、必要な権限のみを付与することを推奨する。 
 

== アーティファクト ==
==== アーティファクトの管理 ====
アーティファクトは、ワークフロー実行中に生成されたファイルをGitHubサーバに保存する機能である。 
ビルド成果物、テストレポート、ログファイル等を保存・共有する時に使用する。 
 
<syntaxhighlight lang="yaml">
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4

- name: ビルド
run: npm run build

- name: アーティファクトのアップロード
uses: actions/upload-artifact@v4
with:
name: build-output
path: ./dist
retention-days: 30

deploy:
runs-on: ubuntu-latest
needs: build
steps:
- name: アーティファクトのダウンロード
uses: actions/download-artifact@v4
with:
name: build-output
path: ./dist
</syntaxhighlight>
 
下表に、アーティファクトに関連するパラメータを示す。 
 
<center>
{| class="wikitable"
|+ actions/upload-artifactの設定項目一覧
|-
! 設定項目 !! 説明
|-
| <code>name</code> || アーティファクトの識別名を指定する。
|-
| <code>path</code> || アップロードするファイルまたはディレクトリのパスを指定する。
|-
| <code>retention-days</code> || アーティファクトの保持日数を指定する。 1から400の範囲で設定できる。 デフォルトは90日である。
|}
</center>
 
==== ジョブ間のデータ共有 ====
アーティファクトを使用することにより、異なるジョブ間でファイルを共有できる。 
 
ステップ間での値の受け渡しには <code>$GITHUB_OUTPUT</code> を使用する。 
 
<syntaxhighlight lang="yaml">
jobs:
prepare:
runs-on: ubuntu-latest
outputs:
version: ${{ steps.get_version.outputs.version }}
steps:
- name: バージョン取得
id: get_version
run: echo "version=1.2.3" >> $GITHUB_OUTPUT

build:
runs-on: ubuntu-latest
needs: prepare
steps:
- name: バージョンの使用
run: echo "ビルドバージョン: ${{ needs.prepare.outputs.version }}"
</syntaxhighlight>
 

== キャッシュ ==
==== キャッシュの使用方法 ====
<code>actions/cache</code> アクションを使用して、依存関係等のファイルをキャッシュすることでワークフローの実行時間を短縮できる。 
 
<syntaxhighlight lang="yaml">
steps:
- uses: actions/checkout@v4

- name: Node.jsのセットアップ
uses: actions/setup-node@v4
with:
node-version: "20"
cache: "npm"

# または、actions/cacheを直接使用する
- name: npmキャッシュの復元
uses: actions/cache@v4
with:
path: ~/.npm
key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
restore-keys: |
${{ runner.os }}-node-

- run: npm ci
</syntaxhighlight>
 
下表に、キャッシュに関連するパラメータを示す。 
 
<center>
{| class="wikitable"
|+ actions/cacheの設定項目一覧
|-
! 設定項目 !! 説明
|-
| <code>path</code> || キャッシュするファイルまたはディレクトリのパスを指定する。
|-
| <code>key</code> || キャッシュを識別するキーを指定する。 キーが一致した場合にキャッシュが復元される。
|-
| <code>restore-keys</code> || <code>key</code> に一致するキャッシュが存在しない場合に、前方一致で検索するキーのリストを指定する。
|}
</center>
 
<code>hashFiles()</code> 関数を使用することにより、ロックファイルの内容に基づいたハッシュ値をキャッシュキーに含められる。 
ロックファイルが変更されると新しいキャッシュが作成される。 
 
==== キャッシュのスコープと制限 ====
キャッシュのスコープと制限に関する主な事項を以下に示す。 
 
* スコープ
*: キャッシュはブランチ間でアクセス制限がある。デフォルトブランチのキャッシュは全ブランチから参照できる。
*: フォークされたリポジトリはベースリポジトリのキャッシュにアクセスできない。
* 容量制限
*: リポジトリあたり10[GB]までキャッシュを保存できる。
*: 制限を超えた場合、古いキャッシュが自動的に削除される。
* 有効期限
*: 7日間アクセスされていないキャッシュは自動的に削除される。
 

== デプロイメント ==
==== 環境 (Environments) ====
環境 (Environments) 機能を使用することにより、デプロイ先の環境 (staging, production等) を定義して、環境固有のシークレットや保護ルールを設定できる。 
 
* 環境の設定場所
*: [リポジトリ]ページ - [Settings] - [Environments]
 
<syntaxhighlight lang="yaml">
jobs:
deploy-staging:
runs-on: ubuntu-latest
environment:
name: staging
url: https://staging.example.com
steps:
- name: ステージングへのデプロイ
env:
DEPLOY_KEY: ${{ secrets.STAGING_DEPLOY_KEY }}
run: ./deploy.sh staging

deploy-production:
runs-on: ubuntu-latest
needs: deploy-staging
environment:
name: production
url: https://example.com
steps:
- name: 本番環境へのデプロイ
run: ./deploy.sh production
</syntaxhighlight>
 
==== 環境保護ルール ====
環境に対して保護ルールを設定することにより、デプロイのプロセスを制御できる。 
 
主な保護ルールを以下に示す。 
 
* 必須レビュアー (Required reviewers)
*: 指定したユーザーまたはチームによる承認が必要となる。最大6名まで指定できる。
*: 承認者がデプロイジョブの実行を承認するまでジョブは待機する。
* 待機時間 (Wait timer)
*: ジョブが実行されるまでの待機時間を分単位で指定できる。
*: 最大43,200分 (30日) まで設定できる。
* デプロイメントブランチ (Deployment branches)
*: デプロイできるブランチを制限する。
*: [All branches]、[Protected branches]、[Selected branches]から選択できる。
 
==== デプロイメントの例 ====
mainブランチへのプッシュ時にステージングへデプロイして、手動承認後に本番環境へデプロイするワークフローの例を以下に示す。 
 
<syntaxhighlight lang="yaml">
name: デプロイメントワークフロー

on:
push:
branches: [main]

jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npm ci && npm run build
- uses: actions/upload-artifact@v4
with:
name: build
path: dist/

deploy-staging:
runs-on: ubuntu-latest
needs: build
environment: staging
steps:
- uses: actions/download-artifact@v4
with:
name: build
- run: ./deploy.sh staging

deploy-production:
runs-on: ubuntu-latest
needs: deploy-staging
environment: production
steps:
- uses: actions/download-artifact@v4
with:
name: build
- run: ./deploy.sh production
</syntaxhighlight>
 

== ワークフロー構文の詳細 ==
==== concurrency ====
<code>concurrency</code> を使用することにより、同一グループ内で同時に実行されるワークフローを制御できる。 
 
<syntaxhighlight lang="yaml">
concurrency:
group: ${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true
</syntaxhighlight>
 
<center>
{| class="wikitable"
|+ concurrencyの設定項目一覧
|-
! 設定項目 !! 説明
|-
| <code>group</code> || 同時実行を制御するグループ名を指定する。 同じグループ名のワークフローは同時に1つしか実行されない。
|-
| <code>cancel-in-progress</code> || <code>true</code> の場合、 同じグループで既に実行中のワークフローをキャンセルして新しいワークフローを実行する。
|}
</center>
 
==== 出力 (outputs) ====
ステップ間またはジョブ間で値を受け渡す場合は、環境変数 <code>$GITHUB_OUTPUT</code> を使用する。 
 
<syntaxhighlight lang="yaml">
steps:
- name: 値の設定
id: my-step
run: |
echo "my-output=hello" >> $GITHUB_OUTPUT
echo "another-value=world" >> $GITHUB_OUTPUT

- name: 値の参照
run: echo "${{ steps.my-step.outputs.my-output }}"
</syntaxhighlight>
 
なお、以前使用されていた <code>set-output</code> コマンドは非推奨であり、<code>$GITHUB_OUTPUT</code> の使用が推奨されている。 
 
==== 式と関数 ====
GitHub Actionsの式は <code>${{ }}</code> 構文で記述する。 
 
下表に、主な組み込み関数を示す。 
 
<center>
{| class="wikitable"
|+ 主な組み込み関数
|-
! 関数 !! 説明
|-
| <code>contains(search, item)</code> || <code>search</code> が <code>item</code> を含む場合に <code>true</code> を返す。
|-
| <code>startsWith(searchString, searchValue)</code> || <code>searchString</code> が <code>searchValue</code> で始まる場合に <code>true</code> を返す。
|-
| <code>endsWith(searchString, searchValue)</code> || <code>searchString</code> が <code>searchValue</code> で終わる場合に <code>true</code> を返す。
|-
| <code>format(string, ...)</code> || 文字列をフォーマットする。
|-
| <code>join(array, separator)</code> || 配列を区切り文字で結合した文字列を返す。
|-
| <code>toJSON(value)</code> || 値をJSON文字列に変換する。
|-
| <code>fromJSON(value)</code> || JSON文字列をオブジェクトに変換する。
|-
| <code>hashFiles(path)</code> || 指定したパスのファイルのSHA-256ハッシュ値を返す。
|}
</center>
 
==== 再利用可能なワークフロー ====
<code>workflow_call</code> トリガーを使用することにより、他のワークフローから呼び出せる再利用可能なワークフローを作成できる。 
 
再利用可能なワークフロー (.github/workflows/reusable.yml) の定義例を以下に示す。 
 
<syntaxhighlight lang="yaml">
# 再利用可能なワークフロー
on:
workflow_call:
inputs:
environment:
required: true
type: string
node-version:
required: false
type: string
default: "20"
secrets:
deploy-key:
required: true
outputs:
deploy-url:
description: "デプロイ先のURL"
value: ${{ jobs.deploy.outputs.url }}

jobs:
deploy:
runs-on: ubuntu-latest
outputs:
url: ${{ steps.deploy.outputs.url }}
steps:
- name: デプロイ
id: deploy
run: echo "url=https://example.com" >> $GITHUB_OUTPUT
</syntaxhighlight>
 
再利用可能なワークフローを呼び出す例を以下に示す。 
 
<syntaxhighlight lang="yaml">
jobs:
call-reusable:
uses: owner/repo/.github/workflows/reusable.yml@main
with:
environment: production
node-version: "20"
secrets:
deploy-key: ${{ secrets.DEPLOY_KEY }}
</syntaxhighlight>
 
再利用可能なワークフローに関する制限事項を以下に示す。 
 
* ネストの深さは最大10レベルまでである。
* 同一ワークフロー実行内で最大20の再利用可能なワークフローを呼び出せる。
 

== 課金 ==
==== 無料枠 ====
下表に、GitHub Actionsの各プランの無料枠を示す。 
 
<center>
{| class="wikitable"
|+ プランごとの無料枠
|-
! プラン !! 無料実行時間 !! ストレージ
|-
| Free || 2,000分/月 || 500[MB]
|-
| Pro || 3,000分/月 || 1[GB]
|-
| Team || 3,000分/月 || 2[GB]
|-
| Enterprise || 50,000分/月 || 50[GB]
|}
</center>
 
パブリックリポジトリでのワークフロー実行は、全プランで無料である。 
セルフホスト型ランナーの使用も無料である。(ランナーの維持費用は別途発生する) 
 
==== 超過時の課金 ====
下表に、無料枠を超過した場合の分単位の料金を示す。 
 
<center>
{| class="wikitable"
|+ ランナーごとの料金
|-
! ランナー !! 分単価 !! 倍率
|-
| Linux || $0.008/分 || 1倍
|-
| Windows || $0.016/分 || 2倍
|-
| MacOS || $0.08/分 || 10倍
|}
</center>
 
Windowsは無料枠の実行時間を2倍、MacOSは10倍として消費する。 
例えば、MacOSで1分実行すると、無料枠から10分消費される。 
 

{{#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]]

GitHub - Releases

2026-03-23T20:27:20Z

Wiki: ページの作成:「== 概要 == GitHub Releasesは、ソフトウェアの特定バージョンをパッケージ化して配布するための機能である。 ReleaseはGitのタグをベースに構築され、リリースノート、バイナリファイル、ドキュメントなどをまとめて公開できる。 下表に、Releasesが提供する主な機能を示す。 <center> {| class="wikitable" |+ GitHub Releasesの主な機能 |- ! 機能 !!…」

== 概要 ==
GitHub Releasesは、ソフトウェアの特定バージョンをパッケージ化して配布するための機能である。 
 
ReleaseはGitのタグをベースに構築され、リリースノート、バイナリファイル、ドキュメントなどをまとめて公開できる。 
 
下表に、Releasesが提供する主な機能を示す。 
 
<center>
{| class="wikitable"
|+ GitHub Releasesの主な機能
|-
! 機能 !! 説明
|-
| バイナリ配布 || コンパイル済みの実行ファイルやライブラリをアセットとして添付して、ユーザに直接提供できる。
|-
| リリースノート || 変更内容、バグ修正、新機能をまとめたノートを自動生成または手動で記述できる。
|-
| バージョン管理 || セマンティックバージョニングに従ったタグと紐付けることにより、バージョン履歴を明確に管理できる。
|-
| ドラフト・プレリリース || 公開前のドラフト状態での準備や安定版に先立つプレリリース版の公開に対応している。
|}
</center>
 
Releaseはタグと区別して管理されており、タグのみが存在する状態と、タグにReleaseを付与した状態は異なる扱いとなる。 
 

== Gitタグ ==
==== タグとは ====
Gitタグは、リポジトリ履歴の特定コミットを指し示すための参照である。 
 
タグはバージョンのマーキングに使用され、後から特定のバージョンに容易にアクセスできるようにする。 
 
タグの一覧を確認するコマンドを以下に示す。 
 
# 全タグの一覧表示
git tag

# パターンに一致するタグの一覧表示
git tag -l "v1.*"
 
特定タグの詳細情報を確認するコマンドを以下に示す。 
 
git show v1.4
 
==== 軽量タグとアノテーションタグ ====
Gitタグには軽量タグとアノテーションタグの2種類が存在する。 
 
下表に、2種類のタグの違いを示す。 
 
<center>
{| class="wikitable"
|+ 軽量タグとアノテーションタグの比較
! 項目 !! 軽量タグ !! アノテーションタグ
|-
| データ構造 || コミットへのポインタのみ || 完全なGitオブジェクト
|-
| メタデータ || なし || タッガー名、メールアドレス、日時、メッセージ
|-
| GPG 署名 || 不可 || 可能
|-
| リモートへの転送 || されない || される
|-
| 主な用途 || 一時的・内部的な目的 || 公開リリース
|}
</center>
 
公開リリースにはアノテーションタグを使用することが推奨される。 
 
==== タグの作成 ====
アノテーションタグを作成するコマンドを以下に示す。 
 
git tag -a v1.4 -m "バージョン 1.4 リリース"
 
軽量タグを作成するコマンドを以下に示す。 
 
git tag v1.4-lw
 
過去のコミットにタグを付ける場合は、コミットのチェックサム (または一部) を指定する。 
 
# コミット履歴を確認してチェックサムを取得する
git log --oneline

# 過去コミットへのタグ付け
git tag -a v1.2 9fceb02 -m "バージョン 1.2 リリース"
 
==== タグのプッシュ ====
<code>git push</code> コマンドは、デフォルトではタグをリモートリポジトリに転送しない。 
 
タグを明示的にプッシュする必要がある。 
 
* 特定のタグをプッシュするコマンド
*: <pre>git push origin v1.4</pre>
*: 
* 全てのタグを一括でプッシュするコマンド
*: <pre>git push --tags</pre>
 
<code>--tags</code> オプションは軽量タグとアノテーションタグの両方を転送する。 
 
アノテーションタグのみを転送する場合は <code>--follow-tags</code> オプションを使用する。 
 
==== タグの削除 ====
ローカルのタグを削除するコマンドを以下に示す。 
 
git tag -d v1.2.0
 
リモートリポジトリのタグを削除するコマンドを以下に示す。 
 
git push origin --delete tag v1.2.0
 
リモートタグを削除しても、ローカルのタグは残るため、ローカルとリモートの両方で削除操作が必要である。 
 

== Releaseの作成 ==
==== Web UIでの作成 ====
GitHubのWebインターフェースからReleaseを作成する手順を以下に示す。 
 
# リポジトリのトップページで[Releases]を選択する。
# [Draft a new release]ボタンを押下する。
# [Choose a tag]ドロップダウンから既存のタグを選択するか、新しいタグ名を入力して[Create new tag]を選択する。
# [Target]ドロップダウンから、タグを付けるブランチまたはコミットを選択する。
# [Release title]フィールドにリリースのタイトルを入力する。
# 説明欄にリリースノートを入力する。
# 必要に応じてバイナリファイルをドラッグ&ドロップでアセットとして添付する。
# プレリリースの場合は、[Set as a pre-release]チェックボックスにチェックを入力する。
# [Publish release]ボタンを押下してリリースを公開する。
 
==== GitHub CLIでの作成 ====
GitHub CLIを使用すると、コマンドからReleaseを作成できる。 
 
基本的な作成コマンドを以下に示す。 
 
gh release create v1.0.0 --title "v1.0.0" --notes "リリースノートの内容"
 
ファイルをアセットとして添付する場合のコマンドを以下に示す。 
 
gh release create v1.0.0 ./dist/app-linux ./dist/app-windows.exe \
--title "v1.0.0" \
--notes "リリースノートの内容"
 
下表に、主要なオプションを示す。 
 
<center>
{| class="wikitable"
|+ gh release createオプション一覧
! オプション !! 説明
|-
| <code>--title</code> || Releaseのタイトルを指定する。
|-
| <code>--notes</code> || リリースノートのテキストを指定する。
|-
| <code>--notes-file</code> || リリースノートをファイルから読み込む。
|-
| <code>--generate-notes</code> || リリースノートを自動生成する。
|-
| <code>--target</code> || タグを付けるブランチまたはコミットを指定する。
|-
| <code>-d</code> || ドラフト状態で作成する。
|-
| <code>-p</code> || プレリリースとしてマークする。
|-
| <code>--latest</code> || 最新リリースとしてマークする。
|}
</center>
 
==== プレリリース ====
プレリリースは、安定版の前に公開するテスト段階のリリースである。 
 
Web UIでは[Set as a pre-release]チェックボックスにチェックを入力することにより、プレリリースとして設定できる。 
 
GitHub CLI でプレリリースを作成するコマンドを以下に示す。 
 
gh release create v1.0.0-beta.1 -p --title "v1.0.0-beta.1" --notes "ベータ版リリース"
 
プレリリースは "Latest release" としては表示されず、Releasesページ上で "Pre-release" ラベルが付与される。 
 
==== ドラフトリリース ====
ドラフトリリースは、公開前の準備段階として保存するリリースである。 
 
ドラフト状態ではReleaseは一般ユーザには見えず、リポジトリの管理者のみが参照できる。 
 
GitHub CLIでドラフトリリースを作成するコマンドを以下に示す。 
 
gh release create v1.0.0 -d --title "v1.0.0" --notes "リリースノートの内容"
 
ドラフトは後から編集して公開 (Publish) することができる。 
 

== リリースノート ==
==== リリースノートの自動生成 ====
GitHubには、マージ済みのプルリクエストとコントリビュータを自動的にまとめてリリースノートを生成する機能がある。 
 
Web UIで自動生成するには、Release作成画面の説明欄上部にある[Generate release notes]ボタンを押下する。 
前回のReleaseタグ以降のマージ済みPRと新しいコントリビュータが自動的にまとめられる。 
 
GitHub CLIで自動生成するコマンドを以下に示す。 
 
gh release create v1.0.0 --generate-notes
 
==== release.ymlの設定 ====
.github/release.yml ファイルを作成することにより、自動生成されるリリースノートの内容をカスタマイズできる。 
 
設定ファイルの基本的な構成例を以下に示す。 
 
<syntaxhighlight lang="yaml">
changelog:
exclude:
labels:
- ignore-for-release
- dependencies
authors:
- dependabot
categories:
- title: 破壊的変更
labels:
- breaking-change
- title: 新機能
labels:
- feature
- enhancement
- title: バグ修正
labels:
- bug
- fix
- title: その他の変更
labels:
- '*'
</syntaxhighlight>
 
下表に、release.ymlファイルの主要な設定項目を示す。 
 
<center>
{| class="wikitable"
|+ release.ymlファイルの主な設定項目一覧
|-
! 設定項目 !! 説明
|-
| <code>changelog.exclude.labels</code> || 指定したラベルが付いたPRをリリースノートから除外する。
|-
| <code>changelog.exclude.authors</code> || 指定した作成者のPRを除外する。 <code>dependabot</code> 等の自動化ツールを除外する時に使用する。
|-
| <code>changelog.categories</code> || PRをカテゴリに分類して表示する。 <code>title</code> にカテゴリ名、<code>labels</code> に対象ラベルを指定する。
|-
| ワイルドカード <code>'*'</code> || いずれのカテゴリにも該当しないPRを全てキャッチするために使用する。
|}
</center>
 
==== コントリビュータの自動表示 ====
リリースノートの自動生成では、対象期間内に初めてコントリビュートしたユーザが New Contributors として自動的にリストアップされる。 
 
この機能により、コントリビュータへの感謝を示すセクションが自動的に追加される。 
 

== Releaseの管理 ==
==== Releaseの編集 ====
公開済みのReleaseは後から編集できる。 
 
Web UIでの編集手順を以下に示す。 
 
# [Releases]ページで編集するReleaseの鉛筆アイコンを選択する。
# タイトル、説明、アセット、プレリリース設定等を変更する。
# [Update release]ボタンを押下して、保存する。
 
GitHub CLIでReleaseを編集するコマンドを以下に示す。 
 
gh release edit v1.0.0 --title "新しいタイトル" --notes "更新されたリリースノート"
 
==== Releaseの削除 ====
Web UIでの削除手順を以下に示す。 
 
# [Releases]ページで削除するReleaseのゴミ箱アイコンを選択する。
# 確認ダイアログにおいて、[Delete]を選択する。
 
GitHub CLIでReleaseを削除するコマンドを以下に示す。 
 
# Releaseのみを削除する (タグは残る)
gh release delete v1.0.0

# Releaseと関連するタグを同時に削除する
gh release delete v1.0.0 --cleanup-tag
 
Releaseを削除しても、デフォルトでは関連するGitタグは削除されない。 
タグも合わせて削除する場合は <code>--cleanup-tag</code> オプションを使用する。 
 
==== ドラフトの公開 ====
ドラフト状態のReleaseを公開するには、Web UI または GitHub CLI を使用する。 
 
GitHub CLIでドラフトを公開するコマンドを以下に示す。 
 
gh release edit v1.0.0 -d=false
 

== アセット管理 ==
==== バイナリファイルの添付 ====
Releaseにはコンパイル済みバイナリ等の任意のファイルをアセットとして添付できる。 
 
Web UIでアセットを添付する手順を以下に示す。 
 
# Releaseの作成画面または編集画面を開く。
# [Attach binaries by dropping them here or selecting them.]のエリアにファイルをドラッグ&ドロップ、または、クリックしてファイルを選択する。
 
GitHub CLIでアセットを添付する場合は、<code>gh release create</code> コマンドの引数にファイルパスを指定する。 
 
gh release create v1.0.0 \
./dist/app-linux-amd64 \
./dist/app-windows-amd64.exe \
./dist/app-darwin-amd64
 
==== ソースコードアーカイブ ====
GitHubは全てのReleaseに対して、ソースコードのZIPアーカイブとtar.gzアーカイブを自動的に生成して添付する。 
これらのアーカイブは手動での操作なしに提供され、ReleaseページのAssetsセクションに表示される。 
 
* Source code (zip)
*: ソースコードのZIP形式アーカイブ
* Source code (tar.gz)
*: ソースコードのtar.gz形式アーカイブ
 
==== アセットの制限 ====
Releaseに添付できるアセットには以下に示す制限がある。 
 
<center>
{| class="wikitable"
|+ アセットの制限
! 項目 !! 制限値
|-
| 1 リリースあたりの最大アセット数 || 1000ファイル
|-
| 1 ファイルあたりの最大サイズ || 2[GiB]
|-
| 総サイズ || 無制限
|-
| 帯域幅 || 無制限
|}
</center>
 
==== アセットの表示ラベル ====
アセットに任意の表示名 (ラベル) を付加することができる。 
 
GitHub CLIでラベルを付けてアセットを添付するコマンドを以下に示す。 
<code>#</code> 以降の文字列がラベルとして表示される。 
 
gh release create v1.2.3 \
'/path/to/app.exe#App for Windows' \
'/path/to/app-linux#App for Linux'
 

== セマンティックバージョニング ==
==== バージョン番号の形式 ====
セマンティックバージョニングは、バージョン番号に意味を持たせるための標準的な規則である。 
バージョン番号は X.Y.Z の形式で表記する。 
 
下表に、それぞれの要素の意味を示す。 
 
<center>
{| class="wikitable"
|+ バージョン番号の要素
! 要素 !! 名称 !! 増加するタイミング
|-
| X || Major (メジャー) || 後方互換性のない破壊的変更を行った場合
|-
| Y || Minor (マイナー) || 後方互換性を保ちながら機能を追加した場合
|-
| Z || Patch (パッチ) || 後方互換性を保ちながらバグ修正を行った場合
|}
</center>
 
各要素の先頭にゼロを付けてはならない。 
例えば、1.01.0 は無効な表記である。 
 
==== タグの命名規則 ====
GitHubでの一般的なタグの命名規則を以下に示す。 
 
* v1.0.0
*: 最も一般的な形式
*: 先頭の v はオプションだが慣習として広く使われている。
* v1.0.0-alpha
*: アルファ版
*: 機能が未完成の段階のプレリリース
* v1.0.0-beta
*: ベータ版
*: 機能は完成しているが、テスト段階のプレリリース
* v1.0.0-rc.1
*: リリース候補 (Release Candidate)
*: 最終リリース前の最終テスト段階
 
プレリリースバージョンはハイフン区切りで識別子を付与する。 
先頭の v はオプションであるが、プロジェクト内で統一することが推奨される。 
 

== GitHub CLIでのRelease操作 ==
==== gh release list ====
リポジトリのRelease一覧を表示するコマンドを以下に示す。 
 
# Releaseの一覧を表示する
gh release list

# ドラフトを除外して表示する
gh release list --exclude-drafts

# プレリリースを除外して表示する
gh release list --exclude-pre-releases

# 表示件数を指定する (デフォルト: 30)
gh release list -L 10

# JSON形式で出力する
gh release list --json tagName,name,isDraft,isPrerelease,publishedAt
 
==== gh release view ====
特定のReleaseの詳細情報を表示するコマンドを以下に示す。 
 
# 特定タグのReleaseを表示する
gh release view v1.0.0

# 最新のReleaseを表示する
gh release view

# Webブラウザで開く
gh release view v1.0.0 -w

# JSON 形式で出力する
gh release view v1.0.0 --json tagName,name,body,assets
 
==== gh release download ====
Releaseのアセットをダウンロードするコマンドを以下に示す。 
 
# 特定タグの全アセットをダウンロードする
gh release download v1.0.0

# パターンに一致するアセットのみをダウンロードする
gh release download v1.0.0 --pattern "*.zip"

# ソースコードアーカイブをダウンロードする
gh release download v1.0.0 --archive=zip
gh release download v1.0.0 --archive=tar.gz

# ダウンロード先ディレクトリを指定する
gh release download v1.0.0 -D ./downloads

# 既存ファイルを上書きする
gh release download v1.0.0 --clobber

# 既存ファイルをスキップする
gh release download v1.0.0 --skip-existing
 
==== gh release edit ====
既存のReleaseを編集するコマンドを以下に示す。 
 
# タイトルを変更する
gh release edit v1.0.0 --title "新しいタイトル"

# リリースノートを変更する
gh release edit v1.0.0 --notes "更新されたリリースノート"

# プレリリースとしてマークする
gh release edit v1.0.0 -p

# ドラフト状態を解除して公開する
gh release edit v1.0.0 -d=false
 
==== gh release delete ====
Releaseを削除するコマンドを以下に示す。 
 
# Releaseを削除する (タグは残る)
gh release delete v1.0.0

# Releaseと関連するタグを同時に削除する
gh release delete v1.0.0 --cleanup-tag

# 確認プロンプトをスキップして削除する
gh release delete v1.0.0 -y
 

== Releaseの通知 ==
==== ウォッチ設定 ====
リポジトリの新しいReleaseが公開された際に通知を受け取るには、リポジトリのウォッチ設定を変更する。 
 
設定手順を以下に示す。 
 
# リポジトリのページ上部にある[Watch]ボタンを押下する。
# ドロップダウンメニューから[Custom]を選択する。
# [Releases]チェックボックスをオンにする。
# [Apply]ボタンを押下して、設定を保存する。
 
この設定により、新しいReleaseが公開された時に、GitHubの通知センターおよびメールで通知を受け取ることができる。 
 
==== RSS / Atomフィード ====
GitHub ReleasesはRSS / Atomフィードを提供しており、RSSリーダー等を使用して新しいReleaseを購読できる。 
 
* フィードのURLの形式
*: https://github.com/<owner>/<repo>/releases.atom
 
<code><owner></code> にはリポジトリオーナーのユーザ名または組織名、<code><repo></code> にはリポジトリ名を指定する。 
 
フィードの具体的な使用例を以下に示す。 
 
# 例: curlでReleasesフィードを取得する
curl https://github.com/octocat/Hello-World/releases.atom
 

{{#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]]

GitHub - Organizations

2026-03-23T20:05:52Z

Wiki: ページの作成:「== 概要 == GitHub Organizations (組織) は、複数のプロジェクトにわたって大規模なチームが協力して作業するための共有アカウントである。 個人アカウントが1人のユーザに紐付いているのに対して、Organizationは複数のメンバーが共同で所有・管理するアカウントである。 企業やオープンソースプロジェクトにおいて、コードの管理・共有・ア…」

== 概要 ==
GitHub Organizations (組織) は、複数のプロジェクトにわたって大規模なチームが協力して作業するための共有アカウントである。 
 
個人アカウントが1人のユーザに紐付いているのに対して、Organizationは複数のメンバーが共同で所有・管理するアカウントである。 
企業やオープンソースプロジェクトにおいて、コードの管理・共有・アクセス制御を一元化する目的で広く利用されている。 
 
Organizationが提供する主な機能は以下の通りである。 
 
<center>
{| class="wikitable"
|+ Organizationの機能
|-
! 項目 !! 説明
|-
| 細粒度の権限管理 || メンバーごとにリポジトリへのアクセスレベルを細かく設定できる。
|-
| チーム組織 || メンバーをチームに分けて管理し、チーム単位でリポジトリへの権限を付与できる。
|-
| 高度なセキュリティ機能 || 二要素認証の必須化、SAML SSO、監査ログ等のセキュリティ機能を利用できる。
|-
| 集中管理 || リポジトリ、メンバー、課金をOrganization単位で一元管理できる。
|}
</center>
 

== Organizationの作成と設定 ==
==== 作成手順 ====
Organizationの作成手順を以下に示す。 
 
# GitHubにログインして、右上のプロフィール画像を選択する。
# メニューから[Your organizations]を選択する。
# [New organization]ボタンを押下する。
# Organization名とメールアドレスを入力する。
# プラン (Free / Team / Enterprise) を選択する。
# 必要な追加情報を入力して、作成を完了する。
 
作成後、メンバーの招待やリポジトリの作成といった初期設定を行うことができる。 
 
==== プロフィール設定 ====
Organizationのプロフィール情報は、[Settings]から変更できる。 
 
設定可能な項目は以下の通りである。 
 
<center>
{| class="wikitable"
|+ Organizationのプロフィール設定
|-
! 項目 !! 説明
|-
| 組織名 || Organizationの識別子となる名前 [Settings]から変更できるが、変更後に旧名は他のユーザに取得される可能性があるため、変更は慎重に行うこと。
|-
| アバター || Organizationを代表するプロフィール画像
|-
| 説明 || Organizationの目的や概要を記述するテキスト
|-
| URL || Organizationに関連するWebサイトのURL
|}
</center>
 
==== 個人アカウントからの変換 ====
個人アカウントをOrganizationへ直接変換することはできない。 
 
アカウントの種別変換が必要な場合は、以下の手順を取る必要がある。 
# 新規にOrganizationを作成する。
# 個人アカウントのリポジトリをOrganizationに移行する。
# 個人アカウントのコラボレータをOrganizationのメンバーとして招待する。
 
同様に、OrganizationをPersonalアカウントへ変換することも不可能である。 
 

== メンバー管理 ==
==== メンバーの招待 ====
Organizationへのメンバー招待は、OwnerがGitHubのユーザ名またはメールアドレスを指定して行う。 
 
招待の手順は以下の通りである。 
# Organizationページを開いて、[People]タブを選択する。
# [Invite member]ボタンを押下する。
# 招待するユーザのユーザ名またはメールアドレスを入力する。
# 対象ユーザにロールを選択して招待を送信する。
 
招待を受け入れる前であれば、OwnerはいつでもOrganizationの設定画面から招待を編集またはキャンセルできる。 
 
==== 権限ロール ====
Organizationのメンバーには、以下に示すいずれかのロールが割り当てられる。 
 
<center>
{| class="wikitable"
|+ Organizationのメンバーロール
! ロール !! 説明
|-
| Owner || Organization全体に対する最高権限を持つ。 メンバー管理、課金管理、セキュリティ設定、リポジトリ管理等の全ての操作が可能
|-
| Member || Organizationの基本的なメンバー 付与された権限の範囲でリポジトリへのアクセスや操作が可能
|-
| Billing Manager || 課金情報の管理のみを担当する。 リポジトリやメンバーへのアクセス権限は持たない。
|-
| Security Manager || セキュリティ関連の機能を管理できる。 GitHub Enterprise Cloudでのみ利用可能
|-
| Moderator || メンバーへのアクセス制限やブロックを行う権限を持つモデレータ
|}
</center>
 
==== メンバーの削除 ====
Ownerは、Organization設定の[People]タブからメンバーを削除できる。 
 
メンバーを削除した場合の影響は以下の通りである。 
* 該当メンバーはOrganizationの全てのリポジトリへのアクセスを失う。
* プライベートリポジトリをフォークしていた場合、そのフォークは削除される。
*: ただし、ローカルにクローン済みのコードはそのまま保持される。
 
==== 外部コラボレータ ====
外部コラボレータとは、Organizationのメンバーではないが、特定の1つ以上のリポジトリへのアクセス権限を持つ人物のことである。 
 
外部コラボレータの特徴は以下の通りである。 
* Organizationのメンバーシップは持たず、特定リポジトリへのアクセスのみが付与される。
* プライベートリポジトリに外部コラボレータを追加する場合は、有料ライセンスを消費する。
* セキュリティの観点から、外部コラボレータへのアクセス権は最小限にとどめることが推奨される。
 
==== 元メンバーの再招待 ====
以前にOrganizationに所属していたメンバーを再招待する場合、過去の設定を復元するオプションが提供される。 
 
再招待時に復元を選択できる項目は以下の通りである。 
 
<center>
{| class="wikitable"
|+ メンバー復帰時に復元される情報
|-
! 項目 !! 説明
|-
| ロール || 削除前に保持していたOrganizationロール
|-
| アクセス権 || 削除前に付与されていたリポジトリへのアクセス権限
|-
| フォーク || 削除時に削除されたプライベートリポジトリのフォーク
|-
| 各種設定 || その他の個人設定
|}
</center>
 
これらの復元は任意であり、再招待時に個別に選択できる。 
 

== チーム ==
==== チームの作成 ====
チームはOrganization内のメンバーをグループ化して、リポジトリへの権限を一括管理するための機能である。 
 
チームの作成手順は以下の通りである。 
# [Organization]ページの[Teams]タブを開く。
# [New team]ボタンを押下する。
# チーム名と説明を入力する。
# チームの可視性を選択する。
# チームを作成する。
 
チームの可視性には、以下に示す2種類がある。 
* Visible team
*: Organizationの全メンバーから検索・メンション (@チーム名) が可能な公開チーム
* Secret team
*: チームのメンバーとOwnerのみが存在を確認できる非公開チーム
 
==== ネストされたチーム ====
チームは階層構造 (ネスト) を持つことができ、親チームと子チームの関係を定義できる。 
 
ネストされたチームの主な特徴は以下の通りである。 
* 子チームは親チームの権限を自動的に継承する。
* 親チームに対して @メンション を行うと、全ての子チームメンバーにも通知が届く。
* 組織の部門・チーム構造を反映した権限管理が可能になる。
 
==== チームへのリポジトリ割り当て ====
チームには複数のリポジトリを割り当てることができ、リポジトリごとにアクセスレベルを設定できる。 
 
設定できるアクセスレベルは以下の通りである。 
 
<center>
{| class="wikitable"
|+ チームのリポジトリ権限レベル
|-
! 権限 !! 説明
|-
| Read || リポジトリの参照のみ可能
|-
| Write || コードの閲覧とプッシュが可能
|-
| Admin || リポジトリの設定を含む全ての操作が可能
|}
</center>
 
親チームに割り当てられたリポジトリアクセス権は、子チームに自動的に継承される。 
 
==== チームの権限とメンテナー ====
チームメンテナーは、Ownerから委任されてチームの管理を行うロールである。 
 
チームメンテナーが実行できる操作は以下の通りである。 
* チームメンバーの追加・削除
* チームのプロフィール画像の変更
* チーム名の編集
* チームの表示・非表示の変更
* チームの通知設定の管理
* チームに割り当てられたリポジトリのアクセス権限の管理
 

== リポジトリ管理 ==
==== Organization所有リポジトリ ====
Organizationが所有するリポジトリは、個人アカウントのリポジトリとは独立して管理される。 
 
Organizationリポジトリの主な特徴は以下の通りである。 
* 複数のメンバーやチームが協調してリポジトリを管理できる。
* メンバーの退職・脱退後もOrganizationのリポジトリは保持される。
* Organizationのプランに応じて、プライベートリポジトリの作成が可能。
 
==== リポジトリ権限レベル ====
リポジトリへのアクセス権限は5段階のレベルで設定できる。 
 
<center>
{| class="wikitable"
|+ リポジトリ権限レベル
! 権限レベル !! 説明
|-
| Read || リポジトリの参照のみ可能 コードの閲覧、Issue・PRの閲覧ができる。
|-
| Triage || Issueやプルリクエストの管理が可能 コードのプッシュはできない。
|-
| Write || コードの閲覧・プッシュ、プルリクエストのマージが可能
|-
| Maintain || リポジトリの設定管理が可能 ただし、リポジトリの削除・アーカイブはできない。
|-
| Admin || リポジトリの削除を含む全ての操作が可能なフル権限
|}
</center>
 
==== デフォルト権限設定 ====
Organization設定でデフォルト権限を設定すると、新規メンバー参加時に自動的に適用される。 
 
設定可能なデフォルト権限レベルは以下の通りである。 
 
<center>
{| class="wikitable"
|+ Organization のベースパーミッション
|-
! 権限 !! 説明
|-
| None || リポジトリへのデフォルトアクセスなし (デフォルト値)
|-
| Read || 全てのリポジトリを参照可能
|-
| Triage || Issue / PR管理が可能
|-
| Write || コードのプッシュが可能
|-
| Maintain || リポジトリ設定の管理が可能
|-
| Admin || 全てのリポジトリに対するフル権限
|}
</center>
 
デフォルト権限はOrganizationの全メンバーに適用されるため、最小権限の原則に従い <code>None</code> または <code>Read</code>> を設定することが推奨される。 
 
==== リポジトリの可視性ポリシー ====
Ownerは、Organizationメンバーがリポジトリを作成・変更できる可視性をポリシーで制限できる。 
 
<center>
{| class="wikitable"
|+ リポジトリの可視性に関するポリシー
|-
! カテゴリ !! 設定内容
|-
| rowspan="3" | 作成時の可視性制限 || PublicとPrivateの両方を許可する。
|-
| Publicのみ許可する。
|-
| リポジトリの作成を禁止する。
|-
| rowspan="2" | 可視性変更の権限制限 || Ownerのみが変更可能とする。
|-
| Admin権限を持つ全メンバーが変更可能とする。
|}
</center>
 

== セキュリティ ==
==== 2要素認証の必須化 ====
Ownerは、Organizationの全メンバーに対して2要素認証 (2FA) の有効化を必須とするポリシーを設定できる。 
 
設定手順は以下の通りである。 
# [Organization]の[Settings]を開く。
# [Security]セクションの[Authentication security]を選択する。
# [Require two-factor authentication]を有効にする。
 
設定時の重要な注意点は以下の通りである。 
* OwnerはOrganizationで2FAを必須化する前に、自分自身のアカウントで2FAを有効化する必要がある。
* 2FA未設定のメンバー
*: Organizationリソースへのアクセスが不可になるが、メンバーシップ自体は保持される。
* 2FA未設定の外部コラボレータ
*: Organizationから削除される。
 
==== SAML SSO ====
SAML SSO (Security Assertion Markup Language Single Sign-On) は、Organizationメンバーが企業のIDプロバイダを通じてGitHubにアクセスするための認証機能である。 
 
SAML SSOを使用することにより、以下のセキュリティ要件を満たすことができる。 
* メンバーの認証を社内のIDプロバイダに統合できる。
* メンバーが退職した場合、IDプロバイダ側で無効化するだけでアクセスを即座に遮断できる。
* SAML SSOはGitHub Enterprise Cloudプランで利用可能
 
==== SSH証明書機関 ====
Organizationは独自のSSH証明書機関 (CA) を設定でき、メンバーのSSH鍵の代わりに証明書を利用してリポジトリへアクセスさせることができる。 
 
SSH証明書機関を使用することにより、SSH鍵の個別管理を不要にして、一元的な認証管理が実現する。 
 
==== IPアドレス許可リスト ====
Organization設定でIPアドレスの許可リストを設定することにより、特定のIPアドレスまたはIPアドレス範囲からのみアクセスを許可できる。 
 
許可リストを使用することで、不正なネットワークからのアクセスをブロックして、セキュリティを強化できる。 
 
==== 監査ログ ====
監査ログは、Organization内で発生した全ての操作を記録する機能である。 
 
下表に、監査ログの主な特徴を示す。 
 
<center>
{| class="wikitable"
|+ 監査ログの概要
|-
! 項目 !! 説明
|-
| アクセス権限 || Ownerのみがアクセス可能
|-
| 保持期間 || 過去180日間の操作ログが保持される。
|}
</center>
 
<center>
{| class="wikitable"
|+ 監査ログのフィルタリング方法
|-
! フィルタ !! 説明
|-
| カテゴリフィルタ || <code>repo</code> / <code>team</code> / <code>org</code> / <code>billing</code> / <code>hook</code> 等でフィルタリング可能。
|-
| アクションフィルタ || <code>action:team.create</code> のように特定のアクションで検索可能
|-
| アクターフィルタ || <code>actor:username</code> のように特定ユーザの操作で検索可能
|}
</center>
 
エクスポート形式は以下の通りである。 
* JSON形式
* CSV形式
 

== 組織のポリシー ==
==== リポジトリ作成の制限 ====
Ownerは、Organizationメンバーがリポジトリを作成できる範囲をポリシーとして設定できる。 
 
設定可能なポリシーは以下の通りである。 
* 全メンバーがパブリックおよびプライベートリポジトリを作成可能とする。
* 全メンバーがパブリックリポジトリのみ作成可能とする。
* リポジトリ作成をOwnerのみに制限する。
 
==== フォークポリシー ====
Ownerは、プライベートリポジトリやインターナルリポジトリのフォークを許可するかどうかをポリシーで制御できる。 
 
フォークポリシーの設定項目は以下の通りである。 
* プライベートリポジトリのフォークを許可または禁止する。
* インターナルリポジトリのフォーク先をOrganition内に限定するか、外部も許可するかを設定する。
 
==== GitHub Actionsのポリシー ====
Ownerは、Organization全体のGitHub Actionsの使用ポリシーを設定できる。 
 
設定可能なポリシーは以下の通りである。 
* All actions allowed
*: 全てのActionの使用を許可する。
* Local actions only
*: Organization内またはリポジトリ内のActionのみ使用を許可する。
* Selected actions allowed
*: 指定した特定のActionのみ使用を許可する。
 
その他のActionsに関するポリシーとして、セルフホストランナーの利用制限や外部コントリビュータによるフォークからのプルリクエスト実行時の承認設定も管理できる。 
 
==== GITHUB_TOKEN権限 ====
GitHub Actionsで自動生成される <code>GITHUB_TOKEN</code> のデフォルト権限をOrganization全体で設定できる。 
 
設定できる権限は以下の通りである。 
* Read-only
*: 読み取り専用権限 (推奨)
* Read and write
*: 読み取りおよび書き込み権限
 
セキュリティの観点から、デフォルトは <code>>Read-only</code> に設定することが推奨される。 
 

== 課金と管理 ==
==== 組織のプラン ====
Organizationでは、以下に示す3つのプランから選択できる。 
 
<center>
{| class="wikitable"
|+ Organizationのプラン比較
! プラン !! 主な特徴
|-
| Free || 基本的な機能を無料で提供 パブリックリポジトリは無制限、プライベートリポジトリも利用可能。GitHub Actionsの無料枠あり。
|-
| Team || 小・中規模チーム向けの有料プラン コードオーナー設定、必須レビュアー等の高度なコラボレーション機能を含む。
|-
| Enterprise || 大規模組織向けの上位プラン SAML SSO、カスタムロール、高度なセキュリティ機能、GitHub Advanced Security等が利用可能
|}
</center>
 
==== 課金管理者 ====
Billing Manager (課金管理者) は、Organizationの課金情報を専門に管理するロールである。 
 
Billing Managerが管理できる項目は以下の通りである。 
* 支払い方法の設定・変更
* 請求先情報の管理
* 利用レポートの確認
* サブスクリプションとライセンスの管理
 
Billing Managerは、セキュリティ機能や機密リポジトリへのアクセス権を持たないため、課金管理のみを委任したい場合に適している。 
 
==== 使用量の確認 ====
Organizationの使用量は、[Settings]の[Billing and plans]から確認できる。 
 
確認できる情報は以下の通りである。 
* 現在のプラン情報
* 月間の支払い額
* GitHub Actionsの使用量 (分数・ストレージ)
* Git LFS等のストレージ使用量
* 共同編集者数とライセンス消費状況
 

{{#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]]

GitHub - Discussions

2026-03-23T19:50:16Z

Wiki: ページの作成:「== 概要 == GitHub Discussionsは、プロジェクトコミュニティがオープンなフォーマットで対話できる協働的コミュニケーションフォーラムである。 Issuesが具体的な作業タスクの追跡を目的とするのに対し、Discussionsは初期段階のアイデア検討、質問への回答、情報共有、コミュニティとの交流を目的とする。 IssuesとDiscussionsの使い分けを以下…」

== 概要 ==
GitHub Discussionsは、プロジェクトコミュニティがオープンなフォーマットで対話できる協働的コミュニケーションフォーラムである。 
 
Issuesが具体的な作業タスクの追跡を目的とするのに対し、Discussionsは初期段階のアイデア検討、質問への回答、情報共有、コミュニティとの交流を目的とする。 
 
IssuesとDiscussionsの使い分けを以下に示す。 
 
<center>
{| class="wikitable"
|+ IssuesとDiscussionsの使い分け
|-
! 機能 !! 説明
|-
| Issues || バグ報告、機能リクエスト、具体的な作業タスクの追跡に使用する。 スコープが確定した作業を担当者・マイルストーンと紐付けて管理する場合に適している。
|-
| Discussions || 初期段階のアイデア検討、コミュニティへの質問、告知、成果物の共有に使用する。 スコープが未確定の段階でコミュニティと議論し、方向性を決めてからIssueに移行する運用が推奨される。
|}
</center>
 
Discussionsで議論が進み、具体的な作業として着手することが決まった段階でIssueへ変換できる。 
逆に、IssueをDiscussionsに変換することも可能である。 
 

== Discussionsの有効化 ==
==== リポジトリでの有効化 ====
リポジトリオーナー、またはそのリポジトリへの書き込み権限を持つユーザがDiscussionsを有効化できる。 
 
有効化の手順を以下に示す。 
 
# リポジトリのページ上部にある[Settings]タブを選択する。
# [Features]セクションまでスクロールして、[Discussions]の項目を確認する。
# [Set up discussions]ボタンを選択する。
# ウェルカムポストのタイトルと本文を編集する。
# [Start discussion]ボタンを押下して、有効化を完了する。
 
有効化後、リポジトリのナビゲーションバーに[Discussions]タブが表示される。 
 
==== 組織レベルでのDiscussions ====
組織オーナーは、組織全体に対してDiscussionsを有効化できる。 
 
有効化の手順を以下に示す。 
 
# 組織のページから[Settings]タブを選択する。
# Discussionsの項目を確認する。
# [Enable]ボタンを押下して有効化する。
# ソースリポジトリを指定する。
 
組織レベルのDiscussionsでは、ソースリポジトリを指定する必要がある。 
Discussionsへの権限は、指定したソースリポジトリの権限設定に基づいて適用される。 
 

== カテゴリ ==
==== デフォルトカテゴリ ====
Discussionsを有効化すると、以下に示すデフォルトカテゴリが自動的に作成される。 
 
<center>
{| class="wikitable"
|+ デフォルトカテゴリ一覧
! カテゴリ名 !! 絵文字 !! 用途
|-
| Announcements || 📣 || メンテナーやコントリビュータからの更新情報・告知を投稿する。
|-
| General || 🗳️ || プロジェクトに関するオープンエンドな議論を行う。
|-
| Ideas || 💡 || 新機能の提案や既存機能の改善アイデアを共有する。
|-
| Polls || 🗳 || 投票を実施してコミュニティの意見を収集する。
|-
| Q&A || 🙏 || 技術的な質問を投稿して、コミュニティから回答を得る。
|-
| Show and tell || 🙌 || プロジェクトを使用して作成した成果物・作品を展示および共有する。
|}
</center>
 
==== カテゴリの形式 ====
各カテゴリには以下に示す4つの形式のいずれかを設定できる。 
 
<center>
{| class="wikitable"
|+ カテゴリ形式一覧
! 形式 !! 説明
|-
| Open-ended discussion || 自由な議論形式 回答のマーク機能は使用できない。 GeneralやIdeasに適している。
|-
| Question / Answer || 構造化されたQ&A形式 回答のマーク機能が有効になり、有用な回答をハイライト表示できる。
|-
| Announcement || メンテナーのみが投稿できる告知形式 コミュニティメンバーはコメントのみ可能
|-
| Poll || 投票形式 選択肢を提示してコミュニティの意見を数値で収集する。
|}
</center>
 
==== カスタムカテゴリの管理 ====
maintain権限または admin権限を持つユーザは、カスタムカテゴリを作成・編集・削除できる。 
 
カスタムカテゴリの仕様を以下に示す。 
* カテゴリ名は一意である必要がある。
*: 既存のカテゴリ名と重複するカテゴリは作成できない。
* 各カテゴリには名前と絵文字のペアを設定する。
*: 絵文字はカテゴリの識別に使用され、一覧表示で視覚的な区別を助ける。
* 1つのリポジトリまたは組織に作成できるカテゴリ数は最大25個である。
* カテゴリのネスト (階層化) が可能である。
*: サブカテゴリを作成して、より細かい分類が行える。
 
==== カテゴリテンプレート ====
カテゴリごとにテンプレートを設定できる。 
 
テンプレートを設定すると、そのカテゴリで新規ディスカッションを作成する時に記入すべき情報が事前に表示され、投稿者が必要な情報を漏れなく記載できるよう促す。 
 
テンプレートはYAML構文で記述する。 
設定例を以下に示す。 
 
<syntaxhighlight lang="yaml">
name: Bug Report
description: バグ報告のテンプレート
labels: ["bug"]
body:
- type: markdown
attributes:
value: |
バグ報告ありがとうございます。以下の項目を記入してください。
- type: textarea
id: description
attributes:
label: バグの説明
description: バグの内容を詳しく説明してください。
placeholder: 説明を入力してください。
validations:
required: true
- type: textarea
id: steps
attributes:
label: 再現手順
description: バグを再現する手順を記載してください。
placeholder: "1. ...\n2. ...\n3. ..."
validations:
required: true
</syntaxhighlight>
 

== ディスカッションの作成と管理 ==
==== ディスカッションの作成 ====
[Discussions]タブからディスカッションを作成する手順を以下に示す。 
 
# リポジトリまたは組織の[Discussions]タブを選択する。
# [New discussion]ボタンを押下する。
# 投稿するカテゴリを選択する。
# タイトルと本文を入力する。
# [Start discussion]ボタンを押下して投稿する。
 
本文はMarkdown記法で記述でき、コードブロック・画像・リンクの挿入が可能である。 
 
==== コメントとリアクション ====
ディスカッションへのコメントはスレッド化されており、特定のコメントに対して返信することで会話の流れが整理される。 
 
コメントに対してアップボート (👍) を付けることができ、有用なコメントが視覚的に強調されてコミュニティの合意形成を助ける。 
 
絵文字リアクション機能により、コメント・投稿に対して感情を簡単に表現できる。 
 
==== 回答のマーク (Q&A) ====
Q&A形式のカテゴリでは、ディスカッションの作成者または triage権限以上を持つユーザが、有用なコメントを回答としてマークできる。 
 
回答としてマークされたコメントはページ上部にハイライト表示され、同様の問題を持つ他のユーザが素早く解決策を見つけられるようになる。 
 
回答がマークされたディスカッションは 回答済み 状態となり、フィルタリングで絞り込むことができる。 
 
==== ピン留め ====
書き込み権限を持つユーザは、重要なディスカッションを[Discussions]タブの上部にピン留めできる。 
 
ピン留めしたディスカッションは一覧の最上部に固定表示され、コミュニティメンバーが重要な情報に素早くアクセスできる。 
 
==== ロック ====
書き込み権限を持つユーザは、ディスカッションをロックできる。 
 
ロックが適切な場面を以下に示す。 
* 不建設的な議論が続いている場合
* コミュニティ規約に違反したコンテンツが含まれている場合
* 解決済みで追加のコメントが不要な場合
 
ロック中も書き込み権限を持つユーザはコメントを投稿できる。 
 
ロック時にリアクションのみ許可するオプションを選択することも可能である。 
 
==== Issueへの変換 ====
ディスカッションで議論が進み、具体的な作業として着手することが決まった場合、ディスカッションをIssueに変換できる。 
 
変換の手順を以下に示す。 
 
# ディスカッションページを開く。
# 右側のサイドバーにある[Convert to issue]を選択する。
 
変換後、ディスカッションのタイトルと本文はIssueに引き継がれる。 
変換元のディスカッションにはリンクが表示され、経緯を追跡できる。 
 
逆に、IssueをDiscussionsに変換することも可能である。 
Issueの詳細ページのサイドバーから[Convert to discussion]を選択して、変換先のカテゴリを指定する。 
 
==== カテゴリの変更 ====
書き込み権限を持つユーザは、投稿済みディスカッションのカテゴリを変更できる。 
 
カテゴリを変更することにより、ディスカッションの性質が変わった場合 (例: Generalで始まった議論がQ&A形式に適するようになった場合) に適切なカテゴリへ移動できる。 
 
==== ディスカッションの転送 ====
書き込み権限を持つユーザは、ディスカッションを別のリポジトリに転送できる。 
 
転送の手順を以下に示す。 
 
# ディスカッションページを開く。
# 右側のサイドバーにある[Transfer this discussion]を選択する。
# 転送先のリポジトリを選択する。
# [Transfer discussion]ボタンを押下して、転送を完了する。
 
Announcement形式のカテゴリのディスカッションは転送できないことに注意する。 
 

== 投票 (Polls) ==
==== 投票の作成 ====
[Polls]カテゴリを選択してディスカッションを作成すると、投票を実施できる。 
 
投票の作成手順を以下に示す。 
 
# [Discussions]タブから[New discussion]を選択する。
# [Polls]カテゴリを選択する。
# 質問文をタイトルに入力する。
# 最低2つの選択肢を入力する。
#: 選択肢は必要に応じて追加できる。
# [Start discussion]ボタンを押下して、投票を開始する。
 
==== 投票結果の確認 ====
投票の結果はリアルタイムで更新され、各選択肢の得票数と得票率がグラフで表示される。 
 
投票はコミュニティの意見収集や、新機能の関心度測定に有効である。 
複数選択肢を提示して優先度を把握することにより、開発の方向性決定に活用できる。 
 

== ラベル ==
==== ディスカッションへのラベル適用 ====
リポジトリに設定されたラベルをディスカッションに適用できる。 
 
ラベルの適用手順を以下に示す。 
 
# ディスカッションページを開く。
# 右側のサイドバーにある[Labels]セクションを選択する。
# 適用するラベルを選択する。
 
カテゴリとラベルを組み合わせることにより、より細かい分類が可能になる。 
例えば、Q&Aカテゴリに対して "help wanted"ラベルを付けることで、回答を必要としているディスカッションを素早く特定できる。 
 

== モデレーション ==
==== コメント管理 ====
書き込み権限を持つユーザは、以下に示すコメント管理操作を実行できる。 
 
* コメントの非表示
*: 不適切なコメントを折りたたんで表示を抑制する。
*: 非表示にしたコメントは このコメントは非表示になっています と表示されて、表示する権限を持つユーザは展開して確認できる。
* コメントの編集
*: コメント内容を修正する。
*: 編集履歴はユーザに表示される。
* コメントの削除
*: コメントを完全に削除する。
*: 削除後は復元できないため慎重に操作する。
 
==== ユーザの制限とブロック ====
書き込み権限を持つユーザは、特定のユーザをブロックしてリポジトリへのアクセスを制限できる。 
 
ブロックの種類を以下に示す。 
* 無期限ブロック
*: 解除するまでブロックが継続する。
*: 重大な規約違反があった場合に使用する。
* 期間限定ブロック
*: 指定した期間 (1日、3日、7日、30日) のみブロックする。
*: 一時的な冷却期間を設ける場合に使用する。
 
期間限定ブロックは指定期間が終了すると自動的に解除される。 
 
==== モデレータ権限の付与 ====
リポジトリのメンテナーは、アクティブなコントリビュータにtriage権限を付与することにより、モデレータとして活動してもらえる。 
 
トップコントリビュータの判定基準を以下に示す。 
* 過去30日間に、Q&Aカテゴリで回答としてマークされたコメント数をもとに算出する。
*: 貢献度の高いユーザが自動的にトップコントリビュータとして表示される。
 
triage権限を付与することにより、そのユーザは以下の操作が行えるようになる。 
* Q&Aディスカッションで回答をマークする。
* ディスカッションのカテゴリを変更する。
* ディスカッションをピン留めする。
* ディスカッションをロックする。
 
==== コミュニティガイドライン ====
Discussionsを健全に運営するために、コミュニティガイドラインを設定することが推奨される。 
 
ガイドラインの設定場所としては以下が適している。 
* リポジトリの README.md ファイル
*: IssueとDiscussionsの使い分けを明記する。
* CONTRIBUTING.md ファイル
*: コントリビューションのルールと合わせて、Discussionsの利用ルールを記載する。
* Discussionsのウェルカムポスト
*: Discussionsを有効化した時に作成するウェルカムポストにガイドラインを記載する。
 

== 検索とフィルタリング ==
==== 検索方法 ====
Discussionsの検索はタイトル、本文、コメントの内容を対象として実行できる。 
 
検索の手順を以下に示す。 
 
# [Discussions]タブを開く。
# 検索バーにキーワードを入力して、[Enter]キーを押下する。
 
GitHubの全体検索からもDiscussionsを検索できる。 
全体検索では <code>type:discussions</code> フィルタを使用して、Discussionsのみに絞り込むことができる。 
 
# GitHub全体検索でのDiscussions検索例
type:discussions repo:owner/repositoryキーワード
 
==== フィルタリングオプション ====
[Discussions]タブでは、以下に示すフィルタリングオプションを利用できる。 
 
<center>
{| class="wikitable"
|+ フィルタリングオプション一覧
! フィルタ種別 !! オプション !! 説明
|-
| カテゴリ || 各カテゴリ名 || 選択したカテゴリのディスカッションのみを表示する。
|-
| ステータス || 回答済み (Answered) || Q&Aカテゴリで回答がマークされたディスカッションを表示する。
|-
| ステータス || 未回答 (Unanswered) || Q&Aカテゴリで回答がマークされていないディスカッションを表示する。
|-
| ソート || 新着順 (Newest) || 作成日時が新しい順にディスカッションを並べる。
|-
| ソート || 最近更新 (Recently updated) || 最後にコメントや更新があった順に並べる。
|-
| ソート || コメント数 (Most commented) || コメント数が多い順にディスカッションを並べる。
|}
</center>
 

== 推奨事項 ==
Discussionsを効果的に活用するための推奨事項を以下に示す。 
 
* 段階的移行 (DiscussionsからIssueへ)
*: 新しいアイデアや要望は最初にDiscussionsに投稿して議論する。
*: スコープが確定して、具体的な作業として着手が決まった時点でIssueに変換する。
*: この運用により、スコープが不明確なIssueが乱立することを防げる。
* 投票の活用
*: 新機能の候補が複数ある場合、Pollsカテゴリで投票を実施してコミュニティの関心度を測定する。
*: 数値データとして優先度の判断材料にできる。
* ガイドラインの明記
*: README.md または CONTRIBUTING.md でIssueとDiscussionsの使い分けを明記する。
*: 新規コントリビュータが適切な場所に投稿できるよう案内することで、メンテナーのトリアージコストを削減できる。
* Q&Aの回答マークを活用する
*: 有用な回答には積極的に回答マークを付ける。
*: 回答済みのディスカッションが蓄積されることにより、同様の問題を持つユーザが自己解決しやすいナレッジベースが形成される。
* Announcementカテゴリの活用
*: リリース情報、重要な変更、メンテナンス情報は、Announcementカテゴリで投稿する。
*: メンテナーのみが投稿できる形式であるため、重要情報の信頼性を担保できる。
 

== 参考リンク ==
* [https://docs.github.com/en/discussions GitHub Discussions 公式ドキュメント]
* [https://docs.github.com/en/discussions/quickstart GitHub Discussions クイックスタート]
* [https://docs.github.com/en/discussions/managing-discussions-for-your-community Discussions のコミュニティ管理]
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,GitHub,Discussions,Forum,Community,Q&A,Poll,Announcement,Issue,Repository,Open Source,Collaboration
|description={{PAGENAME}} - GitHub Discussions の使い方・設定・モデレーションに関するガイド | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:Git]]

GitHub - Projects

2026-03-23T19:35:15Z

Wiki: /* GraphQL APIによる自動化 */

== 概要 ==
GitHub Projectsは、Issue、Pull Request、ドラフトアイテムをテーブル・ボード・ロードマップの複数ビューで一元管理する統合プロジェクト管理ツールである。 
 
スプレッドシート形式のテーブルビュー、カンバン形式のボードビュー、タイムライン形式のロードマップビューを切り替えながら、チームの作業状況を多角的に把握できる。 
 
GitHub Projectsが提供する主な機能は以下の通りである。 
* テーブル / ボード / ロードマップビュー
*: 1つのプロジェクトに対して複数のビューを作成して、目的に応じた形式で作業状況を確認できる。
* カスタムフィールド
*: テキスト、数値、日付、単一選択、イテレーションの最大50個のフィールドを追加して、プロジェクト固有の情報を管理できる。
* 自動化
*: 組み込みワークフローやGitHub Actions、GraphQL APIを利用して、アイテムの追加やステータス変更を自動化できる。
 
プロジェクトには最大50,000アイテムを登録でき、アーカイブ機能によってカスタムフィールドのデータを保持したまま表示から除外できる。 
 

== プロジェクトの作成 ==
==== ユーザプロジェクトの作成 ====
ユーザ個人のプロジェクトを作成する手順を以下に示す。 
 
# GitHubの右上にあるプロフィールアイコンを選択する。
# メニューから[Your projects]を選択する。
# Projectsページで[New project]ボタンを押下する。
# プロジェクトのタイプ (Table / Roadmap / Board) を選択する。
# プロジェクト名を入力して、[Create project]ボタンを押下する。
 
==== 組織プロジェクトの作成 ====
組織 (Organization) 配下にプロジェクトを作成する手順を以下に示す。 
 
# GitHubで対象の組織ページを開く。
# [Projects]タブを選択する。
# [New project]ボタンを押下する。
# プロジェクトのタイプとプロジェクト名を入力して、[Create project]ボタンを押下する。
 
組織プロジェクトは、組織内の複数リポジトリをまたいで、Issue や Pull Requestを管理できる。 
 
==== プロジェクトテンプレート ====
新規プロジェクト作成時にテンプレートを選択することにより、ビュー構成やカスタムフィールドをすぐに利用できる。 
 
テンプレートの種類は以下の通りである。 
* プリセットテンプレート
*: GitHubが公式に提供するテンプレートで、スプリント計画、バグ管理、フィーチャーリクエスト等のユースケースに対応している。
* 組織テンプレート
*: 組織内で作成・登録されたカスタムテンプレートを選択できる。
 
下表に、テンプレートからプロジェクトを作成した場合にコピーされる要素とコピーされない要素を示す。 
 
<center>
{| class="wikitable"
|+ テンプレートコピーの対象
! コピーされる要素 !! コピーされない要素
|-
| ビュー構成 || アイテム (Issue / PR)
|-
| カスタムフィールドの定義 || コラボレータの設定
|-
| ドラフト問題 || リポジトリリンク
|-
| ワークフローの設定 || -
|-
| インサイト (チャート設定) || -
|}
</center>
 
==== プロジェクトの設定 ====
作成後のプロジェクトは、[Settings]から各種設定を変更できる。 
 
<center>
{| class="wikitable"
|+ プロジェクトの基本設定
|-
! 項目 !! 説明
|-
| タイトル || プロジェクトの表示名を変更する。
|-
| 説明(README) || プロジェクトの概要や使い方をMarkdownで記述できる。
|-
| 可視性 || Public(公開)または Private(非公開)を選択する。 組織プロジェクトの場合は組織のメンバーのみに公開することもできる。
|-
| アクセス権 || コラボレータをロール (Read / Write / Admin) 付きで招待できる。 組織プロジェクトはベースロールを設定して組織メンバー全体に権限を付与できる。
|}
</center>
 

== アイテムの管理 ==
==== アイテムの追加 ====
プロジェクトへのアイテム追加方法は複数用意されている。 
 
<center>
{| class="wikitable"
|+ プロジェクトへのアイテム追加方法
|-
! 方法 !! 説明
|-
| URLの貼り付け || テーブルまたはボードビューの下部にある[Add item]フィールドに、Issue または Pull RequestのURLを貼り付けて追加する。
|-
| # 入力によるリポジトリ選択 || [Add item]フィールドで <code>#</code> を入力するとリポジトリ一覧が表示される。 リポジトリを選択後、Issue または Pull Requestを検索して追加する。
|-
| Issue / PR サイドバーからの追加 || Issue または Pull Requestの詳細ページにある右サイドバーの[Projects]セクションから直接プロジェクトへ追加できる。
|-
| 一括追加 || [Add item] - [Add items from repository]を選択して、フィルタ条件を指定することで複数のIssue / PRを1度に追加できる。
|}
</center>
 
==== ドラフトアイテム ====
ドラフトアイテムは、プロジェクト限定の仮Issueとして作成できるアイテムである。 
 
リポジトリにIssueを作成する前の段階でアイデアやタスクを記録しておく用途に適している。 
 
ドラフトアイテムは後から通常のIssueに変換できる。 
変換するには、ドラフトアイテムの詳細パネルを開き、[Convert to issue]ボタンを押下して対象リポジトリを指定する。 
 
==== 編集・削除・アーカイブ ====
テーブルビューでのセル編集手順を以下に示す。 
 
# テーブルビューで対象のセルを選択する。
# 値を直接入力または選択する。
# [Enter]キーまたはセル外を選択して確定する。
 
一括編集の操作方法を以下に示す。 
* コピー & ペースト
*: 複数のセルを選択して [Cmd] + [C]キー (macOS) または [Ctrl] + [C]キー (Windows / Linux) でコピーして、[Cmd] + [V]キーまたは [Ctrl] + [V]キーで貼り付ける。
* ドラッグによる複製
*: セルの右下に表示される青いハンドルをドラッグすることで、値を隣接するセルに複製できる。
* 複数セルの削除
*: 複数のセルを選択して、[Delete]キーで値を削除する。
 
操作を誤った場合は、ページ上部の[Undo]ボタンで直前の変更を取り消すことができる。 
 
アーカイブはアイテムをプロジェクトの表示から除外する機能である。 
アーカイブされたアイテムはカスタムフィールドのデータを保持したまま、[Settings] - [Archived items]ページから確認・復元できる。 
 
==== 一括操作 ====
テーブルビューでは複数アイテムを選択して一括操作を実行できる。 
 
# 行の左端にあるチェックボックスを選択して、複数アイテムを選択する。
# 画面上部に表示される操作バーから、ステータス変更・フィールド更新・アーカイブ・削除等の操作を実行する。
 

== ビュー ==
==== テーブルビュー ====
テーブルビューはスプレッドシート形式でアイテムを管理するビューである。 
 
各行がアイテム (Issue / PR / ドラフト) を表し、各列がフィールドに対応する。 
セルを選択して値を直接編集でき、列の追加・非表示・並べ替えを自由にカスタマイズできる。 
 
大量のアイテムを一覧で把握しながら効率的に編集する用途に最適である。 
 
==== ボードビュー (Kanban) ====
ボードビューはカンバン形式でアイテムをカード表示するビューである。 
 
アイテムをドラッグ&ドロップで別のカラムに移動することでステータスを更新できる。 
カラムは単一選択フィールドの各オプションに対応しており、デフォルトでは[Status]フィールドを基準に表示される。 
 
ステータスの変遷を視覚的に追跡するスクラム・カンバン管理に最適である。 
 
==== ロードマップビュー ====
ロードマップビューはタイムライン形式でアイテムをガントチャート的に表示するビューである。 
 
日付フィールド (開始日・終了日) を軸にしてアイテムの期間をバー表示する。 
イテレーションフィールドと連携することで、スプリントの進行をタイムライン上で可視化できる。 
 
マイルストーン管理やリリース計画の把握に最適である。 
 
==== ビューのカスタマイズ ====
各ビューはそれぞれ独立して設定を保存できる。 
 
<center>
{| class="wikitable"
|+ ビューのカスタマイズ機能
|-
! 機能 !! 説明
|-
| フィルタ || 特定の条件に合致するアイテムのみを表示する。
|-
| ソート || 指定したフィールドの値で昇順・降順に並べ替える。
|-
| グループ化 || 指定したフィールドの値でアイテムをグループに分けて表示する。
|-
| 表示フィールドの選択 || 表示する列を選択して不要なフィールドを非表示にする。
|}
</center>
 
ビューの設定は、[Save changes]ボタンを押下することで保存される。 
 
保存前は変更内容がビュー名の右側に表示される。 
 

== カスタムフィールド ==
==== フィールドの種類 ====
下表に、GitHub Projectsで作成できるカスタムフィールドの種類を示す。 
 
<center>
{| class="wikitable"
|+ カスタムフィールドの種類
! フィールド種類 !! 説明 !! 主な用途
|-
| テキスト || 任意のテキストを入力するフィールド || メモ、補足説明
|-
| 数値 || 数値を入力するフィールド || ストーリーポイント、見積工数
|-
| 日付 || カレンダーから日付を選択するフィールド || 期日、リリース予定日
|-
| 単一選択 || ドロップダウンから1つの値を選択するフィールド 色や説明を設定できる。 || 優先度、カテゴリ
|-
| イテレーション || 時間枠 (スプリント) に関連付けるフィールド || スプリント管理
|}
</center>
 
==== 組み込みフィールド ====
GitHub Projectsには、デフォルトで用意されている組み込みフィールドがある。 
 
<center>
{| class="wikitable"
|+ プロジェクトの主な組み込みフィールド
|-
! フィールド !! 説明
|-
| Status || アイテムの進捗状態を管理するフィールド デフォルトで Todo / In Progress / Done の3つのオプションが用意されている。
|-
| Assignees || アイテムに割り当てられた担当者を表示するフィールド
|-
| Labels || Issue / PRに設定されたラベルを表示するフィールド
|-
| 親課題 (Parent issue) || Sub-issues機能を使用している場合に親Issueを表示するフィールド
|-
| Sub-issues progress || 親課題の配下にあるSub-issuesの完了率を表示するフィールド
|-
| リンク済みPR (Linked pull requests) || Issueに紐付けられたPull Requestを表示するフィールド
|-
| レビュアー (Reviewers) || Pull Requestのレビュアーを表示するフィールド
|-
| 課題タイプ (Issue type) || Issueの種類 (Bug / Feature / Task等) を表示するフィールド
|}
</center>
 
==== フィールドの作成 ====
新しいカスタムフィールドを作成する手順を以下に示す。 
 
# テーブルビューの列ヘッダ右端にある[+]ボタンを押下する。
# [New field]を選択する。
# フィールド名を入力する。
# フィールドの種類 (テキスト / 数値 / 日付 / 単一選択 / イテレーション) を選択する。
# 単一選択の場合は選択肢を追加して、必要に応じて色と説明を設定する。
# [Create]ボタンを押下して、フィールドを作成する。
 
1つのプロジェクトに作成できるカスタムフィールドの上限は50個である。 
 

== フィルタリング・ソート・グループ化 ==
==== フィルタ構文 ====
ビューのフィルタフィールドに構文を入力することにより、表示するアイテムを絞り込める。 
 
下表に、主なフィルタ構文を示す。 
 
<center>
{| class="wikitable"
|+ フィルタ構文一覧
! 構文 !! 説明 !! 例
|-
| <code>is:open</code> / <code>is:closed</code> || Issue の状態でフィルタリングする || is:open
|-
| <code>is:merged</code> / <code>is:draft</code> || PR の状態でフィルタリングする || is:merged
|-
| <code>is:issue</code> / <code>is:pr</code> || アイテムの種類でフィルタリングする || is:issue
|-
| <code>label:</code> || 指定したラベルを持つアイテムを絞り込む || label:bug
|-
| <code>assignee:</code> || 指定したユーザが担当するアイテムを絞り込む || assignee:@me
|-
| <code>no:</code> || 指定フィールドが未設定のアイテムを絞り込む || no:assignee
|-
| <code>reason:</code> || クローズの理由でフィルタリングする || reason:completed
|-
| <code>updated:</code> || 更新日でフィルタリングする || updated:>2024-01-01
|}
</center>
 
フィルタ構文の先頭に <code>-</code> を付加することにより、否定条件として使用できる。 
例: <code>-label:bug</code> は、bugラベルが付加されていないアイテムを表示する。 
 
複数の条件をスペースで区切って組み合わせることができる。 
例: <code>is:open assignee:@me label:bug</code> 
 
==== ソートとグループ化 ====
ビューの表示順序や分類をカスタマイズできる。 
 
* ソート
*: 列ヘッダをクリックする、または、ビューメニューの[Sort]オプションから対象フィールドと昇順・降順を指定する。
*: 複数フィールドによる複合ソートも設定できる。
* グループ化
*: ビューメニューの[Group by]オプションから対象フィールドを指定する。
*: 単一選択フィールドやイテレーションフィールドでグループ化すると、カテゴリ別にアイテムをまとめて表示できる。
 

== ワークフロー自動化 ==
==== 組み込みワークフロー ====
GitHub Projectsには設定するだけで利用できる組み込みワークフローが用意されている。 
 
* Auto-add to project
*: 指定したリポジトリでIssue または Pull Requestが作成・更新された時に、フィルタ条件に合致する場合に自動的にプロジェクトへ追加するワークフローである。
*: ワークフローの設定上限はプランによって異なる。
* Auto-archive items
*: 条件 (クローズから一定期間経過等) に合致したアイテムを自動的にアーカイブするワークフローである。
*: アーカイブ後もカスタムフィールドのデータは保持される。
 
下表に、Auto-add to projectワークフローの設定上限を示す。 
 
<center>
{| class="wikitable"
|+ Auto-add to project の設定上限 (プラン別)
! プラン !! 設定上限数
|-
| Free || 1
|-
| Pro / Team || 5
|-
| Enterprise || 20
|}
</center>
 
既存のアイテムはワークフロー有効化後に自動追加されない。 
新規に作成・更新されたアイテムのみが追加対象となる。 
 
==== GitHub Actionsとの連携 ====
GitHub Actionsワークフローを使用して、より柔軟なプロジェクト自動化を実現できる。 
 
GitHubが公式に提供するアクション <code>actions/add-to-project</code> を利用することにより、イベントをトリガーにしてアイテムの追加やフィールドの更新を自動化できる。 
 
以下の例では、Issueが作成された際に指定したプロジェクトへ自動追加する設定を示している。 
<code>github-token</code> には <code>repo</code> および <code>project</code> スコープを持つPersonal Access Token (PAT) を設定する。 
 
<syntaxhighlight lang="yaml">
name: Add issue to project
on:
issues:
types:
- opened
jobs:
add-to-project:
runs-on: ubuntu-latest
steps:
- uses: actions/add-to-project@v1.0.2
with:
project-url: https://github.com/orgs/YOUR_ORG/projects/1
github-token: ${{ secrets.ADD_TO_PROJECT_PAT }}
</syntaxhighlight>
 
==== GraphQL APIによる自動化 ====
GitHub GraphQL APIを使用して、プロジェクトをプログラムから操作できる。 
 
APIを使用するために必要なスコープは以下の通りである。 
 
<center>
{| class="wikitable"
|+ プロジェクトAPIに必要なスコープ
|-
! スコープ !! 説明
|-
| <code>read:project</code> || プロジェクト情報の読み取り(クエリ)に使用する。
|-
| <code>project</code> || プロジェクト情報の書き込み (ミューテーション) に使用する。
|}
</center>
 
認証方法は、PAT (Personal Access Token) または GitHub Appsトークンを使用する。 
 
プロジェクトのアイテム一覧を取得するクエリの例を以下に示す。 
 
query {
node(id: "PROJECT_ID") {
... on ProjectV2 {
items(first: 20) {
nodes {
id
fieldValues(first: 8) {
nodes {
... on ProjectV2ItemFieldTextValue {
text
field { ... on ProjectV2FieldCommon { name } }
}
... on ProjectV2ItemFieldSingleSelectValue {
name
field { ... on ProjectV2FieldCommon { name } }
}
}
}
}
}
}
}
}
 

== イテレーション ==
==== イテレーションフィールドの設定 ====
イテレーションフィールドを使用することにより、スプリントやタイムボックスを定義してアイテムを関連付けられる。 
 
イテレーションフィールドの作成手順を以下に示す。 
 
# テーブルビューの列ヘッダ右端にある[+]ボタンを押下する。
# [New field]を選択し、フィールド種類で[Iteration]を選択する。
# 以下の項目を設定する。
## 開始日 (Start date)
##: イテレーションの開始日を指定する。
## 期間 (Duration)
##: イテレーションの長さを日数または週数で指定する。
# [Save]ボタンを押下すると、開始日と期間をもとに自動的に3つのイテレーションが作成される。
 
イテレーション設定では休憩期間 (Break) を挿入することもできる。 
 
休憩期間は祝日や連休等、スプリントを行わない期間を表現する時に使用する。 
 
==== スプリント計画への活用 ====
イテレーションフィールドを作成すると、以下の特殊な検索キーワードで現在・次回のスプリントを参照できる。 
 
* <code>@current</code>
*: 現在進行中のイテレーションに属するアイテムを絞り込む。
*: 例: フィルタに iteration:@current を入力する。
* <code>@next</code>
*: 次のイテレーションに属するアイテムを絞り込む。
*: 例: フィルタに iteration:@next を入力する。
 
ロードマップビューでイテレーションフィールドを日付の基準に設定すると、スプリントの期間をタイムライン上に視覚的に表示できる。 
 

== インサイト ==
==== カスタムチャートの作成 ====
インサイト機能を使用することにより、プロジェクトのデータを集計したグラフを作成・共有できる。 
 
チャートを作成する手順を以下に示す。 
 
# プロジェクトページの上部にある[Insights]タブを選択する。
# [New chart]ボタンを押下する。
# チャートの種類 (棒グラフ、円グラフ等) を選択する。
# X軸、Y軸、グループ化に使用するフィールドを選択する。
# 必要に応じてフィルタ条件を設定する。
# [Save changes]ボタンを押下してチャートを保存する。
 
インサイトで作成できるチャートの活用例を以下に示す。 
* 優先度別アイテム数
*: 単一選択フィールド (優先度) をX軸に設定して、各優先度に属するアイテム数を棒グラフで確認する。
* ステータス別進捗
*: [Status]フィールドをX軸に設定して、各ステータスのアイテム数を円グラフで確認する。
* 担当者別ワークロード
*: [Assignees]フィールドをX軸に設定して、各担当者が抱えるアイテム数を棒グラフで確認する。
* イテレーション別消化量
*: イテレーションフィールドをX軸、数値フィールド (ポイント) をY軸に設定して、スプリントごとの消化ポイントを確認する。
 

{{#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]]

GitHub - Projects

2026-03-23T19:34:39Z

Wiki: ページの作成:「== 概要 == GitHub Projectsは、Issue、Pull Request、ドラフトアイテムをテーブル・ボード・ロードマップの複数ビューで一元管理する統合プロジェクト管理ツールである。 スプレッドシート形式のテーブルビュー、カンバン形式のボードビュー、タイムライン形式のロードマップビューを切り替えながら、チームの作業状況を多角的に把握できる。 …」

== 概要 ==
GitHub Projectsは、Issue、Pull Request、ドラフトアイテムをテーブル・ボード・ロードマップの複数ビューで一元管理する統合プロジェクト管理ツールである。 
 
スプレッドシート形式のテーブルビュー、カンバン形式のボードビュー、タイムライン形式のロードマップビューを切り替えながら、チームの作業状況を多角的に把握できる。 
 
GitHub Projectsが提供する主な機能は以下の通りである。 
* テーブル / ボード / ロードマップビュー
*: 1つのプロジェクトに対して複数のビューを作成して、目的に応じた形式で作業状況を確認できる。
* カスタムフィールド
*: テキスト、数値、日付、単一選択、イテレーションの最大50個のフィールドを追加して、プロジェクト固有の情報を管理できる。
* 自動化
*: 組み込みワークフローやGitHub Actions、GraphQL APIを利用して、アイテムの追加やステータス変更を自動化できる。
 
プロジェクトには最大50,000アイテムを登録でき、アーカイブ機能によってカスタムフィールドのデータを保持したまま表示から除外できる。 
 

== プロジェクトの作成 ==
==== ユーザプロジェクトの作成 ====
ユーザ個人のプロジェクトを作成する手順を以下に示す。 
 
# GitHubの右上にあるプロフィールアイコンを選択する。
# メニューから[Your projects]を選択する。
# Projectsページで[New project]ボタンを押下する。
# プロジェクトのタイプ (Table / Roadmap / Board) を選択する。
# プロジェクト名を入力して、[Create project]ボタンを押下する。
 
==== 組織プロジェクトの作成 ====
組織 (Organization) 配下にプロジェクトを作成する手順を以下に示す。 
 
# GitHubで対象の組織ページを開く。
# [Projects]タブを選択する。
# [New project]ボタンを押下する。
# プロジェクトのタイプとプロジェクト名を入力して、[Create project]ボタンを押下する。
 
組織プロジェクトは、組織内の複数リポジトリをまたいで、Issue や Pull Requestを管理できる。 
 
==== プロジェクトテンプレート ====
新規プロジェクト作成時にテンプレートを選択することにより、ビュー構成やカスタムフィールドをすぐに利用できる。 
 
テンプレートの種類は以下の通りである。 
* プリセットテンプレート
*: GitHubが公式に提供するテンプレートで、スプリント計画、バグ管理、フィーチャーリクエスト等のユースケースに対応している。
* 組織テンプレート
*: 組織内で作成・登録されたカスタムテンプレートを選択できる。
 
下表に、テンプレートからプロジェクトを作成した場合にコピーされる要素とコピーされない要素を示す。 
 
<center>
{| class="wikitable"
|+ テンプレートコピーの対象
! コピーされる要素 !! コピーされない要素
|-
| ビュー構成 || アイテム (Issue / PR)
|-
| カスタムフィールドの定義 || コラボレータの設定
|-
| ドラフト問題 || リポジトリリンク
|-
| ワークフローの設定 || -
|-
| インサイト (チャート設定) || -
|}
</center>
 
==== プロジェクトの設定 ====
作成後のプロジェクトは、[Settings]から各種設定を変更できる。 
 
<center>
{| class="wikitable"
|+ プロジェクトの基本設定
|-
! 項目 !! 説明
|-
| タイトル || プロジェクトの表示名を変更する。
|-
| 説明(README) || プロジェクトの概要や使い方をMarkdownで記述できる。
|-
| 可視性 || Public(公開)または Private(非公開)を選択する。 組織プロジェクトの場合は組織のメンバーのみに公開することもできる。
|-
| アクセス権 || コラボレータをロール (Read / Write / Admin) 付きで招待できる。 組織プロジェクトはベースロールを設定して組織メンバー全体に権限を付与できる。
|}
</center>
 

== アイテムの管理 ==
==== アイテムの追加 ====
プロジェクトへのアイテム追加方法は複数用意されている。 
 
<center>
{| class="wikitable"
|+ プロジェクトへのアイテム追加方法
|-
! 方法 !! 説明
|-
| URLの貼り付け || テーブルまたはボードビューの下部にある[Add item]フィールドに、Issue または Pull RequestのURLを貼り付けて追加する。
|-
| # 入力によるリポジトリ選択 || [Add item]フィールドで <code>#</code> を入力するとリポジトリ一覧が表示される。 リポジトリを選択後、Issue または Pull Requestを検索して追加する。
|-
| Issue / PR サイドバーからの追加 || Issue または Pull Requestの詳細ページにある右サイドバーの[Projects]セクションから直接プロジェクトへ追加できる。
|-
| 一括追加 || [Add item] - [Add items from repository]を選択して、フィルタ条件を指定することで複数のIssue / PRを1度に追加できる。
|}
</center>
 
==== ドラフトアイテム ====
ドラフトアイテムは、プロジェクト限定の仮Issueとして作成できるアイテムである。 
 
リポジトリにIssueを作成する前の段階でアイデアやタスクを記録しておく用途に適している。 
 
ドラフトアイテムは後から通常のIssueに変換できる。 
変換するには、ドラフトアイテムの詳細パネルを開き、[Convert to issue]ボタンを押下して対象リポジトリを指定する。 
 
==== 編集・削除・アーカイブ ====
テーブルビューでのセル編集手順を以下に示す。 
 
# テーブルビューで対象のセルを選択する。
# 値を直接入力または選択する。
# [Enter]キーまたはセル外を選択して確定する。
 
一括編集の操作方法を以下に示す。 
* コピー & ペースト
*: 複数のセルを選択して [Cmd] + [C]キー (macOS) または [Ctrl] + [C]キー (Windows / Linux) でコピーして、[Cmd] + [V]キーまたは [Ctrl] + [V]キーで貼り付ける。
* ドラッグによる複製
*: セルの右下に表示される青いハンドルをドラッグすることで、値を隣接するセルに複製できる。
* 複数セルの削除
*: 複数のセルを選択して、[Delete]キーで値を削除する。
 
操作を誤った場合は、ページ上部の[Undo]ボタンで直前の変更を取り消すことができる。 
 
アーカイブはアイテムをプロジェクトの表示から除外する機能である。 
アーカイブされたアイテムはカスタムフィールドのデータを保持したまま、[Settings] - [Archived items]ページから確認・復元できる。 
 
==== 一括操作 ====
テーブルビューでは複数アイテムを選択して一括操作を実行できる。 
 
# 行の左端にあるチェックボックスを選択して、複数アイテムを選択する。
# 画面上部に表示される操作バーから、ステータス変更・フィールド更新・アーカイブ・削除等の操作を実行する。
 

== ビュー ==
==== テーブルビュー ====
テーブルビューはスプレッドシート形式でアイテムを管理するビューである。 
 
各行がアイテム (Issue / PR / ドラフト) を表し、各列がフィールドに対応する。 
セルを選択して値を直接編集でき、列の追加・非表示・並べ替えを自由にカスタマイズできる。 
 
大量のアイテムを一覧で把握しながら効率的に編集する用途に最適である。 
 
==== ボードビュー (Kanban) ====
ボードビューはカンバン形式でアイテムをカード表示するビューである。 
 
アイテムをドラッグ&ドロップで別のカラムに移動することでステータスを更新できる。 
カラムは単一選択フィールドの各オプションに対応しており、デフォルトでは[Status]フィールドを基準に表示される。 
 
ステータスの変遷を視覚的に追跡するスクラム・カンバン管理に最適である。 
 
==== ロードマップビュー ====
ロードマップビューはタイムライン形式でアイテムをガントチャート的に表示するビューである。 
 
日付フィールド (開始日・終了日) を軸にしてアイテムの期間をバー表示する。 
イテレーションフィールドと連携することで、スプリントの進行をタイムライン上で可視化できる。 
 
マイルストーン管理やリリース計画の把握に最適である。 
 
==== ビューのカスタマイズ ====
各ビューはそれぞれ独立して設定を保存できる。 
 
<center>
{| class="wikitable"
|+ ビューのカスタマイズ機能
|-
! 機能 !! 説明
|-
| フィルタ || 特定の条件に合致するアイテムのみを表示する。
|-
| ソート || 指定したフィールドの値で昇順・降順に並べ替える。
|-
| グループ化 || 指定したフィールドの値でアイテムをグループに分けて表示する。
|-
| 表示フィールドの選択 || 表示する列を選択して不要なフィールドを非表示にする。
|}
</center>
 
ビューの設定は、[Save changes]ボタンを押下することで保存される。 
 
保存前は変更内容がビュー名の右側に表示される。 
 

== カスタムフィールド ==
==== フィールドの種類 ====
下表に、GitHub Projectsで作成できるカスタムフィールドの種類を示す。 
 
<center>
{| class="wikitable"
|+ カスタムフィールドの種類
! フィールド種類 !! 説明 !! 主な用途
|-
| テキスト || 任意のテキストを入力するフィールド || メモ、補足説明
|-
| 数値 || 数値を入力するフィールド || ストーリーポイント、見積工数
|-
| 日付 || カレンダーから日付を選択するフィールド || 期日、リリース予定日
|-
| 単一選択 || ドロップダウンから1つの値を選択するフィールド 色や説明を設定できる。 || 優先度、カテゴリ
|-
| イテレーション || 時間枠 (スプリント) に関連付けるフィールド || スプリント管理
|}
</center>
 
==== 組み込みフィールド ====
GitHub Projectsには、デフォルトで用意されている組み込みフィールドがある。 
 
<center>
{| class="wikitable"
|+ プロジェクトの主な組み込みフィールド
|-
! フィールド !! 説明
|-
| Status || アイテムの進捗状態を管理するフィールド デフォルトで Todo / In Progress / Done の3つのオプションが用意されている。
|-
| Assignees || アイテムに割り当てられた担当者を表示するフィールド
|-
| Labels || Issue / PRに設定されたラベルを表示するフィールド
|-
| 親課題 (Parent issue) || Sub-issues機能を使用している場合に親Issueを表示するフィールド
|-
| Sub-issues progress || 親課題の配下にあるSub-issuesの完了率を表示するフィールド
|-
| リンク済みPR (Linked pull requests) || Issueに紐付けられたPull Requestを表示するフィールド
|-
| レビュアー (Reviewers) || Pull Requestのレビュアーを表示するフィールド
|-
| 課題タイプ (Issue type) || Issueの種類 (Bug / Feature / Task等) を表示するフィールド
|}
</center>
 
==== フィールドの作成 ====
新しいカスタムフィールドを作成する手順を以下に示す。 
 
# テーブルビューの列ヘッダ右端にある[+]ボタンを押下する。
# [New field]を選択する。
# フィールド名を入力する。
# フィールドの種類 (テキスト / 数値 / 日付 / 単一選択 / イテレーション) を選択する。
# 単一選択の場合は選択肢を追加して、必要に応じて色と説明を設定する。
# [Create]ボタンを押下して、フィールドを作成する。
 
1つのプロジェクトに作成できるカスタムフィールドの上限は50個である。 
 

== フィルタリング・ソート・グループ化 ==
==== フィルタ構文 ====
ビューのフィルタフィールドに構文を入力することにより、表示するアイテムを絞り込める。 
 
下表に、主なフィルタ構文を示す。 
 
<center>
{| class="wikitable"
|+ フィルタ構文一覧
! 構文 !! 説明 !! 例
|-
| <code>is:open</code> / <code>is:closed</code> || Issue の状態でフィルタリングする || is:open
|-
| <code>is:merged</code> / <code>is:draft</code> || PR の状態でフィルタリングする || is:merged
|-
| <code>is:issue</code> / <code>is:pr</code> || アイテムの種類でフィルタリングする || is:issue
|-
| <code>label:</code> || 指定したラベルを持つアイテムを絞り込む || label:bug
|-
| <code>assignee:</code> || 指定したユーザが担当するアイテムを絞り込む || assignee:@me
|-
| <code>no:</code> || 指定フィールドが未設定のアイテムを絞り込む || no:assignee
|-
| <code>reason:</code> || クローズの理由でフィルタリングする || reason:completed
|-
| <code>updated:</code> || 更新日でフィルタリングする || updated:>2024-01-01
|}
</center>
 
フィルタ構文の先頭に <code>-</code> を付加することにより、否定条件として使用できる。 
例: <code>-label:bug</code> は、bugラベルが付加されていないアイテムを表示する。 
 
複数の条件をスペースで区切って組み合わせることができる。 
例: <code>is:open assignee:@me label:bug</code> 
 
==== ソートとグループ化 ====
ビューの表示順序や分類をカスタマイズできる。 
 
* ソート
*: 列ヘッダをクリックする、または、ビューメニューの[Sort]オプションから対象フィールドと昇順・降順を指定する。
*: 複数フィールドによる複合ソートも設定できる。
* グループ化
*: ビューメニューの[Group by]オプションから対象フィールドを指定する。
*: 単一選択フィールドやイテレーションフィールドでグループ化すると、カテゴリ別にアイテムをまとめて表示できる。
 

== ワークフロー自動化 ==
==== 組み込みワークフロー ====
GitHub Projectsには設定するだけで利用できる組み込みワークフローが用意されている。 
 
* Auto-add to project
*: 指定したリポジトリでIssue または Pull Requestが作成・更新された時に、フィルタ条件に合致する場合に自動的にプロジェクトへ追加するワークフローである。
*: ワークフローの設定上限はプランによって異なる。
* Auto-archive items
*: 条件 (クローズから一定期間経過等) に合致したアイテムを自動的にアーカイブするワークフローである。
*: アーカイブ後もカスタムフィールドのデータは保持される。
 
下表に、Auto-add to projectワークフローの設定上限を示す。 
 
<center>
{| class="wikitable"
|+ Auto-add to project の設定上限 (プラン別)
! プラン !! 設定上限数
|-
| Free || 1
|-
| Pro / Team || 5
|-
| Enterprise || 20
|}
</center>
 
既存のアイテムはワークフロー有効化後に自動追加されない。 
新規に作成・更新されたアイテムのみが追加対象となる。 
 
==== GitHub Actionsとの連携 ====
GitHub Actionsワークフローを使用して、より柔軟なプロジェクト自動化を実現できる。 
 
GitHubが公式に提供するアクション <code>actions/add-to-project</code> を利用することにより、イベントをトリガーにしてアイテムの追加やフィールドの更新を自動化できる。 
 
以下の例では、Issueが作成された際に指定したプロジェクトへ自動追加する設定を示している。 
<code>github-token</code> には <code>repo</code> および <code>project</code> スコープを持つPersonal Access Token (PAT) を設定する。 
 
<syntaxhighlight lang="yaml">
name: Add issue to project
on:
issues:
types:
- opened
jobs:
add-to-project:
runs-on: ubuntu-latest
steps:
- uses: actions/add-to-project@v1.0.2
with:
project-url: https://github.com/orgs/YOUR_ORG/projects/1
github-token: ${{ secrets.ADD_TO_PROJECT_PAT }}
</syntaxhighlight>
 
==== GraphQL APIによる自動化 ====
GitHub GraphQL APIを使用して、プロジェクトをプログラムから操作できる。 
 
APIを使用するために必要なスコープは以下の通りである。 
 
<center>
{| class="wikitable"
|+ プロジェクトAPIに必要なスコープ
|-
! スコープ !! 説明
|-
| <code>read:project</code> || プロジェクト情報の読み取り(クエリ)に使用する。
|-
| <code>project</code> || プロジェクト情報の書き込み (ミューテーション) に使用する。
|}
</center>
 
認証方法は、PAT (Personal Access Token) または GitHub Appsトークンを使用する。 
 
プロジェクトのアイテム一覧を取得するクエリの例を以下に示す。 
 
<syntaxhighlight lang="graphql">
query {
node(id: "PROJECT_ID") {
... on ProjectV2 {
items(first: 20) {
nodes {
id
fieldValues(first: 8) {
nodes {
... on ProjectV2ItemFieldTextValue {
text
field { ... on ProjectV2FieldCommon { name } }
}
... on ProjectV2ItemFieldSingleSelectValue {
name
field { ... on ProjectV2FieldCommon { name } }
}
}
}
}
}
}
}
}
</syntaxhighlight>
 

== イテレーション ==
==== イテレーションフィールドの設定 ====
イテレーションフィールドを使用することにより、スプリントやタイムボックスを定義してアイテムを関連付けられる。 
 
イテレーションフィールドの作成手順を以下に示す。 
 
# テーブルビューの列ヘッダ右端にある[+]ボタンを押下する。
# [New field]を選択し、フィールド種類で[Iteration]を選択する。
# 以下の項目を設定する。
## 開始日 (Start date)
##: イテレーションの開始日を指定する。
## 期間 (Duration)
##: イテレーションの長さを日数または週数で指定する。
# [Save]ボタンを押下すると、開始日と期間をもとに自動的に3つのイテレーションが作成される。
 
イテレーション設定では休憩期間 (Break) を挿入することもできる。 
 
休憩期間は祝日や連休等、スプリントを行わない期間を表現する時に使用する。 
 
==== スプリント計画への活用 ====
イテレーションフィールドを作成すると、以下の特殊な検索キーワードで現在・次回のスプリントを参照できる。 
 
* <code>@current</code>
*: 現在進行中のイテレーションに属するアイテムを絞り込む。
*: 例: フィルタに iteration:@current を入力する。
* <code>@next</code>
*: 次のイテレーションに属するアイテムを絞り込む。
*: 例: フィルタに iteration:@next を入力する。
 
ロードマップビューでイテレーションフィールドを日付の基準に設定すると、スプリントの期間をタイムライン上に視覚的に表示できる。 
 

== インサイト ==
==== カスタムチャートの作成 ====
インサイト機能を使用することにより、プロジェクトのデータを集計したグラフを作成・共有できる。 
 
チャートを作成する手順を以下に示す。 
 
# プロジェクトページの上部にある[Insights]タブを選択する。
# [New chart]ボタンを押下する。
# チャートの種類 (棒グラフ、円グラフ等) を選択する。
# X軸、Y軸、グループ化に使用するフィールドを選択する。
# 必要に応じてフィルタ条件を設定する。
# [Save changes]ボタンを押下してチャートを保存する。
 
インサイトで作成できるチャートの活用例を以下に示す。 
* 優先度別アイテム数
*: 単一選択フィールド (優先度) をX軸に設定して、各優先度に属するアイテム数を棒グラフで確認する。
* ステータス別進捗
*: [Status]フィールドをX軸に設定して、各ステータスのアイテム数を円グラフで確認する。
* 担当者別ワークロード
*: [Assignees]フィールドをX軸に設定して、各担当者が抱えるアイテム数を棒グラフで確認する。
* イテレーション別消化量
*: イテレーションフィールドをX軸、数値フィールド (ポイント) をY軸に設定して、スプリントごとの消化ポイントを確認する。
 

{{#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]]

GitHub - Pull Requests

2026-03-23T17:48:39Z

Wiki: ページの作成:「== 概要 == Pull Request (PR) は、あるブランチで行ったコード変更を別のブランチにマージするよう提案して、 チームメンバーによるレビューとディスカッションを経てリポジトリに統合するためのメカニズムである。 PRを活用することにより、コードの品質向上、知識の共有、バグの早期発見が可能となる。 変更内容は差分 (diff) として可…」

== 概要 ==
Pull Request (PR) は、あるブランチで行ったコード変更を別のブランチにマージするよう提案して、 
チームメンバーによるレビューとディスカッションを経てリポジトリに統合するためのメカニズムである。 
 
PRを活用することにより、コードの品質向上、知識の共有、バグの早期発見が可能となる。 
変更内容は差分 (diff) として可視化され、レビュアーはコメントや提案を通じてフィードバックを提供できる。 
 
PRページは、下表に示す4つのタブで構成される。 
 
<center>
{| class="wikitable"
|+ Pull Requestのタブ
|-
! タブ !! 説明
|-
| Conversation || コメント、レビュー、イベントのタイムライン
|-
| Commits || PRに含まれるコミットの一覧
|-
| Checks || CI/CDやステータスチェックの結果
|-
| Files changed || 変更されたファイルの差分表示
|}
</center>
 

== 開発モデル ==
GitHubでは、PRを活用する開発モデルとして主に2種類が存在する。 
 
<center>
{| class="wikitable"
|+ Pull Requestの主なコラボレーションモデル
|-
! モデル !! 説明
|-
| フォーク & PRモデル || オープンソースプロジェクトに適したモデル 誰でもリポジトリをフォークして変更を加え、元のリポジトリへPRを送ることができる。 貢献者にリポジトリへの直接プッシュ権限を与える必要がない。
|-
| 共有リポジトリモデル || 小規模チームや社内プロジェクトに適したモデル チームメンバーが同一リポジトリに対して直接プッシュ権限を持つ。 フィーチャーブランチを作成してPRを送る運用が一般的である。
|}
</center>
 

== Pull Requestの作成 ==
==== Web UIでの作成 ====
GitHub Web UIからPRを作成する基本的な手順を以下に示す。 
 
# ブランチに変更をプッシュした後、リポジトリページに移動する。
# 表示される通知バナーの[Compare & pull request]ボタンを押下する。
# baseブランチ (マージ先) と compareブランチ (変更元) を選択する。
# タイトルと説明を記入する。
# [Create Pull Request]ボタンを押下してPRを作成する。
 
baseブランチには変更のマージ先となるブランチ (例: main) を指定して、compareブランチには自身が作業したフィーチャーブランチを指定する。 
 
==== ドラフトPull Request ====
ドラフトPRは、作業が進行中であることを示すための機能である。 
レビューの準備が整っていない段階でも、進捗を共有したり早期にフィードバックを得たりする目的で使用できる。 
 
ドラフトPRの特徴は以下の通りである。 
* マージボタンが無効化されており、誤ってマージされる心配がない。
* レビュアーへのレビュー要求通知が自動送信されない。
* 作業内容を早期に共有して、方向性のフィードバックを受けることができる。
 
作成方法は、PR作成画面の[Create Pull Request]ボタン横のドロップダウンから[Create Draft Pull Request]を選択する。 
 
レビュー準備が完了したら、[Conversation]タブ下部の[Mark as ready for review]ボタンを押下することで、通常のPRに昇格できる。 
 
==== PRテンプレート ====
PRテンプレートを設定することで、PR作成時に説明欄へ定型文を自動挿入できる。 
チームで統一したフォーマットのPR説明を記述するよう促すことができる。 
 
* テンプレートファイルの配置場所
*: .github/pull_request_template.md
 
テンプレートの記述例を以下に示す。 
 
<syntaxhighlight lang="md">
## 変更内容


## 変更の理由


## テスト方法


## 関連Issue

</syntaxhighlight>
 
==== PRの説明の書き方 ====
効果的なPRの説明を書くことにより、レビュアーが変更内容を素早く理解できるようになる。 
 
PRの説明に含めると良い項目を以下に示す。 
* 変更の概要
*: 何を変更したか、なぜ変更が必要だったかを簡潔に説明する。
* 変更の影響範囲
*: どのコンポーネントやファイルに影響するかを明記する。
* テスト方法
*: レビュアーが動作確認できるよう、手順を記述する。
* スクリーンショット
*: UIの変更がある場合は、変更前後のスクリーンショットを添付する。
* 関連Issue
*: 関連するIssueやチケット番号を記載する。
 

== コードレビュー ==
==== レビューの依頼 ====
PRの右側パネルにある[Reviewers]セクションから、レビューを依頼するユーザまたはチームを選択できる。 
 
GitHubは、git blameのデータを分析して、変更されたコードに関連する知識を持つ可能性が高い貢献者をレビュアー候補として自動提案する。 
 
レビュー依頼を受けたユーザには通知が送信され、レビュー待ちの状態としてマークされる。 
 
==== レビューコメント ====
レビュアーはPRに対して複数の種類のコメントを残すことができる。 
 
* 一般コメント
*: [Conversation]タブのコメント欄から投稿する。
*: PR全体に対するフィードバックや質問に使用する。
* 行コメント
*: [Files changed]タブで特定のコード行にカーソルを合わせ、表示される[+]アイコンを選択して投稿する。
*: 特定のコード箇所に対する具体的な指摘に使用する。
* 提案 (Suggestion)
*: 行コメントの入力欄にある[Add a suggestion]ボタンを使用して記述する。
*: PR作成者が直接コードを修正・適用できる形式でコード変更を提案できる。
 
==== レビューステータス ====
レビュアーはフィードバックを送信する場合に、下表に示す3つのステータスのいずれかを選択する。 
 
<center>
{| class="wikitable"
|+ レビューステータス一覧
! ステータス !! 説明 !! 用途
|-
| Comment || フィードバックのみ || マージの承認も拒否もしない場合に使用する。 質問や軽微な提案に適している。
|-
| Approve || マージ承認 || 変更内容に問題がなく、マージを承認する場合に使用する。
|-
| Request changes || 修正要求 || マージ前に修正が必要な問題がある場合に使用する。 修正が完了するまでマージがブロックされる。
|}
</center>
 
==== CODEOWNERSによる自動レビュー ====
CODEOWNERSファイルを設定することにより、特定のファイルやディレクトリの変更に対してレビュアーを自動的にアサインできる。 
 
* ファイルの配置場所
*: .github/CODEOWNERS
 
CODEOWNERSファイルの記述例を以下に示す。 
 
# 全てのファイルのオーナーを設定する
* @global-owner1 @global-owner2

# JavaScriptファイルのオーナーを設定する
*.js @js-owner

# docsディレクトリのオーナーを設定する
/docs/ @docsteam
 
CODEOWNERSファイルの特徴と注意事項を以下に示す。 
* パターンマッチングは .gitignore と同様の構文を使用する。
* ファイルサイズは、3[MB]未満に制限されている。
* リポジトリの[Settings] - [Branches]から[Require code owner review]を有効化することにより、CODEOWNERSに指定されたオーナーのレビューを必須にできる。
 
==== Suggested Changesの適用 ====
レビュアーが提案 (Suggestion) を送信した場合、PR作成者はコメント上のボタンから直接コードに変更を適用できる。 
 
適用方法には以下の2種類がある。 
* 個別適用
*: 各Suggestionコメントの[Commit suggestion]ボタンを押下して、提案を1件ずつ適用する。
* 一括適用
*: 各Suggestionコメントの[Add suggestion to batch]ボタンを押下して複数の提案をまとめ、後から一括でコミットする。
 
Suggested Changesを適用してコミットすると、提案を行ったレビュアーが自動的にそのコミットのco-author (共同著者) として追加される。 
 

== ステータスチェック ==
==== ステータスチェックとは ====
ステータスチェックは、PRがマージされる前に自動的に実行される検証プロセスである。 
テストの実行、コードのリント、ビルドの成功確認等、コードの品質を担保するための条件を自動チェックできる。 
 
ステータスチェックの結果はPRの[Conversation]タブに表示され、各チェックの成否を確認できる。 
 
==== 必須ステータスチェック ====
特定のステータスチェックが全てパスした場合のみマージを許可する設定が可能である。 
 
設定手順を以下に示す。 
 
# リポジトリの[Settings]タブに移動する。
# [Branches]セクションを選択する。
# 保護対象のブランチのルールを編集する。
# [Require status checks to pass before merging]を有効化する。
# 必須とするチェック項目を選択する。
 
==== GitHub Actionsとの連携 ====
GitHub Actionsを使用することにより、PRへのプッシュやPRのオープンをトリガーとしてCI/CDパイプラインを自動実行できる。 
 
PRに対してステータスチェックを実行するワークフローの例を以下に示す。 
 
<syntaxhighlight lang="yaml">
name: CI

on:
pull_request:
branches: [ main ]

jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Run tests
run: npm test
</syntaxhighlight>
 
上記のワークフローは、mainブランチへのPRが作成・更新されるたびに自動実行され、テスト結果がステータスチェックとしてPRに反映される。 
 

== マージ ==
==== マージコミット ====
デフォルトのマージ方式である。 
 
PRブランチの全てのコミットをそのまま保持した上で、マージコミットを1つ追加してベースブランチに統合する。 
 
git merge --no-ff feature-branch
 
* 全てのコミット履歴が保持される。
* マージコミットによりブランチの分岐・合流が履歴上で明確に確認できる。
* 複雑なコミット履歴になる場合がある。
 
==== スカッシュマージ ====
PRブランチの複数のコミットを1つのコミットに圧縮してベースブランチに追加するマージ方式である。 
 
* コミット履歴がシンプルになる。
* 作業中の試行錯誤的なコミットを1つにまとめられる。
* 長期間運用するブランチを再利用する場合、マージ済みコミットのSHAが異なるため注意が必要である。
 
==== リベースマージ ====
PRブランチのコミットをベースブランチの先頭に順番に適用して、線形の履歴を作成するマージ方式である。 
 
* マージコミットが作成されず、線形の履歴が維持される。
* 各コミットには新しいSHAが付与される。
* コンフリクトが発生している場合は使用できない。
 
==== 自動マージ (Auto-merge) ====
必須ステータスチェックの完了およびレビュー承認の条件を満たした時点で、PRを自動的にマージする機能である。 
 
有効化手順を以下に示す。 
 
# PRページの[Enable auto-merge]ボタンを押下する。
# マージ方式 (マージコミット、スカッシュ、リベース) を選択する。
# [Confirm auto-merge]を選択して確定する。
 
必須チェックが全てパスし、必要なレビュー承認が得られると自動的にマージが実行される。 
 
==== マージキュー (Merge Queue) ====
複数のPRを順序立てて安全にマージするための機能である。 
 
各PRを個別にマージするのではなく、キューに追加された順に自動でテストおよびマージを行う。 
 
* 複数PRが同時にマージされることによるコンフリクトリスクを軽減できる。
* マージキューはブランチ保護設定から有効化できる。
* キューに追加されたPRは、前のPRの内容を含んだ状態でテストが実行される。
 
==== マージ後の処理 ====
マージ完了後、PRのソースブランチ (head branch) を自動的に削除する設定が可能である。 
 
設定手順を以下に示す。 
 
# リポジトリの[Settings]タブに移動する。
# [General]セクションの[Pull Requests]項目を確認する。
# [Automatically delete head branches]を有効化する。
 
誤って削除した場合でも、PRページの[Restore branch]ボタンからブランチを復元できる。 
 

== コンフリクトの解決 ==
コンフリクトは、PRのソースブランチとベースブランチの両方で同一ファイルの同一箇所が変更された場合に発生する。 
 
マージ前にコンフリクトを解決する必要がある。 
 
==== Web UIでの解決 ====
行レベルの単純なコンフリクトはGitHub Web UIで解決できる。 
 
# PRページで[Resolve conflicts]ボタンを押下する。
# コンフリクトが発生しているファイルが表示される。
# コンフリクトマーカー (<code><<<<<<<</code>, <code>=======</code>, <code>>>>>>>></code>) を含む箇所を編集して、残すべき変更内容に修正する。
# [Mark as resolved]を選択する。
# 全てのファイルのコンフリクトを解決したら[Commit merge]を選択する。
 
複雑なコンフリクト (バイナリファイルや大規模な変更) はWeb UIでは解決できないため、コマンドを使用する。 
 
==== コマンドラインでの解決 ====
コマンドを使用したコンフリクト解決の手順を以下に示す。 
 
# 1. ベースブランチをチェックアウトして最新の状態に更新する
git checkout main
git pull origin main

# 2. PRのソースブランチをチェックアウトする
git checkout feature-branch

# 3. ベースブランチをマージしてコンフリクトを発生させる
git merge main

# 4. コンフリクトが発生したファイルを手動で編集して解決する
# (エディタでコンフリクトマーカーを削除して修正する)

# 5. 解決済みファイルをステージングする
git add .

# 6. マージコミットを作成する
git commit

# 7. リモートにプッシュする
git push origin feature-branch
 
プッシュ後、GitHubのPRページにコンフリクトが解消されたことが反映される。 
 

== Pull Requestの管理 ==
==== クローズと再オープン ====
PRはマージせずにクローズすることができる。 
作業の中断、方針変更、重複PRの整理等の場合にクローズを行う。 
 
クローズしたPRは、write権限を持つユーザがいつでも再オープンできる。 
再オープン時にはブランチが存在している必要がある。 
 
==== ベースブランチの変更 ====
PR作成後にマージ先のベースブランチを変更できる。 
 
PRページのタイトル横にある[Edit]ボタンを押下して、ベースブランチのドロップダウンから変更先のブランチを選択する。 
 
ベースブランチの変更時には、以下に示す事柄に注意する。 
* 変更後の差分に応じてコミットが追加または削除される場合がある。
* 既存のレビューコメントが無効化される場合がある。
 
==== コミットの追加 ====
オープン中のPRに対して、ソースブランチに新たなコミットをプッシュすることで変更を追加できる。 
 
# 変更を加えてコミットする
git add .
git commit -m "<レビュー指摘の修正>"

# PRのソースブランチにプッシュする
git push origin feature-branch
 
プッシュ後、PRページに新しいコミットが自動的に反映される。 
 
==== リバート ====
マージ済みのPRをリバートして変更を取り消すことができる。 
 
# マージ済みのPRページを開く。
# [Revert]ボタンを押下する。
# 自動的に新しいリバートPRが作成される。
# リバートPRをレビューしてマージする。
 
リバート機能を使用するには、リポジトリへのwrite権限が必要である。 
 

== その他の機能 ==
==== IssueとPRのリンク ====
PRの説明またはコメントにIssueへの参照を記述することにより、IssueとPRをリンクできる。 
 
===== キーワードによる自動クローズ =====
PRがマージされた時点で、関連するIssueを自動的にクローズするキーワードが使用できる。 
 
自動クローズに使用できるキーワードの例を以下に示す。 
* fixes #123
* closes #123
* resolves #123
 
1つのPRで最大10個のIssueを自動クローズできる。 
 
===== 手動リンク =====
自動クローズが不要な場合は、キーワードなしで #issue-number 形式で参照を記述することにより、IssueとPRを手動でリンクできる。 
 
また、PRページの右側パネルにある[Development]セクションからIssueを手動でリンクすることも可能である。 
 
==== 差分表示オプション ====
[Files changed]タブでは、コードの差分表示方法を切り替えられる。 
 
<center>
{| class="wikitable"
|+ 差分表示オプション
! オプション !! 説明
|-
| Unified || 変更前後を上下に並べて表示する。 変更内容の全体の流れが把握しやすい。
|-
| Split || 変更前 (左) と変更後 (右) を左右に並べて表示する。 変更箇所の対比が視覚的にわかりやすい。
|}
</center>
 
表示オプションは、[Files changed]タブの右上にある[Display settings] (歯車アイコン) から切り替えられる。 
 
==== ファイルフィルタリング ====
変更ファイルが多い場合に、特定のファイルに絞り込んで差分を確認できる。 
 
* ファイルツリーナビゲーション
*: Files changedタブ左側のファイルツリーからディレクトリおよびファイルを選択して表示を絞り込む。
* 拡張子フィルタ
*: ファイルタイプ別にフィルタリングして特定の種類のファイルのみ表示する。
* CODEOWNERSフィルタ
*: 自分がオーナーとなっているファイルのみ表示する。
 

{{#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]]

GitHub - Issues

2026-03-23T16:25:17Z

Wiki: ページの作成:「== 概要 == GitHub Issuesは、プロジェクト内のバグ報告、機能リクエスト、タスク管理を一元化するための追跡ツールである。 Issueを活用することによりで、開発チームは作業内容を可視化し、優先度の管理や進捗追跡を効率的に行うことができる。 Issuesが提供する主な機能は以下の通りである。 * バグ報告 *: 再現手順や期待動作を記録…」

== 概要 ==
GitHub Issuesは、プロジェクト内のバグ報告、機能リクエスト、タスク管理を一元化するための追跡ツールである。 
 
Issueを活用することによりで、開発チームは作業内容を可視化し、優先度の管理や進捗追跡を効率的に行うことができる。 
 
Issuesが提供する主な機能は以下の通りである。 
* バグ報告
*: 再現手順や期待動作を記録し、開発者が問題を特定・修正しやすくする。
* 機能リクエスト
*: 新機能の提案や改善要望をチームで議論・評価する場として活用できる。
* タスク管理
*: 開発作業をチケット形式で管理し、担当者・期日・進捗を一元管理する。
* ドキュメント・質問
*: 仕様の確認や技術的な疑問点を記録し、チーム内の知識を蓄積する。
 
Issueはラベル、マイルストーン、アサイニーと組み合わせることにより、大規模プロジェクトの管理にも対応できる。 
 

== Issueの作成 ==
==== Web UIでの作成 ====
GitHubのWebインターフェースからIssueを作成する手順を以下に示す。 
 
# リポジトリの[Issues]タブを選択する。
# [New issue]ボタンを押下する。
# テンプレートが設定されている場合は一覧から選択して、テンプレートなしで作成する場合は[Open a blank issue]を選択する。
# タイトルと説明 (本文) を入力する。
# 右側バーからラベル、マイルストーン、アサイニーを必要に応じて設定する。
# [Submit new issue]ボタンを選択して、Issueを作成する。
 
本文はMarkdown記法で記述でき、コードブロック、画像、リンクの挿入が可能である。 
 
==== GitHub CLIでの作成 ====
GitHub CLIを使用すると、コマンドの実行によりIssueを作成できる。 
 
基本的な作成コマンドを以下に示す。 
 
gh issue create --title "<タイトル>" --body "<説明>"
 
オプションを指定した例を以下に示す。 
 
gh issue create \
--title "バグ: ログイン時にエラーが発生する" \
--body "再現手順: ..." \
--assignee @me \
--label bug \
--milestone "v1.0"
 
下表に、主なオプションを示す。 
 
<center>
{| class="wikitable"
|+ gh issue create オプション一覧
! オプション !! 説明
|-
| <code>--title</code> || Issueのタイトルを指定する。
|-
| <code>--body</code> || Issueの本文を指定する。
|-
| <code>--assignee</code> || 担当者を指定する。 <code>@me</code> で自分自身を指定できる。
|-
| <code>--label</code> || ラベルを指定する。 複数指定する場合はカンマ区切りで指定する。
|-
| <code>--milestone</code> || マイルストーンを指定する。
|-
| <code>--web</code> || Webブラウザを開いて、Issue作成フォームを表示する。
|}
</center>
 
==== URLクエリパラメータによる事前入力 ====
Issue 作成フォームのURLにクエリパラメータを付与することで、フォームの各フィールドを事前入力した状態で開くことができる。 
 
パラメータ付きURLの例を以下に示す。 
 
<syntaxhighlight lang="bash">
https://github.com/owner/repo/issues/new?title=バグ報告&labels=bug,enhancement&assignees=username
</syntaxhighlight>
 
下表に、利用可能なクエリパラメータを示す。 
 
<center>
{| class="wikitable"
|+ URLクエリパラメータ一覧
! パラメータ !! 説明 !! 例
|-
| <code>title</code> || Issueタイトルを事前入力する。 || ?title=バグ報告
|-
| <code>body</code> || Issue本文を事前入力する。 || ?body=再現手順を記載
|-
| <code>labels</code> || ラベルをカンマ区切りで指定する。 || ?labels=bug,enhancement
|-
| <code>assignees</code> || 担当者のユーザ名を指定する。 || ?assignees=username
|-
| <code>milestone</code> || マイルストーン名を指定する。 || ?milestone=v1.0
|-
| <code>template</code> || 使用するテンプレートファイル名を指定する。 || ?template=bug_report.md
|}
</center>
 
このURLをドキュメントやREADMEに掲載することにより、ユーザが適切な情報を入力しやすくなる。 
 

== Issueテンプレート ==
==== Markdownテンプレート ====
Markdown テンプレートを使用すると、Issue作成時に定型のフォームを提供できる。 
 
テンプレートは .github/ISSUE_TEMPLATE/ ディレクトリ内に .md ファイルとして配置する。 
 
ディレクトリ構成例を以下に示す。 
 
.github/
└── ISSUE_TEMPLATE/
├── bug_report.md
├── feature_request.md
└── config.yml
 
テンプレートファイルの記述例を以下に示す。 
 
<syntaxhighlight lang="md">
---
name: バグ報告
about: バグを報告するためのテンプレート
title: "[BUG] "
labels: bug
assignees: ""
---

## バグの概要
バグの内容を簡潔に記述してください。

## 再現手順
1. ...
2. ...

## 期待する動作
本来はどのように動作すべきかを記述してください。

## 実際の動作
実際にどのように動作したかを記述してください。

## スクリーンショット
(該当する場合は画像を添付してください)

## 環境
- OS:
- Webブラウザ / バージョン:
</syntaxhighlight>
 
下表に、フロントマターで指定できるフィールドを示す。 
 
<center>
{| class="wikitable"
|+ Issueテンプレート (YAML) の主なフィールド
|-
! フィールド !! 説明
|-
| <code>name</code> || テンプレート選択画面に表示される名前
|-
| <code>about</code> || テンプレート選択画面に表示される説明文
|-
| <code>title</code> || Issueタイトルの初期値
|-
| <code>labels</code> || 自動的に付与するラベル
|-
| <code>assignees</code> || 自動的に割り当てる担当者
|}
</center>
 
==== Issueフォーム (YAML形式) ====
Issueフォームは、YAML形式で定義する構造化フォームである。 
Markdownテンプレートよりも厳密な入力制御が可能で、必須フィールドの設定やドロップダウンの提供ができる。 
 
フォームファイルは .github/ISSUE_TEMPLATE/ ディレクトリ内に .yml ファイルとして配置する。 
 
記述例を以下に示す。 
 
<syntaxhighlight lang="yaml">
name: バグ報告
description: バグを報告するためのフォーム
title: "[BUG] "
labels: ["bug"]
body:
- type: markdown
attributes:
value: |
バグ報告ありがとうございます。
以下のフォームに必要事項を入力してください。

- type: input
id: title
attributes:
label: バグの概要
placeholder: バグを一行で説明してください
validations:
required: true

- type: textarea
id: steps
attributes:
label: 再現手順
description: バグを再現する手順を記載してください
placeholder: |
1. ...
2. ...
validations:
required: true

- type: dropdown
id: severity
attributes:
label: 深刻度
options:
- 低 (軽微な問題)
- 中 (機能に影響する問題)
- 高 (クリティカルな問題)
validations:
required: true

- type: checkboxes
id: checklist
attributes:
label: 確認事項
options:
- label: 同様の Issue が既に報告されていないことを確認しました
required: true
- label: 最新バージョンで問題が発生することを確認しました
</syntaxhighlight>
 
下表に、利用可能なフィールドタイプを示す。 
 
<center>
{| class="wikitable"
|+ フィールドタイプ一覧
! タイプ !! 説明
|-
| <code>markdown</code> || 入力不可の説明文を表示する。 情報提供や注意書きに使用する。
|-
| <code>input</code> || 一行のテキスト入力フィールド
|-
| <code>textarea</code> || 複数行のテキスト入力フィールド
|-
| <code>dropdown</code> || プルダウンメニューから選択するフィールド
|-
| <code>checkboxes</code> || 複数選択可能なチェックボックスフィールド
|}
</center>
 
<code>validations: required: true</code> を指定することで、そのフィールドへの入力を必須にできる。 
 
==== テンプレートチューザーのカスタマイズ ====
.github/ISSUE_TEMPLATE/config.yml ファイルを作成することにより、テンプレート選択画面の動作をカスタマイズできる。 
 
config.ymlファイルの記述例を以下に示す。 
 
<syntaxhighlight lang="yaml">
blank_issues_enabled: false
contact_links:
- name: セキュリティの脆弱性
url: https://example.com/security
about: セキュリティの脆弱性はこちらから報告してください
- name: コミュニティフォーラム
url: https://forum.example.com
about: 一般的な質問はフォーラムをご利用ください
</syntaxhighlight>
 
下表に、config.ymlファイル設定項目を示す。 
 
<center>
{| class="wikitable"
|+ config.yml の主な設定項目
|-
! 項目 !! 説明
|-
| <code>blank_issues_enabled</code> || false に設定すると、テンプレートを使用せずにIssueを作成することを禁止する。 全てのIssueにテンプレートの使用を強制する場合に設定する。
|-
| <code>contact_links</code> || テンプレート選択画面に外部リソースへのリンクを追加する。 セキュリティポリシーページやコミュニティフォーラムへの誘導に利用できる。
|}
</center>
 

== Issueの管理 ==
==== 編集・クローズ・再オープン ====
作成済みの Issue は、権限を持つユーザが編集、クローズ、再オープンを行うことができる。 
 
* 編集
*: Issueの右上メニューから[Edit]を選択して、タイトルや本文を変更して[Update comment]を選択する。
* クローズ
*: Issueページ下部の[Close issue]ボタンを押下して、クローズ時にコメントを追加することもできる。
* 再オープン
*: クローズ済みのIssueで[Reopen issue]ボタンを押下する。
 
GitHub CLIでクローズ、再オープンを行う例を以下に示す。 
 
# Issueをクローズする
gh issue close 123

# Issueを再オープンする
gh issue reopen 123
 
==== Issueの削除 ====
Issue の削除は永続的な操作であり、削除後の復元はできない。 
 
削除権限は以下の通りである。 
 
* 個人所有リポジトリ
*: リポジトリの所有者のみが削除できる。
* 組織所有リポジトリ
*: 組織の管理者 (Admin) またはオーナー (Owner) のみが削除できる。
 
削除はコメントも含めてリポジトリから完全に除去される。 
誤削除を防ぐため、通常はクローズ操作を推奨する。 
 
==== Issueのピン留め ====
リポジトリのIssuesページの上部に最大3つのIssueをピン留めして目立たせることができる。 
 
ピン留めの手順を以下に示す。 
 
# ピン留めしたいIssueを開く。
# 右側バーの[Pin issue]を選択する。
# Issuesページの上部にIssueが固定表示される。
 
ピン留めを解除するには、同じ手順で[Unpin issue]を選択する。 
 
ピン留めは最大3つまでという制限があるため、重要度の高いIssueを選んで設定する。 
 
==== Issueの転送 ====
Issueを別のリポジトリに転送することができる。 
転送できる範囲は同一ユーザまたは同一組織内のリポジトリに限られる。 
 
転送時のデータ保持ルールを以下に示す。 
 
* 保持されるもの
*: コメント、担当者の情報は転送先でも保持される。
* 条件付きで保持されるもの
*: ラベルとマイルストーンは、転送先リポジトリに同名のラベル、マイルストーンが存在する場合のみ保持される。
 
GitHub CLIでの転送例を以下に示す。 
 
gh issue transfer 123 new-owner/new-repo
 

== ラベル ==
==== デフォルトラベル ====
新しく作成されたリポジトリには、以下に示す9つのデフォルトラベルが自動的に設定される。 
 
<center>
{| class="wikitable"
|+ デフォルトラベル一覧
! ラベル名 !! 用途
|-
| <code>bug</code> || 予期しない動作や不具合を示す。
|-
| <code>documentation</code> || ドキュメントの改善や追加が必要であることを示す。
|-
| <code>duplicate</code> || 既存のIssue または Pull Requestと重複していることを示す。
|-
| <code>enhancement</code> || 新機能の追加や既存機能の改善を示す。
|-
| <code>good first issue</code> || 初めてコントリビュートする人に適したIssueであることを示す。
|-
| <code>help wanted</code> || メンテナーがコミュニティの協力を求めていることを示す。
|-
| <code>invalid</code> || Issueの内容が正確でないまたは無効であることを示す。
|-
| <code>question</code> || 質問や調査が必要なIssueであることを示す。
|-
| <code>wontfix</code> || このIssueへの対応を行わないことを示す。
|}
</center>
 
==== カスタムラベルの管理 ====
プロジェクト固有のラベルを作成・編集・削除することができる。 
 
ラベル管理画面へのアクセス手順を以下に示す。 
 
# リポジトリの[Settings]を開く。
# 左メニューから[Issues]を選択する。
# [Labels]セクションで[New label]を選択する。
# ラベル名、説明、カラーを設定して、[Save label]を選択する。
 
カラーは16進数カラーコード (例: #d73a4a) で指定する。 
[Generate a random color]ボタンでランダムな色を自動生成することもできる。 
 
GitHub CLIでのラベル作成例を以下に示す。 
 
gh label create "priority:high" --color "e11d48" --description "<高優先度のIssue>"
 

== マイルストーン ==
==== マイルストーンの作成と管理 ====
マイルストーンは、リリースや期日に向けたIssue、Pull Requestのグループ管理機能である。 
 
マイルストーンの作成手順を以下に示す。 
 
# [Issues]タブを開く。
# [Milestones]ボタンを押下する。
# [New milestone]を選択する。
# 名前、説明、期日を入力して、[Create milestone]を選択する。
 
下表に、設定できる項目を示す。 
 
<center>
{| class="wikitable"
|+ マイルストーンの構成要素
|-
! 項目 !! 説明
|-
| 名前(必須) || マイルストーンを識別するための名前 バージョン番号 (例: v1.0.0) やスプリント名が使われることが多い。
|-
| 説明 || マイルストーンの目的や含まれる作業内容の概要
|-
| 期日 || マイルストーンの完了期日 設定すると期日超過時に警告が表示される。
|}
</center>
 
==== 進捗の追跡 ====
マイルストーンページでは、紐付けられたIssueとPull Requestの進捗を確認できる。 
 
表示される情報を以下に示す。 
 
* オープン数とクローズ数
*: 未完了と完了のIssue/Pull Requestの件数が表示される。
* 完了パーセンテージ
*: クローズ済みのチケット数をもとに完了率が自動計算されて表示される。
* 期日までの残り日数
*: 期日が設定されている場合、残り日数または超過日数が表示される。
 

== アサイン (担当者) ==
==== 担当者の割り当て ====
Issueに担当者を割り当てることで、誰がそのIssueを対応するかを明確にできる。 
 
担当者の割り当て手順を以下に示す。 
 
# Issueを開く。
# 右側バーの[Assignees]を選択する。
# ユーザ名を検索して選択する。
 
担当者には、リポジトリへのコラボレータとして登録されているユーザのみを指定できる。 
 
==== 複数担当者 ====
1つのIssueには最大10名の担当者を割り当てることができる。 
 
GitHub CLIでの一括割り当て例を以下に示す。 
 
gh issue edit 123 --add-assignee "user1,user2,user3"
 
担当者を外す場合は以下のコマンドを使用する。 
 
gh issue edit 123 --remove-assignee "user1"
 

== Sub-issues ==
==== Sub-issueとは ====
Sub-issuesは、Issueを階層構造で管理するための機能である。 
2025年1月13日に正式提供が開始された。 
 
Sub-issuesを使用することにより、大きなタスクを細かな作業単位に分割して、進捗を階層的に管理できる。 
複数リポジトリにまたがるSub-issuesの作成もサポートされている。 
 
==== Sub-issueの作成と管理 ====
下表に、Sub-issuesの仕様を示す。 
 
<center>
{| class="wikitable"
|+ Sub-issuesの仕様
|-
! 項目 !! 説明
|-
| 最大数 || 1つのIssueに対して最大100個のSub-issuesを作成できる。
|-
| ネスト階層 || 最大8段階のネストが可能である。
|-
| クロスリポジトリ || 同一組織内の別リポジトリのIssueをSub-issueとして登録できる。
|}
</center>
 
Sub-issueの作成手順を以下に示す。 
 
# 親となるIssueを開く。
# Issueページ内の[Create sub-issue]ボタンを押下する。
# 新規作成または既存Issueの追加を選択する。
# 必要な情報を入力して作成する。
 
==== 進捗の可視化 ====
Sub-issuesを設定すると、親IssueのページでSub-issuesの完了状況がプログレスバーで表示される。 
 
下表に、表示される情報を示す。 
 
<center>
{| class="wikitable"
|+ Sub-issuesの進捗表示
|-
! 項目 !! 説明
|-
| 完了数と総数 || 完了したSub-issues数と全体のSub-issues数が表示される。
|-
| 完了率バー || クローズ済みのSub-issuesの割合がビジュアルで表示される。
|}
</center>
 
従来のタスクリスト (チェックボックス) よりも柔軟な管理が可能であり、Sub-issuesへの移行が推奨される。 
 

== 検索とフィルタリング ==
==== フィルタ構文 ====
Issuesの検索バーでは、フィルタ構文を使用して絞り込み検索ができる。 
 
下表に、主なフィルタ構文を示す。 
 
<center>
{| class="wikitable"
|+ フィルタ構文一覧
! 構文 !! 説明
|-
| <code>is:open</code> || オープン状態のIssueを表示する。
|-
| <code>is:closed</code> || クローズ済みのIssueを表示する。
|-
| <code>assignee:@me</code> || 自分が担当者のIssueを表示する。
|-
| <code>assignee:username</code> || 指定ユーザが担当者のIssueを表示する。
|-
| <code>label:"bug"</code> || 指定ラベルが付いたIssueを表示する。
|-
| <code>milestone:"v1.0"</code> || 指定マイルストーンに紐付いたIssueを表示する。
|-
| <code>author:username</code> || 指定ユーザが作成したIssueを表示する。
|-
| <code>created:2025-01-01..2025-12-31</code> || 指定期間内に作成されたIssueを表示する。
|-
| <code>sort:created-desc</code> || 作成日時の降順で並べ替える。
|-
| <code>no:assignee</code> || 担当者が未設定のIssueを表示する。
|-
| <code>no:label</code> || ラベルが未設定のIssueを表示する。
|}
</center>
 
AND / OR演算子を組み合わせることで複合条件の検索が可能である。 
 
ネストは最大5段階まで対応している。 
 
==== よく使用される検索クエリ ====
開発でよく使用される検索クエリの例を以下に示す。 
 
<center>
{| class="wikitable"
|+ よく使用される検索クエリ例
! クエリ !! 用途
|-
| is:open assignee:@me || 自分が担当するオープン中のIssueを確認する。
|-
| is:open label:bug || バグラベルの付いたオープン中のIssueを確認する。
|-
| is:open no:assignee label:bug || 担当者未設定のバグIssueを確認する。
|-
| is:open milestone:"v2.0" || 次のリリースに向けたオープンIssueを確認する。
|-
| is:closed author:@me || 自分が作成したクローズ済みIssueを確認する。
|-
| is:open label:"good first issue" || 初心者向けのオープンIssueを確認する。
|-
| is:open sort:created-asc || 長期間オープンのまま放置されたIssueを確認する。
|}
</center>
 

== タスクリスト ==
==== タスクリストの記法 ====
Issueの本文にMarkdownのチェックボックス記法を使用してタスクリストを作成できる。 
 
記法例を以下に示す。 
 
<syntaxhighlight lang="md">
## 対応チェックリスト

- [x] 問題の調査
- [x] 修正方針の確定
- [ ] コードの修正
- [ ] テストの実施
- [ ] ドキュメントの更新
</syntaxhighlight>
 
記法のルールを以下に示す。 
 
* <code>- [ ]</code>
*: 未完了のタスクを表す。
* <code>- [x]</code>
*: 完了済みのタスクを表す。
 
チェックボックスは、Issueページ上でクリックして切り替えることができる。 
タスクの完了数は、Issue一覧ページでもインジケーターとして表示される。 
 
==== Sub-issuesへの移行 ====
従来のタスクリストブロック機能は廃止され、Sub-issuesの使用が推奨されている。 
 
Sub-issuesへの移行を推奨する理由を以下に示す。 
 
* 独立したトラッキング
*: 各タスクが独立したIssueとして管理されるため、個別のラベル・担当者・マイルストーン設定が可能になる。
* 進捗の可視化
*: 親Issueのページでプログレスバーによる完了率の可視化ができる。
* クロスリポジトリ対応
*: 異なるリポジトリのIssueをSub-issueとして紐付けることができる。
* 検索・フィルタリング
*: Sub-issuesを個別に検索・フィルタリングできる。
 

== IssueとPull Requestの連携 ==
==== キーワードによる自動クローズ ====
Pull Request (PR) の説明文またはコミットメッセージに特定のキーワードとIssue番号を記述することにより、PRのマージ時に関連するIssueを自動的にクローズできる。 
 
下表に、自動クローズキーワードを示す。 
 
<center>
{| class="wikitable"
|+ 自動クローズキーワード一覧
! キーワード !! バリエーション
|-
| close || close / closes / closed
|-
| fix || fix / fixes / fixed
|-
| resolve || resolve / resolves / resolved
|}
</center>
 
使用例を以下に示す。 
 
<syntaxhighlight lang="md">
## 変更内容

ログインエラーの原因を修正しました。

Closes #123

## 関連 Issue

Fixes octo-org/octo-repo#100
</syntaxhighlight>
 
自動クローズが機能する条件を以下に示す。 
 
* デフォルトブランチ (通常は main または master) をターゲットにしたPRでのみ有効である。
* 同一リポジトリのIssueは、Closes #123 の形式で指定する。
* 別リポジトリのIssueは、Closes octo-org/octo-repo#100 の形式で指定する。
 
==== クロスリファレンス ====
IssueやPRの本文・コメントに <code>#番号</code> を記述することにより、リポジトリ内の他のIssueやPRへの自動リンクが生成される。 
 
クロスリファレンスの使用例を以下に示す。 
 
<syntaxhighlight lang="md">
この問題は #123 に関連しています。
また、#456 で報告された問題と同じ原因である可能性があります。
</syntaxhighlight>
 
クロスリファレンスの仕様を以下に示す。 
 
* 同一リポジトリ参照
*: <code>#番号</code> でIssueまたはPRへのリンクが自動生成される。
* 別リポジトリ参照
*: <code>owner/repo#番号</code> の形式で別リポジトリのIssueやPRを参照できる。
* PRからIssueへのリンク
*: PRの右側バーの[Development]セクションに、関連するIssueが表示される。
* リンク上限
*: 1つのPRに紐付けられるIssueは最大10件までである。
 

{{#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]]