常見問題

本篇是 HakoSpace 的跨身分快速答疑，給終端使用者、自架者與管理員一起查閱。每題只給一句到三句的結論，需要完整操作步驟時，答案末尾會指向《快速入門》《使用者指南》《速架設指南》《管理員手冊》對應章節。HakoSpace 採每個伺服器各自獨立的帳號設計——每座伺服器的成員資料各自獨立，這是貫穿本篇許多答案的基本特性。

1. 一般問題

Q1.1 HakoSpace 是什麼？跟其他聊天平台的差別在哪？

HakoSpace 是自架的語音、視訊與訊息平台，由 HakoSpace Server 與客戶端（HakoSpace Web 或 HakoSpace Desktop）組成。和其他聊天平台最大的差別，是伺服器由你（或你的伺服器擁有者）架在自己的主機上，伺服器、資料與隱私都由架設者掌控。

→ 詳見《快速入門》§1；自架見《速架設指南》，管理見《管理員手冊》

Q1.2 HakoSpace 能做什麼？

你可以在文字頻道發訊息、在語音頻道進行即時語音 / 視訊 / 螢幕分享、與單一成員 1:1 私訊與通話、在論壇頻道發貼文與回覆，以及在 IO 應用頻道使用白板或貪食蛇等內嵌小應用。

→ 詳見《使用者指南》§2（文字）、§3（語音）、§4（私訊）、§5（論壇）、§6（IO Apps）

Q1.3 我需要安裝什麼才能用 HakoSpace？HakoSpace Web 與 HakoSpace Desktop 有什麼差別？

用瀏覽器打開伺服器擁有者提供的網址就能使用（HakoSpace Web），不必安裝任何軟體；想常駐使用或用桌面專屬功能，可另外下載 HakoSpace Desktop（Windows / Linux）。兩者核心功能相同，桌面專屬功能見 Q4.1。

→ 對照見《快速入門》§2；桌面專屬功能見《使用者指南》§10

Q1.4 HakoSpace 有哪些介面語言？

HakoSpace 提供 English 與繁體中文兩種介面語言，在「設定 → 應用程式設定 → 語言」（點分頁列右側的齒輪圖示開啟設定面板）切換，切換後立即生效。

→ 詳見《使用者指南》§7.8

Q1.5 私訊（DM）跟頻道有什麼不同？

私訊是與單一成員的 1:1 對話空間，不歸任何頻道管理、不受頻道權限限制，並內建 1:1 語音 / 視訊通話；需要三人以上的對話時請改用文字頻道。

→ 詳見《使用者指南》§4

2. 帳號與登入

Q2.1 我在一個 HakoSpace 伺服器註冊後，能用同一組帳號登入別的伺服器嗎？可以同時連多個伺服器嗎？

每座 HakoSpace Server 的帳號各自獨立，你要在每個想加入的伺服器分別註冊一次。可以同時連多座伺服器：HakoSpace Web 開多個瀏覽器分頁即可，HakoSpace Desktop 則用多伺服器側欄切換。

→ 詳見《快速入門》§1 章首備註、§2；桌面多伺服器見《使用者指南》§10.1

Q2.2 我要怎麼加入一個 HakoSpace 伺服器？

你需要伺服器擁有者提供的網址（https://... 開頭）；走 Web 路線在瀏覽器輸入網址即可，走 Desktop 路線則在 HakoSpace Desktop 點多伺服器側欄上的 +（滑鼠移上去會顯示「新增伺服器」），填入伺服器名稱與位址。

→ 詳見《快速入門》§3（§3.1 Web / §3.2 Desktop）

Q2.3 我怎麼建立帳號？為什麼有的伺服器我註冊不了 / 註冊頁長得不一樣？

在登入頁點「還沒有帳號？」旁的「註冊」前往註冊頁，填使用者名稱、密碼（至少 6 個字元，須含英文字母和數字）等欄位。各伺服器的註冊政策不同，你也可能遇到邀請制（需邀請碼）、Email 驗證制，或註冊已關閉（頁面顯示「目前已關閉註冊。」）。

→ 詳見《快速入門》§4；伺服器端設定見《管理員手冊》§3.1

Q2.4 我沒收到 Email 驗證信怎麼辦？

