下面给你一份可直接照做、一步一步成功部署的
👉 使用 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 Web | 8334 |
三、方式一：最简单部署（单容器 ⭐⭐⭐⭐⭐）
适合：快速体验 / 测试
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 中配置存储
- 打开 Filestash Web
- 选择 Local Storage
- 路径填写：
/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。