LINE TAK
DOCS v5.3
新手指南 開啟戰術地圖
軍規級戰術感知 毫秒即時同步 跨網台互聯網關

LineTAK 戰術定位系統

專為現代野外特戰、搜索救援(SAR)、安全防護隊伍設計之次世代全景態勢感知(Situational Awareness)平台。 完美無縫融合 LINE / 手機瀏覽器、OwnTracks 背景低功耗追蹤器、Meshtastic 離網 LoRa 自組網、以及 ATAK / WinTAK / Taky / FreeTAKServer 體系,打破裝置與通訊協定壁壘。

支援客戶端
ATAK / OT / Mesh / Web
通訊協定
CoT / LoRa / WS / MQTT
縮放精度
24 級 (~1cm/px)
防護機制
防迴圈回音攔截

系統總覽與設計架構

CHAPTER 01

在傳統戰術行動或戶外救援搜救中,指揮中心與現場隊員常常面臨裝備與生態碎片化的巨大挑戰: 有的隊員攜帶安裝有 ATAK (Android Tactical Assault Kit) 的專業三防手持機,有的隊員攜帶 iPhone / 一般智慧型手機,甚至還有隊員使用無螢幕的 GPS 追蹤器或直接以通訊軟體報位。

LineTAK 扮演著全體系的「戰術交換網關樞紐 (Tactical SA Hub)」,具備以下核心技術特點:

LINE LIFF & 零安裝網頁端

隊員免下載安裝龐大 App,透過 LINE 官方帳號點擊連結即可直接秒開地圖,自動完成定位、回報、發送求救與查看隊友。

OwnTracks 背景長效追蹤

解決網頁端螢幕關閉即休眠的痛點,利用開源 OwnTracks 原生背景常駐能力,全天候穩定回傳 GPS 軌跡、海拔與電量。

TAK 伺服器雙向互通

原生支援 Cursor-on-Target (CoT XML) 軍規格式。支援多台 Taky / FreeTAK 伺服器串流接入與轉發,並內建防迴圈阻斷引擎。

北約 9-Line MEDEVAC 系統

內建正規北約軍規 9 線醫療後送申請單,緊急狀況一鍵觸發全網地圖閃爍脈衝、戰術警報音效與傷患座標鎖定。

互聯架構拓撲與服務通訊通道矩陣

LineTAK 伺服器整合了多個通訊協定引擎,全系統採用反向代理安全收斂,各服務通道之內部連接埠均全面隱藏保護:

服務名稱 通訊通道 / 安全狀態 傳輸協定 資料格式 用途說明與安全性
Web & REST API ***** 反向代理安全通道 (免 Port) HTTP / HTTPS JSON / HTML 網頁端主介面、歷史軌跡查詢、OwnTracks HTTP 上報、檔案匯入
Tactical WebSocket ***** 安全 WebSocket 代理通道 WS / WSS JSON Stream 網頁端毫秒級即時通訊(位置移動、標記增刪、聊天訊息、陣營廣播)
Inbound CoT 直連 ***** 專屬 CoT 接收通道 UDP & TCP CoT XML 接收本地區域網路或網際網路 ATAK/WinTAK 直接單播/廣播之位置封包
Embedded MQTT ***** 輕量物聯網通道 MQTT (TCP) JSON Payload 內建輕量 MQTT 代理伺服器,接收 OwnTracks MQTT 模式及 IoT 感測器數據
TAK Server 串流 ***** 外部安全串流通道 TCP / TLS CoT XML (SSL) 雙向對接外部 TAK 伺服器 (如 TAKTaiwanCTSserver),雙向同步部隊情資
Meshtastic 離網 LoRa ***** ATAK 網關轉發通道 LoRa RF ➔ CoT (TCP/UDP) Protobuf / CoT XML 無基地台深山隊友透過 LoRa Mesh 廣播,經由 ATAK 網關機自動中繼轉發至 LineTAK 全景地圖
LineTAK 系統互聯拓撲圖 (點擊節點檢視說明)
互動圖表:滑鼠懸停或點擊節點可高亮資料傳輸路徑
LineTAK HUB 中央戰術感知網關 即時同步通道 | Web 服務 CoT 戰術通道 | 感測代理 ● 防迴圈過濾引擎運行中 📱 LINE LIFF / 網頁 WebSocket / HTTP REST 📡 OwnTracks 追蹤器 HTTP 上報模式 MQTT 遙測協議 🛡️ ATAK / WinTAK 直連 CoT 戰術直連廣播 ⚡ 外部 TAK 伺服器群 Taky / FreeTAK / CTS TLS 加密安全雙向串流

網頁與手機端操作手冊

CHAPTER 02

