迁移 Loris Tunnel 配置目录
版本与截图
本指南描述当前源码版本。已发布的安装包可能功能较少;请对照发布说明确认你安装的版本。截图使用演示数据和 Pro 示例状态。
自定义配置目录可以把隧道设置放到已知的备份位置,或把工作用的配置与默认目录分开。Loris 在桌面设置中提供了目录控制项,日常使用不需要手动编辑重定向文件。

开始之前
先导出当前配置,并选择一个你的账号可访问的目录。配置中可能包含密码和注册码,请使用访问控制合适的位置。避免同时运行两个会写入同一个 TOML 文件的应用实例。
默认位置与实际位置
已安装的版本通常使用 ~/.loris-tunnel/config.toml。在 wails dev 下,可写的工作目录会使用 ./config.toml;否则使用主目录。
该默认配置旁的 config.root 文件指向实际生效的数据目录。它的第一行是一个绝对目录路径,而不是 TOML 文件名。如果目标无效、不可用或权限不足,应用会回退到默认位置。
自定义目录改变的是实际生效位置,不会改变云备份包含的内容,也不会转移存放在别处的服务商凭据。
在界面中更改目录
- 打开配置,找到配置数据目录。
- 选择新文件夹前,先确认当前生效的路径。
- 确认复制与切换操作。如果目标目录已有配置文件,请根据你想保留哪一份配置,明确选择覆盖或使用现有。
- 允许应用停止运行中的隧道并退出。打包版本会尝试重新打开;如需要请手动打开。在
wails dev下需自行重新启动。 - 再次打开配置,确认实际路径后再编辑或启动连接。
选择已有的配置档案会改变应用引用的隧道和凭据。在覆盖任何重要内容之前,请先备份两份配置。
恢复默认位置
在同一设置区域使用恢复默认。请仔细阅读确认信息:应用会把配置复制回去、移除重定向并退出以便重启。重新打开后请验证实际路径和配置,而不是想当然认为旧的默认配置未被改动。
备份正确的文件
要备份实际生效的 TOML,而不只是旧的默认文件。如果你还需要机器本地设置,请一并考虑 frp-local.json 和环境相关的同步设置。私钥和 Cloudflare 凭据可能存放在该目录之外,请为它们单独制定安全的备份策略。
云备份只上传实际生效的 TOML,不包括 config.root、密钥、FRP 服务器 token 或服务商登录信息。迁移目录不会让这些文件进入上传范围。
验证迁移结果
在配置中检查实际路径,查看隧道列表,并启动一条已知可用的连接。确认改动被保存到了所选目录。如果你使用云备份,迁移后也请检查它的连接状态。
常见问题
为什么应用又回到默认目录了?
请检查自定义文件夹是否已挂载、可访问且可写,以及 config.root 是否仍指向它的绝对路径。无效的重定向会回退到默认位置。
可以把 config.root 复制到另一个操作系统吗?
Windows 的绝对路径在 macOS 上通常无法解析。请在每台设备上通过界面选择目录,并验证实际生效路径。
共享文件夹可以当作多设备同步方案吗?
不可以。请避免多个写入者同时操作同一个 TOML。需要采用另一台设备的配置时,请使用应用提供的云端冲突与恢复流程。