驗證信由伺服器擁有者設定的寄件地址發出，請先檢查垃圾信匣；若仍未收到，用該帳號的使用者名稱和密碼登入一次，登入頁會出現「重新發送驗證郵件」按鈕（使用者名稱或密碼不對時不會出現），填入註冊時用的 email 後點擊即可重寄。

→ 詳見《快速入門》§4

Q2.5 我忘記密碼了怎麼辦？

登入頁的使用者名稱 / 密碼欄位下方有「忘記密碼？」連結，由你所在伺服器的設定決定後續流程。

→ 詳見《快速入門》§4

3. 訊息 / 語音 / 視訊 / 螢幕分享

Q3.1 訊息支援哪些格式、可以做哪些操作？訊息裡的圖片要怎麼放大看？

訊息支援粗體、斜體、刪除線、行內程式碼、防劇透等 Markdown 風格格式，輸入框旁的「格式說明」按鈕可查完整語法。滑鼠移到訊息上可加 emoji 反應、釘選、回覆，自己的訊息還能編輯與刪除。點擊圖片會開啟圖片檢視器，可縮放與拖曳，觸控裝置則用兩指縮放、左右滑動切換。

→ 詳見《使用者指南》§2.2（格式）、§2.3（訊息操作）、§2.4（圖片檢視器）

Q3.2 我怎麼加入語音頻道？拒絕了鏡頭權限還能通話嗎？

點語音頻道的名稱就直接加入；首次加入時只會請求麥克風權限，鏡頭要等你按「開啟鏡頭」時才另外請求。拒絕鏡頭權限仍可進行純語音通話。

→ 詳見《快速入門》§6；完整見《使用者指南》§3（鏡頭權限見 §3.3）

Q3.3 我怎麼開鏡頭 / 分享螢幕？

在語音頻道的個人控制條點「視訊來源」，選「開啟鏡頭」或「分享螢幕」；在手機與平板的瀏覽器上「分享螢幕」是停用的，「開啟鏡頭」照常可用。Windows 版 HakoSpace Desktop 使用遊戲 HUD 時，也可以在遊戲中開啟「HUD 面板」按「分享目前遊戲畫面」。

→ 詳見《使用者指南》§3.3（鏡頭）、§3.4（螢幕分享）、§10.11（遊戲 HUD）

Q3.4 多人可以同時分享螢幕嗎？可以把畫面移到獨立視窗觀看嗎？

可以，多個分享會並列在舞台上；用 OBS 等工具推送的外部串流會顯示為「點擊載入」方塊，點了才開始觀看。想在獨立視窗觀看，按該畫面控制列上的「彈出視窗」，或按頻道頂端的「彈出舞台」。

→ 詳見《使用者指南》§3.4（螢幕分享與彈出視窗）、§10.5（桌面版彈出視窗的操作）

Q3.5 我可以調整通話的麥克風 / 喇叭 / 音質嗎？

可以；輸入 / 輸出裝置、發話靈敏度與螢幕分享畫質在「設定 → 應用程式設定 → 語音與音訊」調整，語音頻道本身的音質則由持有「管理頻道」權限的成員在頻道設定中決定。想單獨調整某一位成員的說話聲，和對方同在語音頻道時對他按右鍵（觸控裝置上長按），拉成員選單裡的「使用者音量」，只會改變你自己聽到的音量。

→ 詳見《使用者指南》§3.5、§7.6；個別成員音量見《使用者指南》§3.1；頻道音質後台見《管理員手冊》§2.2

Q3.6 頻道裡較早的訊息或檔案不見了，是怎麼回事？

頻道若設了「訊息上限」或「訊息保留天數」，較舊的訊息會被自動移除，往回捲到頻道開頭會看到一則說明已自動移除的提示。若「檔案空間滿了時」設為「移除最舊的檔案」，被移除的只有檔案、訊息本身還在，原位置會顯示「已依頻道檔案空間規則移除 · {日期}」。

→ 詳見《使用者指南》§1.3、§2.4；頻道設定見《管理員手冊》§2.1

4. 桌面版常見問題

Q4.1 桌面版有哪些 Web 版沒有的功能？

HakoSpace Desktop 提供多伺服器側欄、系統匣常駐、全域快捷鍵、按鍵發話、HakoCap 螢幕擷取、記住視窗位置與大小、開機時啟動、（Windows）高負載觀看加速、（Windows）遊戲 HUD，以及（Linux）應用程式音訊擷取等桌面專屬功能。HakoCap 由 HakoSpace 自動判斷是否使用，不需要你設定；開機時啟動在「桌面設定 → 行為」開啟。

