基于 SFTPGo 的 WebDAV 部署

WebDAV 软件我个人不推荐使用 OpenList,因为 OpenList 的操作可见性有点问题,就是创建文件夹之后立马读取这个文件夹是否存在,可能返回不存在,然后调用方可能尝试重复创建,而这时候 OpenList 在创建文件夹的时候发现文件夹已经存在了,他不会报错,而是创建一个加了序号的文件夹,例如“新建文件夹(1)”这样,非常不优雅。

部署和初始化

WebDAV 服务端推荐使用 SFTPGo,可以从 Release 中下载适用于你系统架构的可执行,或者直接使用 docker 部署:

services:
  sftpgo:
    image: drakkan/sftpgo:latest
    restart: always
    ports:
      - 8080:8080
      - 10080:10080
    environment:
      SFTPGO_WEBDAVD__BINDINGS__0__PORT: "10080"
      SFTPGO_WEBDAVD__BINDINGS__0__PREFIX: "/"
      SFTPGO_SFTPD__BINDINGS__0__PORT: "0"
      SFTPGO_COMMON__UPLOAD_MODE: "1"
      SFTPGO_COMMON__TEMP_PATH: "/tmp/uploads"
    volumes:
      - ./config:/var/lib/sftpgo
      - ./data:/srv/sftpgo
      - /vol1/1000:/vol1
      - /var/cache/sftpgo:/tmp/uploads

以上参数的含义:

  • SFTPGO_WEBDAVD__BINDINGS__0__PORT:WebDAV 绑定端口
  • SFTPGO_WEBDAVD__BINDINGS__0__PREFIX:WebDAV 访问路径前缀
  • SFTPGO_SFTPD__BINDINGS__0__PORT:后台网页访问端口,“0” 表示保持默认
  • SFTPGO_COMMON__UPLOAD_MODE:上传模式,“1” 表示先上传到临时目录(也就是 SFTPGO_COMMON__TEMP_PATH 所指向的目录),上传完毕后再转移到目标目录,“0” 表示直接上传到目标目录。
  • SFTPGO_COMMON__TEMP_PATH:上传临时目录。

然后先访问 8080 端口,第一次启动会自动跳转初始化界面,要求设置管理员账号密码,设置之后这个密码适用于后台管理,而非客户端,也就是说这个账号密码只能用于登录:http://<ip>:8080/web/admin/ 前缀的网页。

创建虚拟文件夹和用户

虚拟文件夹的含义是给物理机目录做一个标签,然后可以按标签分配给用户。

首先点击“Virtual folders”,点击右侧“Add”添加虚拟目录:

名称可以随意填写,“Storage”选择“Local disk”,“Root directory”输入本地文件夹,最后点击保存。

回到首页的“User”创建客户端用户。

填写用户名和密码。

然后直接往下翻到最后“Virtual folders”,在第一个编辑框里输入访问路径,第二个框选择刚刚创建的虚拟文件夹。

最后点击“Save”。

访问

网页端访问 http://<ip>:8080/web/client,使用刚刚创建的用户的账号密码登录,即可看到刚刚允许访问的文件夹。

WebDAV 访问时,如果你使用我刚刚的 docker-compose 配置部署,则:

  • 服务器地址:http://<ip>:10080/
  • 用户名/密码:客户端用户的账号密码