セットアップガイド

⚠️ 自己責任でご使用ください。 Reattachはマシン上でリモートコマンド実行を可能にします。使用前にセキュリティ上のリスクをご理解ください。reattachdにはデバイスベースの認証機能がありますが、インターネットに公開する場合は追加のセキュリティ対策（VPN、Cloudflare Zero Trustなど）を推奨します。

1 reattachdをインストール

お使いのコンピュータで以下のコマンドを実行します：

curl -fsSL https://raw.githubusercontent.com/kumabook/Reattach/main/install.sh | sh
2 デーモンを設定

macOS (launchd)

# ログディレクトリを作成
mkdir -p ~/Library/Logs/Reattach

# plistファイルを作成
cat > ~/Library/LaunchAgents/com.kumabook.reattachd.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.kumabook.reattachd</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/reattachd</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
    <key>StandardOutPath</key>
    <string>~/Library/Logs/Reattach/reattachd.log</string>
    <key>StandardErrorPath</key>
    <string>~/Library/Logs/Reattach/reattachd.error.log</string>
    <key>EnvironmentVariables</key>
    <dict>
        <key>REATTACHD_PORT</key>
        <string>8787</string>
        <!-- ローカルネットワークからのアクセスを許可する場合はコメント解除 (デフォルト: 127.0.0.1) -->
        <!-- <key>REATTACHD_BIND_ADDR</key> -->
        <!-- <string>0.0.0.0</string> -->
        <key>PATH</key>
        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string>
    </dict>
</dict>
</plist>
EOF

# 読み込んで開始
launchctl load ~/Library/LaunchAgents/com.kumabook.reattachd.plist

Linux (systemd)

# サービスファイルを作成
sudo tee /etc/systemd/system/reattachd.service << 'EOF'
[Unit]
Description=Reattach Daemon
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/reattachd
Restart=always
Environment=REATTACHD_PORT=8787
# ローカルネットワークからのアクセスを許可する場合はコメント解除 (デフォルト: 127.0.0.1)
# Environment=REATTACHD_BIND_ADDR=0.0.0.0

[Install]
WantedBy=multi-user.target
EOF

# 有効化して開始
sudo systemctl daemon-reload
sudo systemctl enable reattachd
sudo systemctl start reattachd
3 ネットワークアクセスを設定

iOSデバイスからreattachdへの接続方法を選択します：

ローカルネットワーク

直接接続

マシンのローカルIPアドレスを直接使用します。追加の設定は不要です。

URL: http://192.168.x.x:8787

VPN

VPNを設定している場合は、VPNネットワーク上のマシンのIPアドレスを使用します。

URL: http://<vpn-ip>:8787

リモートアクセス

Cloudflare Tunnel + Zero Trust Access（推奨）

ポートを公開せずにリモートアクセスを実現します。Cloudflare Zero TrustのAccess機能を使用することで、認証レイヤーを追加できます。

URL: https://your-domain.example.com

Cloudflareの詳細なセットアップガイドはこちら →

パブリックIP / ドメイン

パブリックIPやドメインで直接公開します。

URL: http://your-public-ip:8787
URL: https://your-domain.com:8787

⚠️ セキュリティ警告: この方法はマシンをインターネットに直接公開します。マシンが攻撃対象となり、デバイストークンが漏洩した場合、攻撃者がシステム上でコマンドを実行できる可能性があります。HTTPSを使用し、追加のセキュリティ対策（ファイアウォールルール、fail2banなど）を検討してください。

4 デバイスを登録

iOSデバイスを登録するためのQRコードを生成します：

reattachd setup --url <your-url>

Reattach iOSアプリでQRコードをスキャンして登録を完了します。

QRコードスキャン画面

サポートが必要ですか？ 詳細やトラブルシューティングについてはGitHubリポジトリをご覧ください。