TradingAgents-CN 多架构 Docker 镜像构建指南AMD64、ARM64 与 Apple Silicon 全流程实战【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN本文以 docs/BUILD_GUIDE.md 为核心骨架系统讲解 TradingAgents-CN 项目针对不同 CPU 架构构建 Docker 镜像的完整方案从预构建镜像拉取、按架构本地构建到多架构交叉构建的原理与取舍并深入到Dockerfile与构建脚本的源码级细节。读完本文你将能根据自身设备Intel/AMD PC、ARM 服务器、树莓派、Apple Silicon Mac选择正确的构建路径掌握REGISTRY、VERSION等关键参数的用法并独立完成镜像的构建、推送、部署与架构验证。快速开始TradingAgents-CN 采用前后端分离架构后端为 FastAPI 服务Dockerfile.backend前端为 Vue 3 Vite 应用Dockerfile.frontend两者需分别构建镜像。项目提供了三种快速上手方案。方案 1使用预构建镜像推荐如果不想经历本地构建可以直接从 Docker Hub 拉取官方预构建镜像这是最快的方式# 从 Docker Hub 拉取最快 docker pull hsliuping/tradingagents-backend:v1.0.0-preview-amd64 docker pull hsliuping/tradingagents-frontend:v1.0.0-preview-amd64预构建镜像的优势在于无需安装任何构建工具链拉取后修改docker-compose.yml中的镜像名称即可启动服务具体见下文「使用方法」章节。方案 2本地构建按架构根据宿主机的 CPU 架构选择对应脚本构建时间约 5-20 分钟# AMD64 (Intel/AMD) ./scripts/build-amd64.sh # ARM64 (ARM 服务器、树莓派、Apple Silicon) ./scripts/build-arm64.sh方案 3多架构构建慢不推荐一次性产出 AMD64 ARM64 两个架构的镜像但代价是构建耗时极长30-60 分钟且交叉编译存在出错风险# 同时构建 AMD64 ARM64非常慢 ./scripts/build-multiarch.sh架构选择不同架构的适用设备、构建脚本与构建时间差异显著先明确目标架构再选择脚本可以避免大量无效等待。AMD64 (x86_64)适用设备✅ Intel 处理器的 PC、笔记本✅ AMD 处理器的 PC、服务器✅ 大部分云服务器AWS、阿里云、腾讯云等✅ Windows、Linux 服务器构建脚本Linux/macOS:./scripts/build-amd64.shWindows:.\scripts\build-amd64.ps1构建时间约 5-10 分钟ARM64适用设备✅ ARM 架构服务器华为鲲鹏、飞腾等✅ 树莓派 4/5 (Raspberry Pi)✅ NVIDIA Jetson 系列✅ AWS Graviton 实例构建脚本Linux/macOS:./scripts/build-arm64.shWindows:.\scripts\build-arm64.ps1构建时间ARM 设备上约 10-20 分钟x86 交叉编译约 20-40 分钟慢Apple Silicon (M1/M2/M3/M4)适用设备✅ MacBook Pro/Air (M1/M2/M3/M4)✅ Mac Mini (Apple Silicon)✅ Mac Studio (M1/M2 Ultra)✅ iMac (Apple Silicon)构建脚本macOS:./scripts/build-arm64.sh与 ARM64 通用构建时间约 5-8 分钟原生架构快优势 原生性能无需模拟⚡ 构建速度比 x86 模拟快 3-5 倍 运行效率高功耗低 镜像与 ARM64 服务器完全通用说明Apple Silicon 使用 ARM64 架构与 ARM 服务器镜像完全兼容无需单独构建直接使用build-arm64.sh即可。项目文档中偶有提及的build-apple-silicon.sh是历史命名建议当前仓库并未提供该文件请以build-arm64.sh为准。构建脚本详解仓库根目录的 scripts 目录下维护了成对的 Bash 与 PowerShell 构建脚本命名与用途一一对应脚本目标架构平台scripts/build-amd64.shlinux/amd64Linux/macOSscripts/build-arm64.shlinux/arm64Linux/macOSscripts/build-multiarch.shlinux/amd64 linux/arm64Linux/macOSscripts/build-amd64.ps1linux/amd64Windows (PowerShell)scripts/build-arm64.ps1linux/arm64Windows (PowerShell)scripts/build-multiarch.ps1linux/amd64 linux/arm64Windows (PowerShell)环境变量与参数约定Bash 脚本通过环境变量控制构建行为PowerShell 脚本则通过同名参数传递两者语义一致变量/参数默认值说明VERSIONv1.0.0-preview镜像版本号同时用于镜像标签REGISTRY空本地构建Docker Hub 用户名设置后镜像会推送到远程仓库PLATFORMS仅多架构脚本linux/amd64,linux/arm64多架构构建的目标平台列表可通过环境变量覆盖以 AMD64 脚本为例scripts/build-amd64.sh 第 15-16 行VERSION${VERSION:-v1.0.0-preview} REGISTRY${REGISTRY:-} # 留空表示本地构建设置为 Docker Hub 用户名可推送到远程脚本执行流程以 build-amd64.sh 为例从 scripts/build-amd64.sh 源码可见一次构建依次经历五个阶段前置检查依次校验docker命令是否存在、docker buildx version是否可用任一不满足即报错退出脚本第 40-52 行。这要求 Docker 19.03 且已启用 Buildx。Builder 准备检查名为tradingagents-builder-amd64的 buildx builder 是否存在不存在则以docker buildx create --name ... --use --platform linux/amd64创建随后docker buildx inspect --bootstrap确保 builder 已启动。后端镜像构建执行docker buildx build --platform linux/amd64 -f Dockerfile.backend -t 镜像标签 [--push|--load] .。未设置REGISTRY时使用--load将镜像加载到本地 Docker 守护进程设置后改用--push直接推送。前端镜像构建对Dockerfile.frontend重复上述过程。结果输出打印构建成功的镜像列表、docker pull/docker-compose使用提示并给出其他架构脚本的指引。镜像命名约定需要注意Bash 脚本默认使用带架构后缀的独立镜像名AMD64 为tradingagents-backend-amd64/tradingagents-frontend-amd64ARM64 为tradingagents-backend-arm64/tradingagents-frontend-arm64并在构建时额外打上:latest标签而 PowerShell 脚本与预构建镜像则使用tradingagents-backend通用名 {version}-{arch}架构后缀标签。两种命名风格均遵循「独立仓库、独立更新、互不影响」的设计思路实际使用时以你选择的脚本输出为准。Dockerfile 源码级解析要理解多架构构建为何可行关键在于 Dockerfile.backend 对架构感知的处理FROM python:3.10-slim-bookworm # 获取构建架构信息 ARG TARGETARCHARG TARGETARCH由 Buildx 在构建时自动注入取值为amd64或arm64后续根据该值选择不同架构的二进制包if [ $TARGETARCH arm64 ]; then \ PANDOC_ARCHarm64; \ WKHTMLTOPDF_ARCHarm64; \ else \ PANDOC_ARCHamd64; \ WKHTMLTOPDF_ARCHamd64; \ fi \ wget -q https://github.com/jgm/pandoc/releases/download/3.8.2.1/pandoc-3.8.2.1-1-${PANDOC_ARCH}.deb \ wget -q https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-3/wkhtmltox_0.12.6.1-3.bookworm_${WKHTMLTOPDF_ARCH}.deb这一设计的背景是TradingAgents-CN 的 PDF 导出依赖pandocMarkdown 转文档与wkhtmltopdfHTML 转 PDF二者没有多架构合一的便捷安装源因此必须按目标架构下载对应.deb包。同时安装fonts-noto-cjk中文字体并执行fc-cache -fv刷新字体缓存确保导出的 PDF 中文显示正常。Python 依赖安装阶段同样为多架构做了优化Dockerfile.backend 第 67-69 行RUN pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple \ pip install --prefer-binary . -i https://pypi.tuna.tsinghua.edu.cn/simple \ pip install --prefer-binary pdfkit -i https://pypi.tuna.tsinghua.edu.cn/simple-i https://pypi.tuna.tsinghua.edu.cn/simple使用清华 PyPI 镜像加速依赖下载--prefer-binary优先安装预编译 wheel 包避免在 ARM 设备上从源码编译这是大幅缩短 ARM64 构建时间的关键手段。前端 Dockerfile.frontend 采用标准的多阶段构建构建阶段基于node:22-alpine通过corepack激活项目锁定的 Yarn 1.22.22执行yarn install --frozen-lockfile --productionfalse --network-timeout 300000保证依赖版本与 frontend/package.json 完全一致并容忍跨平台构建的网络延迟运行阶段基于nginx:alpine将构建产物复制到 Nginx 静态目录并挂载 docker/nginx.conf —— 该配置对 SPA 路由做了try_files $uri $uri/ /index.html回退对index.html设置禁止缓存、对带 hash 的 JS/CSS 设置一年强缓存并开放/health健康检查端点。构建脚本使用详解AMD64 构建Linux/macOS# 基本用法本地构建不推送 ./scripts/build-amd64.sh # 推送到 Docker Hub REGISTRYyour-dockerhub-username VERSIONv1.0.0 ./scripts/build-amd64.sh # 自定义版本 VERSIONv1.0.1 ./scripts/build-amd64.shWindows (PowerShell)# 基本用法 .\scripts\build-amd64.ps1 # 推送到 Docker Hub .\scripts\build-amd64.ps1 -Registry your-dockerhub-username -Version v1.0.0 # 自定义版本 .\scripts\build-amd64.ps1 -Version v1.0.1ARM64 构建Linux/macOS# 基本用法 ./scripts/build-arm64.sh # 推送到 Docker Hub REGISTRYyour-dockerhub-username VERSIONv1.0.0 ./scripts/build-arm64.shWindows (PowerShell)# 基本用法 .\scripts\build-arm64.ps1 # 推送到 Docker Hub .\scripts\build-arm64.ps1 -Registry your-dockerhub-username -Version v1.0.0多架构构建不推荐⚠️ 警告同时构建多个架构非常慢30-60 分钟不推荐使用。Linux/macOS# 构建 AMD64 ARM64慢 ./scripts/build-multiarch.sh # 推送到 Docker Hub REGISTRYyour-dockerhub-username VERSIONv1.0.0 ./scripts/build-multiarch.shWindows (PowerShell)# 构建 AMD64 ARM64慢 .\scripts\build-multiarch.ps1 # 推送到 Docker Hub .\scripts\build-multiarch.ps1 -Registry your-dockerhub-username -Version v1.0.0从 scripts/build-multiarch.sh 源码可以看到两个值得注意的实现细节未设置REGISTRY时脚本会自动探测当前平台docker version --format {{.Server.Os}}/{{.Server.Arch}}并退化为单架构--load构建——因为--load本身只支持单一架构多架构产物必须通过--push推送才能保留多架构场景下latest标签仅在设置REGISTRY时附加。若只想临时构建某个特定架构而不跑完整脚本也可以直接使用 buildx 命令docker buildx build --platform linux/arm64 -f Dockerfile.backend -t tradingagents-backend:arm64 .构建完成后的使用1. 本地构建后使用# 1. 构建镜像 ./scripts/build-amd64.sh # 2. 查看镜像 docker images | grep tradingagents # 3. 启动服务 docker-compose -f docker-compose.yml up -d说明构建脚本输出中的提示信息沿用了docker-compose.v1.0.0.yml的历史命名当前仓库根目录实际提供的是 docker-compose.yml请以实际文件名为准。2. 推送到 Docker Hub# 1. 登录 Docker Hub docker login # 2. 构建并推送 REGISTRYyour-dockerhub-username ./scripts/build-amd64.sh # 3. 在其他机器上拉取 docker pull your-dockerhub-username/tradingagents-backend:v1.0.0-preview-amd643. 使用预构建镜像# 1. 拉取镜像 docker pull hsliuping/tradingagents-backend:v1.0.0-preview-amd64 docker pull hsliuping/tradingagents-frontend:v1.0.0-preview-amd64 # 2. 修改 docker-compose.yml 中的镜像名称 # image: hsliuping/tradingagents-backend:v1.0.0-preview-amd64 # 3. 启动服务 docker-compose up -d4. Compose 编排结构速览启动后整套系统包含以下服务见 docker-compose.yml服务镜像/构建端口映射说明backendDockerfile.backend8000:8000FastAPI 后端带/api/health健康检查frontendDockerfile.frontend3000:80Vue 3 前端通过 Nginx 提供静态服务mongodbmongo:4.427017:27017业务数据库挂载scripts/mongo-init.js初始化redisredis:7-alpine6379:6379缓存服务appendonly yes持久化redis-commanderghcr.io/joeferner/redis-commander8081:8081可选管理界面managementprofilemongo-expressmongo-express8082:8081可选管理界面managementprofile后端通过环境变量注入 Docker 专用的 MongoDB、Redis 连接串TRADINGAGENTS_MONGODB_URL、TRADINGAGENTS_REDIS_URL、TRADINGAGENTS_CACHE_TYPEredis并通过depends_onservice_healthy条件确保依赖服务就绪后才启动。性能对比架构设备示例构建时间运行性能推荐度AMD64Intel/AMD PC5-10 分钟⭐⭐⭐⭐⭐✅ 推荐ARM64ARM 服务器10-20 分钟⭐⭐⭐⭐✅ 推荐Apple SiliconMacBook M1/M25-8 分钟⭐⭐⭐⭐⭐✅ 强烈推荐多架构任意设备30-60 分钟-❌ 不推荐镜像标签规范标签说明示例{version}通用标签v1.0.0-preview{version}-amd64AMD64 专用v1.0.0-preview-amd64{version}-arm64ARM64 专用v1.0.0-preview-arm64{version}-apple-siliconApple Silicon 专用v1.0.0-preview-apple-silicon常见问题排查Q1: 如何选择构建脚本设备类型推荐脚本Intel/AMD PCbuild-amd64.shARM 服务器build-arm64.shMacBook M1/M2/M3/M4build-arm64.sh树莓派 4/5build-arm64.shQ2: 为什么不推荐多架构构建❌ 构建时间长30-60 分钟❌ 占用大量 CPU 和内存❌ 交叉编译可能出错✅ 分架构构建更快5-10 分钟✅ 更稳定可靠Q3: Apple Silicon 用户应该用哪个脚本使用build-arm64.sh✅ 原生架构构建快✅ 性能最优✅ 镜像与 ARM64 通用✅ 可在 ARM 服务器上使用Q4: 构建失败怎么办检查 Docker 版本docker --version # 需要 19.03 docker buildx version # 需要支持 buildx清理 Docker 缓存docker system prune -a重新创建 builderdocker buildx rm tradingagents-builder-amd64 ./scripts/build-amd64.sh检查网络连接确保可以访问 Docker Hub确保可以访问 PyPI 镜像构建脚本默认使用清华镜像https://pypi.tuna.tsinghua.edu.cn/simpleQ5: 如何加速构建使用国内镜像Dockerfile 已配置PyPI 使用清华镜像前端依赖安装亦已配置国内镜像源见 Dockerfile.frontend 复制的frontend/.yarnrc。利用 Docker 缓存不清理缓存复用已有构建层。docker buildx build --cache-from...使用预构建镜像直接docker pull完全跳过构建环节。docker pull hsliuping/tradingagents-backend:v1.0.0-preview-amd64Q6: 如何验证镜像架构# 查看镜像详细信息 docker inspect tradingagents-backend:v1.0.0-preview | grep Architecture # 或使用 buildx适合多架构 manifest 列表 docker buildx imagetools inspect tradingagents-backend:v1.0.0-preview相关文档docs/guides/docker-deployment-guide.mdDocker 部署完整指南docs/deployment/docker/docker-compose.split.yml拆分式 Compose 编排示例docs/guides/INSTALLATION_GUIDE.md整体安装指南docs/guides/LINUX_BUILD_GUIDE.mdLinux 环境构建指南如果构建过程仍然出现问题建议先查看构建日志再对照 Q4 逐项检查 Docker 版本、builder 状态与网络连通性最后确认目标架构与所选脚本是否匹配。【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/10 6:27:04 · 阅读 1.2k TradingAgents-CN 多架构 Docker 镜像构建指南：AMD64、ARM64 与 Apple Silicon 全流程实战
TradingAgents-CN 多架构 Docker 镜像构建指南AMD64、ARM64 与 Apple Silicon 全流程实战【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN本文以 docs/BUILD_GUIDE.md 为核心骨架系统讲解 TradingAgents-CN 项目针对不同 CPU 架构构建 Docker 镜像的完整方案从预构建镜像拉取、按架构本地构建到多架构交叉构建的原理与取舍并深入到Dockerfile与构建脚本的源码级细节。读完本文你将能根据自身设备Intel/AMD PC、ARM 服务器、树莓派、Apple Silicon Mac选择正确的构建路径掌握REGISTRY、VERSION等关键参数的用法并独立完成镜像的构建、推送、部署与架构验证。快速开始TradingAgents-CN 采用前后端分离架构后端为 FastAPI 服务Dockerfile.backend前端为 Vue 3 Vite 应用Dockerfile.frontend两者需分别构建镜像。项目提供了三种快速上手方案。方案 1使用预构建镜像推荐如果不想经历本地构建可以直接从 Docker Hub 拉取官方预构建镜像这是最快的方式# 从 Docker Hub 拉取最快 docker pull hsliuping/tradingagents-backend:v1.0.0-preview-amd64 docker pull hsliuping/tradingagents-frontend:v1.0.0-preview-amd64预构建镜像的优势在于无需安装任何构建工具链拉取后修改docker-compose.yml中的镜像名称即可启动服务具体见下文「使用方法」章节。方案 2本地构建按架构根据宿主机的 CPU 架构选择对应脚本构建时间约 5-20 分钟# AMD64 (Intel/AMD) ./scripts/build-amd64.sh # ARM64 (ARM 服务器、树莓派、Apple Silicon) ./scripts/build-arm64.sh方案 3多架构构建慢不推荐一次性产出 AMD64 ARM64 两个架构的镜像但代价是构建耗时极长30-60 分钟且交叉编译存在出错风险# 同时构建 AMD64 ARM64非常慢 ./scripts/build-multiarch.sh架构选择不同架构的适用设备、构建脚本与构建时间差异显著先明确目标架构再选择脚本可以避免大量无效等待。AMD64 (x86_64)适用设备✅ Intel 处理器的 PC、笔记本✅ AMD 处理器的 PC、服务器✅ 大部分云服务器AWS、阿里云、腾讯云等✅ Windows、Linux 服务器构建脚本Linux/macOS:./scripts/build-amd64.shWindows:.\scripts\build-amd64.ps1构建时间约 5-10 分钟ARM64适用设备✅ ARM 架构服务器华为鲲鹏、飞腾等✅ 树莓派 4/5 (Raspberry Pi)✅ NVIDIA Jetson 系列✅ AWS Graviton 实例构建脚本Linux/macOS:./scripts/build-arm64.shWindows:.\scripts\build-arm64.ps1构建时间ARM 设备上约 10-20 分钟x86 交叉编译约 20-40 分钟慢Apple Silicon (M1/M2/M3/M4)适用设备✅ MacBook Pro/Air (M1/M2/M3/M4)✅ Mac Mini (Apple Silicon)✅ Mac Studio (M1/M2 Ultra)✅ iMac (Apple Silicon)构建脚本macOS:./scripts/build-arm64.sh与 ARM64 通用构建时间约 5-8 分钟原生架构快优势 原生性能无需模拟⚡ 构建速度比 x86 模拟快 3-5 倍 运行效率高功耗低 镜像与 ARM64 服务器完全通用说明Apple Silicon 使用 ARM64 架构与 ARM 服务器镜像完全兼容无需单独构建直接使用build-arm64.sh即可。项目文档中偶有提及的build-apple-silicon.sh是历史命名建议当前仓库并未提供该文件请以build-arm64.sh为准。构建脚本详解仓库根目录的 scripts 目录下维护了成对的 Bash 与 PowerShell 构建脚本命名与用途一一对应脚本目标架构平台scripts/build-amd64.shlinux/amd64Linux/macOSscripts/build-arm64.shlinux/arm64Linux/macOSscripts/build-multiarch.shlinux/amd64 linux/arm64Linux/macOSscripts/build-amd64.ps1linux/amd64Windows (PowerShell)scripts/build-arm64.ps1linux/arm64Windows (PowerShell)scripts/build-multiarch.ps1linux/amd64 linux/arm64Windows (PowerShell)环境变量与参数约定Bash 脚本通过环境变量控制构建行为PowerShell 脚本则通过同名参数传递两者语义一致变量/参数默认值说明VERSIONv1.0.0-preview镜像版本号同时用于镜像标签REGISTRY空本地构建Docker Hub 用户名设置后镜像会推送到远程仓库PLATFORMS仅多架构脚本linux/amd64,linux/arm64多架构构建的目标平台列表可通过环境变量覆盖以 AMD64 脚本为例scripts/build-amd64.sh 第 15-16 行VERSION${VERSION:-v1.0.0-preview} REGISTRY${REGISTRY:-} # 留空表示本地构建设置为 Docker Hub 用户名可推送到远程脚本执行流程以 build-amd64.sh 为例从 scripts/build-amd64.sh 源码可见一次构建依次经历五个阶段前置检查依次校验docker命令是否存在、docker buildx version是否可用任一不满足即报错退出脚本第 40-52 行。这要求 Docker 19.03 且已启用 Buildx。Builder 准备检查名为tradingagents-builder-amd64的 buildx builder 是否存在不存在则以docker buildx create --name ... --use --platform linux/amd64创建随后docker buildx inspect --bootstrap确保 builder 已启动。后端镜像构建执行docker buildx build --platform linux/amd64 -f Dockerfile.backend -t 镜像标签 [--push|--load] .。未设置REGISTRY时使用--load将镜像加载到本地 Docker 守护进程设置后改用--push直接推送。前端镜像构建对Dockerfile.frontend重复上述过程。结果输出打印构建成功的镜像列表、docker pull/docker-compose使用提示并给出其他架构脚本的指引。镜像命名约定需要注意Bash 脚本默认使用带架构后缀的独立镜像名AMD64 为tradingagents-backend-amd64/tradingagents-frontend-amd64ARM64 为tradingagents-backend-arm64/tradingagents-frontend-arm64并在构建时额外打上:latest标签而 PowerShell 脚本与预构建镜像则使用tradingagents-backend通用名 {version}-{arch}架构后缀标签。两种命名风格均遵循「独立仓库、独立更新、互不影响」的设计思路实际使用时以你选择的脚本输出为准。Dockerfile 源码级解析要理解多架构构建为何可行关键在于 Dockerfile.backend 对架构感知的处理FROM python:3.10-slim-bookworm # 获取构建架构信息 ARG TARGETARCHARG TARGETARCH由 Buildx 在构建时自动注入取值为amd64或arm64后续根据该值选择不同架构的二进制包if [ $TARGETARCH arm64 ]; then \ PANDOC_ARCHarm64; \ WKHTMLTOPDF_ARCHarm64; \ else \ PANDOC_ARCHamd64; \ WKHTMLTOPDF_ARCHamd64; \ fi \ wget -q https://github.com/jgm/pandoc/releases/download/3.8.2.1/pandoc-3.8.2.1-1-${PANDOC_ARCH}.deb \ wget -q https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-3/wkhtmltox_0.12.6.1-3.bookworm_${WKHTMLTOPDF_ARCH}.deb这一设计的背景是TradingAgents-CN 的 PDF 导出依赖pandocMarkdown 转文档与wkhtmltopdfHTML 转 PDF二者没有多架构合一的便捷安装源因此必须按目标架构下载对应.deb包。同时安装fonts-noto-cjk中文字体并执行fc-cache -fv刷新字体缓存确保导出的 PDF 中文显示正常。Python 依赖安装阶段同样为多架构做了优化Dockerfile.backend 第 67-69 行RUN pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple \ pip install --prefer-binary . -i https://pypi.tuna.tsinghua.edu.cn/simple \ pip install --prefer-binary pdfkit -i https://pypi.tuna.tsinghua.edu.cn/simple-i https://pypi.tuna.tsinghua.edu.cn/simple使用清华 PyPI 镜像加速依赖下载--prefer-binary优先安装预编译 wheel 包避免在 ARM 设备上从源码编译这是大幅缩短 ARM64 构建时间的关键手段。前端 Dockerfile.frontend 采用标准的多阶段构建构建阶段基于node:22-alpine通过corepack激活项目锁定的 Yarn 1.22.22执行yarn install --frozen-lockfile --productionfalse --network-timeout 300000保证依赖版本与 frontend/package.json 完全一致并容忍跨平台构建的网络延迟运行阶段基于nginx:alpine将构建产物复制到 Nginx 静态目录并挂载 docker/nginx.conf —— 该配置对 SPA 路由做了try_files $uri $uri/ /index.html回退对index.html设置禁止缓存、对带 hash 的 JS/CSS 设置一年强缓存并开放/health健康检查端点。构建脚本使用详解AMD64 构建Linux/macOS# 基本用法本地构建不推送 ./scripts/build-amd64.sh # 推送到 Docker Hub REGISTRYyour-dockerhub-username VERSIONv1.0.0 ./scripts/build-amd64.sh # 自定义版本 VERSIONv1.0.1 ./scripts/build-amd64.shWindows (PowerShell)# 基本用法 .\scripts\build-amd64.ps1 # 推送到 Docker Hub .\scripts\build-amd64.ps1 -Registry your-dockerhub-username -Version v1.0.0 # 自定义版本 .\scripts\build-amd64.ps1 -Version v1.0.1ARM64 构建Linux/macOS# 基本用法 ./scripts/build-arm64.sh # 推送到 Docker Hub REGISTRYyour-dockerhub-username VERSIONv1.0.0 ./scripts/build-arm64.shWindows (PowerShell)# 基本用法 .\scripts\build-arm64.ps1 # 推送到 Docker Hub .\scripts\build-arm64.ps1 -Registry your-dockerhub-username -Version v1.0.0多架构构建不推荐⚠️ 警告同时构建多个架构非常慢30-60 分钟不推荐使用。Linux/macOS# 构建 AMD64 ARM64慢 ./scripts/build-multiarch.sh # 推送到 Docker Hub REGISTRYyour-dockerhub-username VERSIONv1.0.0 ./scripts/build-multiarch.shWindows (PowerShell)# 构建 AMD64 ARM64慢 .\scripts\build-multiarch.ps1 # 推送到 Docker Hub .\scripts\build-multiarch.ps1 -Registry your-dockerhub-username -Version v1.0.0从 scripts/build-multiarch.sh 源码可以看到两个值得注意的实现细节未设置REGISTRY时脚本会自动探测当前平台docker version --format {{.Server.Os}}/{{.Server.Arch}}并退化为单架构--load构建——因为--load本身只支持单一架构多架构产物必须通过--push推送才能保留多架构场景下latest标签仅在设置REGISTRY时附加。若只想临时构建某个特定架构而不跑完整脚本也可以直接使用 buildx 命令docker buildx build --platform linux/arm64 -f Dockerfile.backend -t tradingagents-backend:arm64 .构建完成后的使用1. 本地构建后使用# 1. 构建镜像 ./scripts/build-amd64.sh # 2. 查看镜像 docker images | grep tradingagents # 3. 启动服务 docker-compose -f docker-compose.yml up -d说明构建脚本输出中的提示信息沿用了docker-compose.v1.0.0.yml的历史命名当前仓库根目录实际提供的是 docker-compose.yml请以实际文件名为准。2. 推送到 Docker Hub# 1. 登录 Docker Hub docker login # 2. 构建并推送 REGISTRYyour-dockerhub-username ./scripts/build-amd64.sh # 3. 在其他机器上拉取 docker pull your-dockerhub-username/tradingagents-backend:v1.0.0-preview-amd643. 使用预构建镜像# 1. 拉取镜像 docker pull hsliuping/tradingagents-backend:v1.0.0-preview-amd64 docker pull hsliuping/tradingagents-frontend:v1.0.0-preview-amd64 # 2. 修改 docker-compose.yml 中的镜像名称 # image: hsliuping/tradingagents-backend:v1.0.0-preview-amd64 # 3. 启动服务 docker-compose up -d4. Compose 编排结构速览启动后整套系统包含以下服务见 docker-compose.yml服务镜像/构建端口映射说明backendDockerfile.backend8000:8000FastAPI 后端带/api/health健康检查frontendDockerfile.frontend3000:80Vue 3 前端通过 Nginx 提供静态服务mongodbmongo:4.427017:27017业务数据库挂载scripts/mongo-init.js初始化redisredis:7-alpine6379:6379缓存服务appendonly yes持久化redis-commanderghcr.io/joeferner/redis-commander8081:8081可选管理界面managementprofilemongo-expressmongo-express8082:8081可选管理界面managementprofile后端通过环境变量注入 Docker 专用的 MongoDB、Redis 连接串TRADINGAGENTS_MONGODB_URL、TRADINGAGENTS_REDIS_URL、TRADINGAGENTS_CACHE_TYPEredis并通过depends_onservice_healthy条件确保依赖服务就绪后才启动。性能对比架构设备示例构建时间运行性能推荐度AMD64Intel/AMD PC5-10 分钟⭐⭐⭐⭐⭐✅ 推荐ARM64ARM 服务器10-20 分钟⭐⭐⭐⭐✅ 推荐Apple SiliconMacBook M1/M25-8 分钟⭐⭐⭐⭐⭐✅ 强烈推荐多架构任意设备30-60 分钟-❌ 不推荐镜像标签规范标签说明示例{version}通用标签v1.0.0-preview{version}-amd64AMD64 专用v1.0.0-preview-amd64{version}-arm64ARM64 专用v1.0.0-preview-arm64{version}-apple-siliconApple Silicon 专用v1.0.0-preview-apple-silicon常见问题排查Q1: 如何选择构建脚本设备类型推荐脚本Intel/AMD PCbuild-amd64.shARM 服务器build-arm64.shMacBook M1/M2/M3/M4build-arm64.sh树莓派 4/5build-arm64.shQ2: 为什么不推荐多架构构建❌ 构建时间长30-60 分钟❌ 占用大量 CPU 和内存❌ 交叉编译可能出错✅ 分架构构建更快5-10 分钟✅ 更稳定可靠Q3: Apple Silicon 用户应该用哪个脚本使用build-arm64.sh✅ 原生架构构建快✅ 性能最优✅ 镜像与 ARM64 通用✅ 可在 ARM 服务器上使用Q4: 构建失败怎么办检查 Docker 版本docker --version # 需要 19.03 docker buildx version # 需要支持 buildx清理 Docker 缓存docker system prune -a重新创建 builderdocker buildx rm tradingagents-builder-amd64 ./scripts/build-amd64.sh检查网络连接确保可以访问 Docker Hub确保可以访问 PyPI 镜像构建脚本默认使用清华镜像https://pypi.tuna.tsinghua.edu.cn/simpleQ5: 如何加速构建使用国内镜像Dockerfile 已配置PyPI 使用清华镜像前端依赖安装亦已配置国内镜像源见 Dockerfile.frontend 复制的frontend/.yarnrc。利用 Docker 缓存不清理缓存复用已有构建层。docker buildx build --cache-from...使用预构建镜像直接docker pull完全跳过构建环节。docker pull hsliuping/tradingagents-backend:v1.0.0-preview-amd64Q6: 如何验证镜像架构# 查看镜像详细信息 docker inspect tradingagents-backend:v1.0.0-preview | grep Architecture # 或使用 buildx适合多架构 manifest 列表 docker buildx imagetools inspect tradingagents-backend:v1.0.0-preview相关文档docs/guides/docker-deployment-guide.mdDocker 部署完整指南docs/deployment/docker/docker-compose.split.yml拆分式 Compose 编排示例docs/guides/INSTALLATION_GUIDE.md整体安装指南docs/guides/LINUX_BUILD_GUIDE.mdLinux 环境构建指南如果构建过程仍然出现问题建议先查看构建日志再对照 Q4 逐项检查 Docker 版本、builder 状态与网络连通性最后确认目标架构与所选脚本是否匹配。【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考