FolderHost 私有云部署到 VPS 教程：文件管理、协作权限和长期运行建议
如果你在找一款轻量级自托管私有云，又不想折腾 Nextcloud 那套 PHP + 数据库的复杂环境，FolderHost 可能正对你的胃口。它把整个应用打包成一个可执行文件（Linux/Windows 下仅约 19MB），用 Docker 部署也只需要一行命令。配合一台便宜的 VPS，你就能搭出带文件管理、在线代码协作和用户权限控制的私有云盘。这篇文章会从 VPS 选型开始，一步步带你完成部署、配置反向代理、设置用户权限，最后聊聊长期运行必须注意的安全和备份问题。
为什么选 FolderHost 而不是 Nextcloud 或其他方案？
自托管私有云方案不少，但很多都绕不开 LAMP/LEMP 环境。Nextcloud 功能强大，但部署门槛高，对 VPS 资源要求也高——2GB 内存起步，跑起来还经常因为数据库慢而卡顿。FileBrowser 这类工具则太过简单，没有用户权限分级和协作能力。FolderHost 恰好卡在中间：
| 特性 | FolderHost | Nextcloud | FileBrowser |
|---|---|---|---|
| 部署难度 | 单二进制 / Docker，无依赖 | 需要 PHP、MySQL/PostgreSQL、Redis | 单二进制或 Docker，简单 |
| 资源占用 | 极低，512MB VPS 即可 | 至少 2GB 内存 | 极低 |
| 用户权限 | 细粒度（读、上传、删除、下载） | 强大组权限 | 只有简单密码 |
| 实时协作编辑 | 内置 Monaco Editor，支持多人同时编辑代码 | 需额外安装插件 | 不支持 |
| 回收站与审计 | 有回收站 + 审计日志 | 有 | 无 |
| 移动端适配 | 无（响应式较差） | 有官方 App | 一般 |
| 扩展性 | 有限，主要通过 config.yml | App Store 插件丰富 | 无 |
结论：如果你只需要一个团队文件共享+在线写代码的平台，不依赖 App 生态，FolderHost 是最轻量的选择。
部署前的 VPS 配置建议
最低配置要求
- CPU：1 核心
- 内存：512MB（单人测试）到 1GB（小团队 3-5 人）
- 存储：10GB 以上（默认存储限制 10GB，可在配置中调整）
- 系统：Ubuntu 22.04 / 24.04 LTS 或 Debian 12
- Docker：建议安装 Docker Engine 24+ 和 Docker Compose v2
网络与域名准备
部署后需要通过浏览器访问，建议提前准备一个域名（比如 cloud.yourdomain.com），并做好 DNS 指向。如果你的 VPS 有 IPv4 公网 IP，直接配置反向代理即可；如果只有 IPv6，需要额外处理。
选择哪家 VPS？
FolderHost 对硬件要求很低，所以不用买太贵的。一台年付几十美元的入门级 VPS 就够用。比如 RackNerd 的年付套餐，1 核 1G 的配置约 $20-30/年，跑 FolderHost 还能同时放几个小网站。不过要注意避开没有 SSD 的老款套餐，因为文件存储需要稳定的 IO 性能。
使用 Docker Compose 部署 FolderHost 到 VPS
下面以 Ubuntu 24.04 为例，从零开始部署。
第一步：安装 Docker 和 Docker Compose“`bash
更新包管理器
sudo apt update && sudo apt upgrade -y
安装 Docker（官方脚本）
curl -fsSL https://get.docker.com | sh
将当前用户加入 docker 组（避免每次 sudo）
sudo usermod -aG docker $USER
注销重新登录生效
验证
sudo systemctl enable docker docker –version
### 第二步：创建项目目录和 compose 文件```bash
mkdir -p ~/folderhost && cd ~/folderhost
cat <<EOF > docker-compose.yml
services:
folderhost:
image: mertjsx/folderhost:latest
container_name: folderhost
ports:
- "8090:8090"
volumes:
- ./data:/app
environment:
- TZ=Asia/Shanghai
restart: unless-stopped
EOF注意：默认端口是 8090。你可以改成其他端口，记得修改防火墙规则。
第三步：启动并验证“`bash
docker compose up -d docker compose logs -f
看到类似 `Listening on port 8090` 的日志说明启动成功。打开浏览器访问 `http://你的VPS_IP:8090`，默认账号密码是 `admin / 123`（首次登录后务必修改！）。
### 第四步：修改默认密码与初步配置
登录后点击右上角设置 → 修改密码。然后编辑 `~/folderhost/data/config.yml` 文件，可以调整存储限制、会话超时等参数。修改后需要重启容器：```bash
docker compose restart配置反向代理与 HTTPS（Nginx）
直接暴露 8090 端口既不安全也不好记。建议使用 Nginx 反向代理并启用 HTTPS。
安装 Nginx 并配置站点“`bash
sudo apt install nginx -y sudo nano /etc/nginx/sites-available/folderhost
写入以下配置（替换 your_domain.com 和服务器 IP）：```nginx
server {
listen 80;
server_name cloud.yourdomain.com;
location / {
proxy_pass http://127.0.0.1:8090;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
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;
}
}然后启用站点并测试：“`bash sudo ln -s /etc/nginx/sites-available/folderhost /etc/nginx/sites-enabled/ sudo nginx -t sudo systemctl reload nginx
### 申请 Let's Encrypt 证书并启用 HTTPS```bash
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d cloud.yourdomain.com按提示完成，证书会自动续期。之后只能通过 HTTPS 访问。
用户权限与文件管理设置
FolderHost 的用户系统支持创建多个账号，并分别设置文件权限。
创建新用户
管理员登录 → 设置 → 用户管理 → 添加用户。支持设置：
- 用户名、密码
- 磁盘配额（默认继承全局限制）
- 权限：读取、上传、下载、删除、移动/复制、分享
你可以为不同成员分配不同权限。例如给只读用户只勾选“读取”，给编辑者加上“上传”和“删除”。
回收站与审计日志
- 回收站默认开启，可在 config.yml 中调整存储上限（例如
trash: { max_size: 5GB }） - 审计日志记录所有操作（登录、文件上传、删除等），支持自动清理（按天数或数量）
调整全局存储限制
打开 ~/folderhost/data/config.yml，找到 storage: { max_size: 10GB } 修改你需要的值（例如 100GB），然后重启容器。注意实际物理磁盘要够大。
长期运行注意事项
1. 数据备份
数据都在 ~/folderhost/data 目录下，包括配置文件、用户文件和数据库（SQLite）。建议写个 cron 定时备份：“`bash 0 3 * tar -czf /backup/folderhost-$(date +\%Y\%m\%d).tar.gz ~/folderhost/data
备份文件可以 rsync 到另外的机器或对象存储。SQLite 不支持热备，备份前需要停止容器：`docker stop folderhost && tar ... && docker start folderhost`。或者用更智能的脚本。
### 2. 升级更新```bash
cd ~/folderhost
docker compose pull
docker compose up -d更新前建议先备份数据。偶尔会出现 config.yml 格式变化，升级后检查日志。
3. 安全加固
- 修改默认 SSH 端口，禁止密码登录（仅密钥）
- 用 UFW 只开放 80、443 和 SSH 端口
- 安装 fail2ban 防止暴力破解
- 定期查看
docker logs和审计日志
4. 监控与报警
如果你已经在 VPS 上跑了 Docker 仪表盘，比如 Labby，可以顺便监控 FolderHost 容器的资源占用和运行状态。一旦容器停止或内存异常能及时发现。
5. 合理规划存储
默认 10GB 限制对于小团队个人文档够用，但如果你准备放大量照片或视频，建议挂载外部存储（比如 NFS 或云盘）。config.yml 中可以修改数据目录为 /mnt/storage 之类的路径，但注意权限要一致。
FolderHost 的局限性
- 无移动端适配：手机浏览器访问效果很差，没有官方 App。你需要接受这一点。
- 不支持 office 文档预览：主要面向代码文件（文本），不能预览 Word/PDF。需要扩展可以加 Collabora，但会破坏轻量特性。
- 实时协作只针对代码：Monaco Editor 不是 Google Docs 那种富文本编辑器，适合开发团队。
- 单机瓶颈：没有分布式存储，文件全部在 VPS 本地。如果磁盘坏了数据就丢了，所以备份必须做。
常见问题 FAQ
Q：如何修改 FolderHost 的监听端口？ A：在 docker-compose.yml 中修改 ports 的左侧映射端口，比如 "9090:8090"。然后重新 docker compose up -d。记得防火墙放行新端口。
Q：为什么上传大文件失败？ A：默认可能有文件大小限制。检查 Nginx 的 clientmaxbodysize 设置，在 /etc/nginx/nginx.conf 的 http 块中增加 clientmaxbodysize 200M; 然后重启 Nginx。同时 Dashboard 中也可能有超时限制，可在 config.yml 中调整。
Q：能否在 Docker 外直接运行二进制文件？ A：可以。下载 Linux amd64 二进制，chmod +x 然后直接运行（占用 8090 端口）。不过 Docker 方式更方便管理。
Q：用户删除的文件能找回吗？ A：可以。回收站保留已删除文件，管理员可还原。回收站存储上限可在配置中修改。
Q：是否支持 LDAP / OAuth 集成？ A：目前不支持。用户管理仅限内置账号。
总结：谁适合用 FolderHost？
- 开发小团队：需要一个轻量的代码文件共享和在线编辑器，不需要复杂的 CRM/项目管理。
- 个人 Geek：折腾 VPS 的家庭实验室，想替代网盘又觉得 Nextcloud 太臃肿。
- 临时文件中转：比如几个朋友之间分享文件，FolderHost 安装快、用完即弃。
不推荐给：需要手机 App 全家桶、需要 Office 文档在线编辑、或者团队大于 10 人需要复杂权限结构的用户。
行动建议：先买一台便宜的 VPS（比如前面提到的 RackNerd 年付套餐），跟着本文步骤部署。跑起来后用一周感受一下，如果觉得缺功能再迁移到 Nextcloud 也不迟。记得设置好自动备份和防火墙，别等到数据丢了才后悔。
原创文章，作者：兆润，如若转载，请注明出处：https://vpscn2gia.com/folderhost-private-cloud-vps-deployment-guide/