→ 詳見《使用者指南》§10（HakoCap 見 §10.5，開機啟動與視窗記憶見 §10.7）；自架伺服器的開機自動啟動是另一回事，見 Q5.1

Q4.2 我關掉視窗後 HakoSpace 還在跑，是正常的嗎？要回報問題時該附上什麼？

是；HakoSpace Desktop 預設關閉視窗時會「縮小到系統匣」繼續執行，可在「桌面設定 → 行為 → 關閉按鈕行為」改為「關閉應用程式」。要回報問題時，對系統匣圖示按右鍵選「開啟診斷資料夾」，附上裡面的 hako-diag.log。

→ 詳見《使用者指南》§10.2

Q4.3 桌面版怎麼更新？

Windows 安裝版的「自動更新」預設開啟：啟動時會先檢查並安裝更新，執行中只在背景預先下載、不會自行重新啟動，下載好後按「重新啟動以套用更新」或等下次啟動即可套用。要手動更新，在「桌面設定 → 更新」按「檢查更新」，有新版再按「立即更新」（攜帶版與 Linux 版為「從 GitHub 下載」）。

→ 詳見《使用者指南》§10.8

Q4.4 按鍵發話與全域快捷鍵怎麼設定？綁定後遊戲還收得到同一組按鍵嗎？

按鍵發話要在「桌面設定 → 行為 → 語音輸入模式」選「按鍵發話」，再到「桌面設定 → 快捷鍵」綁定「按鍵發話按鍵」；其他快捷鍵也在同一頁綁定，預設都沒有綁定。「快捷鍵」分頁綁定的組合鍵含 Ctrl / Alt / Shift / Super 等修飾鍵時，前景、背景都能用，遊戲或其他應用程式也照常收得到同一組按鍵。沒有修飾鍵的單一按鍵，或在 Linux 的 Wayland 桌面環境下，快捷鍵只在 HakoSpace 為前景時有效。

→ 詳見《使用者指南》§10.3、§10.4、§11.3；HUD 快捷鍵見《使用者指南》§10.11

Q4.5 我啟用了遊戲 HUD，為什麼在遊戲裡看不到？為什麼在 Office、瀏覽器這類程式上也不會出現？

