最稳妥方法是直接用dpkg安装官方.deb包：先下载对应架构的baidunetdisk_linux_v2.0.1_*.deb，执行sudo dpkg -i安装，再立即运行sudo apt install -f补全libfuse2、libappindicator3-1等依赖，最后终端运行baidunetdisk验证并解决缺失库问题。
直接用 dpkg 安装官方 baidunetdisk .deb 包最稳妥
Ubuntu、Debian、优麒麟、银河麒麟桌面版等 Debian 系发行版，应优先走官方 .deb 包安装路径。它自带 desktop 文件、图标、自动更新机制，且启动后能正常托盘和同步。
常见错误现象包括：Failed to load module "canberra-gtk-module"（不影响功能）、libappindicator3-1: cannot open shared object file（导致托盘不显示）、Segmentation fault（多因缺失 libfuse2 或架构错配）。
- 先确认系统架构：
uname -m—— 若输出aarch64或arm64，必须下载_arm64.deb；x86_64才用_amd64.deb - 下载地址以百度网盘官网为准，例如：
wget https://pan.baidu.com/download/linux/baidunetdisk_linux_v2.0.1_amd64.deb - 安装命令顺序不能颠倒：
sudo dpkg -i baidunetdisk_*.deb→ 立即执行sudo apt install -f补依赖（尤其libfuse2、libappindicator3-1、libqt5svg5） - 装完别急着点图标启动，先终端运行一次：
baidunetdisk，看是否报缺失库——有就手动装，比如sudo apt install libappindicator3-1
ARM64 平台（飞腾/鲲鹏）安装失败，大概率是 libfuse2 版本冲突
银河麒麟 V10 SP3/SP4、openKylin 2.0+ 在 ARM64 上跑 baidunetdisk 常卡在「登录页白屏」或「闪退」，根源不是客户端本身，而是系统预装的 libfuse3 与客户端硬依赖的 libfuse2 不兼容。
这不是百度云的问题，是 Linux 发行版默认启用 fuse3 后的生态断层。绕过方法有限但有效：
- 先卸载冲突包（谨慎）：
sudo apt remove libfuse3，再装libfuse2：sudo apt install libfuse2 - 若无法卸载
libfuse3（如被systemd或udisks2强依赖），可临时降级：sudo apt install libfuse2=2.9.9-3（版本号查apt list -a libfuse2） - 验证 fuse 加载：
fusermount -V应输出fusermount version: 2.9.9，而非3.x - 装完重启
dbus：因为托盘依赖 D-Bus session，systemctl --user restart dbus
没图形界面？用 baidupcs-go 替代，但注意它不支持分享链接直下
服务器、Docker 容器、WSL 等无 GUI 场景，baidupcs-go 是目前最稳定可用的命令行方案。它基于百度 PCS API，不走网页模拟，速度和稳定性优于 bypy。
但它不处理「分享链接」，只操作你自己的网盘空间。想下别人分享的文件？得先用浏览器登录账号，把文件保存到自己网盘，再用 baidupcs-go d /path 下载。
- 安装前确保 Go 环境已就位：
go version输出至少go1.19+ - 不要用
go install直接拉 master 分支——不稳定。应下载 Release 二进制：wget https://github.com/iikira/BaiduPCS-Go/releases/download/v3.10.0/BaiduPCS-Go-v3.10.0-linux-amd64.zip - 解压后首次运行：
./BaiduPCS-Go login，会打开浏览器授权；授权码粘贴回终端即可，token 存在~/.baidupcs-go/config.json - 下载单文件：
./BaiduPCS-Go d /我的资源/backup.tar.gz；同步整个目录：./BaiduPCS-Go sync -from /远程/目录 -to /本地/路径
rclone 配置百度云需手动填 refresh_token，且 v1.65+ 才支持
rclone 的优势是通用性强、能挂载为本地磁盘（rclone mount），但百度云 backend 配置比 Dropbox、OneDrive 复杂得多——它不提供 Web UI 配置向导，必须手动获取 refresh_token。
这个 token 不是网页登录后能看到的，得靠抓包或用第三方工具生成，且有效期长达数月，一旦配错就得重来。
- 确认
rclone版本 ≥ v1.65：rclone version；旧版不识别baidupcs类型 - 配置命令：
rclone config→ 选n新远程 → 名字填baidu→ 类型选baidupcs→ 接下来全留空，直到提示refresh_token - 获取
refresh_token最可靠方式：用baidupcs-go login登录后，从其config.json中复制refresh_token字段值 - 填完后测试：
rclone lsd baidu:；挂载前务必加--vfs-cache-mode writes，否则小文件读写极慢
真正麻烦的不是安装，是第一次把 token 对上。很多用户卡在「配置完成却报 invalid credentials」，其实只是 refresh_token 复制漏了最后几个字符，或混用了不同账号的 token。
