Martin from Cloudflare Tunnel with multiple PMTiles support
Cloudflare Tunnelを使った複数PMTiles対応のMartin

x-24b is a generalized version of gel-tunnel, designed to host multiple PMTiles in a data directory. It simplifies the process of downloading, verifying, and hosting PMTiles files with enterprise-grade reliability and CORS support for web mapping applications.

x-24bはgel-tunnelの汎用版で、データディレクトリ内の複数のPMTilesをホストするように設計されています。PMTilesファイルのダウンロード、検証、ホスティングのプロセスを、エンタープライズグレードの信頼性とWebマッピングアプリケーション向けのCORSサポートにより簡素化します。

The name "x-24b" is a playful nod to the Martin tile server and its connection to Cloudflare. Just like the experimental X-24B aircraft, which was produced by Martin and used flares during landing, this project "lands" PMTiles with the help of Martin and Cloudflare. In aviation, a "flare" is a small nose-up operation performed just before landing to ensure a smooth touchdown. Similarly, this project ensures a smooth and efficient "landing" of PMTiles into your data directory. While we don't have actual flares, we do have blazing-fast tile hosting and a touch of humor to keep things grounded! For more about the X-24B aircraft, visit this reference and this NASA image article.

「x-24b」という名前は、Martinタイルサーバーとその Cloudflare との接続への楽しい敬意です。Martin社によって製造され、着陸時にフレアを使用した実験機X-24Bのように、このプロジェクトはMartinとCloudflareの助けを借りてPMTilesを「着陸」させます。航空において「フレア」とは、スムーズな着陸を確実にするために着陸直前に行われる小さな機首上げ操作です。同様に、このプロジェクトはPMTilesのデータディレクトリへのスムーズで効率的な「着陸」を確実にします。実際のフレアはありませんが、超高速のタイル配信と、物事を地に足をつけて保つためのユーモアのタッチがあります！X-24B航空機についての詳細は、この参考資料およびこのNASA画像記事をご覧ください。

• Multiple PMTiles hosting - Hosts multiple local and remote PMTiles files
• 複数PMTilesホスティング - 複数のローカル・リモートPMTilesファイルをホスト
• Remote PMTiles support - Direct hosting of remote PMTiles URLs without local storage
• リモートPMTilesサポート - ローカルストレージなしでリモートPMTiles URLを直接ホスト
• Parallel downloads - Downloads PMTiles files using aria2c with multi-threading support
• 並列ダウンロード - マルチスレッド対応のaria2cを使用してPMTilesファイルをダウンロード
• File verification - Validates downloaded PMTiles files using pmtiles verify
• ファイル検証 - pmtiles verifyを使用してダウンロードしたPMTilesファイルを検証
• PMTiles metadata editing - Fix incompatible headers using pmtiles edit --header-json
• PMTilesメタデータ編集 - pmtiles edit --header-jsonを使用して非互換ヘッダーを修正
• Makefile automation - Controlled entirely via a Makefile with intuitive commands
• Makefile自動化 - 直感的なコマンドでMakefileにより完全制御
• Real-time monitoring - Process monitoring with monitor.rb for service health tracking
• リアルタイム監視 - サービス健全性追跡のためのmonitor.rbによるプロセス監視
• CORS support - Full CORS compliance for web mapping applications
• CORSサポート - Webマッピングアプリケーション向けの完全CORS準拠
• HTTPS consistency - Reliable HTTPS URL generation through Cloudflare Tunnel
• HTTPS一貫性 - Cloudflare Tunnel経由の信頼性の高いHTTPS URL生成

• make download - Fetch PMTiles files with parallel downloads / 並列ダウンロードでPMTilesファイルを取得
• make download-mapterhorn - Download the large Mapterhorn PMTiles file with optimized settings / 最適化された設定で大きなMapterhornのPMTilesファイルをダウンロード
• make verify - Validate downloaded PMTiles files / ダウンロードしたPMTilesファイルを検証
• make clean - Remove unnecessary files / 不要なファイルを削除
• make martin - Start Martin server in quiet mode / 静かなモードでMartinサーバーを開始
• make martin-debug - Start Martin server with verbose logging / 詳細なログ付きでMartinサーバーを開始
• make caddy - Start Caddy server in quiet mode / 静かなモードでCaddyサーバーを開始
• make caddy-debug - Start Caddy server with verbose logging / 詳細なログ付きでCaddyサーバーを開始
• make tunnel - Establish a Cloudflare Tunnel in quiet mode / 静かなモードでCloudflare Tunnelを確立
• make tunnel-debug - Establish a Cloudflare Tunnel with verbose logging / 詳細なログ付きでCloudflare Tunnelを確立
• make services - Generate SERVICES.md from martin.yml / martin.ymlからSERVICES.mdを生成
• make monitor - Monitor service processes / サービスプロセスを監視

Note: All documentation uses English first, then Japanese for clarity and consistency. 注: すべてのドキュメントは英語→日本語の順で記載しています。

1. Configure PMTiles sources in martin.yml: martin.ymlでPMTilesソースを設定:

   pmtiles:
     paths:
       - data/local-file.pmtiles  # Local files
       - https://example.com/remote.pmtiles  # Remote URLs

