FolderHost 私有云部署到 VPS 教程：文件管理、协作权限和长期运行建议

如果你在找一款轻量级自托管私有云，又不想折腾 Nextcloud 那套 PHP + 数据库的复杂环境，FolderHost 可能正对你的胃口。它把整个应用打包成一个可执行文件（Linux/Windows 下仅约 19MB），用 Docker 部署也只需要一行命令。配合一台便宜的 VPS，你就能搭出带文件管理、在线代码协作和用户权限控制的私有云盘。这篇文章会从 VPS 选型开始，一步步带你完成部署、配置反向代理、设置用户权限，最后聊聊长期运行必须注意的安全和备份问题。

为什么选 FolderHost 而不是 Nextcloud 或其他方案？

自托管私有云方案不少，但很多都绕不开 LAMP/LEMP 环境。Nextcloud 功能强大，但部署门槛高，对 VPS 资源要求也高——2GB 内存起步，跑起来还经常因为数据库慢而卡顿。FileBrowser 这类工具则太过简单，没有用户权限分级和协作能力。FolderHost 恰好卡在中间：

结论：如果你只需要一个团队文件共享+在线写代码的平台，不依赖 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 也不迟。记得设置好自动备份和防火墙，别等到数据丢了才后悔。