用途:在 Tauri v2 应用中打开外部链接或文件,交由系统默认应用处理,同时通过协议与路径白名单限制可打开的目标。
主要能力:安装并注册 opener 插件;在 capabilities 中配置允许的 URL/协议与路径权限;在前端调用 openUrl 与 openPath 打开链接和文件;对协议和路径做安全校验。
使用方式:安装插件 cargo add tauri-plugin-opener;在 Tauri builder 中注册 .plugin(tauri_plugin_opener::init());在 src-tauri/capabilities/default.json 配置权限,例如 opener:allow-open-url 并限定 url 为 https://**,以及 opener:allow-open-path;前端使用 import { openUrl, openPath } from '@tauri-apps/plugin-opener'; 后调用 await openUrl('https://tauri.app'); 或 await openPath('/path/to/document.pdf')。
适用场景:用户提到打开链接、打开 URL、打开文件、默认浏览器、opener、launch 等触发词时使用。
限制与安全:应将允许协议限制为 https:// 及特定 scheme,不要允许任意 URL;打开前需校验路径以防路径穿越攻击。参考文档:https://v2.tauri.app/plugin/opener/。