Skip to content

🚀 使用 Docker Compose 部署 Flare 的完整教程 1

Flare是一款轻量、快速、美观的个人导航页面，特别适合用于HomeLab环境。它无数据库依赖，支持在线编辑，并内置了丰富的Material Design图标。下面介绍如何使用Docker Compose部署和配置Flare。

🔮 Flare简介与核心优势

Flare是一个专注于隐私和效率的个人导航工具，它能帮你集中管理常用的网站和应用。其核心优势包括： - 极速加载：相比其他导航页可能需要2-3秒的加载时间，Flare仅需约0.2秒即可完成加载。 - 本地搜索：支持高效的本地书签搜索功能。 - 批量导入：提供批量导入书签的功能，方便链接的编辑和管理。 - 无需数据库：所有数据通过YAML文件管理，结构透明且易于维护。 - 图标丰富：内置超过6000个Material Design图标。

⚙️ 部署前准备

在开始部署前，请确保你的系统满足以下要求： - 已安装Docker和Docker Compose。 - 确保端口7570未被占用（如被占用，可在配置中修改）。 - 准备约1GB的可用内存（根据配置的资源限制调整）。

建议为Flare创建一个独立的部署目录，例如：

mkdir -p /opt/docker/flare
cd /opt/docker/flare

🚀 编写Docker Compose配置

创建一个名为docker-compose.yml的文件，内容如下：

#version: '3.6'

services:
  flare:
    container_name: flare
    image: soulteary/flare
    restart: always
    ports:
      - "7570:5005" # 主机端口:容器端口，可按需修改主机端口
    volumes:
      - ./flare/app:/app # 将容器内的/app目录映射到当前目录下的flare/app目录
    # 可选：启用用户登录功能（默认无需登录即可访问）
    # command: flare --nologin=0
    # environment:
    #   - FLARE_USER=your_username # 自定义用户名
    #   - FLARE_PASS=your_password # 自定义密码
    deploy:
     resources:
       limits:
        #cpus: '5'
        #memory: 1G
        cpus: '0.5'  # 可根据需要调整CPU限制
        memory: 512M  # 可根据需要调整内存限制

关键配置说明： - 镜像选择：使用soulteary/flare:latest镜像，也可锁定特定版本以确保稳定性。 - 端口映射：7570:5005表示将容器内的5005端口映射到主机的7570端口。 - 数据持久化：通过volumes将容器内的/app目录映射到本地的./flare/app目录，确保配置和数据安全。 - 资源限制：deploy.resources.limits部分可设置CPU和内存使用上限，防止资源过度占用。

🔒 安全配置（可选但推荐）

如果计划将Flare公开到互联网，强烈建议启用登录认证。取消配置文件中以下行的注释并进行修改：

command: flare --nologin=0  # 启用登录模式
environment:
  - FLARE_USER=your_username  # 替换为你的用户名
  - FLARE_PASS=your_password  # 替换为你的密码

或者，你也可以通过环境变量FLARE_DISABLE_LOGIN来控制登录，例如设置 - FLARE_DISABLE_LOGIN=0 来启用登录。

🎯 启动与验证

  1. 启动服务 在docker-compose.yml文件所在目录执行： bash docker-compose up -d

  2. 检查状态 使用以下命令查看容器是否正常运行： bash docker ps 确认flare容器状态为"Up"。

  3. 访问验证 打开浏览器，访问 http://你的服务器IP:7570。如果页面正常加载，说明部署成功。

    首次访问时，如果未启用登录功能，你可以直接使用Flare。如果启用了登录功能，则需要通过访问 http://你的服务器IP:7570/editor 来登录并进行编辑。

🎨 配置Flare导航页

成功部署后，你可以通过以下方式个性化你的Flare导航页：

  1. 基础设置

    • 点击页面左下角的设置按钮（默认主题下颜色较浅，请仔细查找）。
    • 在设置界面中，你可以根据喜好调整主题颜色、背景、天气信息（需要设置位置）和问候语等。

  2. 添加应用和书签

    • 访问 http://你的服务器IP:7570/editor 进入在线编辑页面（如果启用了登录，需先输入用户名密码）。
    • Flare将内容分为 "应用" (拥有大图标的常用应用) 和 "书签" (支持分类功能) 两类。你可以在设置中启用或禁用这两类别的显示。
    • 你可以直接编辑、新增或删除应用和书签。编辑时，双击单元格即可修改，完成后务必点击"保存数据"按钮。

  3. 设置图标

    • Flare内置了丰富的Material Design图标。
    • 访问 http://你的服务器IP:7570/icons/ 可以浏览所有可用图标。
    • 点击心仪的图标，其名称会自动复制到剪贴板，然后将其粘贴到应用或书签的"icon"字段即可。使用图标时，无需添加mdi前缀，例如直接使用 HomeAssistant。

🔄 日常维护与管理

  • 更新Flare：只需拉取新镜像并重新启动容器。 bash docker-compose down docker-compose pull docker-compose up -d

  • 数据备份：定期备份./flare/app目录，其中包含了Flare的所有配置文件。

  • 服务管理：

  • 停止服务：docker-compose down
  • 查看日志：docker-compose logs

🐛 常见问题排查

问题现象 可能原因及解决方法
无法访问页面 检查防火墙/安全组是否开放了7570端口；确认容器是否正常运行 docker ps。
编辑后数据丢失 编辑后未点击"保存数据"按钮。请务必在编辑后保存。
图标不显示 检查图标名称是否正确，确保没有添加mdi前缀。
启用登录后无法登录 确认在docker-compose.yml中正确设置了FLARE_USER和FLARE_PASS环境变量，并且设置了 command: flare --nologin=0。

💎 进阶使用与优化

  • 与浏览器集成：为了获得最佳体验，可以考虑使用如 Custom New Tab URL 这类浏览器扩展，将浏览器的默认新标签页设置为你的Flare导航页。
  • 反向代理：若希望通过域名访问并配置HTTPS，可以考虑使用Nginx或Caddy等工具设置反向代理。

希望这篇教程能帮助你顺利部署并熟练使用Flare，享受高效、个性化的导航体验！如果你在部署过程中遇到任何问题，可以参考Flare的官方文档或在相关技术社区寻求帮助。