Skip to content

jackwu925/USTC-Drive-for-Linux

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 

Repository files navigation

USTC Drive Linux 包装启动器(科大云盘)

问题背景

在 Ubuntu 系统上运行科大云盘时,无法登陆(无法打开登陆GUI界面)

直接执行原始 USTC_Drive_1.1.9.AppImage 时,当前环境会出现两类典型问题:

  1. AppImage 依赖 FUSE 挂载,但受限环境下常见报错如下:
fuse: failed to open /dev/fuse: Permission denied
Cannot mount AppImage, please check your FUSE setup.
  1. 程序在调用系统浏览器登录或打开网页时,可能把 AppImage 自带的库带给外部进程,进而触发类似下面的兼容性问题:
/usr/bin/google-chrome-stable: .../libnss3.so: version `NSS_3.65' not found

解决方案

本仓库提供了一个同名启动器 USTC_Drive_1.1.9.AppImage,核心思路如下:

  • 不再直接挂载 AppImage,而是在首次运行时把原始 AppImage 解包到本地目录。
  • 后续优先从已解包目录启动,绕开 FUSE 限制。
  • xdg-open 提供一个环境净化包装,避免系统浏览器继承 AppImage 的私有动态库路径。
  • 保留原始 AppImage 作为“重新解包来源”。

仓库内容

  • USTC_Drive_1.1.9.AppImage 可直接执行的包装启动器。
  • USTC_Drive_1.1.9.AppImage.orig ���始 AppImage,大文件不适合直接放进 Git 历史。
  • .USTC_Drive_1.1.9.AppDir 解包后的程序目录,首次成功解包后生成。
  • .USTC_Drive_1.1.9.launcher-bin 启动辅助目录,内部包含净化过环境的 xdg-open 包装。

GitHub 仓库存储说明

GitHub 普通 Git 仓库对单文件大小有限制。当前目录中至少有以下文件无法直接作为普通 Git 对象提交:

  • USTC_Drive_1.1.9.AppImage.orig
  • .USTC_Drive_1.1.9.AppDir/usr/lib/libQt5WebEngineCore.so.5

因此推荐的发布方式是:

  • Git 仓库中保存启动器、说明文档和必要脚本。
  • 原始大文件通过 GitHub Release 资产提供下载。

当前已上传的原始 AppImage 下载地址:

https://github.com/jackwu925/USTC_drive_linux/releases/download/v1.1.9-wrapper/USTC_Drive_1.1.9.AppImage.orig

使用方法

方式一:本地已有原始 AppImage

把下面两个文件放在同一目录中:

  • USTC_Drive_1.1.9.AppImage
  • USTC_Drive_1.1.9.AppImage.orig

如果本地没有原始 AppImage,可先从上面的 Release 地址下载 USTC_Drive_1.1.9.AppImage.orig

执行:

chmod +x USTC_Drive_1.1.9.AppImage
./USTC_Drive_1.1.9.AppImage

方式二:已存在解包目录

如果目录中已经有 .USTC_Drive_1.1.9.AppDir,则可直接执行:

./USTC_Drive_1.1.9.AppImage

这时即使 USTC_Drive_1.1.9.AppImage.orig 不在本地,也不影响启动。

运行说明

  • 首次启动时,程序可能需要先解包,耗时会比后续启动更长。
  • 程序启动后通常会常驻托盘,再次执行多半会复用已有实例。
  • 如果 .USTC_Drive_1.1.9.AppDir 被删除,而本地又没有 USTC_Drive_1.1.9.AppImage.orig,启动器会提示缺少原始 AppImage。

About

USTC Drive Linux 启动包装器,解决科大云盘在 Linux 系统上运行时,无法打开登录界面问题。

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages