コミュニティソリューション

ZimaOSにDDNS Updaterをインストールする

A community member shared a DuckDNS configuration for ddns-updater and later added screenshots showing how to locate, edit, restore, and restart the persistent config.

コミュニティのDDNS設定で実現しようとしていたこと

コミュニティの投稿では、DuckDNSを使用するddns-updaterアプリケーション向けに、config.jsonの例が共有されていました。基本的な考え方は現在も有効です。アップデーターには、プロバイダー、ドメイン、認証情報またはトークン、IPバージョンのポリシーが必要であり、再起動後もコンテナが読み取れる場所に永続的な設定を保存する必要があります。

現在のZimaOS向け概要については、DuckDNSのハードウェアおよび設定ガイドと、最新のZimaOS App Store要件ディレクトリをご覧ください。

現在のddns-updaterスキーマを使用する

上流プロジェクトでは、プロバイダーごとの設定が説明されています。プロバイダーのスキーマが変更されている可能性があるため、古い例をそのままコピーしないでください。現在のDuckDNSドキュメントでは、DuckDNSドメインとトークンが必要で、IPバージョンのオプションにも対応しています。正式なリファレンスは、ddns-updaterのDuckDNSドキュメントです。メインプロジェクトのREADMEでも、対応プロバイダーと永続的な設定の動作がddns-updaterプロジェクトドキュメントに記載されています。

{
  "settings": [
    {
      "provider": "duckdns",
      "domain": "your-name.duckdns.org",
      "token": "YOUR_TOKEN",
      "ip_version": "ipv4"
    }
  ]
}

プレースホルダーを自分の値に置き換え、実際のトークンをスクリーンショット、フォーラムへの投稿、Gitリポジトリ、サポートチケットなどで決して公開しないでください。

ZimaOSで設定ファイルを見つける場所

設定と再起動のオプションを表示するZimaOSのDDNS Updaterアプリメニュー
DDNS Updaterチュートリアルに掲載されたコミュニティのスクリーンショット。設定へのアクセスとサービスの再起動に使用するアプリメニューを示しています。
DDNS Updaterのアプリデータを見つけるために使用するZimaOS Filesアプリアイコン
DDNS Updaterの永続的な設定へ移動するために使用するFilesアプリを示す、コミュニティのスクリーンショットです。
ストレージドライブ上のAppDataフォルダーを表示するZimaOS Filesインターフェース
DDNS Updaterのデータディレクトリを開く前の、ZimaOSストレージドライブ上のAppDataフォルダーを示すコミュニティのスクリーンショットです。
AppData内のddns-updaterフォルダーを強調表示したZimaOS AppDataディレクトリ
AppData内で、永続的なアプリケーションファイルが保存されているddns-updaterフォルダーを強調表示したコミュニティのスクリーンショットです。
ZimaOS Filesインターフェースに表示されたDDNS Updaterのconfig.jsonファイル
DDNS Updaterのデータディレクトリ内にあるconfig.jsonを示すコミュニティのスクリーンショットです。元の投稿者は、編集前にバックアップすることを推奨しています。

元のスレッドではappdata/ddns-updaterというパスが示されていましたが、正確なホストパスは、アプリのインストール方法やストレージのマッピング方法によって異なる場合があります。固定パスを想定するのではなく、ZimaOSでアプリの設定を開き、コンテナの設定場所にマッピングされている永続ボリュームを確認してください。編集前に現在のファイルをバックアップしてください。

更新を検証する方法

  1. JSONの解析エラーなしでコンテナが起動することを確認します。
  2. アップデーターのログで、プロバイダー認証エラーやドメインエラーを確認します。
  3. 別のネットワークまたはパブリックDNSリゾルバーからホスト名を解決します。
  4. 返されたAレコードまたはAAAAレコードを、現在のパブリックアドレスと比較します。
  5. アプリを一度再起動し、設定が永続化されていることを確認します。

DDNSはホスト名をアドレスに紐付け続けるだけであり、それ自体が安全なリモートアクセス経路を作成するわけではありません。最終的な目的がホームサーバーへのリモートアクセスである場合は、サービスを直接公開する前に、Zima Clientのリモートアクセスで説明されている接続モデルと比較してください。

プロバイダーの変更とIPv6

Cloudflareなど別のプロバイダーを使用する場合は、DuckDNS固有のフィールドを削除し、そのプロバイダーのスキーマに従ってください。たとえば、現在のCloudflare設定ではゾーン識別子やAPIトークンなどのフィールドを使用します。正式な情報源は、上流のCloudflareプロバイダードキュメントです。

FAQ

appdata/ddns-updaterフォルダーが見つからないのはなぜですか?

永続的なホストパスは、コミュニティの例で使用されているパスと異なる場合があります。推測したシステムパスを作成するのではなく、アプリのボリュームマッピングを確認してください。

IPv4とIPv6の両方を使用できますか?

はい。ただし、現在のプロバイダードキュメントに従ってIPバージョンのオプションを設定し、公開しようとしているアドレスファミリーをISPが実際に提供していることを確認してください。

DDNSはVPNと同じですか?

いいえ。DDNSはホスト名を変動するIPアドレスに対応付けます。認証、暗号化、ファイアウォールルール、リモートアクセスの設計は、それぞれ別の問題です。