如何在 VPS 上部署 FolderHost 私有云：文件管理、协作权限和自托管场景指南

为什么选择在 VPS 上部署 FolderHost 而非 Nextcloud？

自己搭私有云，很多人第一反应就是 Nextcloud。但如果你手里只有一台 1 核 1GB 的入门 VPS，装完 Nextcloud 就得跟资源较劲——PHP、MySQL、Redis 全堆上，内存直接吃掉一大半，再跑别的服务就吃力了。FolderHost 走的是完全相反的路线：单个可执行文件，19MB 大小，不用数据库，不依赖 PHP，开箱即跑。

FolderHost 把自己定位成“轻量级自托管文件管理平台”，没有花里胡哨的插件市场，也没有复杂的安全策略配置。功能集中在文件管理、用户权限和代码协作上，适合不想折腾环境的人。如果你想要一个快速可用的私有云，而不是动不动就得更新十几二十个插件的“全家桶”，FolderHost 是更实在的选择。

部署前的准备工作：VPS 配置与环境要求

在开始部署之前，先把 VPS 环境和基础工具搭好。

VPS 最低配置建议

• CPU：1 核（推荐 2 核，避免并发读写时卡顿）
• 内存：1GB（内存占用跟文件缓存和在线人数相关，单用户 512MB 都够，但留点余量更稳）
• 磁盘：10GB SSD（系统 + Docker 镜像 + 数据，要是存大文件建议至少 20GB）
• 系统：Ubuntu 24.04 LTS 或 Debian 12（推荐 Ubuntu，Docker 官方支持更好）

安装 Docker 和 Docker Compose

不管你是用哪家 VPS，SSH 连上去之后先更新系统，然后装 Docker。以下步骤按 Ubuntu 24.04 写，其他发行版换对应的包管理器就行。

sudo apt update && sudo apt upgrade -y
sudo apt install ca-certificates curl gnupg lsb-release -y
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y

装完执行 sudo docker --version 确认版本。Docker Compose 现在作为插件集成在 docker 里，用 docker compose 命令（注意没有短横线）。

防火墙和端口准备

FolderHost 默认管理端口是 5800，生产环境建议通过反向代理暴露 443 端口，原始端口只允许内网访问。先用防火墙放行需要的端口。

sudo ufw allow 22/tcp    # SSH（建议改成非默认端口后只允许指定 IP）
sudo ufw allow 80/tcp    # HTTP 反代理用
sudo ufw allow 443/tcp   # HTTPS
sudo ufw enable

关于 SSH 加固和防火墙更完整的配置，可以参考 Ubuntu 24.04 VPS 安全加固清单：SSH、UFW、Fail2ban、自动更新与 AI 辅助运维，里面详细讲了怎么防暴力破解。

域名解析

如果你打算用域名访问（推荐），提前把 A 记录指到 VPS 的 IP 上。直接用 IP 也能访问，但浏览器会报不安全，后面配 SSL 也方便。

使用 Docker Compose 部署 FolderHost

FolderHost 官方 Docker 镜像更新还算勤快，写本文时 latest 对应 v26.6.2（需人工核实版本号）。下面是一份可以直接用的 docker-compose.yml，放在你想放数据的目录里。

version: '3'
services:
  folderhost:
    image: mertjsx/folderhost:latest
    container_name: folderhost
    ports:
      - "5800:5800"
    volumes:
      - ./data:/app
    restart: unless-stopped

注意，./data 是宿主机的挂载目录，所有数据（配置文件、用户文件、数据库）都存在这里。如果你容器重启后找不到数据，90% 是挂载路径没写对。

保存后执行：

sudo docker compose up -d

第一次启动会自动拉取镜像，几秒钟后容器就起来了。执行 docker compose ps 看到状态为 Up 就说明成功了。现在用 http://你的VPS_IP:5800 就能访问管理界面。

默认管理员账号：admin，密码：123。这是官方默认值，首次登录后务必立即修改密码，否则任何人都能登上去翻你的文件。

初始化配置与多用户权限管理

