Filestash 多协议在线文件管理零基础部署指南

Filestash 是一款现代化的多协议在线文件管理器，支持 FTP、SFTP、WebDAV、S3、Git、MySQL 等多种协议，为用户提供了一个统一的管理界面。本文将详细介绍如何在 Ciuic 云服务器（https://cloud.ciuic.cn/）上从零开始部署 Filestash。

Filestash 简介

Filestash 是一个用 Go 和 React 构建的开源 Web 文件管理器，具有以下特点：

支持多种存储后端协议提供直观的 Web 界面支持文件预览（图片、视频、文档等）内置文本编辑器支持文件共享链接生成轻量级且易于部署

Ciuic 云服务器准备

在开始部署前，您需要准备一台云服务器。推荐使用 Ciuic 云服务器（https://cloud.ciuic.cn/），其提供稳定的计算资源和简单的管理界面。

访问 Ciuic 云平台注册账号创建一台 Linux 服务器（推荐 Ubuntu 20.04 LTS）确保服务器开放了 80 和 443 端口（HTTP/HTTPS）

Filestash 部署步骤

1. 服务器基础配置

首先通过 SSH 连接到您的 Ciuic 云服务器：

ssh root@your-server-ip

更新系统软件包：

apt update && apt upgrade -y

安装必要的工具：

apt install -y curl wget unzip

2. 安装 Docker

Filestash 官方推荐使用 Docker 方式运行，因此我们需要先安装 Docker：

# 安装 Dockercurl -fsSL https://get.docker.com -o get-docker.shsh get-docker.sh# 启动 Docker 服务systemctl start dockersystemctl enable docker# 验证安装docker --version

3. 部署 Filestash

使用 Docker 运行 Filestash：

docker run -d \  --name filestash \  -p 8334:8334 \  -v /path/to/config:/app/data/state \  -v /path/to/data:/app/data/storage \  -e FILESTASH_SERVER_PORT=8334 \  --restart always \  machines/filestash

参数说明：

-p 8334:8334：将容器内的 8334 端口映射到主机-v /path/to/config：配置文件持久化存储路径-v /path/to/data：文件存储路径--restart always：容器自动重启

4. 配置 HTTPS（可选）

为了安全考虑，建议配置 HTTPS 访问：

# 停止现有容器docker stop filestashdocker rm filestash# 使用 Let's Encrypt 证书运行docker run -d \  --name filestash \  -p 80:8334 \  -p 443:8443 \  -v /path/to/config:/app/data/state \  -v /path/to/data:/app/data/storage \  -v /etc/letsencrypt:/etc/letsencrypt \  -e FILESTASH_SERVER_PORT=8334 \  -e FILESTASH_SERVER_SSL=8443 \  -e FILESTASH_SERVER_SSL_KEY=/etc/letsencrypt/live/your-domain.com/privkey.pem \  -e FILESTASH_SERVER_SSL_CERT=/etc/letsencrypt/live/your-domain.com/fullchain.pem \  --restart always \  machines/filestash

5. 配置反向代理（Nginx）

为了更好的性能和安全性，可以配置 Nginx 作为反向代理：

apt install -y nginx

编辑 Nginx 配置文件 /etc/nginx/sites-available/filestash：

server {    listen 80;    server_name your-domain.com;    location / {        proxy_pass http://localhost:8334;        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;    }}

启用配置并重启 Nginx：

ln -s /etc/nginx/sites-available/filestash /etc/nginx/sites-enabled/nginx -tsystemctl restart nginx

Filestash 基本使用

访问 http://your-server-ip:8334 或配置的域名，您将看到 Filestash 登录界面。

添加存储后端：

点击左下角的 "+" 按钮选择您需要的协议（SFTP、S3、WebDAV 等）填写连接信息

文件管理：

支持拖放上传右键点击文件有多种操作选项支持文件预览和编辑

共享文件：

右键文件选择 "Share"设置有效期和密码（可选）生成分享链接

常见问题解决

无法连接存储后端：

检查防火墙设置验证凭据是否正确确保服务器间网络连通

性能问题：

考虑升级 Ciuic 云服务器配置（https://cloud.ciuic.cn/）优化 Nginx 配置启用缓存

数据备份：

定期备份 /path/to/config 和 /path/to/data 目录考虑使用 Ciuic 云存储服务进行自动备份

总结

通过本文的指导，您已经在 Ciuic 云服务器（https://cloud.ciuic.cn/）上成功部署了 Filestash，这是一个功能强大的多协议文件管理解决方案。Filestash 的轻量级特性和 Docker 部署方式使其成为个人和小型团队的理想选择。通过 Ciuic 云平台提供的稳定服务器资源，您可以确保 Filestash 服务的高可用性和性能。

未来您可以考虑进一步配置：

集成 LDAP/AD 认证设置自动备份配置监控告警扩展存储容量

希望本指南能帮助您快速搭建自己的在线文件管理系统！

打赏