系統總覽與設計架構
CHAPTER 01在傳統戰術行動或戶外救援搜救中,指揮中心與現場隊員常常面臨裝備與生態碎片化的巨大挑戰: 有的隊員攜帶安裝有 ATAK (Android Tactical Assault Kit) 的專業三防手持機,有的隊員攜帶 iPhone / 一般智慧型手機,甚至還有隊員使用無螢幕的 GPS 追蹤器或直接以通訊軟體報位。
LineTAK 扮演著全體系的「戰術交換網關樞紐 (Tactical SA Hub)」,具備以下核心技術特點:
隊員免下載安裝龐大 App,透過 LINE 官方帳號點擊連結即可直接秒開地圖,自動完成定位、回報、發送求救與查看隊友。
解決網頁端螢幕關閉即休眠的痛點,利用開源 OwnTracks 原生背景常駐能力,全天候穩定回傳 GPS 軌跡、海拔與電量。
原生支援 Cursor-on-Target (CoT XML) 軍規格式。支援多台 Taky / FreeTAK 伺服器串流接入與轉發,並內建防迴圈阻斷引擎。
內建正規北約軍規 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 全景地圖 |
網頁與手機端操作手冊
CHAPTER 021. 身分登入、陣營劃分與密碼隔離機制 (Faction & Password Architecture)
使用者進入 LineTAK 網頁(例如 http://domain/line-tak/)時,系統會自動彈出身分認證面板:
- LINE LIFF 一鍵登入:在 LINE App 內開啟時,點選「LINE 快速登入」自動取得使用者暱稱與頭像,迅速完成實名認證。
- 瀏覽器直接登入:在電腦或一般手機瀏覽器環境下,可手動自訂「呼號 (Callsign)」與「陣營密碼 (Faction Password)」。
陣營與密碼的核心運作原理 (Password = Faction Shared Key)
傳統戰術通訊系統通常需要網管人員事先在後台開立帳號、設定複雜的群組權限,在野外緊急搜救或臨時組隊時往往造成嚴重的通聯延誤。 LineTAK 採用創新的「密碼即陣營 (Shared Secret Key)」分流設計,實現了零前置設定、即開即用的戰術分組體系:
當密碼留空時,裝置自動歸屬於公共頻道。適合公開聯合搜救、跨單位大會師或開放式教學展示,所有未設密碼的 Web 與 OwnTracks 成員皆能互見彼此座標。
只要小隊長與隊員約定好相同字串(例如 Alpha、RedTeam,區分大小寫),系統便會以此作為通訊隔離金鑰,非該陣營成員無法接收其動態。
陣營密碼所涵蓋的四重安全隔離維度:
- 1. 即時經緯度遙測隔離:WebSocket 伺服器僅會將隊員位置廣播給輸入相同密碼的客戶端,避免敵軍或外人窺探小隊部署與行進軌跡。
- 2. 戰術地圖標記隔離:在地圖上標記之「敵軍 (Hostile)」、「友軍 (Friendly)」、「撤離點 (Exfil)」等 NATO 戰術圖示會自動綁定該陣營密碼,其他陣營無法查看。
- 3. 戰術文字聊天加密分流:戰術聊天室的即時廣播僅在同陣營頻道內流通,確保文字通訊安全。
- 4. 緊急求救 (SOS / 9-Line) 警報定向通知:觸發 PANIC SOS 或 9-Line 醫療後送單時,警報音效與地圖閃爍精準推送給同陣營指揮官與隊友。
• 陣營密碼 (Faction Password):一般隊員自由輸入,用於小隊通訊分組與情資隔離,不具備系統管理權限。
• 戰情室管理員密碼 (Admin Password):專供指揮官存取「數位戰情室 (War Room)」後台與管理「TAK 伺服器通道」之系統級權限,具備跨陣營全地圖監控與全局情資調度能力。
2. 位置回報與 GPS 模擬測試
側邊欄最上方的「戰術位置回報」控制卡提供以下核心按鈕:
- 「立即上報位置」:點擊後即刻讀取手機 GPS 硬體並將最新座標封裝推送至伺服器。
- 「自動定時上報 (10s)」開關:開啟後,系統每 10 秒在後台自動獲取一次座標並同步,免手動重複點擊。
- 「模擬 GPS (點地圖設定位置)」:勾選後,直接點擊地圖任意地點即可將自身瞬移至該點。極度適合在室內無 GPS 訊號時進行沙盤兵棋推演!
- 「啟動自動巡邏模擬 (漂移)」:開啟後,虛擬角色會在地圖上自動隨機漫遊漂移,方便測試動態追蹤與警報功能。
3. 戰術狀態與北約 9-Line MEDEVAC 求救系統
LineTAK 支援四種作戰狀態切換: 正常 (Standby)、 需要幫忙 (Help)、 戰鬥 (Combat)、 求救 (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 完整內建現代北約作戰符號標準:
標準紅色菱形框架,代表敵方部隊、交火目標、敵狙擊點或可疑敵軍載具。
標準藍色圓角矩形,代表友軍哨所、前方觀察所 (OP) 或後方支援單位。
綠色方形,代表中立平民設施、聯合國/紅十字會救護站或非武裝區。
黃色雲狀標記,代表未經確認之聲響、雷達接觸或待清查之不明目標。
5. 戰術測距 (Ruler) 與電子圍欄接近預警 (Geofence Alarm)
點擊側邊欄工具中的「戰術測距」按鈕,地圖即進入測距模式。在圖上依序點擊任意兩點或多點,系統自動繪製螢光測距線,並在終點即時計算出總直線距離(公尺 / 公里)以及方位角(0° ~ 360°)。
建立戰術標記時可填寫「警戒半徑 (公尺)」。當自身或任何在線隊友的 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 03OwnTracks 是一款開源、免費且極度省電的 GPS 軌跡回報 App(支援 Android 與 iOS)。
現代智慧型手機(尤其是 iOS 與 Android 12+)具備極端嚴格的後台省電管理。若純靠手機瀏覽器回報位置,當螢幕關閉或切換至其他 App 時,瀏覽器通常會在 30 秒至 1 分鐘內被系統強制休眠並停止發送 GPS。
OwnTracks 作為原生 App,採用作業系統底層 Location Service,在手機完全鎖屏黑屏、放進戰術背心口袋時,依然能穩定持續每數秒回報座標!
OwnTracks HTTP 模式設定步驟 (最推薦)
請依照以下步驟在手機 OwnTracks App 內完成設定:
- 至 Google Play 或 Apple App Store 下載安裝 OwnTracks。
- 開啟 App,點擊左上角或右上角進入 Preferences (設定) ➔ Connection (連線)。
- 在 Mode (連線模式) 選擇
HTTP。 - 在 Host (主機設定) 填寫:
- URL (端點網址):
http://bpoint.space/api/owntracks(標準反向代理免 Port 端點;若有 SSL 憑證則填https://...)。 - User identification (用戶標識):填寫你的呼號,例如
GDK(LineTAK 地圖上會自動加上高亮綠色標章[OT] GDK)。 - Device identification (設備標識 / Tracker ID):可填寫 2 碼代號如
72。
- URL (端點網址):
- 回到主畫面,點擊右下角的「向上箭頭 (發送最新位置)」,看到綠色打勾即代表上報成功!
陣營密碼傳遞 7 大途徑技術詳解
OwnTracks 客戶端原生只有回報經緯度,沒有直接的陣營欄位。 LineTAK 後端專門打造了強大容錯的七重陣營密碼辨識管線 (Faction Resolution Pipeline),支援以下任一種方式將設備綁定至特定陣營:
在 URL 後方直接附加 ?password=陣營密碼
範例:http://bpoint.space/api/owntracks?password=red123
★ 絕對不被手機系統轉碼破壞,100% 成功率!
在 Connection 的 Password (密碼) 欄位直接填寫陣營密碼。
注意:iOS 若 Username 含中文,Basic Auth 會被 iOS 轉成 (null),此時請改用途徑 1。
在 Android OwnTracks 的 Device ID (X-Limit-D) 欄位填入 pas:red123 或直接填寫陣營密碼。
使用者名稱直接取為 GDK [red123] 或 GDK(red123)。LineTAK 會自動剝離括號提取密碼,畫面上乾淨顯示 [OT] GDK。
支援以自訂 HTTP 標頭發送:X-Password: red123 或 X-Faction-Password: red123。
在 MQTT 模式下,Topic 設定為 owntracks/red123/username/phone。
任何沒有帶密碼或密碼不存在的 OwnTracks 設備,LineTAK 一律自動配置給「公用預設陣營 (Cyan)」,保證絕對不漏接任何訊號!
遙測欄位對應與 SOS 緊急救援自動觸發
LineTAK 伺服器接收 OwnTracks JSON 時之欄位對齊關係:
lat/lon➔ 經緯度座標。alt➔ 海拔高程 (公尺)。batt➔ 設備電量百分比(隊友名冊即時顯示綠色電量條)。vel➔ 移動時速 (km/h)。acc➔ GPS 水平精度誤差 (±公尺)。- SOS 連動:在 OwnTracks 設定一個名為
emergency或rescue的 Region(電子圍欄),當隊員進入該圍欄或將狀態設為 emergency 時,LineTAK 立即將其標記為紅光求救狀態!
OwnTracks 設備若超過 18 秒 未收到任何位置訊號,圖示即刻變為灰色「離線狀態 (Offline)」以提示隊友可能失去通訊或進入掩體;超過 600 秒 (10 分鐘) 則自活動圖層清除。
為提升系統防護並防範針對特定連接埠的網路掃描,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 的完整配置:
/api/owntracks 端點網址
TAK 伺服器雙向互聯與 CoT 管線技術拆解
CHAPTER 04LineTAK 不僅是一個輕量作戰地圖,更是完整的 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-user.zip
├── default.pref (內含伺服器 IP、連線通道、名稱設定)
├── user.p12 (加密憑證與私鑰)
└── truststore.p12 (CA 根憑證)
匯入操作流程:
- 以管理員身分點擊進入「TAK 伺服器連接設定」彈窗。
- 點擊「上傳 Taky 設定包 (.zip)」按鈕,選擇該 zip 檔案。
- 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 手機開啟「Settings」➔「Network Preferences」➔「Manage Server Connections」➔ 選擇新增「Broadcast」或「Streaming」,直接輸入 LineTAK 伺服器 IP 與專屬直連廣播通道。
手機發出的所有友軍位置 (SA) 與標記將直接灌入 LineTAK,不需經過任何第三方中間伺服器!
5. 流入整理管線:人員與戰術標記自動分類引擎
當外部 TAK 封包抵達時,LineTAK 透過高智慧型分類規則進行標準化整理:
判定標準:封包含有 <takv> 標籤(代表原生 TAK 應用程式)、或型態為 a-f-G-... 且有 contact 呼號。
顯示規格:呼號清理為 [TAK] Callsign,地圖標記內嵌 「T」字戰術識別徽章,側邊欄名冊標註青色高亮 TAK 標籤!
判定標準:型態為 b-m-...、a-h-G-... (敵軍)、archive、usericon 或包含 remarks 備註。
顯示規格:自動同步進入 LineTAK 地圖標記圖層與「戰術標記」分頁清單,點擊可查看建立者與備註。
6. 防迴圈回音阻斷機制 (Anti-Echo Loop Engine)
在雙向戰術轉發中最嚴重的災難就是「廣播風暴 (Broadcast Storm)」: A 發給 B,B 又把 A 發來的封包發回給 A,導致數秒內封包暴增數萬倍、系統死機。
安全鎖 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 封包發送:
<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 資料流拓撲
• 頻段:免執照 ISM 頻段 (如 433MHz / 915MHz)
• 特色:完全不需 4G/5G/Wi-Fi,多跳 (Multi-Hop) 自組中繼傳輸
• 橋接:藍牙/USB 接收 LoRa 封包 ➔ 轉換為 CoT 軍規協定
• 回傳:具備 4G、Starlink 星鏈衛星或戰術 Wi-Fi 回傳鏈路
• 展繪:全景 Web 戰術地圖即時顯示離網人員呼號、位置與電量
• 廣播:支援反向將危險區域/集結點下發回 LoRa 終端
- 硬體選型:推薦採用
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。
- 安裝 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 佔空比 空中頻寬)。
- 開啟網關手機的 ATAK,進入 「Settings」➔「Network Preferences」➔「Manage Server Connections」。
- 點擊右上角新增連線,選擇 「Streaming」 或 「Broadcast」 模式。
- Server Address (位址):填入 LineTAK 伺服器網域或公網 IP(例如
bpoint.space)。 - 通道 (Port):填入系統管理員指定之 專屬 CoT 接收通道(系統手冊中已妥善遮蔽保護)。
- 通訊協定 (Protocol):選擇
TCP(連線較穩定具重傳機制)或UDP。 - 儲存並連線,看到連線指示燈顯示綠色,代表 ATAK 與 LineTAK 戰術樞紐成功連通!
- 前線觸發:深山無網路隊員之 Meshtastic 節點產生 GPS 定位或按下打點。
- 自動中繼:網關節點 ATAK 透過 LoRa 接收該封包,自動轉換為標準軍規
<event type="a-f-G-U-C">CoT 格式,並經由 4G/Starlink 回傳鏈路轉發給 LineTAK。 - 地圖即時呈顯:LineTAK 後端分類管線自動提煉隊員呼號與座標,網頁端地圖秒級顯示該名離網隊員圖示(標註
[TAK] Callsign、海拔高程與電量條)。 - 雙向反向下發 (Downlink):後方指揮官在 LineTAK 或 ATAK 上發布之緊急避難點或撤離路線,亦可經由網關 ATAK 自動壓縮並透過 LoRa 廣播回傳至前線無網路隊友!
LoRa 技術特點為「高穿透、超遠距、極低功耗」,但傳輸頻寬極為有限(約數百 bps 至數 kbps)。為了避免多節點同時發射導致空中封包碰撞或佔空比 (Duty Cycle) 超標,請嚴格遵守以下作戰指引:
- 啟用 Smart Beaconing (智慧間隔):在靜止或掩體待命時,將發送間隔拉長至數分鐘;移動時再提高頻率,可延長 LoRa 節點續航力數天以上並維持空頻純淨。
- 限制大型檔案與長訊息:嚴禁在 LoRa 鏈路上發送高解析圖片或冗長文章,僅用於人員座標 (PLI)、簡短戰術指令 (Chat) 與關鍵標記 (Marker)。
- 絕不使用預設 Public 通道:實戰出勤前,務必透過 QR Code 或配置文件在全隊節點同步預先共享的 AES256 私鑰,杜絕敵方或無關第三方空中側錄監聽。
REST API 與 WebSocket 事件規範
CHAPTER 05HTTP 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 物件雙向傳輸:
// 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(null),導致密碼丟失。解決方法:請使用我們推薦的「途徑 1 (URL 查詢參數法)」,直接在 URL 後面加上
?password=你的密碼,例如 http://bpoint.space/api/owntracks?password=red123,即可 100% 正常辨識!
反向代理安全防護原則:
本系統嚴格落實最小曝露面原則,說明網站中全面不揭露任何內部系統 Port 號。在實際架構中:
1. 對外服務:僅需透過反向代理開放標準 Web 協定(HTTP 80 或 HTTPS 443),所有網頁介面、REST API、WebSocket 即時通訊與 OwnTracks 定位流量皆自動收斂於單一網域名稱,完全不公開內部服務連接埠。
2. 內部通道:各內部引擎(如 WebSocket、CoT、MQTT、TAK 串流)之實際連接埠已全面由防火牆與反向代理保護,免除暴露連接埠帶來的惡意掃描風險。
3. 外部 TAK 伺服器連線:由 LineTAK 主動向外建立安全連線,主機端無須額外開放外網映射。
c:\xampp\htdocs\line-tak 目錄,執行 py server.py 即可同時啟動 Web 核心、即時 WebSocket、CoT 直連廣播、MQTT 感測代理與 TAK 串流守護處理程序。