現在、CasaOSでTwingateを使う最も簡単な方法は、CasaOSホストまたは同じLAN内の別のマシンで、Twingate ConnectorをDockerコンテナとして実行することです。ConnectorはTwingateへの外向き接続を確立するため、CasaOSダッシュボードのポート転送は不要です。
2023年のフォーラムチュートリアルは、Twingateの現在のDocker Composeテンプレートより前のものです。古いワンクリックストアパッケージをそのままコピーせず、現在のConnectorトークンと公式のCompose変数を使用してください。
Remote NetworkとConnectorを作成する
Twingate Admin ConsoleでRemote NetworkとConnectorを作成します。Twingateが、そのConnector専用のアクセストークンとリフレッシュトークンを生成します。
最新のDocker Composeテンプレートを使用する
最新のTwingate Docker Composeガイドには、次の必須変数が記載されています。
services:
twingate-connector:
image: twingate/connector:latest
restart: always
environment:
- TWINGATE_NETWORK=YOUR_TENANT
- TWINGATE_ACCESS_TOKEN=YOUR_ACCESS_TOKEN
- TWINGATE_REFRESH_TOKEN=YOUR_REFRESH_TOKEN
トークンが公開スクリーンショットに写らないようにする
アクセストークンとリフレッシュトークンは、Connectorを一意に認証します。CasaOSのアプリ設定、またはGitにコミットしたり公開したりしない環境ファイルに保存してください。
CasaOSをTwingateのリソースとして追加
Twingate Admin Consoleで、CasaOSのLAN IPアドレスまたはホスト名とWebポートをリソースとして登録します。必要なユーザーやグループにのみアクセスを許可してください。
ブリッジネットワークとホストネットワーク
Twingateによると、デフォルトはブリッジモードです。ホストモードは、ローカルのピアツーピアネットワークに役立つ場合があります。ホストのネットワークスタックを共有する特別な理由がない限り、まずは公式のデフォルト設定を使ってください。
ルーターのポート転送は不要
Connectorはファイアウォールの内側で動作し、外向きの接続を確立します。リモートアクセスを利用したいからといって、CasaOSの管理ポートをインターネットに公開しないでください。
リモートデバイスに Twingate Client をインストールする
Connector は自宅のネットワーク内で動作します。Twingate Client は、外出先で使うノートパソコンやスマートフォンで動作します。トラフィックがプライベート Resource に到達する前に、両方を Twingate ネットワークに登録します。
Resource を追加する前にアクセスを確認する
まず CasaOS ダッシュボードをテストし、その後、ほかの NAS アプリを1つずつ追加してください。これにより、サブネット全体を不必要に公開せず、アクセスポリシーを明確に保てます。
プライベートなリモートアクセスガイドでは、ホームサーバー全般について詳しく説明しています。
CasaOS をテストする前に Connector の状態を確認する
docker ps | grep twingate
docker logs --tail 100 twingate-connectorConnector は正常に登録され、稼働し続けるはずです。再起動を繰り返す場合は、CasaOS の Resource をトラブルシューティングする前に、テナント名とトークンを確認してください。
Resource の範囲を必要最小限にする
CasaOS ダッシュボードだけが必要な場合は、LAN サブネット全体を公開するのではなく、CasaOS の正確な IP アドレスと Web ポートを指定してください。ほかのアプリが必要になったら、個別の Resource として追加します。
Connector の更新を計画する
Twingate は CasaOS とは別にコンテナの更新を公開します。定期的に最新の Connector イメージを取得し、メンテナンス時間中に再起動してから、リモートアクセスが引き続き機能することを確認してください。
よくある質問
ルーターで CasaOS のポートを開放する必要がありますか？
いいえ。Twingate Connectors はファイアウォールの内側で動作し、外向きに接続するよう設計されています。
Twingate のトークンはどこから取得できますか？
Connector のデプロイ時に、Admin Console が生成します。
host networking を使うべきですか？
ネットワーク構成やピアツーピア通信で必要な場合に限ります。デフォルトは bridge です。
1つの Connector で CasaOS 以外も公開できますか？
はい。ただし、デフォルトでサブネット全体への広範なアクセスを許可するのではなく、Resources と permissions を意図的に定義してください。