HUD 在你進入語音頻道後才會啟動，並附著在最大化或以無邊框全螢幕執行的遊戲上；看不到時先到「桌面設定 → HUD」看「狀態」，並確認這款遊戲不在「停用清單」裡。預設情況下 HUD 平常只在有人說話、加入或離開，或有新訊息時出現，按 HUD 快捷鍵（預設 Shift + `）開得了 HUD 面板，就表示 HUD 已經附著。Office、瀏覽器、程式編輯器、通訊軟體、影片播放器等常見工具軟體上，HUD 預設也不會出現。

→ 詳見《使用者指南》§10.11

Q4.6 邊玩遊戲邊看別人的螢幕分享很卡，怎麼辦？

使用 Windows 版的 HakoSpace Desktop 時，可以試著在「桌面設定 → 行為」打開「高負載觀看加速」（預設關閉）。打開後，你在語音頻道中觀看其他成員的螢幕分享時就會套用加速，加速期間主視窗上會顯示「⚡ 觀看加速中」；套用時可能會出現 UAC 提示。

→ 詳見《使用者指南》§10.10

5. Hoster / 管理員常見問題

Q5.1 我要怎麼自己架一座 HakoSpace Server？要怎麼讓它開機自動啟動？

照《速架設指南》用官方 Docker 映像或下載 server 執行檔架設，啟動後第一個註冊的使用者會自動成為 owner。用執行檔架設時，Linux 可用 systemd、Windows 可用工作排程器讓伺服器開機自動啟動；Linux 照範例設定的話，伺服器自行結束（例如套用更新）或異常結束時，systemd 會自動把它帶起來。

→ 詳見《速架設指南》§4（Docker 見 §4.1、系統服務見 §4.5）、§5；桌面版本身的開機啟動是另一個開關，見 Q4.1

Q5.2 我一定要有域名嗎？家用網路的 IP 會變可以架嗎？TLS / HTTPS 憑證要自己手動申請嗎？

只在本機自己試玩時，server 會自動產生自簽憑證（瀏覽器會出現警告、需手動信任）；要邀請他人或公開使用，就需要一個指向 server 公開 IP 的域名與可信 CA 憑證。IP 會變的家用網路可用 DDNS（路由器內建或 no-ip、DuckDNS 等），ISP 採 CGNAT 時請申請固定 IP 或改用雲端 VPS。憑證不必手動申請：在 data/.env 設好 ACME_DOMAIN，內建的 ACME 會自動向 Let’s Encrypt 申請並在到期前續簽。

→ 詳見《速架設指南》§3（§3.1 為何需要域名、§3.2 取得域名與 DDNS、§3.3 設定 TLS）

Q5.3 防火牆要開哪些埠？嚴格 NAT / VPN 後的使用者連不上語音怎麼辦？

對外放行 8080/TCP 與 8443/TCP（沒放行的話外部使用者連不進來，ACME 自動憑證也會失敗）；伺服器對外連線也受限時，「檢查更新」「下載更新」會連到 dl.hakospace.com 與 GitHub，請一併放行。嚴格 NAT（VPN、企業網路）後的使用者連不上語音時，可在「網路 → TURN 伺服器」啟用內建 TURN、開放 TURN 連接埠（預設 3478 的 UDP 與 TCP），並從外部網路實測一次。

→ 詳見《速架設指南》§2.2、§3.3；TURN 見《管理員手冊》§11.1、§12.1；更新要放行的網域見《管理員手冊》§12.2

Q5.4 資料怎麼備份？怎麼升級伺服器到新版本？跑在 Docker 容器裡的伺服器怎麼更新？

資料都存在 data/ 目錄；在「設定 → 儀表板」的「備份」區段按「建立備份」可打包成 zip，建議每週備份、存到 server 以外的地方，升級前一定先備份。升級時在同一頁的「伺服器更新」區段依序按「檢查更新」「下載更新」「套用更新」並確認；在 Linux 上伺服器會換上新版並重新啟動，以 systemd 執行時服務設定要用 Restart=always。跑在 Docker 容器裡的伺服器改用 docker compose pull && docker compose up -d 更新，資料保存在 volume 不會遺失。

→ 詳見《速架設指南》§6.5；備份見《管理員手冊》§11.3；完整更新流程（含預覽版與穩定版之間的切換）見《管理員手冊》§11.5、§12.2

Q5.5 我該先做哪些安全設定再開放給成員？

建議先設好註冊政策（邀請制或 Email 驗證）、啟用禁用字過濾、確認稽核日誌（預設啟用）、至少設一位 admin、建立備份基線，再對外開放。

→ 詳見《速架設指南》§6；各功能進階見《管理員手冊》§3（註冊與角色）、§9（禁用字與稽核日誌）、§11.3（備份）

Q5.6 admin 和 owner 的差別是什麼？

owner 是架設並擁有該伺服器的人、權限最高；admin 是次級管理者，可以進入所有伺服器設定分頁，也能把 member 升為 admin，但不能變更 owner 或其他 admin 的角色，也不能封禁或踢出他們。只想讓某人分擔部分管理工作時，可在「設定 → 權限」把個別權限授予成員或使用者群組，不必把對方升為 admin。

→ 詳見《速架設指南》§6.4；變更角色見《管理員手冊》§3.3；權限的授予見《管理員手冊》§4.3

6. AI bot 常見問題實驗功能

此功能仍在實驗階段，介面與行為可能在未來版本變動。生產環境請審慎評估後再啟用。

Q6.1 HakoSpace 有 AI bot 嗎？我（一般成員）要怎麼跟它對話？預設就能用嗎？

部分伺服器會啟用 AI bot，讓成員透過私訊提問：點「私人訊息」標題右側的星芒圖示按鈕（滑鼠停留會顯示「開始 AI 對話」）開啟與 bot 的私訊即可。「成員存取」開關預設關閉，這時只有 owner、admin 與被授予「管理員」權限的成員能使用，打開後所有成員都能使用。

→ 詳見《使用者指南》§4.1、§9；後台設定見《管理員手冊》§10.1

Q6.2 我是 owner / admin，要怎麼啟用與設定 AI bot？

在「設定 → AI 設定 → 總覽」開關「AI 啟用」、選供應商（Anthropic、OpenAI、Google Gemini 或 OpenRouter）與模型、填 API 金鑰，並設定機器人名稱、是否允許一般成員使用與各項限制。被授予「管理 AI」權限的成員也能進行這些設定。

→ 詳見《管理員手冊》§10.1；權限的授予見《管理員手冊》§4.3

Q6.3 可以限制 AI bot 的用量嗎？

可以；「限制」卡片可設上下文訊息數、最大 Token 數、每日 Token 限額與頻率限制，其中每日 Token 限額是整個伺服器共用的上限，以 UTC 午夜換日。實際用量在「使用紀錄」分頁查看。

→ 詳見《管理員手冊》§10.1、§10.3

Q6.4 AI bot 可以用哪些工具？誰看得到它的使用紀錄？

「工具管理」分頁可逐項開關 bot 能用的工具，bot 替成員做事時只會用那位成員本身有權限的工具。「使用紀錄」分頁列出每次使用的成員、供應商、模型、token 數與狀態，owner、admin 與被授予「管理 AI」或「管理員」權限的成員看得到；頁面說明寫明成員傳給 AI 的訊息不會被記錄，工具呼叫則會連同參數與結果顯示。

→ 詳見《管理員手冊》§10.2、§10.3

7. 隱私、資料、安全

Q7.1 我的資料存在哪裡？誰看得到？

HakoSpace 是自架的，你的訊息、帳號、頻道、上傳檔案都存在該伺服器擁有者的 data/ 目錄、由架設者掌控；私訊是 1:1 對話空間，不歸頻道管理、也不受頻道權限限制。

→ 詳見《速架設指南》§6.5；私訊特性見《使用者指南》§4.2

Q7.2 管理員對伺服器做了什麼，有紀錄可查嗎？

有；稽核日誌預設啟用，變更成員角色、封禁或踢出成員、授予或撤銷權限、修改伺服器名稱或註冊模式等管理操作都會自動記錄，不論操作的是 owner、admin 還是被授予管理權限的成員，都會記下是誰做的。持有「檢視稽核日誌」權限的人（owner 與 admin 一律包含在內）可在「設定 → 稽核日誌」依操作種類篩選查閱。

→ 詳見《速架設指南》§6.2；細節見《管理員手冊》§9.4

Q7.3 訊息會被過濾嗎？

伺服器擁有者可啟用禁用字過濾，命中清單的字詞會依設定被替換或整則訊息被擋下；是否啟用與如何處理由各伺服器自行決定。

→ 詳見《速架設指南》§6.3；管理見《管理員手冊》§9.1

Q7.4 我在瀏覽器主控台（console）看到一段警告、或在桌面版按 F12 打不開開發者工具，是怎麼回事？

在 HakoSpace Web 打開瀏覽器主控台會看到一段紅字警告，大意是：請勿貼上或輸入來路不明的指令，那幾乎可以肯定是詐騙，照做會讓對方有機會盜用你的帳號。開發者確實需要時，可在主控台輸入 devmode=enable 解除保護，只限當前分頁。HakoSpace Desktop 按 F12 打不開開發者工具，同樣是刻意的安全保護，不是故障。

→ 本題答案自足

Q7.5 我的帳號被封禁 / 被踢出，資料會怎樣？

被封禁的成員會立即被斷線且無法再登入；被踢出則會從伺服器移除並刪除其資料；這些動作由 owner、admin 或被授予「管理成員」權限的成員執行，並記入稽核日誌。

→ 詳見《管理員手冊》§3.4

Q7.6 HakoSpace 會收集我的使用資料嗎？隱私權政策與授權條款在哪裡看？

伺服器擁有者可選擇參加「HakoSpace 改善計畫」分享匿名使用統計（介面寫明「不會收集任何個人資料。」）。桌面版只在螢幕分享期間把顯示卡型號、驅動版本等資訊送給你當下連線的那台伺服器（不是 HakoSpace 官方）以診斷影像卡頓；遊戲 HUD 讀取的前景視窗資訊，介面寫明「這些資訊僅於你的裝置上處理，不會傳送至 HakoSpace，也不會傳送至你所連線的伺服器。」完整的隱私權政策與 EULA 可在「使用者設定 → 關於」分頁開啟。

→ 改善計畫見《速架設指南》§5.1，伺服器端開關見《管理員手冊》§1.1；HUD 讀取的項目與用途見《使用者指南》§10.11；「關於」分頁見《使用者指南》§7.10