117503445/go_webdav

GoWebdav

一个基于Golang实现的轻量级WebDAV服务器，旨在提供简单、高效的文件共享解决方案。通过单文件部署即可运行，无需依赖复杂环境，支持多目录独立配置及浏览器在线访问，适合个人或小型团队快速搭建文件共享服务。

核心功能与特性

• 高性能：基于Golang开发，处理效率高，资源占用低。
• 简化部署：编译为单文件可执行程序，无需Apache等额外环境，部署稳定。
• 浏览器支持：支持通过浏览器直接访问和管理文件。
• 多服务配置：可在同一端口下配置多个WebDAV服务，每个服务独立设置挂载目录、访问权限及读写权限。
• Docker友好：提供完善的Docker支持，支持通过环境变量快速配置，部署便捷。

使用场景与适用范围

适用于需要简单高效文件共享的场景，如：

• 个人文件远程访问与管理
• 小型团队内部文件共享服务
• 需多目录独立权限控制的文件服务
• 替代Samba（Windows客户端使用不便）、FTP（挂载复杂）或NextCloud（资源占用高）的轻量级方案

使用方法与配置说明

Docker快速部署

通过以下命令快速启动GoWebdav容器：

sh
docker rm go_webdav -f
docker rmi 117503445/go_webdav
docker run -it --name go_webdav -d \
  -v /root/dir1:/root/dir1 \
  -v /root/dir2:/root/dir2 \
  -e dav="/dav1,/root/dir1,user1,pass1,true;/dav2,/root/dir2,null,null,false" \
  -p 80:80 \
  --restart=always \
  117503445/go_webdav:latest

参数说明

• -v /root/dir1:/root/dir2: 挂载宿主机目录到容器内，需与配置中的挂载目录对应。
• -e dav="...": 配置WebDAV服务的核心环境变量，格式为多个服务配置用分号分隔。
• -p 80:80: 映射容器80端口到宿主机，用于访问WebDAV服务。
• --restart=always: 容器异常退出后自动重启。

配置字符串详解

环境变量dav的配置字符串格式为：服务1配置;服务2配置;...，每个服务配置包含5个参数，用逗号分隔：
[访问路径],[容器内挂载目录],[用户名],[密码],[是否只读]

参数说明

1. 访问路径：WebDAV服务的访问URL路径（如/dav1）。
2. 容器内挂载目录：需与-v挂载的容器目录一致（如/root/dir1）。
3. 用户名：访问认证用户名，null表示无需认证。
4. 密码：访问认证密码，null表示无需认证。
5. 是否只读：true表示只读（仅支持GET），false表示可读写（支持增删改查）。

示例解析

配置字符串：/dav1,/root/dir1,user1,pass1,true;/dav2,/root/dir2,null,null,false 表示两个服务：

• 服务1：路径/dav1，挂载容器目录/root/dir1，用户user1，密码pass1，只读模式。
• 服务2：路径/dav2，挂载容器目录/root/dir2，无需认证，可读写模式。

访问方式：浏览器访问http://localhost/dav1或http://localhost/dav2即可访问对应目录。

本地构建与调试

本地调试

1. 将config.yml.example重命名为config.yml并配置。
2. 按常规Golang项目运行（需本地安装Golang环境）。

本地Docker构建

sh
# 国外环境
docker build -t 117503445/go_webdav .

# 国内环境（使用goproxy.cn镜像加速）
docker build -t 117503445/go_webdav -f Dockerfile_cn .

# 运行本地构建镜像
docker run -it --name go_webdav -d \
  -e dav="/dav1,./TestDir1,user1,pass1;/dav2,./TestDir2,user2,pass2" \
  -p 80:80 \
  --restart=always \
  117503445/go_webdav:latest

安全性说明

• 认证方式：采用HTTP Basic Auth，账号密码明文传输，安全性较低。
• 建议：若配置了访问密码，务必通过Nginx等反向代理工具添加HTTPS加密，避免密码泄露。