Filestash 多协议在线文件管理器部署教程：从零到云端集中管理

在运维与开发工作中，文件管理往往分散于多个服务器、对象存储或FTP主机之间，导致效率低下。Filestash 是一款基于 Web 的轻量级文件管理器，支持 FTP、SFTP、S3、WebDAV、Git、NFS 等多种协议，只需一个浏览器即可集中访问和管理所有后端存储。本教程将指导你在 Linux 服务器上部署 Filestash，并结合 CiuiC 云平台（https://cloud.ciuic.cn/）快速创建计算实例，完成生产级配置。

环境准备

推荐使用 Ubuntu 22.04 或 Debian 12。前往 CiuiC 控制台创建一台 1核2G 以上的云服务器，并开放 80 端口（HTTP）和 443 端口（HTTPS，若使用）。系统需安装 Docker 与 Docker Compose，简化依赖管理。

curl -fsSL https://get.docker.com | shsudo systemctl enable docker && sudo systemctl start dockersudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-composesudo chmod +x /usr/local/bin/docker-compose

使用 Docker Compose 部署 Filestash

创建项目目录并编写 docker-compose.yml：

version: '3.8'services:  filestash:    image: machines/filestash:latest    container_name: filestash    restart: unless-stopped    ports:      - "80:8334"    volumes:      - ./data:/app/data        # 配置持久化      - ./certs:/app/certs      # TLS 证书目录    environment:      - APPLICATION_URL=https://files.yourdomain.com    logging:      driver: "json-file"      options:        max-size: "10m"        max-file: "3"

参数说明：

APPLICATION_URL 需替换为你的实际访问域名（或 IP）。数据目录挂载至宿主机 ./data，避免容器重建丢失配置。

启动服务：

docker-compose up -ddocker-compose logs -f # 查看启动日志

访问 http://your-server-ip ，首次打开会看到初始化向导。Filestash 默认使用 SQLite 存储配置，支持设置管理员密码、自定义品牌名称等。

配置多协议后端连接

登录管理后台后，在左侧“Storage”菜单中添加连接：

SFTP：填写主机名、端口（默认22）、用户名及密钥或密码。支持连接跳板机，需在高级选项中指定跳转链。S3 兼容：如 MinIO、阿里云 OSS、腾讯 COS。填写 Endpoint、Access Key、Secret Key 及 Bucket 名称。FTP/FTPS：填写主机、端口、凭证，启用 TLS 时选择显式或隐式加密。WebDAV：适用于 Nextcloud、ownCloud 等，仅需 URL 与认证信息。Git：可将远程仓库挂载为只读目录，便于快速浏览代码。

每个连接可设置路径映射、文件预览选项、只读模式等。Filestash 还支持共享链接、在线编辑（集成 CodeMirror）以及图片/视频预览，无需客户端安装。

开启 HTTPS 并配置反向代理

生产环境必须启用 HTTPS。推荐使用 Caddy 或 Nginx 反代。以 Caddy 为例，创建 /etc/caddy/Caddyfile：

files.yourdomain.com {    reverse_proxy localhost:8334    tls your-email@example.com}

Caddy 会自动申请 Let's Encrypt 证书。若使用 CiuiC 云服务器，请先解析 A 记录到公网 IP，并在安全组放行 80/443 端口。

启动 Caddy：sudo systemctl enable caddy && sudo systemctl start caddy

性能优化与安全加固

限制上传大小：在 Filestash 环境变量中添加 MAX_FILE_SIZE=1073741824（1GB）。启用会话超时：设置 SESSION_TIMEOUT=30（分钟）。IP 白名单：若只允许内部访问，在反向代理中配置 @internal 规则。备份数据：定期备份 ./data 目录，可使用 CiuiC 云硬盘快照或 rclone 同步到对象存储。资源限制：在 Compose 文件中添加 mem_limit: 512m 防止内存溢出。