🚀 使用 Docker Compose 部署 Flare 的完整教程
该教程基于下面提供的
docker-compose.yml配置文件，演示如何快速将 Flare 部署到本地或服务器。参考配置文件：[1]
1️⃣ 前置准备
| 步骤 | 操作 | 说明 |
|---|---|---|
| 1 | 安装 Docker | 若尚未安装，请先参考官方文档：https://docs.docker.com/get-docker/ |
| 2 | 安装 Docker Compose | 对 Docker Desktop 用户已内置；若使用 Linux，请执行：https://docs.docker.com/compose/install/ |
| 3 | 创建项目目录 | mkdir flare && cd flare |
| 4 | 复制配置文件 | 将上方 docker-compose.yml 拷贝至该目录下 |
⚠️ Tip：如果你想自定义
flare/app目录（例如放置自定义脚本、配置文件等），请先确保该目录存在并且权限可写。
2️⃣ 关键配置说明
#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
| 选项 | 说明 | 备注 |
|---|---|---|
image |
使用官方 Flare 镜像 soulteary/flare |
自动拉取最新版 |
restart: always |
容器异常退出时自动重启 | 适合生产环境 |
ports |
主机 7570 端口映射到容器 5005 端口 | 访问地址：http://<宿主机IP>:7570 |
volumes |
挂载本地 flare/app 目录到容器 /app |
用于持久化配置或脚本 |
command |
取消 --nologin 开关，实现登录 |
需要同时设置 FLARE_USER、FLARE_PASS |
environment |
环境变量 | 仅在开启登录功能时使用 |
deploy.resources.limits |
CPU 与内存限制 | 生产环境可根据硬件调整 |
🔧 自定义登录
若你需要保护 Flare 前端，可取消注释command与environment两行，填入自己的用户名和密码后重启即可。
3️⃣ 启动与管理
# 1. 拉取镜像并启动
docker compose up -d
# 2. 查看运行状态
docker compose ps
# 或
docker ps --filter "name=flare"
# 3. 查看实时日志
docker compose logs -f flare
# 4. 停止服务
docker compose down
# 5. 重启服务
docker compose restart flare
⚙️ 自动更新
若想让 Flare 自动拉取最新镜像，可在docker-compose.yml的image旁边添加image: soulteary/flare:latest并在更新后执行docker compose pull && docker compose up -d --force-recreate。
4️⃣ 访问与使用
- 浏览器访问
打开http://<宿主机IP>:7570即可看到 Flare 页面。 - 登录（如已开启）
使用你在FLARE_USER与FLARE_PASS中设置的账号密码登录。 - 自定义配置
任何放在flare/app目录下的文件都会被挂载到容器/app，可根据 Flare 官方文档自行修改。
5️⃣ 常见问题排查
| 问题 | 解决方案 |
|---|---|
| 端口被占用 | 更改 ports 配置中的主机端口或停止占用进程 |
| 权限错误 | 确认 flare/app 目录属主与权限为可写 |
| 容器未启动 | 查看日志 docker compose logs flare，检查镜像拉取是否成功 |
| CPU/内存不足 | 调整 deploy.resources.limits，或在宿主机升级硬件 |
6️⃣ 小结
- 使用
docker-compose.yml只需几条命令即可完成 Flare 的部署、管理与更新。 - 配置灵活，可通过挂载目录、环境变量、以及自定义命令实现各种需求。
- 通过 Docker 的高可维护性，后期升级与备份均变得极为方便。
祝你部署愉快 🚀！如果还有其他需求或遇到问题，随时告诉我。