部署指南

部署方式

1. 独立部署（推荐）

最简单的方式，直接运行内置的应用服务器：

# Linux
nohup ./bin/start.sh &

# 或使用 systemd 管理
sudo cp magic-report.service /etc/systemd/system/
sudo systemctl enable magic-report
sudo systemctl start magic-report

2. Docker 部署

docker run -d \
  --name magic-report \
  -p 8088:8088 \
  -v /data/magic-report:/app/data \
  magic-report:latest

3. 嵌入式集成

将 Magic Report 作为依赖集成到您的 Java 应用中：

<dependency>
  <groupId>com.haoyu</groupId>
  <artifactId>magic-report-core</artifactId>
  <version>最新版本</version>
</dependency>

反向代理配置

Nginx 配置示例

server {
    listen 80;
    server_name report.example.com;

    location / {
        proxy_pass http://127.0.0.1:8088;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

性能优化建议

• JVM 内存建议设置 -Xmx1g 以上
• 大数据量报表建议启用分页查询
• 配置 Redis 缓存可提升并发性能
• 静态资源建议通过 Nginx 直接提供