容器启动后会在挂载目录下生成一个 config.yml 文件，FolderHost 的所有核心配置都在这里。修改完配置后需要重启容器才能生效。

关键配置项

• storage_limit：默认 10GB，改成 0 代表不限容量。注意这只是软件限制，实际磁盘满会导致容器写不进去。
• users：定义用户及其权限。支持多个用户，每个用户可以针对不同资源赋予读取、写入、上传、删除、下载等细粒度权限。
• recyclebinretention_days：回收站文件保留天数，默认 7 天。
• logautoclean_days：审计日志自动清理周期。

添加用户并分配权限

FolderHost 的权限粒度比想象中细：你可以让某个用户只能读一个文件夹，另一个用户能上传但没法删除，适合给不同角色分配不同目录权限。举个例子，开发团队里让测试人员只能上传日志，而管理员有全部权限。

具体做法是编辑 config.yml 中的 users 段，添加如下结构（注意缩进）：

users:
  - username: zhangsan
    password: hashed_password_here
    permissions:
      - resource: "/shared"
        actions: [read, write, upload]

密码需要是哈希值（参考官方文档或通过界面添加用户生成哈希）。如果你嫌手动编辑麻烦，也可以在 Web 界面里添加用户，但部分高级参数还是得改配置文件。

修改完执行 sudo docker compose restart folderhost。

文件管理与实时协作编辑

FolderHost 的文件管理界面做得比较简洁，左侧目录树，右侧文件列表。支持这些基本操作：

• 上传：支持大文件分块上传，单个文件大小受 VPS 磁盘和 Web 服务器限制。实测上传超过 2GB 的文件，只要磁盘够用，Nginx 不设限制，就没问题。
• 拖拽：可以把本地文件直接拖到浏览器窗口上传。
• 回收站：删除的文件先进回收站，可配置保留期限，防止手滑删错。
• 代码编辑：内置 Monaco Editor（就是 VS Code 网页版的内核），支持语法高亮、自动补全。最实用的功能是多人实时协作编辑——你和同事可以同时打开同一个文件，每个人的修改都会实时同步，类似 Google Docs 但只针对代码文件。

这个协作功能对小团队非常实用。比如运维改 Nginx 配置、前端调 CSS，几个人同时看着，谁改了哪里一目了然。不过要注意，目前不支持冲突合并，如果两个人同时改同一行，后保存的人会覆盖前面的。

如果你对更多自托管工具感兴趣，可以看看 在 Debian 云服务器上自托管 AI 编码助手：Claude Code 部署、安全与运维指南，里面讲了怎么在 VPS 上跑 AI 辅助编码服务，跟 FolderHost 的代码编辑器搭配起来用效果更好。

安全防护与公网暴露风险

FolderHost 默认没有 SSL，也没有身份验证次数限制，直接暴露 5800 端口到公网风险很大。生产环境必须配反向代理和防火墙。

配置反向代理（以 Caddy 为例）

Caddy 最大的好处是可以自动申请和续签 Let's Encrypt SSL 证书，配置极简。安装 Caddy 后，创建一个 Caddyfile：

your-domain.com {
    reverse_proxy localhost:5800
}

启动 Caddy，它会自动获取证书并代理流量。这时你的 FolderHost 就能通过 HTTPS 访问了，浏览器不会有安全警告。

防火墙只放必要的端口

sudo ufw deny 5800/tcp          # 禁止外网访问原始端口
sudo ufw allow https            # 只允许 HTTPS

如果你需要从内网管理，可以通过 SSH 隧道或 VPN 访问 5800 端口，不要直接暴露。

审计日志和密码策略

• 启用审计日志：config.yml 里 audit_log: true（默认已启用），所有文件操作、登录尝试都会被记录。日志文件体积会增长，记得设置自动清理。
• 修改默认 admin 用户名：不要用 admin，改成不容易被猜到的新名字。
• 目前 FolderHost 原生不支持两步验证（2FA），如果有更高的安全要求，可以自己用 Nginx 的 auth_request 模块在前面挂一个认证层，或者暂时放弃 FolderHost，换 Nextcloud。这是需要你根据实际风险做取舍的部分。

