前言¶
在 DSH Web 環境中配置遠程訪問配對通常需要手動操作。爲了減少這一步驟，dsh-pair-quick 插件在設置頁增加了一個「快速配對」入口，提供一鍵生成配對鏈接和二維碼的能力。
插件簡介¶
dsh-pair-quick 是由 dsh-publish 維護的客戶端插件。它通過在 DSH Web 的設置界面中新增頁面，實現遠程訪問配對鏈接的一鍵鑄造與二維碼展示。該插件僅提供界面和令牌生成功能，不涉及憑據的持久化存儲。
核心功能¶
該插件包含以下功能：
* 新增設置頁：在設置頁增加「快速配對」頁面。
* 一鍵鑄造：點擊按鈕即可生成遠程訪問配對鏈接。
* 二維碼展示：實時顯示配對二維碼，方便移動端掃描。
* 一次性令牌：生成的鏈接爲一次性令牌，有效期約 10 分鐘。
安裝與啓用¶
使用官方安裝命令將插件添加到 Web 配置文件中：
dsh plugin --profile web add dsh-pair-quick
安裝完成後，重啓 dsh web 進程。在瀏覽器中打開設置頁面，進入「快速配對」標籤，點擊「獲取配對鏈接」，使用手機掃描生成的二維碼即可完成配對。
注意事項¶
- 依賴檢查：該插件依賴
remote-web-ui的/api/pair/issue接口。使用前需確保remote-web-ui已安裝並正確配置了隧道/LAN 訪問。 - 安全限制：配對鏈接的鑄造端點僅允許迴環地址（
127.0.0.1/::1）訪問。來自局域網的請求會被拒絕並返回 403 錯誤。 - 有效期與隱私：配對鏈接是一次性令牌，有效時間約 10 分鐘。插件不會在此處持久化任何憑據，符合最小權限原則。
結尾¶
dsh-pair-quick 簡化了 DSH Web 端的配對流程，適合需要頻繁進行遠程訪問配對的場景。
