在服务器运维或开发过程中，我们经常需要远程管理文件，例如通过 SFTP、FTP、WebDAV、S3、NAS 等方式访问存储。传统工具通常需要安装客户端，例如 FileZilla、WinSCP 等。

如果希望 通过浏览器统一管理各种存储，可以使用 Filestash。

Filestash 是一个开源的 Web 文件管理器，支持多种存储协议，可以把各种存储统一在一个 Web 界面中进行管理。

---

## 一、Filestash 到底是什么？
Filestash 是个现代化的 Web 文件管理器，核心就是一句话：**用浏览器搞定所有文件管理需求**。

它支持的存储协议几乎覆盖了你能想到的所有场景：
- 服务器：SFTP、FTP
- 云存储：S3/MinIO、Google Drive、Dropbox
- 自建服务：WebDAV（Nextcloud、Alist、坚果云都能用）、Git、Samba（NAS）
- 本地文件：直接挂载服务器本地目录

而且不用装任何客户端，浏览器打开就能用，在线预览、拖拽上传、批量管理全搞定。

---

## 二、前置准备：Docker 环境一键搞定
部署 Filestash 之前，先把 Docker 环境搭好。这里给大家准备了适配全场景的一键安装脚本，Linux 系统直接用，国产系统（银河麒麟、欧拉）也支持。

### 1. Linux 系统 Docker 一键安装
#### 🧪 docker安装
直接一条命令，自动安装 Docker、Docker Compose：
```bash
bash <(wget -qO- https://xuanyuan.cloud/docker.sh)
```

### 2. Windows / Mac 用户
直接去 Docker 官网`https://www.docker.com/products/docker-desktop` 下载 Docker Desktop，安装启动即可，图形化操作很简单。

---

## 三、一键部署 Filestash
这里给大家分系统提供**一键启动命令**，复制粘贴就能运行，新手零门槛。

### 方式 1：Linux / macOS 系统（终端执行）
```bash
docker run -d \
--name filestash \
-p 8334:8334 \
--restart unless-stopped \
docker.xuanyuan.run/machines/filestash:latest
```

### 方式 2：Windows 系统（PowerShell 专用命令）
打开 **Windows PowerShell**（建议管理员权限运行），直接复制粘贴这条完整命令：
```powershell
docker run -d --name filestash -p 8334:8334 --restart unless-stopped docker.xuanyuan.run/machines/filestash:latest
```

### 方式 3：Docker Compose 部署（全系统通用，NAS 或长期使用推荐）
创建 `docker-compose.yml` 文件，写入以下内容：
```yaml
version: "3"

services:
  filestash:
    image: docker.xuanyuan.run/machines/filestash:latest
    container_name: filestash
    ports:
      - "8334:8334"
    restart: unless-stopped
```

然后在文件所在目录执行启动命令：
```bash
# Linux/macOS/PowerShell 通用
docker compose up -d
```

---

## 四、第一次访问与初始化
容器启动成功后，打开浏览器访问：
- 服务器部署：`http://你的服务器IP:8334`
- 本地部署：`http://localhost:8334`

首次进入会先让你设置一个管理员密码，设置完成就能进入主界面了。