备份与恢复策略

FolderHost 的所有数据都在你挂载的那个目录里，包括 config.yml、sqlite 数据库文件（内置的）以及用户上传的文件。备份这个目录就等于备份了整个服务。

推荐备份方案

用 crontab 加 rsync 或 rclone，每天打包并同步到另一个存储（比如另一台 VPS 或对象存储）。

#!/bin/bash
BACKUP_DIR="/backups"
mkdir -p $BACKUP_DIR
tar -czf $BACKUP_DIR/folderhost-$(date +%Y%m%d).tar.gz -C /path/to/folderhost/data .
## 然后上传到远程（假设用 rclone）
rclone copy $BACKUP_DIR remote:folderhost-backups
## 保留最近 7 天
find $BACKUP_DIR -name "*.tar.gz" -mtime +7 -delete

把脚本加到 crontab 里，每天凌晨执行一次。恢复就更简单：停掉容器，清空挂载目录，解压备份文件进去，重启容器。

需要注意

默认存储限制 10GB，如果你调大了限制或者存了大量文件，备份文件也会变大。建议在备份脚本里加磁盘空间检查，避免写满导致备份失败。

适用场景与局限性

FolderHost 不是万能的，搞清楚它适合什么、不适合什么，才能选对工具。

适合的场景

• 个人私有云：存文档、照片、代码，自己访问。低配 VPS 就能跑，预算有限的首选。
• 小团队文件共享和协作：三五个人共享文件、实时编辑代码，比用微信传文件靠谱。
• 家庭 NAS 轻替代：不想花几千块买 NAS，用一台旧电脑装 Linux 或者便宜的 VPS 跑 FolderHost，配合电视盒子能访问。
• 开发测试环境：临时需要文件共享服务，几分钟部署完，用完直接删容器，不留痕迹。

局限性

• 没有移动端 App：官方明确说“不是为移动设备设计的”。你在手机上用浏览器打开界面很别扭，按钮小、布局变形。如果必须在手机或平板上频繁访问，建议配一个第三方 Web 移动端适配插件，或者干脆选 Nextcloud。
• 搜索功能弱：只能搜文件名，不能搜文件内容。如果你需要全文检索文档内容（比如 PDF、Word），FolderHost 帮不上忙。
• 零扩展性：没有插件系统，功能就这些，别指望以后加日历、联系人、笔记之类。
• 单机部署：不支持集群或跨地域同步，高可用得自己用 rsync 组。

和 Nextcloud / Seafile 怎么选？

一句话总结：想要简单省资源，选 FolderHost；想要功能全面且愿意花时间和金钱维护，选 Nextcloud；只追求文件同步速度和稳定性，选 Seafile。

总结与行动建议

从选 VPS 到部署 FolderHost，整个流程半小时内就能跑完。如果你手里正好有一台吃灰的低配 VPS，花个十几分钟装起来，比每个月给百度网盘续费来得踏实。

这里再理一遍完整流程：

1. 准备一台 1 核 1GB 以上的 VPS，安装 Ubuntu 24.04。
2. 安装 Docker + Docker Compose。
3. 配置防火墙，放行 80 和 443。
4. 编写 docker-compose.yml，启动容器。
5. 登录后改默认密码，配置 config.yml，添加用户和权限。
6. 用 Caddy 或 Nginx 配置反向代理 + SSL，关闭原始端口。
7. 设置定时备份脚本。

如果你还没有 VPS，可以看看 2026 海外 VPS 主机推荐：6 款价格低、性能稳的高性价比选择（完整选购指南），里面推荐的入门套餐完全够跑 FolderHost。

行动建议：先在你的 VPS 上照着本文步骤部署一遍，体验一下 FolderHost 的轻快。之后思考自己真实需求：如果只用文件管理，它足够了；如果需要更多功能，再考虑升级到 Nextcloud。不管选哪个，自托管的掌控感永远比第三方服务更让人放心。