寶塔網站出錯先看哪份紀錄:訪問日誌與錯誤日誌
網站突然404或500,先保存出錯網址與時間,再看對應的日誌。寶塔的響應日誌和錯誤日誌各有用途:前者幫你找請求與回應,後者提供服務執行中的錯誤線索。只翻最近一行,或者只看一個狀態碼,都不一定能定位原因。 以下依寶塔、Nginx、Apache及MDN官方文件整理核對方法,沒有替你的網站產生測試日誌。實際欄位、檔案位置和保留範圍以現場配置為準,先找對站點和時間,再判斷下一步。 先留下足以找到請求的資訊 保存完整網址、HTTP方法、發生時間與畫面中的錯誤。若只有某個內頁出錯,就記錄它的路徑,不要只留域名首頁。表單或API也需要方法資訊,因為同一路徑的GET與POST可能走不同處理。 時間要包括時區,並留意瀏覽器、面板和伺服器記錄可能不同。寶塔官方響應日誌介紹包含帶時區的請求時間;用它對照自己的觀察,避免在另一個小時的紀錄裡尋找錯誤。 如果問題涉及登入或特定資料,記錄必要步驟即可,密碼與私人資訊不要放進公開截圖。診斷需要辨認請求,不需要把使用者的完整資料交給所有求助者。 從正確站點打開網站日誌 寶塔官方步驟是進入網站清單,選中目標站點,再打開網站日誌。頁面分成響應日誌、錯誤日誌與日誌安全分析;先確定你正在查看出錯網站,而不是同一台伺服器上的另一個站點。 響應日誌文件列有客戶端IP、請求時間、方法及資源路徑、狀態碼、內容長度、Referer與User-Agent等資訊。IP歸屬地在官方頁被標為企業版功能,不要把介面缺少它當成一般站點的日誌故障。 不同版本與日誌格式可能影響展示。Nginx的log_format及Apache的LogFormat都可決定記錄欄位,因此不能假設每份日誌都包含相同內容,或用欄位位置直接套用另一台主機的解析方式。 響應日誌先確認請求是否出現 用剛才保存的時間、方法與路徑尋找相應請求。如果找不到,先核對站點、時區、保留範圍、是否啟用日誌,以及請求是否經過代理或另一個入口。沒有在這份日誌看到,不足以證明訪客沒有發出請求。 找到後查看狀態與相關內容。MDN把回應狀態分成資訊、成功、轉址、客戶端錯誤及伺服器錯誤等類別;狀態可以縮小方向,但不代替對錯誤內容及實際功能的核對。 例如200可能是正確頁面,也可能是應用以成功狀態提供的通用錯誤畫面。404則表示資源未找到,但仍要辨認是哪一層回應;不要只看到數字,就直接重裝程式或修改所有路由。 再對照同一時段的錯誤日誌 寶塔錯誤日誌介紹列出發生時間、進程資訊、請求及錯誤詳情等線索。先找同一請求附近的相關紀錄,而不是把最新一條不相干錯誤,直接解釋成眼前問題的原因。 Nginx的error_log具有配置位置與嚴重程度;設定某個等級時,會記錄該等級與更嚴重的訊息。這表示看不到某種較低等級資訊,可能與配置有關,不能直接推斷服務完全沒有異常。 不要為了找一個問題就長期開最高詳細程度。詳細紀錄可能增加負擔並帶出更多資料;先使用現有證據,必要的臨時調整應由維護者安排,並記錄原值與結束條件。 Web服務日誌不等於應用程式日誌 PHP或框架本身可能有自己的日誌位置與錯誤處理。Web服務只看到請求失敗,不一定會保存完整應用例外。應按實際程式的文件和配置核對,不把寶塔網站錯誤頁當成所有錯誤都會出現在同一個檔案的承諾。 反向代理也可能把後端狀態轉交給訪客。這時要分別找代理和後端的相應紀錄,並對照路徑與時間;不能因為公開入口是寶塔網站,就只看前面的那份日誌。 Apache官方日誌指南把存取與錯誤紀錄分開說明。若站點使用Apache,核對它的實際設定;不要把Nginx的指令或假設中的檔案路徑原樣套到另一種服務。 代理後的IP不能只看名稱判斷 經過CDN或代理時,日誌裡的連線來源可能是代理節點,也可能由已配置的來源資訊還原。先核對實際格式與信任設定,不把某個欄位名稱叫客戶端IP,就一律認定它是訪客真實位址。 也不要只靠User-Agent或Referer判定身分。這些請求資料有診斷用途,但不等於可靠登入資訊;來源網頁欄位缺少或出現特殊值時,先看請求整體,不直接把它當成攻擊成功的證據。 若需要交接,用時間、路徑、狀態和相應錯誤組成最小片段,遮去敏感參數。完整日誌可能包含多位訪客與私人網址,公開貼整份往往超出排查需要。 安全分析結果要回到原請求核對 寶塔官方頁說明,日誌安全分析也包含已攔截的請求。因此,看到攻擊類型標記,不表示該請求已成功入侵,更不能只憑掃描摘要就宣稱整個網站安全。 回到原始請求與服務處理結果,區分嘗試、攔截及真正產生的影響。若需要調整告警或定期掃描,另外按站點負載與既有維護安排處理,不把閱讀日誌擴成未經核對的自動規則變更。 保留證據,不用清空日誌驗證修復 修復前保存相關紀錄與原設定,修復後以相同合法請求重新核對功能及新日誌。不要清空所有日誌,只為讓畫面看起來沒有錯誤;歷史證據可能正是辨認重複問題的重要依據。 如果日誌已輪替,查看現場保留的舊檔與時間範圍,不假設目前顯示的檔案包含所有歷史。檔案不在或紀錄超出保留範圍時,清楚寫成證據缺口,不補上沒有讀到的結果。 最後將問題網址、對應響應、相關錯誤、處理內容及重新核對時間保存成一組紀錄。下一位維護者就能看懂你是根據哪些線索處理,而不是只留下「重啟後正常」這種無法還原原因的說法。 參考資料寶塔官方:網站日誌Nginx:存取日誌格式Nginx:error_logApache:日誌指南MDN:HTTP狀態碼
寶塔反向代理後頁面404:核對代理目錄與上游路徑
寶塔反向代理的首頁能開,內頁卻404,先查後端實際收到的路徑。代理不是只把IP換成域名;公開網址的前綴、後端路由、請求Host和靜態資源地址都可能影響結果。 以下依寶塔及Nginx官方文件整理診斷方法。配置片段只解釋Nginx一般原理,不是宣稱某個寶塔版本一定生成相同內容,也沒有替你的網站執行修改。先把預期映射寫清楚,再核對現場。 先列出公開路徑與後端路徑 假設訪客使用/api/users,後端究竟需要/users,還是/api/users?先從後端路由與部署文件確認,不能只因首頁回應成功,就推斷所有內頁都能接受同樣的前綴。 也確認代理的是整個網站,還是其中一個目錄。若只代理/api/,其他路徑可能仍由原站點處理;它們各自的404不能直接合併為同一個代理錯誤。記錄一條已知有效的後端路由,作為核對基準。 寶塔官方反向代理頁要求目標URL可以正常訪問,並提供代理目錄與發送域名等欄位。代理目錄涉及高級功能,介面能力以你的版本為準,不要在欄位不存在時用另一個近似選項代替。 Nginx的proxy_pass有沒有URI,含義不同 Nginx官方proxy_pass說明,帶URI時,匹配location的那部分標準化請求URI會被指定URI替換;不帶URI時,通常按文件所列條件傳遞原始或完整變更後的請求URI。簡單前綴範例可以先看以下差異。 location /api/ { proxy_pass http://127.0.0.1:3000/; } location /api/ { proxy_pass http://127.0.0.1:3000; } 第一段的目標包含/這個URI,對/api/users的簡單映射會移除匹配的/api/,交給後端/users。第二段目標沒有URI,在未另外改寫的普通請求中保留/api/users。兩段是互相對照的替代範例,不要同時貼進同一份配置。 這個差異不是「永遠要加斜線」的口訣。選哪一種取決於後端需要的路徑;正則location、命名location、rewrite及變數又有文件列出的特殊條件。遇到它們時按完整配置核對,不能只盯著最後一個字元。 回到寶塔核對真正生成的配置 面板欄位保存成功,只能先證明設定已被接受,還要查看實際站點配置和回應。不同版本或服務可能有不同生成方式,不能把上面的Nginx例子冒成寶塔UI一定產生的結果。 若要檢查Nginx,先找到目標站點及匹配的location,再看proxy_pass與相關改寫。Nginx核心文件說明location選擇有匹配規則,另一段更具體或正則配置可能接手請求;不是所有/api/網址都一定由你剛看到的那段處理。 變更前保存原配置,避免直接覆蓋其他站點或原有規則。若服務不是Nginx,改查對應服務的代理文件,不將Nginx指令貼到不同配置格式中。 404是誰回的,要靠紀錄核對 MDN將404定義為伺服器找不到請求資源;狀態本身沒有告訴你是哪一層回應。它可能來自前面的Web服務,也可能是後端收到不正確路徑後回傳,再由代理轉交。 保存完整網址、時間和回應,再核對相應的代理與後端日誌。前端日誌記錄的公開URI與後端記錄的路由如果不同,正是定位前綴變換的線索;不要只因錯誤頁有某個服務名稱,就斷言整個問題的來源。 Nginx日誌文件說明,可以按配置使用相應格式記錄請求。實際欄位取決於log_format與相關設定,不能假設每台機器都已記錄上游狀態。若沒有該欄位,先查現有證據,不替日誌補出想像的值。 發送域名影響後端選中的站點 寶塔官方頁把發送域名描述為傳遞到代理請求頭的域名,預設使用目標URL域名,並提醒設定不當可能導致代理不能正常運行。若後端依Host選站點,路徑正確也仍可能收到另一個虛擬站點的回應。 先確認後端需要的Host,再查看實際代理設定。不要因為公開域名和後端域名不同,就一律把某個值改成公開域名;後端可能正是依內部名稱安排服務。 若你自己使用proxy_set_header,依Nginx官方說明核對其作用與變數。請求頭設定和URI改寫是不同工作,改其中一項不代表另一項已符合後端需求。 首頁成功後,也要查靜態資源網址 應用部署在子路徑時,HTML中的絕對資源地址可能仍指向根目錄。例如頁面在/app/,資源卻要求/assets/;該請求可能根本沒有進入/app/代理。先看瀏覽器真正要求的資源網址,再查相應路徑。 這類問題可能需要應用的公開基底路徑設定,而不是再加一個泛用替換規則。寶塔內容替換僅在Nginx提供,官方頁列有條數限制;不要把文字替換當成可靠修復所有腳本、API與資源地址的辦法。 如果是WebSocket或其他特殊協定,也另外依服務能力核對。本篇聚焦普通HTTP路徑診斷,不用一張首頁成功的畫面,替所有連線模式作驗收。 代理後重新核對原有存取限制 寶塔官方頁明確提醒,設定反向代理後,訪問限制中相應路徑的規則會失效。因此,不能只確認頁面能開,就認定原本的存取控制仍在相同位置生效。 先列出原本需要保護的管理、私人內容與寫入入口,再確認目前由哪一層負責限制。不要為了消除404就放開所有路徑,也不要把後端只綁本機,直接推斷公開代理入口必定安全。 後端位址以代理服務的環境為準 目標URL若使用127.0.0.1,它指向代理服務所在環境的本機,不一定是你操作瀏覽器的電腦。容器、另一台主機或不同網路安排,都要按實際部署核對;不要把某個教學的本機端口原樣填入,卻沒有確認那裡存在需要的服務。 連線失敗時先核對目標入口可達性,收到404時再查路徑和後端路由。兩種現象分開記錄,能避免為了處理網路問題反覆改URI,或為了處理錯誤路由去更換正常的端口。 用路徑樣本收束變更 保存首頁、合法內頁、靜態資源、需要參數的路徑與必要例外的核對結果,對照公開URI和後端路由。出現錯誤時按匹配、URI、Host與應用資源地址逐項查,不同時猜改所有設定。 最後把原配置、預期映射及驗收時間放在維護紀錄。下次更新後端路由,就能直接檢查代理前綴是否仍合適,不必重新用「加斜線或刪斜線」碰運氣。 參考資料寶塔官方:反向代理Nginx:proxy_pass與代理請求頭Nginx:location匹配MDN:404回應Nginx:請求日誌
寶塔舊網址要轉址:301與302、路徑保留先確認
舊域名轉到新域名,首頁能跳,內頁卻全部回到首頁,先核對重定向的目標與URI保留設定。301與302表示轉址的性質,但它們本身不決定路徑是否保留;狀態碼、目的地和路徑需要分開確認。 以下依寶塔、MDN及Nginx官方文件整理設定思路。網址是示例,不是已替你的站點建立規則;先把需要的映射寫清楚,再到面板處理,避免一條全站轉址把原本有效的內容入口一起導錯。 先寫來源和目標,不先選狀態碼 先列出完整來源網址與預期目的地,包括協定、主機名稱及路徑。例如舊站的/articles/guide若在新站仍有相同路徑,可以考慮保留;若新站已改用另一種路由,就不能只換域名,期待內頁自動存在。 也分清這次是全域名搬遷、某個目錄變更,還是單一頁面換位置。規則範圍越大,越要核對不同網址的結果。不要為了一張頁面改網址,就先建立影響整個域名的規則。 目標必須能正常提供需要的內容。寶塔官方重定向頁也要求有效的目標URL;瀏覽器成功跳到另一個網址,不代表那裡不是404、登入頁或另一張轉址頁。 301永久,302臨時,按變更目的選擇 寶塔介面提供301永久重定向與302臨時重定向。MDN分別說明兩種狀態的語意:301表示資源永久移往Location指定位置;302則表示暫時位於另一個位置。 已確定長期使用新網址時,永久轉址可以表達這個安排。若只是臨時維護或尚未確定的入口,先不要用永久性語意宣告所有內容都已搬走。這不表示任何測試都必須用同一種狀態碼,而是要把預期安排說清楚。 也不要承諾301一定立即完成搜尋結果更新,或302一定不影響任何搜尋表現。HTTP狀態表達的是回應語意;搜尋系統何時重新讀取與處理,是另外的觀察,不能用面板保存成功代替成效。 寶塔的URI保留選項決定內頁去向 在網站清單選中目標站點,打開重定向,再添加規則。依官方文件核對重定向類型、目標URL、方式及保留URI參數。域名規則與路徑規則要符合你剛才列出的範圍。 寶塔官方示例說明,從舊域名轉到新域名,保留URI時,/1.html仍轉到新域名的/1.html;不保留則轉到新域名根目錄。這個差異解釋了為什麼首頁測試正常,內頁卻全部落到首頁。 保留路徑的目標示例: https://old.example.com/1.html → https://new.example.com/1.html 不保留路徑的目標示例: https://old.example.com/1.html → https://new.example.com/ 上面是用來討論預期結果的網址,沒有代表你的面板已生成這條規則。若新站路徑和舊站不同,應安排明確映射,不能只勾保留選項就宣稱內容搬遷完成。 查詢參數也要用真正需要的網址核對 商品篩選、文章頁碼或追蹤網址可能帶查詢參數。先確認哪些參數需要延續,哪些屬於舊系統專用資訊;不要一律刪掉,也不要把可能包含敏感內容的參數原樣送到不相關目的地。 面板選項描述包含子路徑或參數,但具體規則仍需以實際回應核對。挑一條需要參數的合法網址,看Location中的目的地是否符合預期,再查看抵達後的頁面內容。 如果自己編輯Nginx規則,依官方rewrite模組核對return與rewrite的語法和參數處理。不要把某個泛用片段當成寶塔每種版本都會生成的固定配置,更不要直接覆蓋已有業務規則。 看第一次回應和完整跳轉鏈 只看瀏覽器最後的網址,可能看不到中途經過幾次轉址。MDN的Location文件說明它指定重定向位置;核對時記錄第一個狀態碼和Location,再沿著鏈查看下一個回應。 如果來源轉到目標,目標又轉回來源,就可能形成循環。常見的排查方向是域名、HTTP與HTTPS及不同層的既有規則,但不能單憑現象就刪除所有規則。先把每一跳記下來,才能找出互相矛盾的位置。 也看是否有不必要的多跳。來源HTTP先換域名、再升HTTPS、再加www,可能經過多次跳轉;若要調整,先確認每個正式入口的憑證與最終網址,不能只為減少跳數就忽略來源端的HTTPS要求。 表單與API不要當成一般頁面轉址 301與302遇到POST時,瀏覽器可能在後續改用GET。MDN指出,若需要保留方法,308或307具有不同要求。因此,登入、付款或API入口不能因一般GET頁面轉址正常,就直接套用同一判斷。 這不是要求你在寶塔介面選一個它沒有提供的選項,而是提醒先核對業務需要。若涉及方法與請求內容保留,應按應用和服務能力設計相應方案,不把301或302當成所有請求都能透明搬遷的保證。 也不要拿正式付款或寫入資料的請求隨意試驗。先由維護者辨認影響範圍,使用適當的驗證方式核對,讓入口變更和業務資料處理保持可追蹤。 先確認目標內容,再擴大規則 若新站的內容尚未全部就緒,可以先列出已完成與未完成的路徑,再決定哪些入口適合切換。把所有舊網址導向新首頁,雖然可能不再顯示舊站內容,卻會讓原本尋找特定文章的訪客失去對應位置,不能把這種結果稱為逐頁搬遷完成。 驗收時也看頁面內容是否真是該篇文章,而不是新站以成功狀態回傳的通用錯誤頁。HTTP回應和內容映射都需要核對,才知道路徑保留是否達到原本目的。 完成時保存規則與網址樣本 至少保存首頁、一條內頁、一個帶參數的合法網址及必要的例外入口,記錄來源、第一次回應與最終內容。每個樣本都需要符合預期,不能只用首頁跳轉成功作全站結論。 變更前後也保留原規則與時間,讓之後看到舊結果的人知道它是歷史記錄還是新的現場觀察。如果永久轉址已被快取,重新核對時要留意不同客戶端的結果,不要急著反覆改回相反方向。 最後把這次搬遷的範圍寫清楚:哪些網址保留路徑,哪些另有映射,哪些暫時不調整。這份紀錄比只寫「已開301」更有用,下次新增內容或改路由時,也能知道該核對哪些入口。 參考資料寶塔官方:重定向與URI保留MDN:301永久轉址MDN:302臨時轉址MDN:Location回應標頭Nginx:return與rewrite
寶塔首頁出現舊HTML:先核預設文件順序與站點入口
網站已上傳新的index.php,打開域名卻仍看到舊HTML頁面,先查預設文件,不急著刪除整個網站。瀏覽器要求的是目錄網址,Web伺服器還要決定該目錄的入口檔案;目錄裡同時有多個首頁候選,最後顯示哪個,取決於實際服務配置。 以下依寶塔及Web伺服器官方文件整理查法。文中的檔名與配置是說明用示例,不是本站替你的伺服器測得的結果。先辨認網站使用Nginx還是Apache,再看對應的生效設定,避免把不同服務的語法混在一起。 先比較目錄網址與明確檔名 先記下完整網址。https://example.com/和https://example.com/index.php不是同一個請求路徑;前者要求根目錄入口,後者直接指定檔案。若兩者看到不同內容,這是檢查預設文件的線索,不是單憑畫面就能確認的唯一原因。 在正確的公開目錄查看index.php、index.html與其他入口是否同時存在。也核對檔案大小寫和內容,避免把另一個資料夾的舊檔誤認成網站正在使用的檔案。不要先刪檔再查,否則原本的選擇順序和回復依據都可能消失。 如果PHP入口本身報錯,而靜態HTML可以開,還要另外處理PHP執行問題。預設文件設定只決定入口選擇,不能替你修復程式依賴、資料庫連線或PHP版本不相容。把不同結果記下來,才能判斷下一步查哪一層。 到寶塔目標站點查看預設文件 寶塔官方步驟是進入網站清單,選中要管理的站點,再打開預設文件。文件列出常見名稱,包括index.php、index.html、index.htm及default系列,也允許加入自訂文件,例如1.html。 這份名稱清單不是所有現有站點都以相同順序提供首頁的保證。網站可能已經被修改過,伺服器類型及其他配置也可能不同。應以目標站點當前設定和最後生效的服務配置為準,不只看文章裡列出的名稱。 修改之前保存原清單,先確認你想使用的入口檔案確實存在於公開目錄。新增一個不存在的名稱,不會讓Web伺服器自動產生對應首頁。自訂檔名也要和部署方式一致,不能只改面板欄位,卻沒有上傳真正的文件。 Nginx會按index清單順序找檔案 Nginx官方index模組處理以斜線結尾的請求,index指令可以列出多個候選文件,並按指定順序檢查。以下只用來說明順序;實際站點要查看它自己的server或location上下文。 index index.html index.php; 在這個示例中,若index.html存在,就可能先選中它,而不是後面的index.php。若你的目標是PHP程式,先查清楚為什麼保留HTML入口,再決定調整順序、移出舊檔或採用其他部署安排。不要一概宣稱寶塔永遠先選PHP。 Nginx文件也提醒,選中索引文件會造成內部轉交,後續可能由另一個location處理。因此,查看根目錄的index值之後,還要確認被選中的檔案如何處理,尤其是PHP入口,不把選中檔案和成功執行程式當成同一件事。 Apache則核對DirectoryIndex 若網站使用Apache,官方mod_dir文件以DirectoryIndex設定目錄入口,可以列出多個資源,選取第一個找到的候選。這是Apache的規則,不能把Nginx的index指令直接貼進Apache配置。 也注意同一上下文中多個DirectoryIndex指令可能累加清單,而不是你想像的後面一行覆蓋前面一行。讀配置時,要把相關設定放在一起核對;只抄最後一行,可能漏掉原本仍在清單中的入口。 沒有找到入口時,是否產生目錄列表取決於相關設定。不要為了解決首頁問題就打開目錄瀏覽,讓訪客看到原本不應公開的檔案清單。先把正確入口、公開目錄和服務規則查清楚,再處理必要變更。 分清入口問題與路由問題 如果根目錄能開,但程式內頁404,不代表再增加幾個首頁檔名就能修好。框架路由通常還需要把特定請求交給入口程式;預設文件主要解決目錄請求的入口選擇,兩者責任不同。 相反地,如果所有網址都回到某張舊維護頁,也要核對是否有轉址、維護規則或代理服務。先看回應狀態和網址是否改變,再回到檔案入口。不要只因首頁內容舊,就在沒有證據時修改每一段路由配置。 寶塔網站目錄與運行目錄也會影響你正在查哪組檔案。若網站已指向public,應查看public裡的候選入口,而不是專案根目錄中的同名文件。把生效路徑記清楚,避免修改到不參與服務的舊副本。 變更後查看回應,別把快取當成配置未生效 瀏覽器或中間快取可能保留先前回應。MDN的Cache-Control文件說明,回應可以具有不同的儲存與重新驗證條件;看到舊畫面時,應核對實際回應及快取資訊,而不是立刻再改一次預設文件。 記錄測試網址、時間、狀態碼及實際內容,必要時使用合適的重新驗證方式核對。不要為了測一張首頁,直接清除全站或其他網站的快取,也不要把隨便增加查詢參數當成所有代理都必定繞過快取的保證。 確認新入口正常後,再安排舊文件的保存或移除。保留可回復的原設定和檔案版本,讓維護者知道這次改的是候選順序、文件內容,還是公開目錄;日後出現相似問題,就不必重新猜測整個部署過程。 用小範圍核對完成首頁切換 至少分別查看根目錄、明確入口檔名、一個靜態資源及一條合法內頁,核對它們是否符合預期。這不是要求所有網址都顯示同一內容,而是確認首頁切換沒有讓其他請求走錯入口。 如果網站有多個正式域名,也分別核對各自選中的站點。相同IP不代表各域名使用相同配置;不要用其中一個域名的成功結果,替另一個尚未檢查的入口作結論。 交接時附上改動前後的候選文件清單,並說明哪個文件仍保留作回復使用。若之後更新工具又產生同名HTML,就能辨認它可能再次參與入口選擇,先查實際排序,而不是直接認定PHP程式更新失敗。 參考資料寶塔官方:預設文件Nginx:index文件與選擇順序Apache:DirectoryIndexMDN:Cache-Control寶塔官方:網站目錄
