# Termux Headless Setup (Igbo) 🌐 **Languages:** 🇺🇸 [English](../../../../guides/TERMUX_GUIDE.md) · 🇪🇹 [am](../../../am/docs/guides/TERMUX_GUIDE.md) · 🇸🇦 [ar](../../../ar/docs/guides/TERMUX_GUIDE.md) · 🇦🇿 [az](../../../az/docs/guides/TERMUX_GUIDE.md) · 🇧🇬 [bg](../../../bg/docs/guides/TERMUX_GUIDE.md) · 🇧🇩 [bn](../../../bn/docs/guides/TERMUX_GUIDE.md) · 🇧🇦 [bs](../../../bs/docs/guides/TERMUX_GUIDE.md) · 🇨🇿 [cs](../../../cs/docs/guides/TERMUX_GUIDE.md) · 🇩🇰 [da](../../../da/docs/guides/TERMUX_GUIDE.md) · 🇩🇪 [de](../../../de/docs/guides/TERMUX_GUIDE.md) · 🇬🇷 [el](../../../el/docs/guides/TERMUX_GUIDE.md) · 🇪🇸 [es](../../../es/docs/guides/TERMUX_GUIDE.md) · 🇪🇪 [et](../../../et/docs/guides/TERMUX_GUIDE.md) · 🇮🇷 [fa](../../../fa/docs/guides/TERMUX_GUIDE.md) · 🇫🇮 [fi](../../../fi/docs/guides/TERMUX_GUIDE.md) · 🇫🇷 [fr](../../../fr/docs/guides/TERMUX_GUIDE.md) · 🇮🇪 [ga](../../../ga/docs/guides/TERMUX_GUIDE.md) · 🇮🇳 [gu](../../../gu/docs/guides/TERMUX_GUIDE.md) · 🇳🇬 [ha](../../../ha/docs/guides/TERMUX_GUIDE.md) · 🇮🇱 [he](../../../he/docs/guides/TERMUX_GUIDE.md) · 🇮🇳 [hi](../../../hi/docs/guides/TERMUX_GUIDE.md) · 🇭🇷 [hr](../../../hr/docs/guides/TERMUX_GUIDE.md) · 🇭🇺 [hu](../../../hu/docs/guides/TERMUX_GUIDE.md) · 🇦🇲 [hy](../../../hy/docs/guides/TERMUX_GUIDE.md) · 🇮🇩 [id](../../../id/docs/guides/TERMUX_GUIDE.md) · 🇮🇹 [it](../../../it/docs/guides/TERMUX_GUIDE.md) · 🇯🇵 [ja](../../../ja/docs/guides/TERMUX_GUIDE.md) · 🇬🇪 [ka](../../../ka/docs/guides/TERMUX_GUIDE.md) · 🇰🇭 [km](../../../km/docs/guides/TERMUX_GUIDE.md) · 🇮🇳 [kn](../../../kn/docs/guides/TERMUX_GUIDE.md) · 🇰🇷 [ko](../../../ko/docs/guides/TERMUX_GUIDE.md) · 🇱🇹 [lt](../../../lt/docs/guides/TERMUX_GUIDE.md) · 🇱🇻 [lv](../../../lv/docs/guides/TERMUX_GUIDE.md) · 🇮🇳 [ml](../../../ml/docs/guides/TERMUX_GUIDE.md) · 🇮🇳 [mr](../../../mr/docs/guides/TERMUX_GUIDE.md) · 🇲🇾 [ms](../../../ms/docs/guides/TERMUX_GUIDE.md) · 🇲🇹 [mt](../../../mt/docs/guides/TERMUX_GUIDE.md) · 🇲🇲 [my](../../../my/docs/guides/TERMUX_GUIDE.md) · 🇳🇵 [ne](../../../ne/docs/guides/TERMUX_GUIDE.md) · 🇳🇱 [nl](../../../nl/docs/guides/TERMUX_GUIDE.md) · 🇳🇴 [no](../../../no/docs/guides/TERMUX_GUIDE.md) · 🇮🇳 [or](../../../or/docs/guides/TERMUX_GUIDE.md) · 🇮🇳 [pa](../../../pa/docs/guides/TERMUX_GUIDE.md) · 🇵🇭 [phi](../../../phi/docs/guides/TERMUX_GUIDE.md) · 🇵🇱 [pl](../../../pl/docs/guides/TERMUX_GUIDE.md) · 🇵🇹 [pt](../../../pt/docs/guides/TERMUX_GUIDE.md) · 🇧🇷 [pt-BR](../../../pt-BR/docs/guides/TERMUX_GUIDE.md) · 🇷🇴 [ro](../../../ro/docs/guides/TERMUX_GUIDE.md) · 🇷🇺 [ru](../../../ru/docs/guides/TERMUX_GUIDE.md) · 🇱🇰 [si](../../../si/docs/guides/TERMUX_GUIDE.md) · 🇸🇰 [sk](../../../sk/docs/guides/TERMUX_GUIDE.md) · 🇸🇮 [sl](../../../sl/docs/guides/TERMUX_GUIDE.md) · 🇷🇸 [sr](../../../sr/docs/guides/TERMUX_GUIDE.md) · 🇸🇪 [sv](../../../sv/docs/guides/TERMUX_GUIDE.md) · 🇰🇪 [sw](../../../sw/docs/guides/TERMUX_GUIDE.md) · 🇮🇳 [ta](../../../ta/docs/guides/TERMUX_GUIDE.md) · 🇮🇳 [te](../../../te/docs/guides/TERMUX_GUIDE.md) · 🇹🇭 [th](../../../th/docs/guides/TERMUX_GUIDE.md) · 🇹🇷 [tr](../../../tr/docs/guides/TERMUX_GUIDE.md) · 🇺🇦 [uk-UA](../../../uk-UA/docs/guides/TERMUX_GUIDE.md) · 🇵🇰 [ur](../../../ur/docs/guides/TERMUX_GUIDE.md) · 🇺🇿 [uz](../../../uz/docs/guides/TERMUX_GUIDE.md) · 🇻🇳 [vi](../../../vi/docs/guides/TERMUX_GUIDE.md) · 🇳🇬 [yo](../../../yo/docs/guides/TERMUX_GUIDE.md) · 🇨🇳 [zh-CN](../../../zh-CN/docs/guides/TERMUX_GUIDE.md) · 🇹🇼 [zh-TW](../../../zh-TW/docs/guides/TERMUX_GUIDE.md) --- OmniRoute nwere ike ịrụ ọrụ dịka sava na-enweghị ihu njirimara na Android site na Termux. A naghị akwado ngwa desktọọpụ Electron na Termux, mana dashboard weebụ na API dakọtara na OpenAI na-arụ ọrụ site na ihe nchọgharị mpaghara ma ọ bụ site na ngwaọrụ ndị ọzọ nọ n'otu netwọk ahụ. ## Ihe Ndị Achọrọ Tupu Amalite Wụnye Termux site na F-Droid ma ọ bụ mbipụta GitHub, emesịa melite ngwugwu ma wụnye ngwaọrụ nrụpụta ndị dependency native dịka `better-sqlite3` chọrọ. ```bash pkg update pkg upgrade pkg install nodejs python build-essential git ``` > **Ụdị Node.js:** OmniRoute chọrọ Node `>=22.22.2 <23 || >=24.0.0 <27` (nke kwekọrọ na `engines` dị na `package.json` / `SUPPORTED_NODE_RANGE`). `nodejs-lts` nke Termux na-ebukarị Node 20 LTS, nke **anaghịzi akwado** — kama nke ahụ, wụnye `pkg install nodejs` (ụdị dị ugbu a) ma nyochaa na `node --version` na-egosi ahịrị 22.x/24.x+. Ọ bụrụ na mkpokọta ngwugwu native ada, mee iwu `pkg install` dị n'elu ọzọ, wee nwaa nrụnye OmniRoute ọzọ. ## Nrụnye Gbaa ngwugwu kachasị ọhụrụ e bipụtara ozugbo: ```bash npx -y omniroute@latest ``` Ị nwekwara ike iwunye ya n'ogo zuru ụwa ọnụ: ```bash npm install -g omniroute omniroute ``` ## Otu E Si Agba Ya Bido OmniRoute n'ụdị sava na-enweghị ihu njirimara: ```bash omniroute ``` ma ọ bụ: ```bash npx omniroute ``` Dashboard na-ege ntị na: ```text http://localhost:20128 ``` Mepee URL ahụ n'ihe nchọgharị Android. Ọ bụrụ na ị na-agba client n'ime Termux, jiri otu host na port ahụ dịka base URL dakọtara na OpenAI. ## Ịgba Ọrụ n'Azụ Maka process dị mfe nke na-agba n'azụ: ```bash nohup omniroute > omniroute.log 2>&1 & ``` Iji kwụsị ya: ```bash pkill -f omniroute ``` Maka mmalite akpaaka mgbe ngwaọrụ gbanyechara, wụnye mgbakwunye Termux:Boot ma mepụta skrip boot: ```bash mkdir -p ~/.termux/boot cat > ~/.termux/boot/omniroute.sh <<'EOF' #!/data/data/com.termux/files/usr/bin/sh cd "$HOME" nohup omniroute > "$HOME/omniroute.log" 2>&1 & EOF chmod +x ~/.termux/boot/omniroute.sh ``` Nchekwa batrị Android nwere ike ịkwụsị process ndị na-agba n'azụ ogologo oge. Gbanyụọ njikarịcha batrị maka Termux ma ọ bụrụ na a tụrụ anya na sava ga-anọ n'ịntanetị. ## Ịnweta Ya Site na Ngwaọrụ Ndị Ọzọ Chọta adreesị IP ekwentị na netwọk WiFi: ```bash ip addr show wlan0 ``` Mgbe ahụ, mepee dashboard site na ngwaọrụ ọzọ: ```text http://PHONE_IP:20128 ``` Dịka ọmụmaatụ: ```text http://192.168.1.50:20128 ``` Debe ekwentị na client n'otu netwọk a tụkwasịrị obi. Ọ bụrụ na ị mee ka OmniRoute dịrị site n'èzí ekwentị ahụ, gbanye igodo API na nyocha njirimara dashboard. ## Ebe Nchekwa Data Na ndabara, OmniRoute na-echekwa data n'okpuru ndekọ ụlọ Termux, dịka omume ụzọ data nke akụkụ sava a na-eji na Linux. Iji tinye database n'ebe akọwapụtara nke ọma: ```bash export DATA_DIR="$HOME/.omniroute" omniroute ``` ## Mmachi - Electron anaghị arụ ọrụ na Termux. - Enweghị system tray ma ọ bụ njikọta desktọọpụ. - Nhazi a bụ naanị maka sava: jiri dashboard ihe nchọgharị. - Dependency native nwere ike ịchọ mkpokọta n'ime ngwaọrụ ahụ. - Ngwaọrụ Android nwere ebe nchekwa dị ala nwere ike ịchọ arịrịọ ole na ole na-aga n'otu oge. - Njirimara asambodo MITM/system nwere ike ịchọ ọrụ trust-store n'ogo Android n'èzí Termux. ## Nchọpụta na Ndozi Nsogbu ### Platform Anaghị Akwado: android (arịrịọ ọ bụla na-eweghachi HTTP 500) **Mgbaàmà:** `omniroute` / `omniroute serve` na-ebipụta `✔ OmniRoute is running!`, mana arịrịọ dashboard ma ọ bụ API ọ bụla na-eweghachi naanị `500 Internal Server Error`. `~/.omniroute/logs/application/app.log` na-anọgide ghe oghe, `APP_LOG_LEVEL=debug` anaghị ebipụta ihe bara uru, ma ọdịnaya nzaghachi bụ ederede nkịtị (`Internal Server Error`) na-enweghị nkọwa JSON. **Ihe kpatara ya:** Ụfọdụ build Termux/Node na-akọ `process.platform === "android"`. `getCacheDirectory()` nke Next.js anaghị akwado platform ahụ: ọ chọrọ ka `~/.cache` (ma ọ bụ ndekọ tmp izugbe) _dịrịrị_ tupu oge eruo, ma ọ bụghị ya, ọ ga-ada mgbe ọ na-ebunye instrumentation hook site na njehie a: ```text Error: An error occurred while loading instrumentation hook: Unsupported platform: android ``` N'ihi na hook ahụ anaghị ebunye ma ọlị, ndekọ log anaghị amalite — nke a na-eme ka o yie na enweghị ụzọ isi chọpụta ihe kpatara 500 ahụ. OmniRoute na-emepụta `~/.cache` (ma na-ahazi `XDG_CACHE_HOME` mgbe ahazibeghị ya) n'ebe mbido CLI tupu Next.js amalite, ka nyocha a wee gaa nke ọma na Android/Termux. **Ndozi akwadoro (na-enweghị imegharị ngwugwu):** ```bash mkdir -p ~/.cache omniroute serve ``` Na build OmniRoute ndị dị ugbu a, CLI na-eme nke a na akpaaka na Android/Termux — `npx -y omniroute@latest` ọhụrụ / nrụnye zuru ụwa ọnụ ekwesịghị ịchọ usoro aka a. Ọ bụrụ na ị ka na-ahụ njehie ahụ mgbe nkwalite gasịrị, mepụta `~/.cache` otu ugboro dịka e gosiri n'elu ma malitegharịa ya. **Emela** mgbanwe na `dist/server.js` iji manye `process.platform = "linux"`. A na-edegharị ụdị mgbanwe ngwugwu ahụ n'oge nrụnye/nkwalite ọ bụla, ọ dịghịkwa mkpa ozugbo ndekọ cache dị. ### Njehie Nrụpụta better-sqlite3 Wụnye usoro ngwaọrụ nrụpụta Termux: ```bash pkg install nodejs python build-essential ``` Mgbe ahụ, gbaa ya ọzọ: ```bash npx -y omniroute@latest ``` ### Port Adịlarị n'Ojiji Lelee ihe na-ege ntị na port ndabara: ```bash ss -ltnp | grep 20128 ``` Kwụsị process ochie ahụ: ```bash pkill -f omniroute ``` ### Enweghị Ike Ịnweta Dashboard Site na Ngwaọrụ Ọzọ Nyochaa na ngwaọrụ abụọ ahụ nọ n'otu netwọk WiFi, emesịa nwalee site na Termux: ```bash curl http://localhost:20128 ``` Ọ bụrụ na ohere mpaghara na-arụ ọrụ mana ohere LAN anaghị arụ ọrụ, lelee ikewapụ hotspot/WiFi nke Android yana firewall ma ọ bụ profaịlụ VPN ọ bụla dị na ekwentị ahụ.