Docker搭建filebrowser

这份教程专门针对您的 GCP VPS（1G内存 / 30G硬盘）

---

🛠️ 第一步：环境与目录准备

在 /root 下创建一个独立的项目目录，可以确保文件结构清晰，且不与系统文件混淆。

1. 创建项目文件夹：

   mkdir -p /root/filebrowser/my-files
   cd /root/filebrowser
   

2. 预建数据库文件（核心安全步）： 必须手动创建一个空的数据库文件，否则 Docker 会把这个路径识别为“文件夹”，导致启动失败。

   touch filebrowser.db
   

3. 设置权限： 确保当前目录权限正确（虽然在 root 下，但预设一下更稳妥）。

   chmod 666 filebrowser.db
   

---

📝 第二步：编写 Docker Compose 配置文件

在 /root/filebrowser 目录下创建配置文件：

Bash

nano docker-compose.yml

请直接复制并粘贴以下完整内容：

version: '3'

services:
  filebrowser:
    image: filebrowser/filebrowser:latest
    container_name: filebrowser
    # 使用 root 权限运行，确保能读写挂载的硬盘空间
    user: 0:0 
    ports:
      - "8080:80"
    volumes:
      - ./my-files:/srv          # 您存放软件、文档、图片的实际路径
      - ./filebrowser.db:/database.sqlite # 存储用户信息和系统设置的数据库
    
    # 策略：除非手动停止，否则始终自动重启
    restart: unless-stopped
    
    # 针对 1G 内存 VPS 的性能优化（防止扫描大文件时撑爆内存）
    deploy:
      resources:
        limits:
          memory: 128M
          cpus: '0.5'

• 保存并退出： 按 Ctrl + O，回车，再按 Ctrl + X。

---

🚀 第三步：一键启动容器

在当前目录下执行：

docker compose up -d

---

🌐 第四步：关键的初始设置（保姆级避坑）

容器启动后，请立即登录网页端进行以下三项核心配置：

1. 登录与语言

• 地址： http://您的服务器IP:8080

• 初始账号： admin 密码： 输入以下命令会看到一行以随机生成的密码结尾

docker logs filebrowser

• 中文设置： 点击左侧 Settings -> Profile Settings -> Language 改为 zh-cn，点击 SAVE

2.记得修改密码