JKSV远程存储功能全攻略：从配置到迁移的完整指南

准备工作：环境搭建与前置条件

开发环境准备

建议您先确认本地开发环境已满足构建需求。推荐操作：通过以下命令克隆项目代码库并准备构建环境：

git clone https://gitcode.com/gh_mirrors/jk/JKSV
cd JKSV

必要文件准备

在开始配置前，请确保您已准备好以下文件：

• 云端存储所需的JSON格式凭据文件
• WebDav服务的访问信息（服务器地址、账号密码）
• 最新版本的JKSV源码

⚠️ 注意：远程存储功能需要自行构建项目才能使用，预编译版本可能不包含此功能。

---

核心功能：两种远程存储方案部署

云端存储方案

适用场景：个人用户的跨设备同步需求

项目创建与API启用

准备：访问服务商控制台创建新项目，建议命名为"JKSV"。在项目仪表板中导航至"已启用的API和服务"，启用"云端存储API"服务。

授权配置与凭据获取

连接：创建OAuth（一种安全的第三方授权协议）凭据时，选择"Cloud Storage API"类型和"用户数据"访问类型。添加.../auth/drive权限范围后，创建桌面应用类型的OAuth客户端ID。

凭据部署与测试用户设置

验证：下载生成的JSON凭据文件，复制到Switch的SD卡指定路径SD:/config/JKSV/。在OAuth同意屏幕中添加测试用户账号，完成配置。

WebDav存储方案

适用场景：自建服务器用户的私有存储需求

配置文件创建

准备：创建webdav.json配置文件，包含以下内容：

{
  "origin": "https://your-webdav-server",  // 服务器地址，不含结尾斜杠
  "basepath": "optional-base-path",        // 可选基础路径，不含首尾斜杠
  "username": "testuser",                  // 服务器认证用户名
  "password": "testpassword"               // 服务器认证密码
}

配置文件部署

连接：将配置文件复制到SD卡指定路径SD:/config/JKSV/。建议使用HTTPS加密连接以确保数据安全。

连接验证

验证：启动JKSV后查看WebDav状态提示。如遇问题，可检查日志文件SD:/JKSV/log.txt获取详细错误信息。

JKSV项目官方标志，代表着可靠的存档管理解决方案

---

高级配置：优化与个性化设置

存储优先级设置

建议您了解：当同时配置云端存储和WebDav时，系统会优先使用云端存储。如需切换存储方式，可暂时移除不需要的配置文件。

网络传输优化

推荐操作：大文件传输时，建议在网络稳定的环境下进行。对于WebDav服务，可适当调整服务器超时设置以适应大型存档文件的传输需求。

安全增强配置

⚠️ 重要安全建议：妥善保管您的凭据文件，避免分享给他人。使用WebDav时，务必启用HTTPS加密连接，防止数据在传输过程中被拦截。

---

问题解决：常见问题与迁移指南

常见配置对比表

存储方案	优势	劣势	适用场景
云端存储	配置简单，跨平台同步	有用户限制，需定期重新登录	个人用户日常使用
WebDav	完全控制数据，无用户限制	需要自建服务器	技术爱好者，隐私敏感用户

版本迁移指南

如果您从旧版本升级而来，请注意：2024年7月27日之后的版本移除了远程目录中标题名称的"不安全"字符。建议您：

1. 手动迁移包含不安全字符的存档
2. 检查并更新所有相关的自动化脚本
3. 确保新配置文件与旧版兼容

常见问题排查

• 认证失败：检查凭据文件路径是否正确，测试用户是否已添加
• 连接超时：验证服务器地址和端口是否可达，网络连接是否稳定
• 同步错误：查看日志文件获取详细错误信息，检查文件权限设置

---

通过本指南，您应该能够顺利配置和使用JKSV的远程存储功能。建议定期检查配置状态，确保存档数据安全可靠。如有其他问题，可参考项目文档或社区支持资源。