alterafpga/quartuspro-v25.3

镜像概述

这是Altera Quartus Prime Pro v25.3（b109）的容器镜像系列，基于Ubuntu 24.04构建。注：最新补丁版本可访问https://hub.docker.com/r/alterafpga/quartus-pro%E3%80%82

核心功能

• 提供针对不同FPGA器件系列的镜像版本（all、Agilex3、Agilex5、Agilex7），支持完整编译流程；
• 采用可重基分层构建，Quartus基础层在各镜像间共享，避免重复下载；
• 可运行Quartus Prime Pro的所有命令行工具（如quartus_sh）。

使用场景

• FPGA项目的完整编译流程执行；
• Quartus Tcl脚本的自动化运行；
• 获取Quartus命令行工具的帮助信息。

配置说明

运行镜像时需指定以下必要参数：

1. --net=host：Quartus授权机制要求，缺少将导致运行失败；
2. --mount type=bind,source=<本地设计路径>,target=<容器内路径>：挂载本地FPGA设计目录到容器内（默认推荐目标路径为/data）；
3. --env LM_LICENSE_FILE：传递本地环境中的Quartus许可证文件路径。

运行示例

使用Agilex7镜像执行Tcl脚本

运行本地/quartus/project1目录下的run.tcl脚本（参数为val1 val2）：

docker run \
    --net=host \
    --env LM_LICENSE_FILE \
    --mount type=bind,source=/quartus/project1,target=/data \
    alterafpga/quartuspro-v25.3:agilex7 \
    quartus_sh -t /data/run.tcl val1 val2

使用Agilex5镜像执行完整编译

编译本地/quartus/project1目录下的top项目（基于.qsf文件）：

docker run \
    --net=host \
    --env LM_LICENSE_FILE \
    --mount type=bind,source=/quartus/project1,target=/data  \
    alterafpga/quartuspro-v25.3:agilex5 \
    quartus_sh --flow compile /data/top

获取quartus_sh帮助信息

docker run \
    --net=host \
    --env LM_LICENSE_FILE \
    --mount type=bind,source=/quartus/project1,target=/data  \
    alterafpga/quartuspro-v25.3:agilex5 \
    quartus_sh -h

参考资料

官方文档：https://www.intel.com/content/www/us/en/support/programmable/support-resources/design-software/user-guides.html