![设置一个管理员密码](https://developer.qcloudimg.com/http-save/yehe-2813964/3c1f5a6e2188ea347ecdc67f3cded3e0.png)

---

## 五、核心玩法：连接你的各种存储
Filestash 本身不存文件，只是个“文件管理前端”，核心就是连接已有的存储系统。下面给大家演示几个最常用的场景。

### 场景 1：连接 Linux 服务器（SFTP）
选 SFTP 协议，填服务器信息：
- Hostname：你的服务器 IP 或域名
- Username：服务器登录用户名（比如 root）
- Password：服务器登录密码
- Port：默认 22，如果你改了 SSH 端口就填对应的

![连接 Linux 服务器（SFTP）](https://developer.qcloudimg.com/http-save/yehe-2813964/b7f4c7c21c67d7df7d8234ee3b051759.png)


填完点“连接”，直接就能在浏览器里管理服务器文件了，上传、下载、编辑、解压都支持。

![浏览器里管理服务器文件](https://developer.qcloudimg.com/http-save/yehe-2813964/9c873cdf33cfc098d39122c5c8262466.png)


### 场景 2：连接 WebDAV 服务（Nextcloud/Alist/坚果云）
WebDAV 支持很多自建和公共服务，比如 Alist、Nextcloud、坚果云，配置也很简单：
- 协议选 WebDAV
- URL：你的 WebDAV 地址，比如 `https://alist.example.com/dav`
- Username：WebDAV 用户名
- Password：WebDAV 密码

### 场景 3：连接 S3/MinIO 对象存储
不管是 AWS S3，还是自建的 MinIO，都能直接连：
- 协议选 S3
- Endpoint：对象存储的地址（比如 MinIO 就是 `http://你的MinIOIP:9000`）
- AccessKey/SecretKey：对象存储的密钥
- Bucket：要访问的桶名
- Region：根据你的存储填写（MinIO 可以随便填，比如 `us-east-1`）

### 场景 4：Windows 挂载本地目录（管理电脑硬盘文件）
如果想直接管理 Windows 本地磁盘（如 D 盘），在 PowerShell 执行这条命令：
```powershell
docker run -d --name filestash -p 8334:8334 -v D:\:/data --restart unless-stopped docker.xuanyuan.run/machines/filestash:latest
```
登录时选择 `LOCAL`，路径填写 `/data`，即可直接访问 Windows D 盘。

---

## 六、进阶配置：反向代理与后台设置
### 1. 用域名访问（Nginx 反向代理）
如果不想每次都输 IP+端口，可以用 Nginx 配置反向代理，用域名访问：
```nginx
server {
    listen 80;
    server_name filestash.example.com;  # 换成你的域名

    location / {
        proxy_pass http://127.0.0.1:8334;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}
```
配置完成后重载 Nginx，就能通过 `http://filestash.example.com` 访问了，还能后续配置 HTTPS 加密访问。

### 2. 管理员后台设置
访问 `http://你的地址:8334/admin` 就能进入后台，这里可以配置存储预设、用户权限、S3 模板等。

后台里还能看到运行状态，比如当前是以非 root 用户运行，以及版本信息、企业版升级提示等，生产环境建议配置 HTTPS 加密访问，避免明文传输数据。

---

## 七、总结：Filestash 适合谁用？
Filestash 不是万能的，但对很多人来说是“效率神器”：
- 运维/开发：统一管理多台服务器的文件，不用来回切换 SFTP 客户端
- NAS 用户：给家里的 NAS 搭个 Web 管理界面，在外网也能方便访问
- 多网盘用户：把 Alist、Nextcloud、坚果云都接进来，一个界面搞定所有云盘
- 轻量文件预览：给同事分享文件，直接发个链接，对方用浏览器就能看，不用装客户端

搭配 Alist、MinIO 这些工具，还能搭一个“多存储统一管理平台”，把所有文件都管起来。

在服务器运维或开发过程中，我们经常需要远程管理文件，例如通过 SFTP、FTP、WebDAV、S3、NAS 等方式访问存储。传统工具通常需要安装客户端，例如 FileZilla、WinSCP 等。

用 Docker 一键部署 Filestash：打造你的全能 Web 文件管理器

还在为不同存储协议装一堆客户端？SFTP、FTP、WebDAV、S3、云盘……每次都要切换工具，传个文件像“打地鼠”？今天给大家安利一个神器——Filestash，一个开源的 Web 文件管理器，把所有存储协议都收进浏览器里，用 Docker 几分钟就能搭好，运维、开发、日常用都超爽！

运维

后端

开发工具

Filestash是一款开源Web文件管理器，支持SFTP、FTP、S3、WebDAV等多种协议，无需安装客户端即可通过浏览器统一管理各类存储。提供Docker一键部署方案，支持Linux、Windows、Mac系统，包含管理员后台、反向代理等进阶功能，适合运维、开发及NAS用户实现跨平台文件管理。

对象存储

云存储

服务器

Windows

容器

Docker

Linux

2026采购季 | AI焕新·智启新局

4核4G3M云服务器 新用户低至38元/年！

domain

对象存储COS新用户低至1元！


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

用 Docker 一键部署 Filestash：打造你的全能 Web 文件管理器-腾讯云开发者社区-腾讯云

用 Docker 一键部署 Filestash：打造你的全能 Web 文件管理器

用 Docker 一键部署 Filestash：打造你的全能 Web 文件管理器

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