LogForge项目Docker Compose部署指南

LogForge是一个日志管理与分析平台，通过Docker Compose可以快速部署其完整服务栈。本文将深入解析项目的docker-compose.yml配置文件，帮助开发者理解各服务组件及其配置要点。

服务架构概述

LogForge采用微服务架构设计，主要包含以下四个核心服务：

1. 后端服务(logforge-backend)：提供核心API功能
2. 前端服务(logforge-frontend)：用户交互界面
3. 通知服务(logforge-notifier)：处理通知相关功能
4. 自动更新服务(logforge-autoupdate)：管理服务自动更新

网络配置

networks:
  logforge-network:
    driver: bridge

所有服务都连接到一个名为logforge-network的桥接网络，这使得各容器间可以通过服务名称相互通信，同时保持与外部网络的隔离。

核心服务详解

1. 后端服务(logforge-backend)

logforge-backend:
  image: madanb13/logforge-backend:latest
  environment:
    PORT: "${BACKEND_SERVICE_PORT:-8000}"
    NOTIFIER_SERVICE_CONTAINER_NAME: "${NOTIFIER_SERVICE_CONTAINER_NAME:-logforge-notifier}"
    NOTIFIER_PLAIN_PORT: "${NOTIFIER_PLAIN_PORT:-8083}"
  volumes:
    - /var/run/docker.sock:/var/run/docker.sock
    - logforge_core_data:/app/app/core/data

关键配置说明：

• 默认监听8000端口，可通过环境变量覆盖
• 挂载Docker套接字，使服务能与宿主机Docker引擎交互
• 使用命名卷logforge_core_data持久化核心数据
• 配置了通知服务的连接信息

2. 前端服务(logforge-frontend)

logforge-frontend:
  image: madanb13/logforge-frontend:latest
  environment:
    VITE_BACKEND_SERVICE_HOST: "http://${BACKEND_SERVICE_CONTAINER_NAME:-logforge-backend}"
    VITE_BACKEND_SERVICE_PORT: "${BACKEND_SERVICE_PORT:-8000}"
  depends_on:
    - logforge-backend

关键配置说明：

• 使用Vite构建工具
• 通过环境变量配置后端API地址
• 显式声明依赖后端服务，确保启动顺序
• 默认暴露3000端口

3. 通知服务(logforge-notifier)

logforge-notifier:
  image: madanb13/logforge-notifier:latest
  ports:
    - "${NOTIFIER_PLAIN_PORT:-8083}:8083"
    - "${NOTIFIER_WEB_PORT:-8085}:8085"
  volumes:
    - logforge_notifier_data:/app/data
    - /etc/localtime:/etc/localtime:ro

关键配置说明：

• 暴露两个端口：8083(普通端口)和8085(Web端口)
• 使用命名卷logforge_notifier_data持久化通知数据
• 同步宿主机时区配置，确保时间记录准确

4. 自动更新服务(logforge-autoupdate)

logforge-autoupdate:
  image: madanb13/logforge-autoupdate:latest
  volumes:
    - /var/run/docker.sock:/var/run/docker.sock

关键功能：

• 基于Watchtower实现自动更新
• 需要访问Docker引擎管理容器更新
• 通过标签com.centurylinklabs.watchtower.enable=true启用更新

环境变量配置

配置文件大量使用环境变量提供灵活性，主要变量包括：

• BACKEND_SERVICE_PORT：后端服务监听端口
• EXPOSED_BACKEND_PORT：后端服务暴露端口
• FRONTEND_SERVICE_PORT：前端服务监听端口
• EXPOSED_FRONTEND_PORT：前端服务暴露端口
• NOTIFIER_PLAIN_PORT：通知服务普通端口
• NOTIFIER_WEB_PORT：通知服务Web端口

数据持久化

配置中定义了两个命名卷确保数据持久化：

1. logforge_core_data：存储后端核心数据
2. logforge_notifier_data：存储通知服务数据

部署建议

1. 端口配置：生产环境应修改默认端口配置，避免冲突
2. 自动更新：自动更新适合开发环境，生产环境建议手动控制更新
3. 数据备份：定期备份命名卷数据
4. 资源限制：生产环境应为各服务添加资源限制(resources)

常见问题排查

1. 端口冲突：检查各服务端口是否被占用
2. 容器通信问题：确认所有服务连接到同一网络
3. 权限问题：确保Docker套接字有适当访问权限
4. 数据持久化：验证命名卷是否正确创建

通过理解这份Docker Compose配置，开发者可以更灵活地部署和管理LogForge平台，根据实际需求调整配置参数。