2. Optional: Download files listed in urls.txt: オプション: urls.txtにリストされたファイルをダウンロード:

   https://server/directory/xyz.pmtiles
       out=data/xyz.pmtiles.part
   

3. Use the Makefile to manage the process: プロセス管理にMakefileを使用:

   # Download and verify
   make download   # Download files with parallel processing / 並列処理でファイルをダウンロード
   make download-mapterhorn # Download large Mapterhorn PMTiles (>300GB) / 大きなMapterhornのPMTiles（>300GB）をダウンロード
   make verify     # Verify integrity / 整合性を検証
   
   # Quiet operation (default for stable systems)
   make martin     # Start Martin server in quiet mode / 静かなモードでMartinサーバーを開始
   make caddy      # Start Caddy server in quiet mode / 静かなモードでCaddyサーバーを開始
   make tunnel     # Start Cloudflare tunnel in quiet mode / 静かなモードでCloudflare tunnelを開始
   
   # Debug operation (for troubleshooting)
   make martin-debug  # Start Martin with verbose logging / 詳細ログ付きでMartinを開始
   make caddy-debug   # Start Caddy with verbose logging / 詳細ログ付きでCaddyを開始
   make tunnel-debug  # Start Cloudflare tunnel with verbose logging / 詳細ログ付きでtunnelを開始
   
   # Utilities
   make services   # Update services documentation / サービスドキュメントを更新
   make monitor    # Monitor service processes / サービスプロセスを監視
   make clean      # Remove unnecessary files / 不要なファイルを削除

4. Access your tiles via the tunnel: tunnel経由でタイルにアクセス:

   • TileJSON: https://tunnel.optgeo.org/martin/[tileset-name]
   • Tiles: https://tunnel.optgeo.org/martin/[tileset-name]/{z}/{x}/{y}
   • Monitor: Run make monitor to track service health
   • 監視: make monitorでサービス健全性を追跡

This project solves complex URL generation and CORS issues that occur when serving tiles through multiple proxy layers:

このプロジェクトは、複数のプロキシ層を通してタイルを配信する際に発生する複雑なURL生成とCORSの問題を解決します：

Web Browser ←→ Cloudflare Tunnel ←→ Caddy (Reverse Proxy) ←→ Martin (PMTiles Server)
Webブラウザ ←→ Cloudflare Tunnel ←→ Caddy (リバースプロキシ) ←→ Martin (PMTilesサーバー)

Key innovations / 主要な革新:

• X-Rewrite-URL header for consistent HTTPS URL generation
• X-Rewrite-URLヘッダー による一貫したHTTPS URL生成
• Centralized CORS handling to prevent header conflicts
• 集中CORS処理 によるヘッダー競合の防止
• Path-specific OPTIONS handling for proper preflight support
• パス固有のOPTIONS処理 による適切なプリフライトサポート
• Remote PMTiles proxying through Martin for seamless integration
• リモートPMTilesプロキシ Martinによるシームレスな統合
• PMTiles metadata repair for compatibility with Martin/go-pmtiles
• PMTilesメタデータ修復 Martin/go-pmtiles互換性のため

For detailed technical documentation, see SETUP.md. 詳細な技術ドキュメントについては、SETUP.mdをご覧ください。

• Repository cleanliness - Ensure the repository remains clean
• リポジトリの清潔さ - リポジトリを清潔に保つ
• Documentation updates - Regularly update README.md and NOTES.md to reflect changes
• ドキュメント更新 - 変更を反映するためREADME.mdとNOTES.mdを定期的に更新
• Tunnel configuration - The Cloudflare tunnel name is configurable via the tunnel_name variable in the Makefile
• Tunnel設定 - Cloudflare tunnelの名前はMakefileのtunnel_name変数で設定可能

• SETUP.md - Detailed technical setup and troubleshooting / 詳細な技術セットアップとトラブルシューティング
• SERVICES.md - Available services and endpoints / 利用可能なサービスとエンドポイント
• NOTES.md - Development notes and changelog / 開発ノートと変更履歴
• OPERATION.md - Basic operation procedure for x-24b / x-24bの基礎的な運用手順

The x-24b system successfully operated for the first time on 2025-07-27. This marks the beginning of its journey as a reliable and experimental web map server.

x-24bシステムは、2025年7月27日に初めて正常に稼働しました。これは、信頼性の高い実験的なウェブ地図サーバーとしての旅の始まりを示しています。

The name "x-24b" not only refers to the Martin tile server and its connection to Cloudflare but may also stand for "experimental 24-hour business." This could symbolize the goal of achieving 24/7 stable operation as a portable web map server, potentially running on devices like the Raspberry Pi 4B.

"x-24b"という名前は、MartinタイルサーバーとCloudflareとの接続を指すだけでなく、「experimental 24-hour business」の略でもあるかもしれません。これは、Raspberry Pi 4Bのようなデバイスで24時間365日安定稼働するポータブルなウェブ地図サーバーを目指すことを象徴している可能性があります。