跳到主要内容

FileBrowser

官方网站​

FileBrowser 是一个基于 Web 的文件管理器，它允许你通过简单的 Web 界面管理服务器上的文件。

Docker方式安装​

FileBrowser 可以轻松地通过 Docker 容器进行部署。以下是详细的安装和配置步骤。

compose文件​

创建一个 compose.yml 文件，内容如下：

networks:
  default:
    external: true
    name: ${DOCKER_MY_NETWORK}
services:
  filebrowser:
    image: filebrowser/filebrowser:latest
    container_name: filebrowser
    user: "${UID}:${GID}"
    ports:
      - "8080:80"
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - /etc/timezone:/etc/timezone:ro
      - ${DOCKER_HOME}/filebrowser/srv:/srv
      - ${DOCKER_HOME}/filebrowser/database:/database
      - ${DOCKER_HOME}/filebrowser/config:/config
      - ${DOCKER_HOME}/filebrowser/branding:/branding
    restart: unless-stopped
    networks:
      default:
        ipv4_address: 172.20.0.10
    deploy:
      resources:
        limits:
          cpus: "0.3"
          memory: 200M

env文件​

创建一个 .env 文件来定义环境变量：

UID=1000
GID=1000
DOCKER_HOME=/home/username/docker
DOCKER_MY_NETWORK=npm_default

这里的 UID 和 GID 应替换为你实际的用户 ID 和组 ID，可以通过 id 命令查看。

启动​

使用以下命令启动 FileBrowser 容器：

docker compose up -d

启动后，你可以通过访问 http://your-server-ip:8080 来打开 FileBrowser 界面。默认登录信息：

  • 用户名: admin
  • 密码: admin

建议首次登录后立即修改默认密码。

配置文件​

FileBrowser 使用 JSON 格式的配置文件。在首次启动后，会在 ${DOCKER_HOME}/filebrowser/config 目录下生成以下文件：

  • settings.json: 主要配置文件

会在 ${DOCKER_HOME}/filebrowser/database 目录下生成以下文件：

  • filebrowser.db: 数据库文件，包含用户信息和设置

你可以修改 settings.json 文件来自定义 FileBrowser：

{
  "port": 80,
  "baseURL": "",
  "address": "",
  "log": "stdout",
  "root": "/srv",
  "allowCommands": true,
  "allowEdit": true,
  "allowNew": true,
  "commands": []
}

修改配置文件后，需要重新启动容器以使更改生效。

备注​

  1. 安全提示：

    • 建议设置强密码
    • 考虑使用反向代理（如 Nginx）并启用 HTTPS
    • 根据需要限制用户权限

  2. 用户管理：

    • 可以通过 Web 界面创建多个用户
    • 每个用户可以设置不同的权限和访问目录

  3. 常见问题：

    • 如果遇到权限问题，确保容器的用户 ID 和组 ID 配置正确
    • 文件上传大小限制可以在设置中调整
最后于 更新