ProReports Docker镜像文档

镜像概述和主要用途

本镜像为ProReports的Docker化版本。ProReports是一个简单的报表系统，旨在生成多种流行办公格式的报表，包括PDF、XLS、RTF、HTML、TXT、XML、CSV、PNG、GIF等。支持通过Web浏览器访问，具备多数据源、定时生成、权限管理等功能，适用于企业报表生成与管理场景。

核心功能和特性

• 一份报表支持多个SQL查询
• 一份报表支持多个数据源
• 支持临时表
• 支持存储过程（PL/SPL）
• 可执行非SELECT SQL命令
• 报表多语言支持（UTF-8）
• 跨平台（AIX、Linux、Solaris、Windows）
• 支持基于RTF模板的报表
• 支持多种输出格式（PDF、XLS、RTF、HTML、TXT、XML、CSV、PNG、GIF）
• PDF报表数字签名
• 支持多种数据库
• 管理人员仪表板
• 可通过添加PHP和JAVA模块扩展功能
• 通过Web浏览器访问报表
• 内部报表生成计划任务
• 自动发送报表（邮件）模块，支持GPG加密、ZIP压缩
• 数据库连接池
• 支持命令行生成报表（Windows和Unix）
• 支持批量生成和处理报表
• 可定义报表参数表单
• 报表权限支持
• 生成报表的数据过滤器
• SQL查询多线程执行

限制说明

• 年度报表生成限制为5份
• 可通过向作者***增加限制，详情见ProReports Wiki帮助

使用方法

基本运行命令

可通过以下命令启动默认的ProReports服务：

bash
docker run -itd -p 8080:8080 --name proreports gemail/docker-proreports

添加自定义JDBC驱动

如需向容器添加自定义JDBC驱动，可挂载驱动目录：

bash
docker run -itd -p 8080:8080 -v /本地驱动目录:/libjar --name proreports gemail/docker-proreports

环境变量配置

核心环境变量

数据同步配置（ENV_RSYNC_BASE）

用于配置rsync-dir机制，实现ProReports数据库文件向ETCD/REDIS的分布式同步，避免容器重启后数据丢失（无需持久卷）。配置文件示例：

ini
[MAIN]
description=rsync-dir复制器
license=XX:XX:XX:XX:XX:XX (需购买许可证并在此处设置)
storedb=redis
actions=restore,delete,mtime,start
basedir=/usr/ProReports.utf8/BASE/
rootdir=/rsync-base/
rootchunks=/rsync-base-chunks/
chunksize=***
patterns=*.log.db,*.data.db,*.lob.db,*.index.db,*.temp.db
ignore_patterns=*.lock.db
mtime_patterns=*.log.db,*.data.db,*.lob.db,*.index.db,*.temp.db
mtime_cycle_time=15
mtime_info=False
case_sensitive=True
[ETCD]
hosts=ADDRESS_IP1[,ADDRESS_IP2,...] 
ports=2379[,2379,...]
threads=2
ca_cert=/rsync/ca.crt
cert_key=/rsync/server.key
cert_cert=/rsync/server.crt
user=
password=
timeout=2
reconnect_time=5
reconnect_max=3
[REDIS]
hosts=ADDRESS_IP1[,ADDRESS_IP2,...]
ports=6379[,6379,...]
db=10
user=
password=
ssl=False
threads=2
reconnect_time=5
reconnect_max=3

Kubernetes环境ETCD配置：需挂载Kubernetes集群ETCD证书（取自/etc/kubernetes/pki/etcd），并通过secret管理配置文件。启动示例：

bash
docker run -itd -p 8080:8080 -v /opt/rsync-dir/:/rsync -e ENV_RSYNC_BASE=/rsync/rsync-base.ini --name proreports gemail/docker-proreports

文件同步配置（ENV_RSYNC_FILES）

用于同步上传到ProReports的文件，配置与ENV_RSYNC_BASE类似，需修改以下参数：

ini
basedir=/usr/ProReports.utf8/webapps-plus/rep/files/
rootdir=/rsync-files/
rootchunks=/rsync-files-chunks/
patterns=*.*
ignore_patterns=*.---
mtime_patterns=*.*

同步等待配置

• ENV_RSYNC_MAX_LOOP：默认20，数据库和文件同步的最大等待循环次数（总等待时间=该值×5秒）

访问与登录

启动容器后，通过浏览器访问：
[***]

默认登录信息：

• 登录名：admin
• 密码：admin

相关链接

• ProReports***网站
• ProReports Wiki帮助