如果你手上有幾個(gè) SQLite 數(shù)據(jù)庫(kù)文件散落在服務(wù)器或自己的電腦里想用瀏覽器直接看表、跑 SQL、導(dǎo)出 CSVSQLITE-WEB 是我用得最順手的工具之一。它本質(zhì)上是一個(gè)用 Go 寫(xiě)的輕量 Web 服務(wù)把一個(gè) SQLite 文件暴露成可交互的管理頁(yè)面部署就一個(gè)可執(zhí)行文件不依賴運(yùn)行時(shí)也不挑系統(tǒng)。本地用確實(shí)方便可一旦從另一臺(tái)電腦、手機(jī)甚至跨網(wǎng)絡(luò)訪問(wèn)很多人開(kāi)始卡殼頁(yè)面打不開(kāi)、綁定了 0.0.0.0 也沒(méi)用、認(rèn)證一直不過(guò)……這篇文章把遠(yuǎn)程訪問(wèn) SQLITE-WEB 牽扯到的監(jiān)聽(tīng)、防火墻、SSH 端口轉(zhuǎn)發(fā)、HTTPS 入口和運(yùn)維排錯(cuò)一次講透適合剛接觸 SQLITE-WEB 的開(kāi)發(fā)者也適合那些想讓小服務(wù)器上的數(shù)據(jù)庫(kù)隨時(shí)可查的運(yùn)維。1. 整體思路遠(yuǎn)程訪問(wèn) SQLITE-WEB 到底在解決什么問(wèn)題1.1 為什么選 SQLITE-WEB 做遠(yuǎn)程管理面板SQLite 和 MySQL、PostgreSQL 最大的區(qū)別在于它是嵌入式數(shù)據(jù)庫(kù)所有數(shù)據(jù)都在一個(gè)普通文件里沒(méi)有獨(dú)立服務(wù)進(jìn)程也沒(méi)有網(wǎng)絡(luò)協(xié)議。你平時(shí)在本機(jī)用命令行工具或圖形客戶端操作沒(méi)問(wèn)題但放到服務(wù)器上管理手段就只剩兩種SSH 進(jìn)去敲sqlite3命令或者把數(shù)據(jù)庫(kù)文件下載到本地再改。這兩種方式都不適合遠(yuǎn)程頻繁操作尤其是當(dāng)你只是查一條記錄、導(dǎo)入一個(gè)小 CSV、看一眼表結(jié)構(gòu)時(shí)開(kāi)命令行純屬殺雞用牛刀。SQLITE-WEB 恰好補(bǔ)上了這個(gè)空檔。它把 SQLite 文件包裝成一個(gè) Web 界面瀏覽器里就能看表、執(zhí)行 SQL、導(dǎo)入導(dǎo)出 CSV甚至做點(diǎn)簡(jiǎn)單圖表。我選擇它的原因很實(shí)在單文件二進(jìn)制Linux、macOS、Windows 都能跑不依賴 Python、Node 這些運(yùn)行時(shí)啟動(dòng)一條命令搞定界面足夠輕對(duì)老舊小機(jī)器也友好。相比那些重型數(shù)據(jù)庫(kù)管理面板它和 SQLite 的定位是一致的——小而夠用。但“Web 界面”四個(gè)字容易給人錯(cuò)覺(jué)以為它天然支持遠(yuǎn)程訪問(wèn)。實(shí)際上 SQLITE-WEB 默認(rèn)只監(jiān)聽(tīng)本機(jī)回環(huán)地址這意味著只有你自己這臺(tái)機(jī)器能打開(kāi)。遠(yuǎn)程訪問(wèn)的所有工作本質(zhì)上就是把這個(gè)“默認(rèn)只給本機(jī)用”的服務(wù)安全地開(kāi)放給別的機(jī)器同時(shí)在開(kāi)放過(guò)程中不讓數(shù)據(jù)裸奔。1.2 遠(yuǎn)程訪問(wèn)的三要素監(jiān)聽(tīng)、可達(dá)、控制我把遠(yuǎn)程訪問(wèn)拆成三件事排錯(cuò)和部署都按這個(gè)順序來(lái)。第一監(jiān)聽(tīng)地址。SQLITE-WEB 進(jìn)程需要決定自己監(jiān)聽(tīng)哪塊網(wǎng)卡?；丨h(huán)地址127.0.0.1只有本機(jī)能碰0.0.0.0代表所有網(wǎng)卡局域網(wǎng)里的機(jī)器甚至公網(wǎng)都能碰到。大部分人說(shuō)“遠(yuǎn)程訪問(wèn)不了”原因就是忘改監(jiān)聽(tīng)地址。第二網(wǎng)絡(luò)可達(dá)。監(jiān)聽(tīng)地址改成0.0.0.0只是第一步從訪問(wèn)者到服務(wù)之間還有很多關(guān)卡本機(jī)防火墻、云服務(wù)器安全組、路由器端口映射每一層都可能把請(qǐng)求攔掉。網(wǎng)頁(yè)打不開(kāi)時(shí)大多數(shù)人懷疑是程序問(wèn)題其實(shí)八成卡在這一層。第三訪問(wèn)控制。服務(wù)一旦能被別人訪問(wèn)到就必須考慮認(rèn)證、只讀、加密傳輸這些問(wèn)題。SQLITE-WEB 支持基本認(rèn)證也支持只讀模式但需要你主動(dòng)配置默認(rèn)不會(huì)替你擋。公網(wǎng)場(chǎng)景下還得加 HTTPS否則賬號(hào)密碼在鏈路上裸奔。后面所有實(shí)操都是圍繞這三個(gè)要素展開(kāi)。先把地圖畫(huà)清楚再動(dòng)手就不會(huì)亂。2. 安裝與核心參數(shù)先弄清楚每個(gè)開(kāi)關(guān)2.1 單文件與 Docker 兩種安裝方式安裝這東西有兩種主流方式我兩種都用過(guò)場(chǎng)景不同。單文件方式最直接。去項(xiàng)目發(fā)布頁(yè)下載對(duì)應(yīng)平臺(tái)的可執(zhí)行文件比如 Linux x86_64 就下那個(gè) linux 版本解壓后扔到/usr/local/bin/加執(zhí)行權(quán)限就行。命令名可能是sqlite-web也可能是sqlite_web以你下載的包為準(zhǔn)用--help確認(rèn)一下。版本差異是我踩過(guò)的坑不同版本的參數(shù)名略有不同比如有的用短參數(shù)-H、-p有的長(zhǎng)參數(shù)更全所以第一件事永遠(yuǎn)是看--help輸出。Docker 方式適合不想在本機(jī)裝多余文件的場(chǎng)景。官方鏡像本身就是把 SQLITE-WEB 封裝好掛載數(shù)據(jù)目錄、映射端口即可。這兩種方式的核心參數(shù)完全一致區(qū)別只在進(jìn)程由誰(shuí)來(lái)拉起來(lái)。我自己的建議長(zhǎng)期跑的服務(wù)用 systemd 托管二進(jìn)制臨時(shí)用一次就拉起來(lái)用 Docker靈活。裝完先驗(yàn)證一下能不能起來(lái)。隨便指向一個(gè)已有的 SQLite 文件啟動(dòng)后在瀏覽器輸入http://127.0.0.1:8080能看到登錄頁(yè)或表數(shù)據(jù)界面說(shuō)明安裝沒(méi)問(wèn)題。2.2 核心啟動(dòng)參數(shù)速查表我用得上的參數(shù)就幾個(gè)整理成一張表直接對(duì)著抄就行。這里統(tǒng)一用長(zhǎng)參數(shù)避免短參數(shù)在不同版本里打架。參數(shù)作用我的建議--host監(jiān)聽(tīng)地址默認(rèn)127.0.0.1遠(yuǎn)程訪問(wèn)時(shí)改0.0.0.0否則不用動(dòng)--port監(jiān)聽(tīng)端口默認(rèn)8080沖突時(shí)換個(gè)高位端口比如18080--database指定數(shù)據(jù)庫(kù)文件路徑Docker 場(chǎng)景常用本地可直接把路徑放命令最后--auth開(kāi)啟登錄認(rèn)證遠(yuǎn)程訪問(wèn)必開(kāi)別猶豫--password設(shè)置登錄密碼和--auth配合使用--read-only只讀模式只是查數(shù)據(jù)時(shí)強(qiáng)烈建議加--no-browser啟動(dòng)時(shí)不自動(dòng)打開(kāi)瀏覽器跑在服務(wù)器上必須加不然會(huì)報(bào)錯(cuò)--url-prefixURL 前綴放在入口轉(zhuǎn)發(fā)的子路徑下時(shí)需要設(shè)置數(shù)據(jù)庫(kù)文件參數(shù)需要多說(shuō)一句。有些版本用--database /data/app.db指定有些版本直接支持sqlite-web /data/app.db兩種寫(xiě)法本質(zhì)上都是告訴程序打開(kāi)哪個(gè)文件。如果你不確定自己的版本支持哪種跑一下sqlite-web --help看到database或者位置參數(shù)說(shuō)明就清楚了。2.3 監(jiān)聽(tīng)地址怎么選才不裸奔監(jiān)聽(tīng)地址選錯(cuò)要么連不上要么裸奔。這里有三個(gè)典型選擇127.0.0.1是本機(jī)專用外部機(jī)器永遠(yuǎn)訪問(wèn)不到純粹本地自用0.0.0.0是所有網(wǎng)卡都監(jiān)聽(tīng)局域網(wǎng)、公網(wǎng)只要能路由到這臺(tái)機(jī)器就能碰到端口具體內(nèi)網(wǎng) IP比如192.168.1.10等于只監(jiān)聽(tīng)這塊內(nèi)網(wǎng)網(wǎng)卡比0.0.0.0稍微收斂一點(diǎn)但在多網(wǎng)卡機(jī)器上是更精準(zhǔn)的選擇。我的習(xí)慣是默認(rèn)永遠(yuǎn)不加--host讓程序跑在127.0.0.1。確定要遠(yuǎn)程訪問(wèn)那一刻才改成0.0.0.0同時(shí)馬上配好防火墻和認(rèn)證。不要圖省事從一開(kāi)始就開(kāi)著0.0.0.0尤其是公網(wǎng)服務(wù)器掃描器全天候在碰你的端口晚一步配置認(rèn)證都是在賭運(yùn)氣。2.4 端口與 URL 前綴的實(shí)際取舍端口默認(rèn)是8080但如果機(jī)器上已經(jīng)跑了別的服務(wù)就得換。我習(xí)慣選一個(gè)五位數(shù)高位端口比如18080、28080一方面避開(kāi)常見(jiàn)服務(wù)默認(rèn)端口另一方面也讓無(wú)差別掃描撞上的概率低一點(diǎn)。端口改了之后所有訪問(wèn)路徑、防火墻規(guī)則、入口轉(zhuǎn)發(fā)配置都要同步改這一步最容易漏。URL 前綴是另一個(gè)容易忽略的配置。假設(shè)你用 Nginx 或 Caddy 把某個(gè)域名下的/db路徑轉(zhuǎn)發(fā)到 SQLITE-WEB那么 SQLITE-WEB 里的靜態(tài)資源、跳轉(zhuǎn)鏈接默認(rèn)都會(huì)指向/導(dǎo)致頁(yè)面樣式錯(cuò)亂、點(diǎn)擊跳轉(zhuǎn) 404。解決辦法就是啟動(dòng)時(shí)加--url-prefix /db讓程序知道自己在子路徑下工作。這個(gè)參數(shù)平時(shí)用不上但一旦扯上入口轉(zhuǎn)發(fā)它就是生死線。3. 實(shí)操流程局域網(wǎng)、SSH 端口轉(zhuǎn)發(fā)與公網(wǎng)入口3.1 局域網(wǎng)訪問(wèn)改監(jiān)聽(tīng)地址并放行防火墻局域網(wǎng)訪問(wèn)是最常見(jiàn)也最簡(jiǎn)單的遠(yuǎn)程場(chǎng)景。假設(shè)你有一臺(tái) Linux 服務(wù)器內(nèi)網(wǎng) IP 是192.168.1.10SQLite 文件在/data/app.db目標(biāo)是讓另一臺(tái)電腦通過(guò)瀏覽器訪問(wèn)。第一步啟動(dòng) SQLITE-WEB監(jiān)聽(tīng)所有網(wǎng)卡、開(kāi)認(rèn)證、不開(kāi)瀏覽器sqlite-web --host 0.0.0.0 --port 8080 --auth --password 一個(gè)足夠長(zhǎng)的密碼 --no-browser /data/app.db第二步確認(rèn)本機(jī)能訪問(wèn)。這一步別省直接在服務(wù)器上執(zhí)行curl -I http://127.0.0.1:8080能返回 HTTP 狀態(tài)碼說(shuō)明服務(wù)本身是好的。接著用內(nèi)網(wǎng) IP 試一次curl -I http://192.168.1.10:8080這一步能通說(shuō)明監(jiān)聽(tīng)地址沒(méi)問(wèn)題卡點(diǎn)已經(jīng)轉(zhuǎn)移到防火墻。第三步放行防火墻。不同系統(tǒng)命令不同。Ubuntu 的 ufw 是sudo ufw allow 8080/tcpCentOS/RHEL 的 firewalld 是sudo firewall-cmd --permanent --add-port8080/tcp sudo firewall-cmd --reload還有一些機(jī)器直接用的 iptables規(guī)則寫(xiě)法和前兩者不一樣。如果服務(wù)器在云上還要去云控制臺(tái)的安全組規(guī)則里放行入方向 TCP 8080。很多新人只改系統(tǒng)防火墻忘了云安全組兩頭一夾端口就出不來(lái)了。搞定之后在另一臺(tái)電腦的瀏覽器輸入http://192.168.1.10:8080輸入密碼就能看到數(shù)據(jù)庫(kù)頁(yè)面。這個(gè)方案適合內(nèi)網(wǎng)可信環(huán)境不建議直接暴露到公網(wǎng)。3.2 SSH 端口轉(zhuǎn)發(fā)不改防火墻也能遠(yuǎn)程訪問(wèn)如果不想開(kāi)放任何端口又想從遠(yuǎn)程安全訪問(wèn) SQLITE-WEBSSH 端口轉(zhuǎn)發(fā)是最高性價(jià)比的方案。它的原理很簡(jiǎn)單你的電腦和服務(wù)器之間建一條 SSH 加密通道本地某個(gè)端口收到的請(qǐng)求通過(guò)這條通道直接送到服務(wù)器上的127.0.0.1:8080。整個(gè)過(guò)程不需要在服務(wù)器防火墻里開(kāi)放 8080也不需要改--hostSQLITE-WEB 甚至保持默認(rèn)監(jiān)聽(tīng)127.0.0.1就行。服務(wù)器端啟動(dòng)命令sqlite-web --port 8080 --auth --password 你的密碼 --no-browser /data/app.db保持默認(rèn)監(jiān)聽(tīng)本機(jī)即可?？蛻舳藞?zhí)行ssh -N -L 8080:127.0.0.1:8080 你的用戶名服務(wù)器地址命令解釋一下-N表示只建通道不登錄執(zhí)行命令-L是本地端口轉(zhuǎn)發(fā)格式是本地端口:目標(biāo)地址:目標(biāo)端口。執(zhí)行后在你本地電腦的瀏覽器輸入http://127.0.0.1:8080流量會(huì)通過(guò) SSH 通道加密送到服務(wù)器的 8080 端口全程不暴露任何額外端口。這個(gè)方案特別適合的場(chǎng)景是服務(wù)器沒(méi)有公網(wǎng) IP但你能通過(guò)跳板機(jī) SSH 登錄或者公司內(nèi)網(wǎng)限制嚴(yán)格只開(kāi)了 22 端口。它的缺點(diǎn)是不能讓多人同時(shí)直接訪問(wèn)畢竟通道建立在單一客戶端上但個(gè)人管理完全夠用。3.3 公網(wǎng)訪問(wèn)加一層 HTTPS 入口轉(zhuǎn)發(fā)公網(wǎng)訪問(wèn)是需求最強(qiáng)烈、風(fēng)險(xiǎn)也最高的場(chǎng)景。如果你的服務(wù)器有公網(wǎng) IP最簡(jiǎn)單的鏈路是客戶端 → 公網(wǎng) IP:443 → 入口轉(zhuǎn)發(fā)服務(wù) → 本機(jī) 127.0.0.1:8080 → SQLITE-WEB。入口轉(zhuǎn)發(fā)服務(wù)的職責(zé)是終止 HTTPS 和做請(qǐng)求轉(zhuǎn)發(fā)這樣 SQLITE-WEB 本身不用處理證書(shū)繼續(xù)保持只監(jiān)聽(tīng)回環(huán)地址。我用得最多的是 Caddy原因是配置短、自動(dòng)管理證書(shū)。在服務(wù)器上裝好 Caddy 后建一個(gè) Caddyfile你的域名 { reverse_proxy 127.0.0.1:8080 }這段配置的意思是用戶訪問(wèn)https://你的域名時(shí)Caddy 自動(dòng)申請(qǐng)并續(xù)期證書(shū)然后把請(qǐng)求轉(zhuǎn)給本機(jī)的 8080 端口。SQLITE-WEB 那邊不需要開(kāi)--host 0.0.0.0監(jiān)聽(tīng)回環(huán)即可入口轉(zhuǎn)發(fā)服務(wù)反正是發(fā)到本機(jī)回環(huán)地址。重點(diǎn)提醒公網(wǎng)場(chǎng)景下--auth必開(kāi)密碼別用短密碼查詢?yōu)橹鞯膸?kù)加上--read-only。如果想把 SQLITE-WEB 放在域名子路徑下比如https://你的域名/dbCaddyfile 要加路徑匹配同時(shí) SQLITE-WEB 啟動(dòng)參數(shù)要加--url-prefix /db你的域名 { handle /db* { reverse_proxy 127.0.0.1:8080 } }入口轉(zhuǎn)發(fā)這種方式適合需要 HTTPS 的正式環(huán)境。沒(méi)有域名的話也可以用 IP 加端口直連但我個(gè)人不推薦暴露一個(gè)帶密碼的明文 HTTP 服務(wù)在公網(wǎng)上等于把鑰匙掛在門上。3.4 Docker 部署時(shí)同樣三步走Docker 部署看著不一樣本質(zhì)上還是那三要素綁定地址、端口映射、訪問(wèn)控制。我的典型啟動(dòng)命令長(zhǎng)這樣docker run -d \ --name sqlite-web \ -p 8080:8080 \ -v /data:/data \ --restart unless-stopped \ sqlite-web:latest \ --host 0.0.0.0 --port 8080 --auth --password 你的密碼 /data/app.db這里-p 8080:8080是把宿主機(jī) 8080 端口映射到容器 8080 端口-v /data:/data把宿主機(jī)的數(shù)據(jù)目錄掛載到容器內(nèi)。注意容器內(nèi)進(jìn)程要監(jiān)聽(tīng)0.0.0.0因?yàn)槎丝谟成渲徽J(rèn)容器內(nèi)部監(jiān)聽(tīng)的地址如果容器內(nèi)默認(rèn)只監(jiān)聽(tīng)回環(huán)宿主機(jī)轉(zhuǎn)發(fā)進(jìn)來(lái)的請(qǐng)求就找不到目標(biāo)。Docker 還有一個(gè)坑數(shù)據(jù)庫(kù)文件在宿主機(jī)上屬主和容器內(nèi)用戶不一致時(shí)SQLITE-WEB 可能打不開(kāi)文件。解決方案是啟動(dòng)時(shí)用--user指定 UID/GID或者直接把宿主機(jī)目錄權(quán)限調(diào)成當(dāng)前容器用戶可讀寫(xiě)。我在實(shí)際使用中吃過(guò)一次虧容器能啟動(dòng)但頁(yè)面一直報(bào)錯(cuò)查了半天才發(fā)現(xiàn)是權(quán)限問(wèn)題。4. 安全加固與日常運(yùn)維遠(yuǎn)程服務(wù)而不是裸服務(wù)4.1 認(rèn)證、只讀與運(yùn)行用戶SQLITE-WEB 的認(rèn)證是基本認(rèn)證開(kāi)啟方式就是--auth加--password。這里有幾個(gè)細(xì)節(jié)值得注意。密碼不要直接出現(xiàn)在 systemd 配置里我的建議是如果機(jī)器上只有你自己用寫(xiě)配置里沒(méi)問(wèn)題但生產(chǎn)環(huán)境建議用 systemd 的 EnvironmentFile 加載密碼或者用密碼文件掛載方式。還有一點(diǎn)密碼放進(jìn)命令行參數(shù)時(shí)用ps能看到完整參數(shù)所以多人共享的機(jī)器上避免用命令行傳密碼改成配置文件或環(huán)境變量更穩(wěn)。只讀模式是我每次查數(shù)據(jù)必開(kāi)的選項(xiàng)。加--read-only之后頁(yè)面上的刪除、更新、導(dǎo)入功能會(huì)被禁用只能執(zhí)行 SELECT 查詢。這個(gè)模式不是用來(lái)防黑客的而是防手滑——遠(yuǎn)程打開(kāi)一個(gè)能寫(xiě)的數(shù)據(jù)庫(kù)不小心在錯(cuò)誤的表上執(zhí)行了 DELETE想找后悔藥都來(lái)不及。運(yùn)行用戶也別用 root。SQLITE-WEB 本身只是個(gè) Web 服務(wù)用普通用戶跑完全夠。至少在 systemd 里指定User某個(gè)普通用戶避免數(shù)據(jù)庫(kù)文件、日志文件都變成 root 屬主后面?zhèn)浞菥S護(hù)時(shí)權(quán)限混亂。這條對(duì)任何 Web 服務(wù)都適用SQLITE-WEB 也不例外。4.2 用 systemd 托管讓服務(wù)崩潰自動(dòng)拉起如果你打算讓 SQLITE-WEB 長(zhǎng)期跑在服務(wù)器上別用 nohup 加用 systemd 才是正路。好處很多開(kāi)機(jī)自啟、崩潰自動(dòng)重啟、日志走 journald。我常用的 unit 文件是這樣[Unit] DescriptionSQLITE-WEB service Afternetwork.target [Service] Userappuser Groupappgroup WorkingDirectory/data ExecStart/usr/local/bin/sqlite-web --host 0.0.0.0 --port 8080 --auth --password 你的密碼 --read-only --no-browser /data/app.db Restartalways RestartSec5 [Install] WantedBymulti-user.targetUser指定普通用戶Restartalways讓進(jìn)程掛掉后自動(dòng)拉起來(lái)RestartSec5避免頻繁重啟打日志。寫(xiě)完放到/etc/systemd/system/sqlite-web.service執(zhí)行sudo systemctl daemon-reload sudo systemctl enable --now sqlite-web查看日志用journalctl -u sqlite-web -f比任何手動(dòng)重定向日志都方便。這里再提醒一次如果開(kāi)只讀模式就要”只讀是只讀”后面數(shù)據(jù)變更需求變多時(shí)再改回來(lái)別在高權(quán)限模式里過(guò)夜。4.3 數(shù)據(jù)庫(kù)文件層面的準(zhǔn)備與備份SQLITE-WEB 本身不負(fù)責(zé)數(shù)據(jù)庫(kù)的備份但我覺(jué)得跑在服務(wù)器上的系統(tǒng)備份比面板更重要。最簡(jiǎn)單的備份方式是利用 SQLite 自帶的備份命令sqlite3 /data/app.db .backup /backup/app-$(date %F).db.backup命令會(huì)在備份過(guò)程中保持一致性比直接復(fù)制文件更可靠。配合計(jì)劃任務(wù)每天凌晨自動(dòng)備份一次是性價(jià)比最高的數(shù)據(jù)保險(xiǎn)。我自己的習(xí)慣是備份文件保留最近 7 天然后同步到另一塊磁盤(pán)或網(wǎng)盤(pán)避免服務(wù)器整機(jī)故障時(shí)備份也沒(méi)了。還有一個(gè)數(shù)據(jù)庫(kù)層面的優(yōu)化如果你的 SQLITE-WEB 會(huì)被多人查詢同時(shí)又有人寫(xiě)入建議提前把數(shù)據(jù)庫(kù)切到 WAL 模式。WAL 允許讀操作和寫(xiě)操作并發(fā)進(jìn)行減少“database is locked”報(bào)錯(cuò)。切換命令sqlite3 /data/app.db PRAGMA journal_modeWAL;切換一次后模式就是持久的。注意 WAL 會(huì)產(chǎn)生額外的-wal、-shm文件備份時(shí)要確保這些文件也在備份范圍里或者用.backup命令來(lái)規(guī)避這個(gè)問(wèn)題。5. 常見(jiàn)問(wèn)題與排查技巧實(shí)錄5.1 一張表查清“連不上”的常見(jiàn)原因我把自己和周圍人遇到過(guò)的典型問(wèn)題整理成一張速查表哪條對(duì)上了直接照做。癥狀常見(jiàn)原因解決辦法本機(jī)能開(kāi)其他機(jī)器打不開(kāi)監(jiān)聽(tīng)地址還是127.0.0.1加--host 0.0.0.0或具體內(nèi)網(wǎng) IP重啟服務(wù)改了監(jiān)聽(tīng)地址還是連不上防火墻或云安全組沒(méi)放行端口檢查 ufw/firewalld再看云控制臺(tái)安全組提示輸入密碼但輸對(duì)了也進(jìn)不去啟動(dòng)參數(shù)里有多個(gè)實(shí)例在跑舊實(shí)例沒(méi)密碼ps aux頁(yè)面打開(kāi)了但樣式全亂用了子路徑訪問(wèn)沒(méi)配--url-prefix啟動(dòng)加--url-prefix /db刷新瀏覽器緩存導(dǎo)入 CSV 一直失敗入口轉(zhuǎn)發(fā)服務(wù)把請(qǐng)求體大小限制了調(diào)大請(qǐng)求大小限制或改用 SQL 粘貼方式操作時(shí)報(bào)database is locked多個(gè)寫(xiě)連接同時(shí)操作 SQLite 文件開(kāi)啟 WAL 模式減少并發(fā)寫(xiě)錯(cuò)峰執(zhí)行服務(wù)啟動(dòng)時(shí)報(bào)數(shù)據(jù)庫(kù)文件不存在路徑寫(xiě)錯(cuò)或權(quán)限不足ls -l確認(rèn)文件存在和屬主用絕對(duì)路徑這張表覆蓋了我遇到過(guò)的絕大多數(shù)問(wèn)題剩下那些基本都是參數(shù)名寫(xiě)錯(cuò)--help一看就知道不展開(kāi)。5.2 從內(nèi)到外的五層排查法遇到“遠(yuǎn)程打不開(kāi)”這種模糊問(wèn)題我有一套固定排查順序基本能快速定位到具體是哪一層出問(wèn)題。第一層確認(rèn)進(jìn)程活著且監(jiān)聽(tīng)正確ss -lntp | grep 8080看到127.0.0.1:8080說(shuō)明服務(wù)只監(jiān)聽(tīng)了本機(jī)看到0.0.0.0:8080或具體內(nèi)網(wǎng) IP說(shuō)明監(jiān)聽(tīng)沒(méi)問(wèn)題。第二層本機(jī)用回環(huán)地址試curl -I http://127.0.0.1:8080能通說(shuō)明程序正常不通就回頭查啟動(dòng)日志和數(shù)據(jù)庫(kù)路徑。第三層本機(jī)用內(nèi)網(wǎng) IP 試curl -I http://192.168.1.10:8080能通說(shuō)明監(jiān)聽(tīng)地址已經(jīng)生效問(wèn)題在防火墻或路由不通基本就是監(jiān)聽(tīng)地址沒(méi)改對(duì)或者防火墻攔了本地入站。第四層從外部機(jī)器測(cè)端口nc -vz 服務(wù)器IP 8080通的話說(shuō)明網(wǎng)絡(luò)鏈路沒(méi)問(wèn)題重點(diǎn)查認(rèn)證和瀏覽器緩存不通就說(shuō)明端口被防火墻或安全組擋在外面。第五層檢查所有防火墻層系統(tǒng) ufw/firewalld、云安全組、路由器端口映射。這一步?jīng)]有統(tǒng)一命令挨個(gè)看。這套流程走完問(wèn)題基本可以被精確鎖定不會(huì)再出現(xiàn)換了三種姿勢(shì)還是不知道哪里有問(wèn)題的情況。5.3 個(gè)人習(xí)慣把“邊界”當(dāng)成第一優(yōu)先級(jí)最后分享一點(diǎn)實(shí)際使用心得。我的默認(rèn)策略是能不開(kāi)遠(yuǎn)程就不開(kāi)能少開(kāi)就少開(kāi)。SQLITE-WEB 默認(rèn)監(jiān)聽(tīng)127.0.0.1不是給用戶添麻煩而是保護(hù)數(shù)據(jù)的基本邊界。需要遠(yuǎn)程訪問(wèn)時(shí)我的優(yōu)先級(jí)很固定先想 SSH 端口轉(zhuǎn)發(fā)因?yàn)樗恍枰_(kāi)放任何新端口加密通道順帶完成再想局域網(wǎng)直連前提是網(wǎng)絡(luò)環(huán)境可信、認(rèn)證必開(kāi)最后才是公網(wǎng)入口轉(zhuǎn)發(fā)必須接 HTTPS 和強(qiáng)密碼。這種習(xí)慣幫我少處理了很多安全問(wèn)題。遠(yuǎn)程訪問(wèn) SQLITE-WEB 這件事本身不難難的是把邊界劃清楚讓哪塊網(wǎng)卡能碰到它、誰(shuí)能碰到它、碰到之后能做什么。參數(shù)、防火墻、認(rèn)證都是邊界的一部分。把這套想明白不管換什么機(jī)器、什么網(wǎng)絡(luò)環(huán)境你都能很快配出一個(gè)既順手又穩(wěn)妥的方案。