1. 为什么选择Docker Compose部署FileBrowser？

最近几年，个人数据存储需求呈现爆发式增长。我自己的手机相册就存了上万张照片，加上工作文档、影视资源，传统的移动硬盘已经难以满足需求。这时候，搭建一个轻量级的个人NAS（网络附加存储）就成了性价比极高的解决方案。

在众多NAS方案中，FileBrowser以其极简设计和易用性脱颖而出。它就像一个运行在浏览器里的"资源管理器"，支持文件预览、上传下载、在线编辑等基础功能。最让我心动的是，它不需要复杂的配置，特别适合技术小白入门。

传统部署方式需要手动安装依赖、配置环境变量，过程繁琐容易出错。而使用Docker Compose，所有服务配置都写在YAML文件里，真正实现了"一次编写，到处运行"。我实测从零开始部署，不到10分钟就能完成整套流程，这对想快速搭建个人文件服务器的用户来说简直是福音。

2. 环境准备与基础配置

2.1 硬件与系统要求

虽然FileBrowser对硬件要求极低，但合理规划能获得更好体验。我的测试环境是一台闲置的Intel NUC迷你主机（8GB内存/256GB SSD），跑Ubuntu 22.04系统。实际上，树莓派4B这种ARM设备也能流畅运行，功耗还不到5W。

关键是要确保：

• 系统已安装Docker Engine（版本≥20.10.0）
• 至少1GB可用存储空间
• 能通过路由器端口映射访问内网服务

如果还没装Docker，可以用这个命令快速安装：

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

2.2 目录结构规划

良好的文件组织能避免后期维护混乱。我推荐这样创建项目目录：

mkdir -p ~/nas/filebrowser/{data,config}
cd ~/nas/filebrowser

这里data将挂载为文件存储根目录，config保存应用配置。这种分离式设计方便后续迁移或备份。

3. Docker Compose深度配置

3.1 编写docker-compose.yml

下面是我优化过的配置文件，增加了数据持久化和安全设置：

version: '3.8'

services:
  filebrowser:
    image: filebrowser/filebrowser:latest
    container_name: fb-nas
    restart: unless-stopped
    environment:
      - FB_BASEURL=/files  # 自定义URL路径
      - FB_PORT=80
    volumes:
      - ./data:/srv
      - ./config/database.db:/database.db
      - ./config/.filebrowser.json:/.filebrowser.json
    ports:
      - "8080:80"
    networks:
      - nas-network

networks:
  nas-network:
    driver: bridge

关键参数说明：

• restart: unless-stopped确保服务意外退出后自动重启
• 网络隔离增强安全性
• 数据库和配置文件持久化存储

3.2 权限与安全加固

为防止权限问题，建议提前设置好目录权限：

chmod -R 775 ./data
chown -R 1000:1000 ./data

FileBrowser默认以UID 1000运行，这样配置能保证容器有写入权限。

4. 服务部署与日常运维

4.1 启动与初始化

执行以下命令启动服务：

docker compose up -d

首次启动会自动生成配置文件。查看日志确认运行状态：

docker logs -f fb-nas

访问http://你的IP:8080，用默认账号admin/admin登录后，强烈建议立即修改密码。我在管理界面发现可以设置用户配额、限制文件类型等实用功能。

4.2 常用运维命令

• 更新镜像：

  docker compose pull && docker compose up -d
  

• 备份配置：

  tar -czvf fb-backup-$(date +%Y%m%d).tar.gz ./config
  

• 查看资源占用：

  docker stats fb-nas
  

5. 高级功能扩展

5.1 集成外部存储

如果想挂载已有NAS存储，只需修改volumes配置：

volumes:
  - /mnt/nas/Media:/srv/Media
  - /mnt/nas/Backup:/srv/Backup

5.2 启用HTTPS加密

配合Nginx反向代理可以实现HTTPS：

server {
    listen 443 ssl;
    server_name nas.yourdomain.com;
    
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:8080;
    }
}

5.3 性能调优建议

对于大文件传输场景，可以调整这些参数：

environment:
  - FB_MAXIMUM_UPLOAD_SIZE=2048  # 最大上传2GB
  - FB_WORKERS=4  # 并发工作线程

6. 故障排查与优化

遇到服务无法启动时，我通常会按这个流程排查：

1. 检查端口冲突：ss -tulnp | grep 8080
2. 查看详细日志：docker compose logs --tail=100
3. 验证挂载点权限：docker exec -it fb-nas ls -l /srv

有个常见坑点是SELinux导致权限拒绝，临时解决方案是：

chcon -Rt svirt_sandbox_file_t ./data

7. 实际使用体验分享

稳定运行三个月后，我发现这些功能特别实用：

• 手机APP支持：浏览器访问就能直接播放存储的电影
• 分享链接：生成临时下载链接发给朋友
• 图片预览：自动生成缩略图，浏览相册超方便

最惊喜的是资源占用：同时服务5个用户，内存占用始终低于300MB。对于想低成本搭建个人云存储的用户，这个方案确实值得尝试。