# 客户端安装与配置

充分利用云盘提高效率，你需要看这一份新手教程~

# 客户端、挂载盘、移动端下载与配置

## 如何下载

客户端下载请点击右侧：[下载地址](https://box.nju.edu.cn/download_client_program/)

Windows、macOS、Linux、Android、iPhone/iPad、命令行平台均有对应客户端。

**注意，在以下步骤前，请务必登入一次[云盘网页端](https://box.nju.edu.cn)以激活。**

## 桌面端

### 登录云盘

PC客户端都大同小异，此处以Windows为例。安装完成后，在 **“云盘网址”** 输入`https://box.nju.edu.cn`，然后使用自己的 **统一身份认证** 即可登录~

![](https://doc.nju.edu.cn/uploads/images/gallery/2021-07/scaled-1680-/image-1625736919269.png)

在保证隐私安全的前提下，可以勾上 **“自动登录”** 。

### 设置同步资料库或文件夹

如果要同步资料库怎么办呢？

如果你是从云盘里**同步整个资料库**到本地：

![](https://doc.nju.edu.cn/uploads/images/gallery/2021-07/image-1625737166461.gif)

如果你只是想从云盘里**同步单个文件夹**，在云端文件浏览器内直接右键文件夹也有同步选项：

![](https://doc.nju.edu.cn/uploads/images/gallery/2021-07/scaled-1680-/image-1625737393921.png)

如果你是想把本地文件夹作为资料库同步到盘里：

![](https://doc.nju.edu.cn/uploads/images/gallery/2021-07/image-1625737244653.gif)

这里的加密大家要慎重，加密的文件受限较多而且加密不可取消。

你可以设置同步时间间隔，默认`0`意味着改动后立即同步：

![](https://doc.nju.edu.cn/uploads/images/gallery/2021-07/image-1625737295941.gif)

同步会保持云端与本地文件一致，也就是删了一边会导致另一边文件一块被删掉——除非解除同步：

![](https://doc.nju.edu.cn/uploads/images/gallery/2021-07/image-1625737316429.gif)

解除同步后，本地和云端都会保留一个文件夹，但是改动其中一边对另一边就不再影响了~

> PS. Linux 用户注意：虽然官网说只有 Fedora、Ubuntu、Debian、CentOS 客户端，但实际上 Arch Linux 也有社区维护版本，参见[官方文档-安装 Linux 客户端](https://help.seafile.com/syncing_client/install_linux_client/)。

## 挂载盘

## 移动端

### 安卓端

下载安卓端后，首先添加账户。在选择服务器时，务必选择 **其他Seafile服务器**~

![](https://doc.nju.edu.cn/uploads/images/gallery/2021-07/20210708175058.gif)

勾选 **“https”** 后，其他输入的与桌面端一致：

![](https://doc.nju.edu.cn/uploads/images/gallery/2021-07/20210708175109.gif)

进入后，你可以在设置打开手势密码、同步相册等功能~

![](https://doc.nju.edu.cn/uploads/images/gallery/2021-07/20210708175113.gif)

如果你想从手机上传文件，只需点开一个资料库，点击右上角可以手动添加。

![](https://doc.nju.edu.cn/uploads/images/gallery/2021-07/Gpf20210708175119.gif)

或者找到文件点击分享或发送，在目标应用里选到 **“Seafile”** 就OK啦~

![](https://doc.nju.edu.cn/uploads/images/gallery/2021-07/20210708175124.png)

### iOS/iPadOS端

苹果设备上登录步骤与上边安卓端大同小异，APP内使用基本也一样，请参看上文。

但不一样的是，得益于 iOS/iPadOS 的 **“文件”** 应用， **在安装iOS/iPad端后** ，你可以直接在其中如同访问本地文件夹一样访问文件。这时文件并不在你的设备上，只有当你点击他才会自动下载（有点像挂载盘），是不是很棒？

![](https://doc.nju.edu.cn/uploads/images/gallery/2021-07/20210708180054.gif)

> PS. 仅用“文件”内的“服务器”功能添加 WebDAV 目前是不支持的。

# 特别篇：Linux 图形与命令行客户端

## 同步客户端

### 安装
参考[官方文档](https://help.seafile.com/syncing_client/install_linux_client/)安装Linux同步客户端，我们的镜像站提供了客户端的[本地镜像](https://mirrors.nju.edu.cn/seafile/)。

- 同步客户端命令行界面：seaf-cli（[Linux命令行客户端手册](https://help.seafile.com/syncing_client/linux-cli/)）
- 同步客户端图形化界面：seafile-applet

### 命令行使用

1. 创建客户端本地数据目录（目录名可更改）
   ```sh
   mkdir ~/Seafile
   ```
2. 初始化客户端并指定本地数据目录（上一步创建的目录）
   ```sh
   seaf-cli init -d ~/Seafile
   ```
3. 启动客户端
   ```sh
   seaf-cli start
   ```
4. 列出云盘资料库ID（`<username>`替换为账号）
   ```sh
   seaf-cli list-remote -s https://box.nju.edu.cn -u <username>
   ```
5. 将本地目录与云盘资料库同步（`<library-id>`替换为上一步列出的某个资料库ID，`<folder>`替换为本地目录）
   ```sh
   seaf-cli sync -s https://box.nju.edu.cn -u <username> -l <library-id> -d <folder>
   ```
	将云盘资料库下载到本地目录
   ```sh
   seaf-cli download -s https://box.nju.edu.cn -u <username> -l <library-id> -d <folder>
   ```
6. 查看当前同步状态
   ```sh
   seaf-cli status
   ```
7. 解除本地目录同步
   ```sh
   seaf-cli desync -d <folder>
   ```
8. 停止客户端
   ```sh
   seaf-cli stop
   ```
   
## 挂载盘客户端

### 安装

参考[官方文档](https://help.seafile.com/drive_client/drive_client_for_linux/)安装Linux挂载盘客户端，我们的镜像站提供了客户端的[本地镜像](https://mirrors.nju.edu.cn/seafile/)。

- 挂载盘客户端命令行界面：seadrive（[Linux命令行挂载盘手册](https://help.seafile.com/drive_client/drive_client_for_linux/#running-seadrive-without-gui)）
- 挂载盘客户端图形化界面：seadrive-gui

### 命令行使用

1. 获取Token（`<username>`替换为账号，`<password>`替换为密码）
   ```sh
   curl -d 'username=<username>' -d 'password=<password>' https://box.nju.edu.cn/api2/auth-token/
   ```

2. 创建配置文件`~/seadrive.conf`，`<username>`替换为账号，`<token>`替换为上一步的返回值
   ```
   [account]
   server = https://box.nju.edu.cn
   username = <username>
   token = <token>
   is_pro = true
   [general]
   client_name = mypc
   [cache]
   size_limit = 10GB
   clean_cache_interval = 10
   ```
3. 启动挂载盘，命令在前台运行，新开一个窗口进行其它操作
   ```sh
   seadrive -c ~/seadrive.conf -f -d ~/.seadrive/data -l ~/.seadrive/data/logs/seadrive.log ~/SeaDrive
   ```
4. 如果报错 `Transport endpoint is not connected` ，执行：`fusermount -u ~/SeaDrive`
5. `~/SeaDrive` 目录就是云盘挂载在本地的目录，可以直接读写访问