Docker 部署 Go-WebDAV 文件共享服务 🐳

📋 目录导航

🎯 项目简介

Go-WebDAV 是一个轻量级的 WebDAV 服务器实现，基于 Go 语言开发，具有高性能和低资源占用的特点。通过 Docker 部署，您可以快速搭建个人或团队的文件共享服务，支持标准的 WebDAV 协议，兼容各种客户端。

GitHub 地址: https://github.com/117503445/GoWebDAV

🛠️ 核心特性

特性类别 功能描述 优势
🌐 WebDAV 协议支持 支持标准 WebDAV 协议 兼容各种客户端，实现跨平台文件访问
⚡ 高性能 基于 Go 语言开发 资源占用低，响应速度快，适合资源受限环境
🔒 认证安全 支持基本认证和匿名访问 灵活的安全策略，保护文件安全
📁 多目录共享 支持同时共享多个目录 可按需设置不同目录的访问权限
👥 权限控制 可设置只读或读写权限 精细化的访问控制，防止误操作
🖥️ Web 界面 提供 Web 文件管理界面 无需客户端即可管理文件，方便快捷
🔄 跨平台 支持多种操作系统 Windows、macOS、Linux 全平台兼容
🐳 容器化部署 Docker 部署简单 环境隔离性好，部署和维护便捷

🐳 一、Docker 部署 Go-WebDAV

1. 创建部署目录和 docker-compose.yml 文件 📁

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
mkdir -p /mnt/mydisk/home/go-webdav && cd $_ && \
cat > docker-compose.yml <<'EOF'
services:
  go-webdav:
    container_name: go-webdav
    image: 117503445/go_webdav:latest
    restart: unless-stopped
    ports:
      - "8008:80"
    volumes:
      - /mnt:/data
    environment:
      - TZ=Asia/Shanghai
      - dav=/ARS2,/data/ARS2-NFS,admin,yifan0719,false;/Aliyun,/data/ARS2-NFS/阿里云盘,null,null,false;/NAS,/data/ARS2-NFS/NAS,admin,yifan0719,true
EOF

📁 目录映射说明: /mnt 等于容器内的 /data

🗂️ 共享目录配置格式: /网页显示名称,/容器内路径,用户名,密码,是否只读

🔐 安全提示: 建议使用强密码替代默认凭证

2. 拉取镜像并启动容器 🚀

1
docker-compose up -d

🚀 二、使用 Go-WebDAV

1. 访问 Web 界面 💻

2. 首次使用步骤 🎯

  1. 打开浏览器访问上述地址
  2. 根据需要访问不同共享目录：
    • /ARS2: 用户名 admin, 密码 yifan0719 (读写权限)
    • /Aliyun: 无需认证 (读写权限)
    • /NAS: 用户名 admin, 密码 yifan0719 (只读权限)
  3. 使用 Web 界面管理文件或配置客户端连接

🌐 三、Nginx 反向代理配置

访问地址示例：https://webdav.example.com

1. 创建 Nginx 配置文件 🔧

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
mkdir -p /etc/nginx/conf.d && \
cat > /etc/nginx/conf.d/go-webdav.conf <<'EOF'
server {
    listen 443 ssl;
    server_name webdav.example.com;   # 替换为你的域名

    # SSL 证书
    ssl_certificate /path/to/your/cert.pem;
    ssl_certificate_key /path/to/your/key.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-SHA384;
    ssl_prefer_server_ciphers off;

    # 文件大小限制
    client_max_body_size 0;

    # 安全头部
    add_header X-Frame-Options DENY;
    add_header X-Content-Type-Options nosniff;
    add_header X-XSS-Protection "1; mode=block";
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;

    location / {
        proxy_pass http://127.0.0.1:8008;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_buffering off;

        # WebSocket 支持
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        # 增加超时时间
        proxy_read_timeout 3600s;
        proxy_send_timeout 3600s;
        proxy_connect_timeout 300s;
    }

    # 错误页
    error_page 404 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
    }
}
EOF

2. 测试并重载 Nginx 🔄

1
sudo nginx -t && sudo systemctl reload nginx

🔧 四、容器维护命令

1. Docker Compose 命令 🐳

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# 进入项目目录（请替换为您的实际目录）
cd /mnt/mydisk/home/go-webdav

# 停止并删除容器
docker-compose down

# 拉取最新镜像
docker-compose pull

# 启动容器
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看服务日志
docker-compose logs

# 跟踪服务日志
docker-compose logs -f

# 完整升级流程
docker-compose down && \
docker-compose pull && \
docker-compose up -d && \
docker image prune -f

2. Docker 容器命令 📦

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# 查看所有容器名称
docker ps -a --format "{{.Names}}"

# 查看运行中容器
docker ps

# 停止/启动/重启容器（请替换 <container_name> 为实际容器名）
docker stop go-webdav      # 停止容器
docker start go-webdav     # 启动容器  
docker restart go-webdav   # 重启容器

# 删除容器
docker rm go-webdav        # 删除已停止容器
docker rm -f go-webdav     # 强制删除运行中容器

# 进入容器Shell
docker exec -it go-webdav sh      # 使用sh进入容器
docker exec -it go-webdav bash    # 使用bash进入容器

# 以root身份进入容器  
docker exec -u 0 -it go-webdav sh

# 在容器中执行命令
docker exec go-webdav ls -la

# 查看容器详情和资源使用
docker inspect go-webdav     # 查看详细配置
docker stats go-webdav       # 实时资源监控

## 容器日志管理
docker logs go-webdav           # 查看日志
docker logs -f go-webdav        # 实时跟踪日志
docker logs --tail 100 go-webdav  # 查看最后100行
docker logs -t go-webdav        # 带时间戳的日志

3. Docker 镜像管理 📀

1
2
3
4
docker images                  # 列出所有镜像
docker rmi <image_name:tag>    # 删除指定镜像（请替换为实际镜像名和标签）
docker image prune -f          # 清理悬空镜像
docker image prune -a -f       # 清理所有未使用镜像

🌟 启航文件共享，连接无限

通过本文档，你已经成功使用 Docker 部署了 Go-WebDAV 文件共享服务，并借助 Nginx 反向代理实现了安全便捷的远程访问。现在，你可以：

🌍 随时随地 访问和管理你的文件，无论是在家中、办公室还是旅途中
🔐 安全共享 通过精细的权限控制，安全地与团队成员或客户共享文件
📱 多端协同 支持各种 WebDAV 客户端，实现跨设备、跨平台的文件同步与协作
⚡ 高效稳定 享受轻量级架构带来的快速响应和稳定服务体验

文件是数字时代的记忆载体，高效的文件管理是现代工作和生活的基础。愿 Go-WebDAV 成为你可靠的数字文件管家，陪伴你整理每一个重要文档，分享每一份珍贵资料。

从现在开始，轻松管理，高效共享——构建你无缝连接的数字文件空间吧！🚀

📌 持续维护：建议定期更新 Docker 镜像以获取安全补丁和新功能
🐛 反馈与建议：使用中如有疑问或需求，可前往 GitHub Issues 提出

祝你文件管理得心应手，协作无间！🎉