JKSV项目远程存储功能使用指南:云端存储与WebDav配置详解
前言
JKSV作为一款功能强大的游戏存档管理工具,其远程存储功能为用户提供了云端备份的解决方案。本文将详细介绍如何配置云端存储和WebDav两种远程存储方式,帮助用户实现游戏存档的云端同步与管理。
云端存储配置指南
重要注意事项
- 开发状态:当前版本需要用户自行构建才能使用云端存储功能
- 使用限制:
- 由于服务商对未验证应用的限制,每个用户需要每7天重新登录一次
- 最多支持100个测试用户(这是服务商的政策限制)
详细配置步骤
1. 创建云端项目
首先访问服务商控制台,创建新项目:
- 项目名称建议使用"JKSV"
- 无需设置组织信息
- 创建后等待几秒钟完成项目初始化
2. 启用必要API服务
在项目仪表板中:
- 导航至"已启用的API和服务"
- 点击"+启用API和服务"
- 在分类下找到并启用"云端存储API"
3. 配置OAuth凭据
- 创建OAuth凭据时选择:
- API类型:Cloud Storage API
- 数据访问类型:用户数据
- 添加必要的权限范围:
- 查找并选择
.../auth/drive
权限
- 查找并选择
- 创建OAuth客户端ID:
- 应用类型:桌面应用
- 名称:JKSV
4. 下载并部署凭据文件
- 下载生成的JSON格式凭据文件
- 将该文件复制到Switch的SD卡指定路径:
SD:/config/JKSV/
5. 设置测试用户
- 导航至"OAuth同意屏幕"
- 在"测试用户"部分添加您的账号
使用说明
完成上述配置后,下次启动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
)
- 注意:路径中的特殊字符和空格需使用URI编码(如空格变为
username/password
(可选):服务器认证信息
2. 部署配置文件
将配置文件复制到SD卡指定路径:SD:/config/JKSV/
3. 验证与排错
- 启动JKSV后会显示WebDav状态提示
- 如遇问题,可查看日志文件:
SD:/JKSV/log.txt
版本变更说明
2024年7月27日重要更新:
- 移除了远程目录中标题名称的"不安全"字符
- 影响:如果已有存档使用了包含不安全字符的标题名称,需要手动迁移这些存档
技术原理深入解析
JKSV的远程存储功能实现基于以下技术要点:
- OAuth 2.0认证流程:云端存储集成采用标准的OAuth 2.0协议,确保安全的用户授权
- 凭证管理:使用JSON格式的客户端密钥文件,比传统配置文件更安全可靠
- 文件同步机制:采用差异同步策略,优化网络传输效率
- 错误处理:完善的日志系统帮助用户排查连接问题
最佳实践建议
-
定期维护:
- 建议每月检查一次云端存储的访问令牌状态
- 定期清理不需要的云端存档副本
-
网络优化:
- 使用WebDav时,确保本地网络与服务器之间的稳定连接
- 大文件传输建议在后台进行
-
安全建议:
- 妥善保管凭据文件
- 使用WebDav时建议启用HTTPS加密连接
通过本文的详细指导,用户应该能够顺利完成JKSV的远程存储配置,享受云端存档管理的便利。如在配置过程中遇到问题,建议仔细检查每个步骤,特别是凭据文件的格式和存放位置。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考