取得支援
新手入門
一次收集好該有的資料,把私人內容隱藏起來,再到對的地方提問。
發問之前
連結到「發問之前」- 先看疑難排解裡對應你症狀的部分。
- 執行 doctor:
docker exec holyarrs /holyarrs doctor。如果有FAIL那一行,照它的說明修正。
收集支援封包
連結到「收集支援封包」支援封包是一個 zip,裡面有協助的人最先會問的資料。擁有者和管理員可以下載它。
- 開啟
/health頁面。 - 按下 Download support bundle(下載支援封包)。你應該會得到一個
.zip檔案。
| 檔案 | 內容 |
|---|---|
log.txt |
最新的 log,金鑰、token 和密碼都已移除。 |
about.json |
版本和設定的詳細資料。 |
doctor.txt |
doctor 的報告。 |
health.json |
目前的健康檢查結果。 |
如果你開不了 Web 頁面,就改為提供 doctor 的輸出和最後 100 行 log:docker logs --tail 100 holyarrs。
隱藏私人內容
連結到「隱藏私人內容」機密資料會被移除,但封包裡還是可能看得到資料夾路徑和主機名稱。貼出任何東西之前:
- 把主機名稱、網域和公開 IP 位址換成
example。 - 移除你不想公開的資料夾名稱,例如路徑裡有你的名字。
- 絕對不要貼出
holyarrs.key、API 金鑰、密碼,或含有機密資料的 Compose 檔。
去哪裡發問
連結到「去哪裡發問」| 地方 | 用在 |
|---|---|
| Discord | 問題和設定上的協助。 |
| GitHub Issues | 你能重現的 bug。 |
| r/HolyArrs | 想法。 |
在訊息裡寫出你做了什麼、你預期會發生什麼,以及實際發生了什麼。附上封包,或貼上 doctor 的輸出。
給進階使用者
連結到「給進階使用者」用 API 取得封包
用擁有者或管理員的金鑰(需有 admin 範圍),放在 X-Api-Key 裡送出 GET /api/v1/support/bundle,就會回傳同一個 zip。
相關頁面
連結到「相關頁面」HolyArrs 是免費的。如果它幫你省下了時間,歡迎在 GitHub 上給顆星、贊助專案,或請我喝杯咖啡。