下面给你一份可直接照做、一步一步成功部署的
👉 使用 Docker 部署 Filestash 文件管理器完整实现步骤
（适合个人云盘 / 内网文件管理 / 运维学习）。

一、Filestash 是什么？（先简单认识）

Filestash 是一个 Web 文件管理器，可通过浏览器访问多种存储后端：

  • 本地目录
  • FTP / SFTP
  • WebDAV
  • S3 / MinIO
  • Git / SMB / NFS（部分版本）

📌 常见用途：

  • 私有云文件管理
  • 运维文件中转
  • 内网 NAS Web 管理界面

二、部署前准备

1️⃣ 环境要求

  • Linux / macOS / Windows
  • 已安装 Docker（≥ 20.x）

检查 Docker：

docker -v

2️⃣ 端口规划（默认）

服务端口
Filestash Web8334

三、方式一：最简单部署（单容器 ⭐⭐⭐⭐⭐）

适合：快速体验 / 测试

1️⃣ 拉取 Filestash 镜像

docker pull machines/filestash

2️⃣ 启动容器

docker run -d \
  --name filestash \
  -p 8334:8334 \
  machines/filestash

3️⃣ 访问 Web 页面

浏览器打开：

http://服务器IP:8334

✅ 看到 Filestash 登录界面即成功

四、方式二：挂载本地目录（实际使用必选 ⭐⭐⭐⭐⭐）

让 Filestash 管理宿主机文件。

1️⃣ 创建宿主机目录

mkdir -p /data/filestash

2️⃣ 启动并挂载目录

docker run -d \
  --name filestash \
  -p 8334:8334 \
  -v /data/filestash:/data \
  machines/filestash

📌 /data 是容器内默认可访问路径

3️⃣ Web 中配置存储

  1. 打开 Filestash Web
  2. 选择 Local Storage
  3. 路径填写：
/data

五、方式三：Docker Compose（推荐生产使用 ⭐⭐⭐⭐⭐）

1️⃣ 创建目录结构

mkdir -p filestash/{data,config}
cd filestash

2️⃣ 编写 docker-compose.yml

version: "3.9"

services:
  filestash:
    image: machines/filestash
    container_name: filestash
    restart: unless-stopped
    ports:
      - "8334:8334"
    volumes:
      - ./data:/data
      - ./config:/app/data/state

📌 state 目录用于保存配置与用户信息

3️⃣ 启动

docker-compose up -d

4️⃣ 查看状态

docker-compose ps

六、Filestash 常见存储配置示例

1️⃣ 本地文件系统（最常用）

Type: Local
Path: /data

2️⃣ SFTP（运维常用）

Type: SFTP
Host: 192.168.1.100
Port: 22
User: root
Path: /var/www

3️⃣ MinIO / S3

Type: S3
Endpoint: http://minio:9000
Access Key: xxx
Secret Key: xxx
Bucket: data

七、权限 & 安全建议（很重要）

1️⃣ 宿主机权限问题

如果无法访问目录：

chown -R 1000:1000 /data/filestash
chmod -R 755 /data/filestash

2️⃣ 建议配置反向代理（Nginx）

server {
    listen 80;
    server_name files.example.com;

    location / {
        proxy_pass http://127.0.0.1:8334;
        proxy_set_header Host $host;
    }
}

3️⃣ 启用 HTTPS（强烈推荐）

👉 使用：

  • Nginx + Let’s Encrypt
  • 或 Traefik / Caddy

八、常见问题排查

❌ 访问不了 Web

docker logs filestash

确认：

  • 端口未被占用
  • 防火墙已放行 8334

❌ 本地目录看不到文件

  • 路径是否 /data
  • 目录是否有权限
  • volume 是否挂载成功
docker inspect filestash | grep Mounts -A 10

九、升级与维护

升级 Filestash

docker pull machines/filestash
docker stop filestash
docker rm filestash
docker-compose up -d

📌 数据不会丢（使用 volume）

十、适合你的典型部署方案推荐

场景推荐方式
快速体验单容器
私有云盘Docker Compose
公司内网Compose + Nginx
多用户HTTPS + 账号管理

十一、一句话总结（必记）

Filestash 是轻量级 Web 文件管理器，
用 Docker 一条命令即可部署，
通过 volume 管理宿主机或远程存储，
生产环境推荐 Docker Compose + HTTPS。