跳到內容

取得支援

新手入門

一次收集好該有的資料,把私人內容隱藏起來,再到對的地方提問。

  1. 先看疑難排解裡對應你症狀的部分。
  2. 執行 doctor:docker exec holyarrs /holyarrs doctor。如果有 FAIL 那一行,照它的說明修正。

支援封包是一個 zip,裡面有協助的人最先會問的資料。擁有者和管理員可以下載它。

  1. 開啟 /health 頁面。
  2. 按下 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 上給顆星、贊助專案,或請我喝杯咖啡。