LinuxディストリビューションでのHappのインストールと設定
デスクトップ版HappはLinux上でXrayコアで動作し、システムとアプリ向けにローカルプロキシを提供します。以下では、AppImageまたはパッケージによるインストール、Telegramボットから取得した購読リンクの接続、そして自動起動の設定を解説します。
Happ VPN の接続方法 — Linux
アプリをインストール
お使いのディストリビューション用の公式ソースから Linux 版 Happ をダウンロードします。
キーを取得
Telegram ボットを開いてアクセスを有効にします。
キーを追加
サブスクリプションリンクをアプリにインポートします。
接続をオン
サーバーを選択して VPN をオンにします。
Linuxへのインストール: AppImageと.deb
Happのデスクトップ版は、GitHub上のHapp-proxyリポジトリのReleasesセクションで配布されています。ほとんどのディストリビューションでは、汎用フォーマットのAppImageが便利です。インストール不要で、任意のフォルダから起動できます。DebianおよびUbuntu系向けには、別途.debパッケージが用意されています。
自分のアーキテクチャ（通常はx86_64）向けの最新ファイルをダウンロードし、AppImageに実行権限を付与してから起動します: `chmod +x Happ-x86_64.AppImage` と `./Happ-x86_64.AppImage`。.debの場合は `sudo apt install ./happ_amd64.deb` を使えば、パッケージマネージャーが依存関係を自動で解決します。
AppImageが起動しない場合、多くはFUSEライブラリが不足しています。`sudo apt install libfuse2`（Debian/Ubuntu）または各ディストリビューション相当のコマンドでインストールしてください。回避策として、AppImageを展開して直接実行することもできます: `./Happ-x86_64.AppImage --appimage-extract` の後に `./squashfs-root/AppRun` を実行します。
購読と設定のインポート
サーバーへのアクセスは、サービスのTelegramボットが発行します。そこで試用・有料・公式のいずれかのキーを有効化し、https://…/sub/… の形式の購読リンクを受け取ります。このリンクには最新のサーバー一覧とXrayのパラメータが含まれており、設定を手動で入力する必要はありません。
アプリで設定の追加を開き、購読リンクを貼り付けて保存します。Happは利用可能なすべてのサーバーを1つのリストとして読み込み、以降は同じリンクから更新します。サーバーが変更されたり新しいロケーションが追加されたりした場合は、購読の更新を押すだけで済み、再インストールは不要です。
必要に応じて単一の設定を追加することもできます。ボットから vless:// または ss:// の文字列をコピーし、クリップボードからのインポートで貼り付けてください。同じキーがすべてのデバイスで動作するため、Linux・Windows・モバイルクライアント向けの購読は共通です。
Xrayコアでのプロキシモードの起動
インポート後、リストからサーバーを選択して接続を有効にします。HappはXrayコア上でローカルプロキシ（SOCKSおよびHTTP）を起動し、それを経由してトラフィックをルーティングします。システムモードでは、クライアントがデスクトップ環境の設定にプロキシを書き込むため、ブラウザやほとんどのアプリが追加設定なしでトンネル経由で動作し始めます。
ローカルプロキシのポートはアプリの設定で手動指定できます。特定のプログラムだけをHappに通したいときに便利です。ブラウザのプロキシ設定または環境変数（例: `export https_proxy=http://127.0.0.1:PORT`）にアドレス 127.0.0.1 と指定ポートを記述し、その他のトラフィックは直接接続のまま残せます。
トラフィックを細かく分けるために、Happにはリストによるルーティングとsplit tunnelingがあります。どのドメインやアプリをプロキシ経由にし、どれを迂回させるかを指定できます。ルールとutilityの詳しい解説は、基本的なインストールとルートの詳細設定を混同しないよう、サイトの別セクションにまとめています。
システム起動時のHappの自動起動
プロキシが自動的に立ち上がるようにするには、デスクトップ環境の自動起動にクライアントを追加します。`~/.config/autostart/happ.desktop` ファイルを作成し、`[Desktop Entry]`、`Type=Application`、`Exec=/フルパス/Happ-x86_64.AppImage`、`X-GNOME-Autostart-enabled=true` の行を記述します。GNOME、KDE、そしてほとんどの環境が次回ログイン時にこれを読み込みます。
.debでインストールした場合は、アプリの設定内から直接、または環境の自動起動メニューから自動起動のショートカットを有効にできます。実行ファイルへのパスは自動で入力されます。ログイン後、Happはシステムトレイに最小化され、時計の隣のアイコンから利用できます。
グラフィカルシェルなしでLinuxを起動する場合は、systemdのユーザーサービスとして設定してください。unitを `~/.config/systemd/user/` に配置し、`ExecStart` にAppImageへのパスを指定して、`systemctl --user enable --now happ.service` コマンドで自動起動を有効にします。
接続の確認と診断
接続後、トラフィックがサーバー経由になっているか確認します。IP判定サービスを開き、アドレスと国が選択したロケーションと一致するはずです。IPが変わらない場合は、システムプロキシが有効になっていること、そしてアプリが正しいローカルポートを参照していることを確認してください。
切断や速度低下がある場合は、購読リストの中でサーバーを切り替えてください。近隣のロケーションのほうが安定したルートになることがよくあります。次に購読を更新して最新のXrayパラメータを取得し、接続を再起動します。ローカルのファイアウォールが妨げになることもあるため、ufwやfirewalldでHappの送信接続を許可してください。
クライアント更新後にサーバーリストが読み込まれない場合は、TelegramボットでキーのXの有効期限と購読リンクの正しさを確認してください。接続ログはアプリ内で確認でき、キーの問題とネットワークのブロックを切り分けるのに役立ちます。
よくある質問
LinuxにHappをインストールするには？
GitHub上のHapp-proxyリポジトリのReleasesセクションから最新版をダウンロードします。どのディストリビューションでも使えるAppImage、またはDebianとUbuntu向けの.debがあります。AppImageは chmod +x で実行権限を付与して起動し、.debは sudo apt install ./ファイル.deb でインストールします。次にTelegramボットの購読リンクを追加してください。
Linux用のキーと購読はどこで入手できますか？
キーと購読リンクはサービスのTelegramボットが発行し、そこで試用・有料・公式のアクセスを有効化します。リンクにはサーバー一覧とXrayのパラメータが含まれ、一度アプリに貼り付けるだけで済みます。キーは全デバイス共通のため、Linux用の購読はWindowsやモバイルクライアントと同じです。
AppImageが起動しない場合はどうすればいいですか？
多くの場合FUSEライブラリが不足しています。sudo apt install libfuse2 または各ディストリビューション相当のコマンドでインストールしてください。回避策として、./Happ-x86_64.AppImage --appimage-extract でイメージを展開し、./squashfs-root/AppRun を実行します。また、chmod +x でファイルに実行フラグが付いているか確認してください。
LinuxでHappの自動起動を設定するには？
~/.config/autostart/happ.desktop ファイルを作成し、Desktop Entryの記述とExec行にAppImageへのパスを指定すれば、GNOMEやKDEがログイン時に読み込みます。グラフィックなしのサーバーでは、~/.config/systemd/user/ にsystemdのユーザーサービスを用意し、systemctl --user enable --now happ.service コマンドで有効にします。
Happ経由で1つのブラウザだけを通すには？
アプリの設定でローカルプロキシを有効にし、アドレス 127.0.0.1 と指定ポートを控えます。このプロキシを特定のブラウザの設定または環境変数 https_proxy に記述すれば、そのブラウザだけがトンネルを経由し、その他のトラフィックは直接接続のまま残ります。ドメイン単位のルーティングには split tunneling を使います。
接続はあるのにIPが変わらないのはなぜですか？
システムプロキシが有効になっていること、そしてアプリが正しいローカルポートを待ち受けていることを確認してください。購読リスト内でサーバーを切り替え、購読を更新して最新のパラメータを取得します。ローカルのファイアウォールが妨げている場合は、ufwやfirewalldでHappの送信接続を許可し、接続を再起動してください。