Invoicerr项目Docker-Compose部署指南

项目概述

Invoicerr是一个基于Docker容器化的发票管理应用系统，通过docker-compose.yml文件可以快速部署完整的服务环境。该文件定义了应用服务(invoicerr)和数据库服务(invoicerr_db)两个核心组件，以及它们之间的依赖关系和配置参数。

核心服务解析

1. Invoicerr应用服务

应用服务使用最新版本的invoicerr镜像，主要配置包括：

• 端口映射：将容器内部的80端口映射到主机的80端口，使外部可以访问
• 数据库连接：通过DATABASE_URL环境变量配置PostgreSQL数据库连接
• 应用URL：APP_URL用于电子邮件模板中的重定向链接
• SMTP配置：完整的邮件服务配置，包括主机、用户、发件人和密码
• JWT密钥：用于身份验证的安全密钥，建议生产环境使用强密码

2. 数据库服务

数据库服务使用PostgreSQL最新官方镜像，配置了：

• 认证信息：预设了用户名、密码和数据库名称
• 数据持久化：通过卷(volume)挂载确保数据持久存储
• 自动初始化：环境变量会触发数据库的自动创建和配置

关键配置详解

环境变量配置

1. DATABASE_URL：采用PostgreSQL连接字符串格式，包含用户名、密码、主机和数据库名
2. SMTP相关配置：
   • SMTP_HOST：邮件服务器地址
   • SMTP_USER/SMTP_FROM：发件人信息
   • SMTP_PASSWORD：邮件服务密码
3. JWT_SECRET：建议使用强随机字符串，长度至少32字符

数据持久化方案

使用Docker卷(db_data)持久化存储数据库文件，确保：

• 容器重启后数据不丢失
• 方便数据备份和迁移
• 避免容器层存储带来的性能问题

部署建议

1. 生产环境调整：

   • 修改所有默认密码和密钥
   • 考虑使用TLS加密连接
   • 设置适当的资源限制

2. 安全最佳实践：

   • 不要将敏感信息直接写入文件，考虑使用Docker secrets
   • 定期轮换JWT_SECRET
   • 为数据库使用独立网络

3. 性能优化：

   • 根据负载调整PostgreSQL配置
   • 考虑添加缓存层
   • 监控服务资源使用情况

常见问题排查

1. 连接问题：

   • 检查数据库服务是否先启动完成
   • 验证网络连接是否正常

2. 邮件发送失败：

   • 检查SMTP配置是否正确
   • 验证网络访问设置

3. 性能问题：

   • 检查数据库索引
   • 分析查询性能

通过这份docker-compose配置，用户可以快速搭建完整的Invoicerr服务环境，但需要注意根据实际生产需求调整安全性和性能相关参数。