> ## Content Index
> Fetch the complete content index at: https://sgpublic.xyz/llms.txt
> Use this file to discover other available public pages before exploring further.

# 基于 SFTPGo 的 WebDAV 部署
- URL: https://sgpublic.xyz/p/2026/11/6afc4c6fa02562000144c929/
- Published: 2026-11-17T12:59:02.000Z
- Updated: 2026-11-17T13:09:07.000Z
- Author: Haven Madray
- Tags: 运维

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

## 部署和初始化

WebDAV 服务端推荐使用 [SFTPGo](https://github.com/drakkan/sftpgo?ref=sgpublic.xyz)，可以从 Release 中下载适用于你系统架构的可执行，或者直接使用 docker 部署：

```yaml
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”添加虚拟目录：

![](https://sgpublic.xyz/content/images/2026/11/image-13.png)

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

![](https://sgpublic.xyz/content/images/2026/11/image-14.png)

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

![](https://sgpublic.xyz/content/images/2026/11/image-15.png)

填写用户名和密码。

![](https://sgpublic.xyz/content/images/2026/11/image-16.png)

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

![](https://sgpublic.xyz/content/images/2026/11/image-18.png)

最后点击“Save”。

## 访问

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

![](https://sgpublic.xyz/content/images/2026/11/image-19.png)

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

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