1. 身分登入、陣營劃分與密碼隔離機制 (Faction & Password Architecture)

使用者進入 LineTAK 網頁(例如 http://domain/line-tak/)時,系統會自動彈出身分認證面板:

  • LINE LIFF 一鍵登入:在 LINE App 內開啟時,點選「LINE 快速登入」自動取得使用者暱稱與頭像,迅速完成實名認證。
  • 瀏覽器直接登入:在電腦或一般手機瀏覽器環境下,可手動自訂「呼號 (Callsign)」與「陣營密碼 (Faction Password)」。

陣營與密碼的核心運作原理 (Password = Faction Shared Key)

傳統戰術通訊系統通常需要網管人員事先在後台開立帳號、設定複雜的群組權限,在野外緊急搜救或臨時組隊時往往造成嚴重的通聯延誤。 LineTAK 採用創新的「密碼即陣營 (Shared Secret Key)」分流設計,實現了零前置設定、即開即用的戰術分組體系:

公用預設陣營 (Public)

當密碼留空時,裝置自動歸屬於公共頻道。適合公開聯合搜救、跨單位大會師或開放式教學展示,所有未設密碼的 Web 與 OwnTracks 成員皆能互見彼此座標。

專屬私密陣營 (Private)

只要小隊長與隊員約定好相同字串(例如 Alpha、RedTeam,區分大小寫),系統便會以此作為通訊隔離金鑰,非該陣營成員無法接收其動態。

陣營密碼所涵蓋的四重安全隔離維度:
  • 1. 即時經緯度遙測隔離:WebSocket 伺服器僅會將隊員位置廣播給輸入相同密碼的客戶端,避免敵軍或外人窺探小隊部署與行進軌跡。
  • 2. 戰術地圖標記隔離:在地圖上標記之「敵軍 (Hostile)」、「友軍 (Friendly)」、「撤離點 (Exfil)」等 NATO 戰術圖示會自動綁定該陣營密碼,其他陣營無法查看。
  • 3. 戰術文字聊天加密分流:戰術聊天室的即時廣播僅在同陣營頻道內流通,確保文字通訊安全。
  • 4. 緊急求救 (SOS / 9-Line) 警報定向通知:觸發 PANIC SOS 或 9-Line 醫療後送單時,警報音效與地圖閃爍精準推送給同陣營指揮官與隊友。
陣營密碼 vs 戰情室管理員密碼之重要區別:
• 陣營密碼 (Faction Password):一般隊員自由輸入,用於小隊通訊分組與情資隔離,不具備系統管理權限。
• 戰情室管理員密碼 (Admin Password):專供指揮官存取「數位戰情室 (War Room)」後台與管理「TAK 伺服器通道」之系統級權限,具備跨陣營全地圖監控與全局情資調度能力。

2. 位置回報與 GPS 模擬測試

側邊欄最上方的「戰術位置回報」控制卡提供以下核心按鈕:

  • 「立即上報位置」:點擊後即刻讀取手機 GPS 硬體並將最新座標封裝推送至伺服器。
  • 「自動定時上報 (10s)」開關:開啟後,系統每 10 秒在後台自動獲取一次座標並同步,免手動重複點擊。
  • 「模擬 GPS (點地圖設定位置)」:勾選後,直接點擊地圖任意地點即可將自身瞬移至該點。極度適合在室內無 GPS 訊號時進行沙盤兵棋推演!
  • 「啟動自動巡邏模擬 (漂移)」:開啟後,虛擬角色會在地圖上自動隨機漫遊漂移,方便測試動態追蹤與警報功能。

3. 戰術狀態與北約 9-Line MEDEVAC 求救系統

LineTAK 支援四種作戰狀態切換: 正常 (Standby)、 需要幫忙 (Help)、 戰鬥 (Combat)、 求救 (SOS)。

求救 (SOS) 聯動機制:
當任何成員觸發「求救 (SOS)」時,全網地圖將立即啟動紅色光環脈衝閃爍、觸發求救連續音效 (Beep Alarm),側邊欄會即時顯示閃爍警告三角,所有在線管理員皆能點擊一鍵「置中鎖定」傷患座標!

北約軍規 9-Line MEDEVAC 欄位標準

點擊求救按鈕或在成員名冊中點擊 SOS 詳細資訊,可開啟軍規 9-Line 醫療後送卡,內容精確對應北約作戰規範:

行次名稱標準填寫內容與意義
Line 1後送地點系統自動帶入精確 GPS 座標 (WGS84 經緯度及高程)
Line 2無線電呼號與頻率現場負責聯絡之部隊代號、無線電頻道與保密頻率
Line 3傷患緊急等級Urgent (緊急/命危 2小時內)、Priority (優先 4小時內)、Routine (常規 24小時內)
Line 4特殊裝備需求None (無)、Hoist (絞盤吊掛機)、Extraction (破壞剪)、Ventilator (呼吸器)
Line 5傷患類型與人數Litter (擔架傷患人數) / Ambulatory (可自行行走傷患人數)
Line 6後送區安全狀態No enemy (安全無敵軍)、Possible enemy (可能有敵軍)、Enemy in area (敵軍交火中)
Line 7後送點標識方法Panels (面板標識)、Pyro (信號彈)、Smoke (發煙筒顏色)、IR (紅外線閃光燈)
Line 8傷患身分與國籍US/Allied Military (友軍)、Civilian (平民)、Enemy POW (敵軍戰俘)
Line 9地形與生化核威脅NBC (核生化威脅類型) 或 LZ 障礙物描述 (如電線、陡坡、叢林)

4. 戰術標記與北約 (NATO) 符號系統

在地圖任意處「滑鼠雙擊 (Double Click)」或點擊「新增標記」按鈕,即可開啟標記面板。 LineTAK 完整內建現代北約作戰符號標準:

敵軍 (Hostile / Enemy)

標準紅色菱形框架,代表敵方部隊、交火目標、敵狙擊點或可疑敵軍載具。

友軍 (Friendly)

標準藍色圓角矩形,代表友軍哨所、前方觀察所 (OP) 或後方支援單位。

中立 (Neutral)

綠色方形,代表中立平民設施、聯合國/紅十字會救護站或非武裝區。

未知 (Unknown)

黃色雲狀標記,代表未經確認之聲響、雷達接觸或待清查之不明目標。

5. 戰術測距 (Ruler) 與電子圍欄接近預警 (Geofence Alarm)

點擊側邊欄工具中的「戰術測距」按鈕,地圖即進入測距模式。在圖上依序點擊任意兩點或多點,系統自動繪製螢光測距線,並在終點即時計算出總直線距離(公尺 / 公里)以及方位角(0° ~ 360°)。

電子圍欄接近預警 (Proximity Geofencing):
建立戰術標記時可填寫「警戒半徑 (公尺)」。當自身或任何在線隊友的 GPS 座標進入該標記的範圍內時,系統會自動在畫面上彈出警告並響起專屬接近音效,有效防止誤入雷區、危險交火區或偏離集結點!

6. 數位戰情室 (War Room 後台監控)

點擊頂部 Logo 或「關於我」彈窗中的「開啟數位戰情室」,輸入管理員帳密(預設 admin123),即可解鎖高級指揮官視角:

  • 多陣營圖資過濾勾選:管理員可跳脫單一陣營密碼限制,自由勾選/勾銷欲在地圖上顯示的特定部隊(例如只顯示紅隊與藍隊,隱藏綠隊)。
  • 陣營色彩管理 (14 色 ATAK 標準色庫):為各個陣營設定專屬名稱、密碼與地圖標籤發光色彩。
  • 部隊成員名冊監控:全螢幕檢視所有在線隊員之最新回報時間、精確經緯度、海拔高度、移動時速與設備剩餘電量。
  • 全網緊急救援清單:集中監控所有觸發求救之成員與 9-Line 醫療資訊。

7. 24 級戰術極限深度縮放 (1cm/px 戰術微觀圖資)

一般民用 Leaflet 地圖通常限制在 18 或 19 級縮放,在特種作戰或複雜建築物搜尋中解析度明顯不足。 LineTAK 經過底層圖資矩陣重構,支援高達 24 級深度數位縮放 (MAP_MAX_ZOOM = 24):

  • 當縮放超過圖資原生圖塊層級時,系統自動啟用 maxNativeZoom 超採樣演算法,持續平滑放大地面細節。
  • 支援四種高對比戰術底圖:Esri 暗色戰術圖(預設低眩光)、OpenStreetMap(街道地標)、Esri 衛星影像標籤混合圖(真實空拍地形)、OpenTopoMap(等高線山地地形)。

OwnTracks 手機背景追蹤器設定指南

CHAPTER 03

OwnTracks 是一款開源、免費且極度省電的 GPS 軌跡回報 App(支援 Android 與 iOS)。

為什麼戶外行動務必搭配 OwnTracks?
現代智慧型手機(尤其是 iOS 與 Android 12+)具備極端嚴格的後台省電管理。若純靠手機瀏覽器回報位置,當螢幕關閉或切換至其他 App 時,瀏覽器通常會在 30 秒至 1 分鐘內被系統強制休眠並停止發送 GPS。
OwnTracks 作為原生 App,採用作業系統底層 Location Service,在手機完全鎖屏黑屏、放進戰術背心口袋時,依然能穩定持續每數秒回報座標!

OwnTracks HTTP 模式設定步驟 (最推薦)

請依照以下步驟在手機 OwnTracks App 內完成設定:

  1. 至 Google Play 或 Apple App Store 下載安裝 OwnTracks。
  2. 開啟 App,點擊左上角或右上角進入 Preferences (設定) ➔ Connection (連線)。
  3. 在 Mode (連線模式) 選擇 HTTP。
  4. 在 Host (主機設定) 填寫:
    • URL (端點網址):http://bpoint.space/api/owntracks(標準反向代理免 Port 端點;若有 SSL 憑證則填 https://...)。
    • User identification (用戶標識):填寫你的呼號,例如 GDK(LineTAK 地圖上會自動加上高亮綠色標章 [OT] GDK)。
    • Device identification (設備標識 / Tracker ID):可填寫 2 碼代號如 72。
  5. 回到主畫面,點擊右下角的「向上箭頭 (發送最新位置)」,看到綠色打勾即代表上報成功!

陣營密碼傳遞 7 大途徑技術詳解

OwnTracks 客戶端原生只有回報經緯度,沒有直接的陣營欄位。 LineTAK 後端專門打造了強大容錯的七重陣營密碼辨識管線 (Faction Resolution Pipeline),支援以下任一種方式將設備綁定至特定陣營:

途徑 1:URL 查詢參數 (最推薦、最防呆)

在 URL 後方直接附加 ?password=陣營密碼
範例:http://bpoint.space/api/owntracks?password=red123
★ 絕對不被手機系統轉碼破壞,100% 成功率!

途徑 2:HTTP Basic Auth (帳號密碼)

在 Connection 的 Password (密碼) 欄位直接填寫陣營密碼。
注意:iOS 若 Username 含中文,Basic Auth 會被 iOS 轉成 (null),此時請改用途徑 1。

途徑 3:Device ID 帶入 (Android 快捷)

在 Android OwnTracks 的 Device ID (X-Limit-D) 欄位填入 pas:red123 或直接填寫陣營密碼。

途徑 4:呼號括號法 (Callsign Hint)

使用者名稱直接取為 GDK [red123] 或 GDK(red123)。LineTAK 會自動剝離括號提取密碼,畫面上乾淨顯示 [OT] GDK。

途徑 5:自訂 HTTP Headers

支援以自訂 HTTP 標頭發送:X-Password: red123 或 X-Faction-Password: red123。

途徑 6:MQTT Topic 規範

在 MQTT 模式下,Topic 設定為 owntracks/red123/username/phone。

途徑 7:未帶密碼自動防呆 (公用陣營)

任何沒有帶密碼或密碼不存在的 OwnTracks 設備,LineTAK 一律自動配置給「公用預設陣營 (Cyan)」,保證絕對不漏接任何訊號!

遙測欄位對應與 SOS 緊急救援自動觸發

LineTAK 伺服器接收 OwnTracks JSON 時之欄位對齊關係:

  • lat / lon ➔ 經緯度座標。
  • alt ➔ 海拔高程 (公尺)。
  • batt ➔ 設備電量百分比(隊友名冊即時顯示綠色電量條)。
  • vel ➔ 移動時速 (km/h)。
  • acc ➔ GPS 水平精度誤差 (±公尺)。
  • SOS 連動:在 OwnTracks 設定一個名為 emergency 或 rescue 的 Region(電子圍欄),當隊員進入該圍欄或將狀態設為 emergency 時,LineTAK 立即將其標記為紅光求救狀態!
離線逾時 (Timeout) 判定機制:
OwnTracks 設備若超過 18 秒 未收到任何位置訊號,圖示即刻變為灰色「離線狀態 (Offline)」以提示隊友可能失去通訊或進入掩體;超過 600 秒 (10 分鐘) 則自活動圖層清除。
🔒 安全防護機制:全面收斂免除 Port 埠號暴露

為提升系統防護並防範針對特定連接埠的網路掃描,LineTAK 已全面透過 Apache / Nginx 反向代理收斂所有服務通道,技術說明與操作範例中均嚴格不揭露任何內部 Port 號!
您與所有隊友可直接使用以下安全無 Port的標準專屬網址,由網頁伺服器安全自動路由:

  • 戰術地圖主頁:http://bpoint.space/line-tak/ 或 http://bpoint.space/linetak/(免 Port)
  • 使用教學手冊:http://bpoint.space/line-tak/docs.html(免 Port)
  • OwnTracks 連線網址:http://bpoint.space/api/owntracks?password=陣營代碼(免 Port)
🛠️ 互動式 OwnTracks 連線 URL 產生器

在下方輸入你的伺服器位址與陣營資訊,即可自動生成可直接貼入手機 OwnTracks 的完整配置:

全面啟用安全無 Port 模式(標準代理通道)
自動產出乾淨且安全的 /api/owntracks 端點網址
【推薦設定】請將以下網址直接貼入 OwnTracks 的「URL」欄位:
http://bpoint.space/api/owntracks?password=red123

TAK 伺服器雙向互聯與 CoT 管線技術拆解

CHAPTER 04

LineTAK 不僅是一個輕量作戰地圖,更是完整的 Cursor-on-Target (CoT) 雙向互聯網關。 無論是自建的 Taky、FreeTAKServer、或是國外商用/官方 TAK Server (TAK.gov),LineTAK 都能作為跨網台客戶端兼轉發中繼站進行毫秒級資料交換。

1. 三大互聯連線模式對比

連線模式適用情境連線協定安全機制設定複雜度
模式 A:一鍵匯入 Taky ZIP 由伺服器提供 .zip 連線包之標準情境 TLS (SSL) 用戶端 p12 憑證與密鑰 ★ 極簡 (1 鍵搞定)
模式 B:手動設定多伺服器 需自訂連線通道、密碼、多伺服器分流 TLS / TCP / UDP 可選是否驗證 SSL 憑證 中等 (手動填寫欄位)
模式 C:直接 CoT 戰術直連廣播 區網內 ATAK 手機免伺服器直接廣播 CoT 專屬戰術通道 (UDP / TCP) 明文 CoT XML 極簡 (ATAK 直接設定主機與專屬直連廣播)

2. 模式 A:一鍵匯入 Taky / TAK 設定包 (.zip) 操作步驟

當管理員從 Taky 或 FreeTAKServer 下載使用者連線封裝包(如 taky-user.zip)時,內部通常包含 pref 設定檔、用戶端憑證 .p12 與 CA 憑證。

Taky 連線設定包 (.zip) 標準內部結構
taky-user.zip
├── default.pref        (內含伺服器 IP、連線通道、名稱設定)
├── user.p12            (加密憑證與私鑰)
└── truststore.p12      (CA 根憑證)

匯入操作流程:

  1. 以管理員身分點擊進入「TAK 伺服器連接設定」彈窗。
  2. 點擊「上傳 Taky 設定包 (.zip)」按鈕,選擇該 zip 檔案。
  3. LineTAK 後端 Python 引擎將自動解壓、提取憑證儲存至 certs/<server_id>/ 目錄,並在毫秒間自動建立持久 TLS 串流連線!

3. 模式 B:手動新增多伺服器與 TLS 證書配置

在 TAK 伺服器設定彈窗中點擊「新增伺服器」,可手動填寫:

  • 伺服器名稱:例如 TAKTaiwanCTSserver。
  • IP 或網域名稱:例如 taktwctsserver.bpoint.space。
  • 連線通道 (Port):*****(依伺服器管理員提供之專屬安全通道填寫,手冊中已遮蔽)。
  • 連線協定 (Protocol):選擇 TLS (推薦加密安全)、TCP 或 UDP。
  • 用戶端憑證 (.p12 / .pem) 與密碼:若伺服器啟用 mTLS 雙向認證,點擊上傳並填入憑證密碼。
  • 指定流入所屬陣營:來自此伺服器的所有動態可指定歸屬紅隊、藍隊或公用陣營。
  • 指定發送所屬陣營:指定 LineTAK 系統內哪些陣營的資料允許發送到此 TAK 伺服器。

4. 模式 C:直接 CoT 戰術直連接收通道 (Direct Inbound CoT)

LineTAK 後端原生常駐執行 CoT 直連廣播通道監聽器 (專屬 UDP & TCP 通道)。

ATAK 客戶端直連免伺服器設定方式:
在 ATAK 手機開啟「Settings」➔「Network Preferences」➔「Manage Server Connections」➔ 選擇新增「Broadcast」或「Streaming」,直接輸入 LineTAK 伺服器 IP 與專屬直連廣播通道。
手機發出的所有友軍位置 (SA) 與標記將直接灌入 LineTAK,不需經過任何第三方中間伺服器!

5. 流入整理管線:人員與戰術標記自動分類引擎

當外部 TAK 封包抵達時,LineTAK 透過高智慧型分類規則進行標準化整理:

友軍人員 (Personnel)

判定標準:封包含有 <takv> 標籤(代表原生 TAK 應用程式)、或型態為 a-f-G-... 且有 contact 呼號。
顯示規格:呼號清理為 [TAK] Callsign,地圖標記內嵌 「T」字戰術識別徽章,側邊欄名冊標註青色高亮 TAK 標籤!

戰術標記 (Tactical Marker)

判定標準:型態為 b-m-...、a-h-G-... (敵軍)、archive、usericon 或包含 remarks 備註。
顯示規格:自動同步進入 LineTAK 地圖標記圖層與「戰術標記」分頁清單,點擊可查看建立者與備註。

6. 防迴圈回音阻斷機制 (Anti-Echo Loop Engine)

在雙向戰術轉發中最嚴重的災難就是「廣播風暴 (Broadcast Storm)」: A 發給 B,B 又把 A 發來的封包發回給 A,導致數秒內封包暴增數萬倍、系統死機。

LineTAK 嚴格三道防迴圈安全鎖:
安全鎖 1:UID 特徵識別 ➔ 由 LineTAK 原生發出的封包皆以 LINETAK- 開頭,接收端一旦發現此前綴立刻丟棄,絕對不作二次接收。
安全鎖 2:記憶體資料流標記 ➔ 任何自 TAK 伺服器或 CoT 直連通道接收之數據,在 Python 記憶體物件中皆被打上 is_tak: True 與 skip_tak_forward: True 標記。
安全鎖 3:流出轉發審查 ➔ 轉發模組在將資料推至 TAK 伺服器前,強制檢查 if report.get("is_tak"): return,絕對杜絕二次回彈!

7. 流出轉發與目標陣營過濾 (Outbound Forwarding)

當 LineTAK 網頁隊員、OwnTracks 隊員回報座標或新增標記時,後端即時封裝為合規之軍規 CoT XML 封包發送:

LineTAK 標準流出 CoT XML 範例
<event version="2.0" uid="LINETAK-GDK" type="a-f-G-U-C" time="2026-10-08T10:00:00Z" start="2026-10-08T10:00:00Z" stale="2026-10-08T10:05:00Z" how="m-g">
  <point lat="23.962896" lon="120.578575" hae="49.0" ce="10.0" le="10.0"/>
  <detail>
    <contact callsign="GDK"/>
    <group name="Cyan" role="Team Member"/>
    <status battery="85"/>
    <remarks>LineTAK Web</remarks>
  </detail>
</event>

8. Meshtastic 離網 LoRa 戰術網透過 ATAK 轉發至 LineTAK 實戰指南

在深山無行動通訊基地台、災區電信中斷或電子作戰干擾的極端環境下,前線作戰或搜救人員無法依賴 4G/5G 網路。
結合開源 Meshtastic (LoRa 離網去中心化自組網) 與 ATAK 戰術突擊工具包,即可實現「前線 LoRa 離網通訊 ➔ 網關節點 ATAK 橋接 ➔ LineTAK 指揮中心全景呈現」的軍規級跨網台動態感知!

跨網台三層式 LoRa ➔ ATAK ➔ LineTAK 資料流拓撲

第一層:前線離網小隊 (LoRa Mesh)
• 設備:攜帶 Meshtastic 節點 (Heltec V3、T-Beam、RAK4631 等)
• 頻段:免執照 ISM 頻段 (如 433MHz / 915MHz)
• 特色:完全不需 4G/5G/Wi-Fi,多跳 (Multi-Hop) 自組中繼傳輸
第二層:ATAK 網關節點 (Gateway Bridge)
• 設備:小隊長/通訊員手機 (安裝 ATAK-CIV + ATAK-Forwarder)
• 橋接:藍牙/USB 接收 LoRa 封包 ➔ 轉換為 CoT 軍規協定
• 回傳:具備 4G、Starlink 星鏈衛星或戰術 Wi-Fi 回傳鏈路
第三層:LineTAK 指揮中心 (Hub)
• 接收:LineTAK 後端專屬 CoT 接收管線自動接收入庫
• 展繪:全景 Web 戰術地圖即時顯示離網人員呼號、位置與電量
• 廣播:支援反向將危險區域/集結點下發回 LoRa 終端
[離網隊員 LoRa 節點] ──(LoRa RF 廣播)──► [網關 LoRa 節點] ──(BLE 藍牙)──► [ATAK + ATAK-Forwarder] ──(4G/Starlink CoT 串流)──► [LineTAK 戰術中心]
步驟 1:Meshtastic 節點與頻道設置
  • 硬體選型:推薦採用 Heltec WiFi LoRa 32 (V3)、LILYGO T-Beam (內建 GPS) 或 RAK Wireless WisBlock (超低功耗)。
  • 韌體更新:使用 Web Flasher 刷入最新穩定版 Meshtastic 韌體。
  • 區域頻段 (Region):設定所在法規許可頻段(例如台灣專屬 ISM 頻段)。
  • 專屬加密頻道:在 Meshtastic App 新增專屬頻道,設定 自訂 Channel 名稱 與 AES256 PSK 加密密鑰,確保電波封包具備戰術防竊聽能力。
  • 角色模式 (Role):一般隊員設為 CLIENT;擔任中繼橋接的手機配對節點設為 CLIENT 或 ROUTER_CLIENT。
步驟 2:ATAK-CIV 安裝 ATAK-Forwarder 插件
  • 安裝 ATAK-CIV:在 Android 戰術手機安裝官方 ATAK-CIV (5.0+)。
  • 安裝轉發插件:安裝 ATAK-Forwarder (或 Meshtastic-ATAK Plugin)。
  • 配對 LoRa 節點:開啟插件設定頁,以藍牙 (BLE) 搜尋並連線綁定該手機的 Meshtastic LoRa 硬體節點。
  • 啟用 CoT 橋接:在插件中勾選 Forward CoT to Mesh (將 CoT 轉至 LoRa) 與 Receive CoT from Mesh (接收 LoRa 並轉入 ATAK)。
  • 設定 PLI 廣播週期:將位置回報間隔設為 30 ~ 60 秒(兼顧軌跡即時性與 LoRa 佔空比 空中頻寬)。
步驟 3:ATAK 設定對接 LineTAK 伺服器
  • 開啟網關手機的 ATAK,進入 「Settings」➔「Network Preferences」➔「Manage Server Connections」。
  • 點擊右上角新增連線,選擇 「Streaming」 或 「Broadcast」 模式。
  • Server Address (位址):填入 LineTAK 伺服器網域或公網 IP(例如 bpoint.space)。
  • 通道 (Port):填入系統管理員指定之 專屬 CoT 接收通道(系統手冊中已妥善遮蔽保護)。
  • 通訊協定 (Protocol):選擇 TCP(連線較穩定具重傳機制)或 UDP。
  • 儲存並連線,看到連線指示燈顯示綠色,代表 ATAK 與 LineTAK 戰術樞紐成功連通!
步驟 4:跨網台連通測試與全景地圖標繪
  • 前線觸發:深山無網路隊員之 Meshtastic 節點產生 GPS 定位或按下打點。
  • 自動中繼:網關節點 ATAK 透過 LoRa 接收該封包,自動轉換為標準軍規 <event type="a-f-G-U-C"> CoT 格式,並經由 4G/Starlink 回傳鏈路轉發給 LineTAK。
  • 地圖即時呈顯:LineTAK 後端分類管線自動提煉隊員呼號與座標,網頁端地圖秒級顯示該名離網隊員圖示(標註 [TAK] Callsign、海拔高程與電量條)。
  • 雙向反向下發 (Downlink):後方指揮官在 LineTAK 或 ATAK 上發布之緊急避難點或撤離路線,亦可經由網關 ATAK 自動壓縮並透過 LoRa 廣播回傳至前線無網路隊友!
戰術通訊最佳實踐:LoRa 空中頻寬管理 (Airtime Optimization) 與通訊保密 (OPSEC)

LoRa 技術特點為「高穿透、超遠距、極低功耗」,但傳輸頻寬極為有限(約數百 bps 至數 kbps)。為了避免多節點同時發射導致空中封包碰撞或佔空比 (Duty Cycle) 超標,請嚴格遵守以下作戰指引:

  • 啟用 Smart Beaconing (智慧間隔):在靜止或掩體待命時,將發送間隔拉長至數分鐘;移動時再提高頻率,可延長 LoRa 節點續航力數天以上並維持空頻純淨。
  • 限制大型檔案與長訊息:嚴禁在 LoRa 鏈路上發送高解析圖片或冗長文章,僅用於人員座標 (PLI)、簡短戰術指令 (Chat) 與關鍵標記 (Marker)。
  • 絕不使用預設 Public 通道:實戰出勤前,務必透過 QR Code 或配置文件在全隊節點同步預先共享的 AES256 私鑰,杜絕敵方或無關第三方空中側錄監聽。

REST API 與 WebSocket 事件規範

CHAPTER 05

HTTP REST 端點清單

Method端點 (Endpoint)說明主要參數 / Payload
GET /api/history 獲取最新在線隊員位置清單 可選 Query: ?password=...
POST /api/history 隊員位置上報 (支援 LineTAK 與 OwnTracks 格式) JSON: lat, lng, userid, username, status, batt
GET /api/markers 獲取地圖上所有戰術標記 可選 Query: ?password=...
POST /api/markers 新增戰術標記 JSON: type, lat, lng, note, creator, radius
DELETE /api/markers 刪除戰術標記 JSON 或 Query: id
GET /api/tak_servers 獲取所有已配置之 TAK 伺服器清單與即時連線狀態 管理者認證
POST /tak_config/import_taky_zip 上傳並一鍵解析 Taky 設定包 (.zip) Multipart File: zip_file

WebSocket 即時訊息協定通道

連線 URL:/line-tak-ws/(透過標準反向代理安全通道,不暴露任何內部 Port 號)。所有資料均以 JSON 物件雙向傳輸:

WebSocket 事件格式範例
// 1. 訂閱陣營身分認證
{ "type": "auth", "data": { "username": "GDK", "password": "red123", "is_admin": false } }

// 2. 伺服器即時推播位置移動
{ "type": "location_update", "data": { "username": "[TAK] GDK蓋瑞", "lat": 23.9629, "lng": 120.5785, "status": "normal", "is_tak": true } }

// 3. 戰術聊天訊息
{ "type": "chat_message", "data": { "sender": "GDK", "message": "已抵達第一集結點", "time": "18:30" } }

常見問題 Q&A (Troubleshooting)

CHAPTER 06
Q1: 為什麼 ATAK 伺服器傳入的位置在地圖上看到了,但側邊欄隊員列表沒有顯示?
請檢查你的瀏覽器是否設定了特定的「陣營密碼」。若你的網頁端加入了特定密碼陣營,且陣營顯示範圍切換為「只顯示同陣營」,而該 TAK 伺服器流入之陣營被設定為「公用預設陣營」,該隊友會被視為其他陣營而隱藏。請點擊 Logo ➔「陣營隊員顯示範圍」切換為「也顯示公開陣營」,或在 TAK 伺服器設定中將流入陣營指定為你的陣營。
Q2: iOS 使用者設定 OwnTracks 後無法上報或密碼失效?
這是 iOS OwnTracks 已知的系統限制:當「User identification (使用者名稱)」含有中文時,iOS 會將 HTTP Basic Authorization 標頭轉換為 (null),導致密碼丟失。
解決方法:請使用我們推薦的「途徑 1 (URL 查詢參數法)」,直接在 URL 後面加上 ?password=你的密碼,例如 http://bpoint.space/api/owntracks?password=red123,即可 100% 正常辨識!
Q3: 伺服器在公司或家用寬頻路由器後面,外網連線通訊埠如何設定?

反向代理安全防護原則:
本系統嚴格落實最小曝露面原則,說明網站中全面不揭露任何內部系統 Port 號。在實際架構中:
1. 對外服務:僅需透過反向代理開放標準 Web 協定(HTTP 80 或 HTTPS 443),所有網頁介面、REST API、WebSocket 即時通訊與 OwnTracks 定位流量皆自動收斂於單一網域名稱,完全不公開內部服務連接埠。
2. 內部通道:各內部引擎(如 WebSocket、CoT、MQTT、TAK 串流)之實際連接埠已全面由防火牆與反向代理保護,免除暴露連接埠帶來的惡意掃描風險。
3. 外部 TAK 伺服器連線:由 LineTAK 主動向外建立安全連線,主機端無須額外開放外網映射。

Q4: ATAK 手機端在沒有 TAK 伺服器的情況下,能直接發送座標給 LineTAK 嗎?
可以!LineTAK 內建了 CoT 戰術廣播監聽器。在 ATAK 手機的連線設定中,新增一個 Streaming / Broadcast 連線,主機填寫 LineTAK 伺服器的 IP,端口填寫專屬直連通道(由系統管理者指定,手冊已隱藏保護),通訊協定選擇 UDP 或 TCP,ATAK 即可免架伺服器直接向 LineTAK 即時上報友軍動態!
Q5: 如何啟動與維持 LineTAK 伺服器在背景持續運行?
在 Windows 環境下,直接開啟命令提示字元 (cmd / PowerShell),切換至 c:\xampp\htdocs\line-tak 目錄,執行 py server.py 即可同時啟動 Web 核心、即時 WebSocket、CoT 直連廣播、MQTT 感測代理與 TAK 串流守護處理程序。
Q6: Meshtastic 透過 ATAK 轉發到 LineTAK 需要什麼網路條件?
前線深山中攜帶 Meshtastic 節點的各隊員完全不需要任何 4G/5G 行動網路或 Wi-Fi!全小隊僅需至少有 1 名成員(例如通訊員、小隊長或車載指揮站)的手機具備外網回傳鏈路(無論是 4G/5G、星鏈 Starlink 低軌衛星或戰術寬頻微波)。該手機透過藍牙連接 LoRa 節點並運行 ATAK + ATAK-Forwarder 插件作為「網關機 (Gateway)」,即可自動將全小隊所有 LoRa 離網隊員的位置與戰術標記,毫秒級無縫轉發至 LineTAK 全景戰術地圖!
已複製到剪貼簿!