文档

SauOS OSSDisk 详细使用指南和技术文档

快速开始

系统要求

  • Windows 7 或更高版本
  • .NET 10.0 运行时环境
  • 阿里云账号及OSS服务访问权限

安装步骤

  1. 下载便携式ZIP包或安装程序
  2. 如果下载的是ZIP包，解压到目标目录
  3. 如果下载的是安装程序，运行安装向导完成安装
  4. 双击桌面图标或从开始菜单启动应用程序

详细使用指南

配置OSS连接

在主界面的"阿里云OSS配置"区域填写以下信息：

  • Endpoint：OSS服务地址，如 oss-cn-hangzhou.aliyuncs.com
  • AccessKey：阿里云访问密钥ID
  • AccessKey：阿里云访问密钥Secret
  • Bucket：要挂载的OSS存储空间名称

填写完成后，点击"测试连接"按钮验证配置是否正确。

设置挂载参数

在"磁盘挂载"区域配置以下参数：

  • 挂载路径：本地磁盘驱动器号（如 Z:）或文件夹路径
  • OSS目录：要挂载的OSS目录前缀（可选）
  • 开机自动挂载：勾选以启用开机自动挂载功能

挂载OSS存储

配置完成后，点击"挂载"按钮将OSS存储映射为本地磁盘。挂载成功后，您可以在文件资源管理器中访问挂载的OSS存储。

OSS目录选择器

点击"选择目录"按钮可以打开图形化OSS目录选择器，通过可视化界面浏览和选择OSS目录结构。

  • 双击目录进入子目录
  • 双击文件选择文件
  • 点击"选择"按钮选择当前目录
  • 点击"取消"按钮取消选择

高级功能

保存和导入配置

应用程序支持将当前配置保存到JSON文件和从文件导入配置：

  • 点击"保存配置"按钮将当前配置保存到JSON文件
  • 点击"导入配置"按钮从JSON文件加载配置

开机自动挂载

启用开机自动挂载功能后，应用程序会在系统启动时自动挂载OSS存储：

  1. 勾选"开机自动挂载"选项
  2. 配置好OSS连接参数和挂载设置
  3. 点击"挂载"按钮
  4. 应用程序会自动保存配置并在下次系统启动时自动挂载

故障排除

常见问题

无法找到dotnet命令

确保已安装.NET 10.0运行时环境，并且已将dotnet添加到系统PATH环境变量中。

阿里云访问凭证错误

请检查AccessKey ID和AccessKey Secret是否正确，并确保该账号有访问指定OSS Bucket的权限。

挂载路径被占用

请尝试使用其他驱动器号或文件夹路径作为挂载点。

开机自动挂载不工作

  1. 检查是否以管理员权限运行应用程序
  2. 查看Windows注册表项`HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\Run`中是否有SauOS_OSSDISK项
  3. 确保防病毒软件没有阻止注册表修改

OSS目录选择器无法显示目录

  1. 检查网络连接是否正常
  2. 确认OSS访问凭证是否正确
  3. 确认Bucket名称是否正确

技术文档

架构概述

SauOS OSSDisk 采用模块化设计，主要包括以下组件：

  • OSSFileSystem：封装阿里云OSS的基本操作
  • OSSDriveMapper：实现OSS与本地文件系统的映射逻辑
  • MainForm：提供用户界面用于配置和控制OSS挂载
  • OSSDirectorySelector：提供图形化OSS目录选择界面
  • ConfigManager：管理应用程序配置
  • Logger：记录应用程序操作日志

配置文件

应用程序使用JSON格式的配置文件 appsettings.json：

{
  "OSS": {
    "DefaultEndpoint": "oss-cn-hangzhou.aliyuncs.com",
    "DefaultMountPoint": "Z:"
  },
  "Application": {
    "Name": "SauOS_OSSDISK",
    "Version": "1.2.0"
  },
  "AutoMount": {
    "Enabled": false,
    "MountPath": "",
    "OSSPrefix": ""
  }
}

日志文件

应用程序会在运行目录生成日志文件 ossdisk.log，记录关键操作和错误信息。