JKSV项目远程存储功能使用指南：云端存储与WebDav配置详解

前言

JKSV作为一款功能强大的游戏存档管理工具，其远程存储功能为用户提供了云端备份的解决方案。本文将详细介绍如何配置云端存储和WebDav两种远程存储方式，帮助用户实现游戏存档的云端同步与管理。

云端存储配置指南

重要注意事项

1. 开发状态：当前版本需要用户自行构建才能使用云端存储功能
2. 使用限制：
   • 由于服务商对未验证应用的限制，每个用户需要每7天重新登录一次
   • 最多支持100个测试用户（这是服务商的政策限制）

详细配置步骤

1. 创建云端项目

首先访问服务商控制台，创建新项目：

• 项目名称建议使用"JKSV"
• 无需设置组织信息
• 创建后等待几秒钟完成项目初始化

2. 启用必要API服务

在项目仪表板中：

1. 导航至"已启用的API和服务"
2. 点击"+启用API和服务"
3. 在分类下找到并启用"云端存储API"

3. 配置OAuth凭据

1. 创建OAuth凭据时选择：
   • API类型：Cloud Storage API
   • 数据访问类型：用户数据
2. 添加必要的权限范围：
   • 查找并选择.../auth/drive权限
3. 创建OAuth客户端ID：
   • 应用类型：桌面应用
   • 名称：JKSV

4. 下载并部署凭据文件

1. 下载生成的JSON格式凭据文件
2. 将该文件复制到Switch的SD卡指定路径：SD:/config/JKSV/

5. 设置测试用户

1. 导航至"OAuth同意屏幕"
2. 在"测试用户"部分添加您的账号

使用说明

完成上述配置后，下次启动JKSV时：

• 系统将通过Switch的网页浏览器提示您登录账号
• 登录成功后即可使用云端存储进行存档的云端同步

WebDav配置指南

重要说明

• 如果同时配置了云端存储和WebDav，系统会优先使用云端存储
• WebDav配置相对简单，适合自建存储服务器的用户

配置步骤

1. 创建配置文件

创建名为webdav.json的文件，内容格式如下：

{
  "origin": "https://your-webdav-server",
  "basepath": "optional-base-path",
  "username": "testuser",
  "password": "testpassword"
}

参数说明：

• origin（必需）：服务器地址，包含协议和端口（如https://server:8080），不要包含结尾斜杠
• basepath（可选）：基础路径，需事先存在（如games/saves），不要包含开头和结尾斜杠
  • 注意：路径中的特殊字符和空格需使用URI编码（如空格变为%20）
• username/password（可选）：服务器认证信息

2. 部署配置文件

将配置文件复制到SD卡指定路径：SD:/config/JKSV/

3. 验证与排错

• 启动JKSV后会显示WebDav状态提示
• 如遇问题，可查看日志文件：SD:/JKSV/log.txt

版本变更说明

2024年7月27日重要更新：

• 移除了远程目录中标题名称的"不安全"字符
• 影响：如果已有存档使用了包含不安全字符的标题名称，需要手动迁移这些存档

技术原理深入解析

JKSV的远程存储功能实现基于以下技术要点：

1. OAuth 2.0认证流程：云端存储集成采用标准的OAuth 2.0协议，确保安全的用户授权
2. 凭证管理：使用JSON格式的客户端密钥文件，比传统配置文件更安全可靠
3. 文件同步机制：采用差异同步策略，优化网络传输效率
4. 错误处理：完善的日志系统帮助用户排查连接问题

最佳实践建议

1. 定期维护：

   • 建议每月检查一次云端存储的访问令牌状态
   • 定期清理不需要的云端存档副本

2. 网络优化：

   • 使用WebDav时，确保本地网络与服务器之间的稳定连接
   • 大文件传输建议在后台进行

3. 安全建议：

   • 妥善保管凭据文件
   • 使用WebDav时建议启用HTTPS加密连接

通过本文的详细指导，用户应该能够顺利完成JKSV的远程存储配置，享受云端存档管理的便利。如在配置过程中遇到问题，建议仔细检查每个步骤，特别是凭据文件的格式和存放位置。