doona 可以修改什麼

doona 透過不同的控制項修改組態來源、執行期狀態、持久儲存的地理資料設定和瀏覽器偏好。關閉 experimental.native_api.config_write 會停用組態寫入，但不會停用所有操作。

更改儲存在哪裡

下表中的組態來源權限指 experimental.native_api.config_write: true、Token 或密碼認證、可用的組態協調器，以及完整且可寫的組態來源。資料庫組態儲存被阻止寫入時，也無法進行一般的組態來源編輯。引入檔案與主設定檔遵循相同的組態來源規則。

即時生效表示無需重新載入組態。重載表示寫入必須通過驗證並完成啟用操作。重新啟動表示必須在 doona 之外編輯組態，再重新啟動 honk。

更改	條件	儲存與生效方式
組態來源文字：node、subscription、group、routing、dns 中除 bind 之外的欄位、可重載的 global 欄位，以及 assets.subscription	組態來源權限、目前修訂、所需的本機相依項目可用	檔案模式替換檔案；--store db 模式儲存修訂。寫入後重載。
新增或刪除受管節點和訂閱源	可寫的主組態來源及對應的 can_manage 能力	寫入後重載。受管刪除不適用於內建節點、訂閱源產生的節點或引入檔案中的宣告。
編輯訂閱宣告	包含該宣告的組態來源完整且可寫	寫入組態來源後重載。
群組欄位：policy、default、final、tolerance、idle_timeout、interrupt_connections、check_url	所屬組態來源可寫，支援 groups.config_patch，且群組的 mutable_config 包含該欄位	寫入後重載。支援可寫的引入檔案。API 將 default 和 final 分別命名為 default_member_id 和 final_outbound。
執行期 record_flows、record_logs、record_dns_log、log.level、log.buffered_records、dns_log.max_records、flows.max_flows、flows.retention_seconds	API 請求獲准、後端宣告支援該欄位、組態允許記錄且值未超出限制	即時生效。不需要 config_write。重新啟動或已接受的組態啟用會重置這些覆寫值。
地理資料 URL 清單、下載路由、檢查碼驗證、自動更新排程及重置	憑證、可用的狀態資料庫，以及後端宣告支援的對應設定	即時生效，儲存在狀態資料庫中。設定請求不下載或啟用檔案，也不需要 config_write。更新可用時，doona 在儲存來源 URL 後另行啟動更新。
更新地理資料檔案	組態寫入權限、憑證、已載入且具備路徑和 URL 的資源	下載、替換檔案，然後啟用。見地理資料更新條件。
選擇群組成員、固定自動策略的成員或取消固定	後端運作中、群組選擇能力，以及群組的 can_select 或 can_override	即時生效的執行期操作。不寫入組態來源，也不需要 config_write。Selector 的持久儲存依賴狀態快取，且 experimental.cache_file.enabled 不能為 false。
外觀、語言、版面配置、旗幟覆寫和探測偏好	瀏覽器支援及儲存可用	在目前瀏覽器中即時生效，不修改 honk 組態。背景圖片透過 IndexedDB 持久儲存。

honk 啟動時，啟動組態中明確指定的地理資料 URL 和下載路由會替換對應的已儲存覆寫值。組態來源編輯若改變了解析後的原生 API 設定，就需要重新啟動。見地理資料設定。

必須重新啟動的設定

API 會在寫入前拒絕以下實際生效值的更改。請使用外部編輯器修改，再按服務管理操作。編輯器可能顯示需要重新啟動的診斷或 listener_settings_changed；見寫入被拒絕。

區塊	只能透過重新啟動生效的鍵
dns	bind
global	check_interval、tcp_check_url、tcp_check_http_method、udp_check_dns、tls_implementation、tproxy_port、tproxy_port_protect、pprof_port、so_mark_from_dae、log_level、log_file、lan_interface、wan_interface、auto_config_kernel_parameter、data_dir、store_subscribe、nfqueue_enable
experimental.native_api	所有欄位，包括認證、監聽器、介面、記錄和寫入設定
experimental.clash_api	external_controller、external_ui、external_ui_download_url、external_ui_download_detour、secret、default_mode
experimental.cache_file	enabled、store_dns
assets	geodata.geosite、geodata.geoip、geodata.route、ui.url、ui.route，以及繼承的 route，條件是更改影響了解析後的原生 API 或 Clash API 設定

健康檢查比較的是實際生效的第一個 HTTP URL、請求方法，以及選定的 UDP DNS 目標。切換到 UTLS 模式或從該模式切出時，tls_implementation 需要重新啟動。日誌檔案比較的是實際生效路徑，包括命令列覆寫值。

重載策略也會比較內部欄位 global.tproxy_mark。DAE 組態不接受此鍵，請勿將它加入檔案。資料庫模式下，修改 global.data_dir 會被拒絕並回傳 listener_settings_changed；檔案模式下則回傳需要重新啟動的診斷。

組態來源為何唯讀

檢視組態頁的組態來源標記。以下情況會使組態來源唯讀：

• config_write 已停用，或 secret 與 password_auth 均未提供憑證。
• 組態來源宣告了原生 API 或 Clash API 監聽器的金鑰。
• 文字中含有需要遮罩處理的監聽器金鑰值。honk 會遮罩處理與金鑰相符且長度至少為八位元組的值。
• 資料庫模式下，記錄生效修訂失敗，導致儲存被阻止寫入。

組態來源集合或寫入協調器不可用時，組態操作也不可用。doona 拒絕不完整的組態來源內容。寫入不能引入監聽器金鑰、改變包含憑證的組態來源集合，或修改監聽器設定。

將監聽器金鑰放在單獨的引入檔案中，並在 doona 之外編輯該檔案。重新啟動 honk 後，重新開啟組態頁，檢查其他組態來源的標記。如果其他組態來源含有相同的已遮罩金鑰值，僅拆分金鑰宣告仍無法解除唯讀。見唯讀組態來源與寫入被拒絕。

檔案系統要求

可寫標記不代表檔案系統允許替換檔案。在檔案模式下，honk 必須讀取原檔案，在同一目錄建立並同步暫存檔，再將暫存檔重新命名以替換原檔案，最後同步目錄。服務使用者須能存取所在目錄，並有權在其中建立和替換目錄項目。

組態寫入會拒絕來源路徑中的符號連結和非一般檔案。替換操作修改的是目錄項目，因此僅檢查來源檔案的寫入權限位元，無法判斷能否寫入。同時修改檔案也可能導致寫入遭拒。套用後，確認操作成功，再重新讀取組態來源核對修改。

地理資料更新有單獨的目標位置規則：套件中的資源通常由資料目錄中的檔案替代。見地理資料位置。

已接受但沒有預期即時效果的欄位

欄位	實際行為
global.preconnect_node_count	供啟動預熱使用。接受組態來源編輯不會再次執行預熱。重新啟動 honk 後，啟動預熱才會使用新值。
global.tls_fragment、global.tls_fragment_length、global.tls_fragment_interval	為相容性而接受並儲存；此 honk 修訂沒有使用這些欄位進行執行期分片的實作。
global.bandwidth_max_tx、global.bandwidth_max_rx	為相容性而接受並儲存；此 honk 修訂沒有使用這些欄位限制執行期頻寬的實作。

編輯被接受只表示操作已開始。操作狀態變為 succeeded 後變更才生效，請重新讀取來源確認。即使如此，相容性欄位也不會改變流量行為。

---

來源：doona 上游文件，採用 CC BY 4.0 授權條款。