人工智能AI AgentAgent 工作流RPA后端前端工具调用【免费下载链接】astron-agentAn enterprise-ready AI agent development platform combining intelligent RPA, enabling agents to not only think but also act—automating workflows across digital and desktop environments. 这是一个镜像仓库有issue、pr欢迎去github提交。项目地址https://gitcode.com/ifly_opensource/astron-agent点击查看免费下载本篇文章围绕 Astron Agent 官方部署文档的完整脉络展开系统讲解「先快速体验、再逐步生产化」的接入思路如何用 Docker Compose 在本地拉起一套可登录、可访问的完整链路如何按需叠加 Casdoor 统一身份认证与 RPA 后端能力以及如何通过 Helm / Kubernetes 走向企业级标准化部署与弹性扩容。读完本文你将掌握 Astron Agent 的部署方式选型、部署前的基础设施与模型密钥准备、两种典型部署路径的核心配置项以及从.env到 Helm values 的关键参数含义与升级注意事项。一、部署方式选型两条主路径按场景决策Astron Agent 官方部署文档给出的建议非常明确当前更适合按「先快速体验、再逐步生产化」的方式接入即先用门槛最低的 Docker Compose 把完整链路跑起来再根据业务需求平滑过渡到 Helm / Kubernetes 部署。这种「渐进式生产化」策略避免了一开始就淹没在大量细节中。Docker Compose本地体验与联调的默认选择优点启动快、上手门槛低适合本地和测试环境典型场景产品演示、研发联调、初次验证架构链路推荐入口快速开始。从仓库实际编排看Docker Compose 方案并非只有几个零散容器而是一整套可独立运行的完整栈。docker-compose.yaml 中包含了基础设施PostgreSQL、MySQL、Redis、MinIO与全部核心服务core-tenant、core-database、core-rpa、core-link、core-aitools、core-agent、core-knowledge、core-workflow以及控制台服务nginx、console-frontend、console-hub所有服务共享astron-agent-network桥接网络并通过命名卷持久化数据。这意味着「快速体验」阶段就能验证 Agent 构建、工作流执行、知识库检索、插件链接等核心业务链路而不仅仅是界面演示。Helm / Kubernetes面向生产的标准化部署优点更适合多实例、弹性伸缩和统一运维典型场景企业集群部署、持续交付、环境隔离相关目录helm/astron-agent。仓库在 helm/astron-agent/Chart.yaml 中提供了名为astron-agent的 Helm ChartREADME 位于 helm/README.md。需要说明的是Helm 路径与 Docker Compose 路径是同一套组件编排的两种承载形态Compose 面向单机/测试环境Helm 面向多实例、弹性伸缩与统一运维的生产集群两者共享同一套业务组件划分与配置语义。二、部署前准备基础设施、模型与鉴权策略三件事无论选择哪种部署方式部署前都需确认以下四类事项对应 docs/zh/guide/deploy.md 的「部署前准备」小节基础设施准备数据库PostgreSQL / MySQL、缓存Redis、对象存储MinIO 或外部 S3等。仓库默认在 Compose 栈中内置这些中间件若使用外部托管实例则需通过.env修改连接地址模型接入与密钥管理确认模型接入方式和密钥管理策略。业务侧模型账号讯飞开放平台、AI Ability Chat、知识库平台等不再写入.env而是启动后通过控制台「平台账号管理」页面配置鉴权选型根据是否需要登录鉴权选择标准部署或带鉴权部署Casdoor能力范围明确是否需要接入 RPA、插件和租户能力决定使用哪一个 Compose 清单。最低硬件门槛来自 DEPLOYMENT_GUIDE.md 的官方前置要求Agent 系统CPU 2 CoreRAM 4 GiBDisk 50 GBRAGFlow 知识库可选CPU 4 CoreRAM 16 GBDisk 50 GB。三、方案一标准部署无鉴权最小可用链路标准部署适合只想尽快跑起来、暂不引入统一身份认证的场景对应 DEPLOYMENT_GUIDE.md。3.1 准备环境变量cd docker/astronAgent cp .env.example .env.env文件只用于配置服务启动、访问地址、认证、数据库、Redis、对象存储等基础设施参数RAGFlow、讯飞开放平台、AI Ability Chat、虚拟人能力、星火知识库等业务能力账号不再写入.env请在 Astron Agent 启动后登录控制台通过平台账号管理页面配置。3.2 配置服务主机地址编辑.envHOST_BASE_ADDRESShttp://localhost使用域名访问时将localhost替换为你的域名仅向用户公开 Astron Agent 的应用入口Nginx/Ingress内置 MinIO API 与管理控制台必须保持安全默认值Docker Compose 仅绑定宿主机回环地址127.0.0.1默认端口18998/18999见 docker-compose.yamlHelm 使用ClusterIP。只有存在明确运维需求并配置独立认证、TLS 与网络策略/防火墙限制时才可显式开放相应端点禁止将 MinIO 直接发布到互联网。3.3 启动核心服务cd docker/astronAgent docker compose up -d启动完成后通过控制台前端Nginx 代理访问http://localhost/。四、方案二带鉴权部署Casdoor 统一身份认证当团队需要统一身份认证、可登录可访问的示例环境时使用带鉴权部署对应 DEPLOYMENT_GUIDE_WITH_AUTH.md 与 快速开始。4.1 组件概览带鉴权部署在标准部署之上引入Casdoor身份认证组件同时可选引入 RagFlow 知识库服务。官方对三大组件的定位是组件角色是否必要Casdoor身份认证和单点登录服务提供 OAuth 2.0、OIDC、SAML 等认证协议支持必要RagFlow知识库和文档检索服务RAG 引擎按需部署Astron Agent核心业务服务集群必要4.2 启动 Casdoor 认证服务可选分步docker-compose-with-auth.yaml已通过include机制将 docker-compose-auth.ymlCasdoor 及其专用 MySQL和 docker-compose.yaml核心服务组合为同一astron-agent-network。也可以先单独启动 Casdoorcd docker/astronAgent docker compose -f docker-compose-auth.yml up -d访问地址http://localhost:8000容器名称casdoor镜像casbin/casdoor:v2.67.0默认配置生产模式GIN_MODErelease。从 docker-compose-auth.yml 可以看到Casdoor 公网访问仅通过casdoor-gatewayNginx提供端口由CASDOOR_PORT默认8000控制casdoor-password-check容器会在发布前只读校验密码存储契约配合 CASDOOR_PASSWORD_STORAGE.md 完成初始化与迁移不自动转换任何密码。4.3 准备环境变量带鉴权部署建议用更严格的权限创建.envcd docker/astronAgent install -m 600 .env.example .env同样先配置主机地址HOST_BASE_ADDRESShttp://localhost。4.4 配置 Casdoor 认证集成在.env中填写 Casdoor 连接信息# Casdoor配置 CONSOLE_CASDOOR_URLhttp://your-casdoor-server:8000 CONSOLE_CASDOOR_IDyour-casdoor-client-id CONSOLE_CASDOOR_APPyour-casdoor-app-name CONSOLE_CASDOOR_ORGyour-casdoor-org-name.env.example 中的默认值.env.exampleCONSOLE_CASDOOR_URL${HOST_BASE_ADDRESS}:${CASDOOR_PORT}、CONSOLE_CASDOOR_IDastron-agent-client、CONSOLE_CASDOOR_APPastron-agent-app、CONSOLE_CASDOOR_ORGbuilt-in。获取 Casdoor 配置信息首次部署或新建应用/组织时访问 Casdoor 管理控制台http://localhost:8000使用默认管理员账号登录admin / 123创建组织进入http://localhost:8000/organizations页面点击「添加」填写组织名称。在带鉴权部署中官方还特别提示新组织请将密码类型设为 Argon2id不要使用明文密码存储创建应用并绑定组织进入http://localhost:8000/applications页面点击「添加」填写Name自定义应用名称例如agentRedirect URL项目的回调地址。Nginx 暴露端口为80时使用http://your-local-ip/callback其他端口如888时使用http://your-local-ip:888/callbackOrganization选择刚创建的组织名称保存应用后将以下信息与.env配置项一一对应Casdoor 信息项示例值.env中对应配置项Casdoor 服务地址URLhttp://localhost:8000CONSOLE_CASDOOR_URLhttp://localhost:8000客户端 IDClient IDyour-casdoor-client-idCONSOLE_CASDOOR_IDyour-casdoor-client-id应用名称Nameyour-casdoor-app-nameCONSOLE_CASDOOR_APPyour-casdoor-app-name组织名称Organizationyour-casdoor-org-nameCONSOLE_CASDOOR_ORGyour-casdoor-org-name说明.env.example注释指出CONSOLE_DOMAIN变量用于动态设置 Casdoor 的 redirectUrisCasdoor 容器的 entrypoint.sh 会将 redirectUris 替换为${CONSOLE_DOMAIN}/callback因此该值与你的实际访问域名保持一致即可。4.5 启动全部服务含 Casdoorcd docker/astronAgent # 变更服务前先校验完整渲染后的凭据共享与健康检查契约 python3 scripts/verify_security_contract.py --compose-file docker-compose-with-auth.yaml # 新旧数据库均须先完成 docs/zh/CASDOOR_PASSWORD_STORAGE.md 的私有初始化与迁移 # 启动所有服务并等待已配置的健康检查收敛 docker compose -f docker-compose-with-auth.yaml up -d --wait --wait-timeout 900升级注意事项升级时必须让检出的 Compose 清单与应用镜像同步更新——docker compose pull只更新镜像不会更新docker-compose.yaml停止现有服务前应运行仓库提供的部署契约预检并保留.env与命名卷。常规升级禁止使用down -v否则会销毁命名卷中的数据。verify_security_contract.py是仓库提供的部署契约预检脚本scripts/verify_security_contract.py它校验渲染后 Compose 清单中的凭据共享与健康检查契约覆盖console-hub、core-agent、core-workflow等关键服务检查internal-credentials-init生成的workflow_internal_secrets与tenant_bootstrap_secrets是否正确注入到各消费方。此外docker-compose.yaml 中internal-credentials-init一次性容器会在首次启动时自动生成并持久化WORKFLOW_INTERNAL_API_KEY32–128 位安全字符与租户引导凭据TENANT_KEY/TENANT_SECRET32–50 位 URL 安全字符旧版默认的租户凭据会被自动轮换minio-credentials-check一次性容器则会校验对象存储凭据非空、非对称且与 MinIO 根账号一致——这些机制让「零配置」启动与升级自动轮换成为可能。4.6 方案二 plus叠加 RPA 后端能力若需要让 Agent 不仅会思考、还能在数字与桌面环境执行自动化流程使用 docker-compose-with-auth-rpa.yaml它通过include机制在带鉴权栈之上叠加了astronRPA编排对应 DEPLOYMENT_GUIDE_WITH_AUTH_RPA.mdcd docker/astronAgent python3 scripts/verify_security_contract.py --compose-file docker-compose-with-auth-rpa.yaml docker compose -f docker-compose-with-auth-rpa.yaml up -d该清单通过env_file同时加载.env.with-rpa、.env与astronRPA/.env父级.env先加载、astronRPA/.env可覆盖。RPA 后端默认地址配置见.env.exampleRPA_URLhttps://newapi.iflyrpa.com任务创建与查询 URL 分别对应XIAOWU_RPA_TASK_CREATE_URL与XIAOWU_RPA_TASK_QUERY_URL。启动后 RPA 后端服务入口Nginx 代理为http://localhost:32742。五、业务能力账号配置平台账号管理启动后页面配置无论哪种部署方案业务能力账号都不写入.env。启动并登录控制台后在左侧菜单进入平台账号管理与应用管理、资源管理等菜单同级包含四张配置卡片保存后立即全局生效、系统自动刷新缓存、无需重启容器某功能依赖的能力未配置时系统会提示前往平台账号管理配置不会阻塞系统启动。5.1 讯飞开放平台内置星火模型、实时语音转写、图片生成等能力需要准备并在卡片中填写PLATFORM_APP_IDPLATFORM_API_KEYPLATFORM_API_SECRETSPARK_API_PASSWORD星火大模型 API 的额外口令在页面上获取SPARK_RTASR_API_KEY实时语音转写5.2 AI Ability ChatOpenAI 协议用于平台 AI 生成相关能力AI_ABILITY_CHAT_BASE_URLAI_ABILITY_CHAT_MODELAI_ABILITY_CHAT_API_KEY5.3 虚拟人能力SPARK_VIRTUAL_MAN_APP_IDSPARK_VIRTUAL_MAN_API_KEYSPARK_VIRTUAL_MAN_API_SECRET使用虚拟人能力时若服务地址非 localhost / 127.0.0.1需确保是 HTTPS 环境HTTP 环境需配置浏览器绕过不安全来源检查例如 Chrome 的chrome://flags/#unsafely-treat-insecure-origin-as-secure。5.4 知识库平台RAGFlow / 星火知识库二选一RAGFlowRAGFLOW_BASE_URL、RAGFLOW_API_TOKEN、RAGFLOW_TIMEOUT、RAGFLOW_DEFAULT_GROUP星火知识库XINGHUO_DATASET_ID。创建知识库时会选择使用 RAGFlow 或星火知识库只需配置实际使用的平台。获取 RagFlow API Token访问 RagFlow Web 界面http://localhost:18080登录后点击头像进入用户设置点击 API 生成 API KEY在「平台账号管理 - 知识库平台」中填写到RAGFLOW_API_TOKEN。获取星火知识库数据集 ID两种方式方式一页面获取使用讯飞开放平台创建的 APP_ID 和 API_SECRET直接在页面中获取星火数据集 ID详见仓库内的 xinghuo_rag_tool.html。方式二cURL 命令行curl -X PUT https://chatdoc.xfyun.cn/openapi/v1/dataset/create \ -H Accept: application/json \ -H appId: your_app_id \ -H timestamp: $(date %s) \ -H signature: $(echo -n $(echo -n your_app_id$(date %s) | md5sum | awk {print $1}) | openssl dgst -sha1 -hmac your_api_secret -binary | base64) \ -F name我的数据集请将your_app_id替换为实际 APP ID、your_api_secret替换为实际 API Secret。获取数据集 ID 后填入XINGHUO_DATASET_ID。六、可选的 RagFlow 知识库服务部署RagFlow 是开源的 RAG检索增强生成引擎使用深度文档理解技术提供准确的问答服务可按需部署cd docker/ragflow chmod x *.sh docker compose up -d # 查看状态与日志 docker compose ps docker compose logs -f ragflow访问地址http://localhost:18080模型配置步骤点击头像进入Model Providers模型提供商页面选择Add Model添加模型填写对应API 地址和API Key分别添加Chat 模型与Embedding 模型然后在页面右上角点击Set Default Models设置默认模型将二者设为默认重要配置默认使用 Elasticsearch如需使用 OpenSearch、Infinity修改.env中的DOC_ENGINE配置支持 GPU 加速使用docker-compose-gpu.yml启动。macOS 环境可改用 docker-compose-macos.yml。七、方案三Helm / Kubernetes 生产化部署当需要多实例、弹性伸缩与统一运维时切换到 Helm 路径。前置条件可用的 Kubernetes 集群且kubectl已配置、已安装 Helm 3、启用 Ingress 时需要 Ingress Controller推荐ingress-nginx。7.1 快速部署cd helm/astron-agent编辑 values.yaml 的关键配置global: astronAgentVersion: latest hostBaseAddress: http://your-domain.com ingress: enabled: true hosts: - host: your-domain.com tls: hosts: - your-domain.com部署helm install astron-agent . -n astron-agent --create-namespace生产环境配置域名解析后访问http://your-domain.com。业务能力账号同样在系统启动后进入「平台账号管理」配置。7.2 Helm 的凭据与安全设计源码级要点从 values.yaml 可以归纳出与 Docker Compose 一脉相承的凭据管理约定workflowInternalAuthconsole-hub与core-workflow之间特权调用的共享认证existingSecret.name留空时由 Helm 生成并保留随机 SecrettenantBootstrap由 Tenant、Console Hub、Agent、Workflow 共享的引导身份tenantId固定为680ab54f稳定 ID因为已有数据引用它key/secret 与existingSecret.name留空即为零配置安装Helm 生成强随机 Secret并通过lookup在在线升级时复用离线 GitOps 渲染helm template则需引用预创建 Secret因为helm template无法读取集群中已存储的值Langfuse 可观测性langfuse.enabledfalse默认关闭凭据一律通过预创建的 Kubernetes Secret 注入禁止把密钥写进 values.yamlMinIO 端点独立配置global.hostBaseAddress只影响应用 IngressMinIO 端点独立配置启用应用 Ingress 不会顺带暴露对象存储。7.3 无 LoadBalancer 时的 NodePort 外挂 Nginx当集群没有 LoadBalancer云 LB / MetalLB能力时可将 Ingress Controller 以 NodePort 方式暴露再在集群外入口机部署一层 Nginx 监听 80 转发流量kubectl -n ingress-nginx get svc ingress-nginx-controllerserver { listen 80; server_name your-domain.com; location / { proxy_pass http://any-k8s-node-ip:ingress-nodeport; 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; } }八、服务访问地址速查服务地址Astron Agent 控制台前端Nginx 代理http://localhost/Casdoor 管理界面http://localhost:8000RagFlow Web 界面http://localhost:18080RPA 后端服务入口Nginx 代理RPA 部署http://localhost:32742九、常见选择建议与下一步按 docs/zh/guide/deploy.md 的官方建议快速决策只想尽快跑起来优先 Docker Compose标准或带鉴权需要统一身份认证优先带鉴权部署文档DEPLOYMENT_GUIDE_WITH_AUTH.md需要 RPA 时使用 DEPLOYMENT_GUIDE_WITH_AUTH_RPA.md计划进入生产环境结合 Helmhelm/astron-agent、配置说明 与 FAQ 一起评估。推荐的阅读顺序先读本文对应的部署指南再读配置说明遇到问题时查阅 FAQ 与仓库根目录 FAQ.md。此外CASDOOR_PASSWORD_STORAGE.md 是带鉴权部署初始化与升级时必读的密码存储契约文档。最后提醒无论选择哪种部署路径首次部署都建议先在测试环境中验证所有功能再部署到生产环境日常升级遵循「先运行部署契约预检、保留.env与命名卷、禁止down -v」的原则即可让 Astron Agent 从本地体验平滑演进到企业级生产环境。赞分享人工智能AI AgentAgent 工作流RPA后端前端工具调用【免费下载链接】astron-agentAn enterprise-ready AI agent development platform combining intelligent RPA, enabling agents to not only think but also act—automating workflows across digital and desktop environments. 这是一个镜像仓库有issue、pr欢迎去github提交。项目地址https://gitcode.com/ifly_opensource/astron-agent点击查看免费下载相关推荐Astron Agent 部署方式选型与实施指南从 Docker Compose 快速体验到 Helm 生产化Astron Agent 部署方式选型与实施指南从 Docker Compose 快速体验到 Helm 生产化 本文是 Astron Agent企业级智能体人工智能AI AgentAgent 编排RPA后端前端企业应用Astron Agent 部署路线指南从 Docker Compose 快速起步到 Helm/Kubernetes 生产落地Astron Agent 部署路线指南从 Docker Compose 快速起步到 Helm/Kubernetes 生产落地 Astron Agent 是一套人工智能AI AgentAgent 编排RPA后端前端企业应用Astron Agent Helm Chart 部署指南从前置检查到生产级配置的完整实践Astron Agent Helm Chart 部署指南从前置检查到生产级配置的完整实践 Astron Agent 是一个面向企业级、可商用化的 Agenti人工智能AI AgentAgent 编排RPA后端前端企业应用上一篇Wiseflow数据库事务隔离确保并发操作的数据一致性下一篇Sliver 服务器通知Notifications完整配置指南从 Slack/Telegram 到自定义模板创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/14 6:15:40 · 阅读 1.2k Astron Agent 部署指南：从 Docker Compose 快速体验到 Helm 生产化落地的完整选型与实践
人工智能AI AgentAgent 工作流RPA后端前端工具调用【免费下载链接】astron-agentAn enterprise-ready AI agent development platform combining intelligent RPA, enabling agents to not only think but also act—automating workflows across digital and desktop environments. 这是一个镜像仓库有issue、pr欢迎去github提交。项目地址https://gitcode.com/ifly_opensource/astron-agent点击查看免费下载本篇文章围绕 Astron Agent 官方部署文档的完整脉络展开系统讲解「先快速体验、再逐步生产化」的接入思路如何用 Docker Compose 在本地拉起一套可登录、可访问的完整链路如何按需叠加 Casdoor 统一身份认证与 RPA 后端能力以及如何通过 Helm / Kubernetes 走向企业级标准化部署与弹性扩容。读完本文你将掌握 Astron Agent 的部署方式选型、部署前的基础设施与模型密钥准备、两种典型部署路径的核心配置项以及从.env到 Helm values 的关键参数含义与升级注意事项。一、部署方式选型两条主路径按场景决策Astron Agent 官方部署文档给出的建议非常明确当前更适合按「先快速体验、再逐步生产化」的方式接入即先用门槛最低的 Docker Compose 把完整链路跑起来再根据业务需求平滑过渡到 Helm / Kubernetes 部署。这种「渐进式生产化」策略避免了一开始就淹没在大量细节中。Docker Compose本地体验与联调的默认选择优点启动快、上手门槛低适合本地和测试环境典型场景产品演示、研发联调、初次验证架构链路推荐入口快速开始。从仓库实际编排看Docker Compose 方案并非只有几个零散容器而是一整套可独立运行的完整栈。docker-compose.yaml 中包含了基础设施PostgreSQL、MySQL、Redis、MinIO与全部核心服务core-tenant、core-database、core-rpa、core-link、core-aitools、core-agent、core-knowledge、core-workflow以及控制台服务nginx、console-frontend、console-hub所有服务共享astron-agent-network桥接网络并通过命名卷持久化数据。这意味着「快速体验」阶段就能验证 Agent 构建、工作流执行、知识库检索、插件链接等核心业务链路而不仅仅是界面演示。Helm / Kubernetes面向生产的标准化部署优点更适合多实例、弹性伸缩和统一运维典型场景企业集群部署、持续交付、环境隔离相关目录helm/astron-agent。仓库在 helm/astron-agent/Chart.yaml 中提供了名为astron-agent的 Helm ChartREADME 位于 helm/README.md。需要说明的是Helm 路径与 Docker Compose 路径是同一套组件编排的两种承载形态Compose 面向单机/测试环境Helm 面向多实例、弹性伸缩与统一运维的生产集群两者共享同一套业务组件划分与配置语义。二、部署前准备基础设施、模型与鉴权策略三件事无论选择哪种部署方式部署前都需确认以下四类事项对应 docs/zh/guide/deploy.md 的「部署前准备」小节基础设施准备数据库PostgreSQL / MySQL、缓存Redis、对象存储MinIO 或外部 S3等。仓库默认在 Compose 栈中内置这些中间件若使用外部托管实例则需通过.env修改连接地址模型接入与密钥管理确认模型接入方式和密钥管理策略。业务侧模型账号讯飞开放平台、AI Ability Chat、知识库平台等不再写入.env而是启动后通过控制台「平台账号管理」页面配置鉴权选型根据是否需要登录鉴权选择标准部署或带鉴权部署Casdoor能力范围明确是否需要接入 RPA、插件和租户能力决定使用哪一个 Compose 清单。最低硬件门槛来自 DEPLOYMENT_GUIDE.md 的官方前置要求Agent 系统CPU 2 CoreRAM 4 GiBDisk 50 GBRAGFlow 知识库可选CPU 4 CoreRAM 16 GBDisk 50 GB。三、方案一标准部署无鉴权最小可用链路标准部署适合只想尽快跑起来、暂不引入统一身份认证的场景对应 DEPLOYMENT_GUIDE.md。3.1 准备环境变量cd docker/astronAgent cp .env.example .env.env文件只用于配置服务启动、访问地址、认证、数据库、Redis、对象存储等基础设施参数RAGFlow、讯飞开放平台、AI Ability Chat、虚拟人能力、星火知识库等业务能力账号不再写入.env请在 Astron Agent 启动后登录控制台通过平台账号管理页面配置。3.2 配置服务主机地址编辑.envHOST_BASE_ADDRESShttp://localhost使用域名访问时将localhost替换为你的域名仅向用户公开 Astron Agent 的应用入口Nginx/Ingress内置 MinIO API 与管理控制台必须保持安全默认值Docker Compose 仅绑定宿主机回环地址127.0.0.1默认端口18998/18999见 docker-compose.yamlHelm 使用ClusterIP。只有存在明确运维需求并配置独立认证、TLS 与网络策略/防火墙限制时才可显式开放相应端点禁止将 MinIO 直接发布到互联网。3.3 启动核心服务cd docker/astronAgent docker compose up -d启动完成后通过控制台前端Nginx 代理访问http://localhost/。四、方案二带鉴权部署Casdoor 统一身份认证当团队需要统一身份认证、可登录可访问的示例环境时使用带鉴权部署对应 DEPLOYMENT_GUIDE_WITH_AUTH.md 与 快速开始。4.1 组件概览带鉴权部署在标准部署之上引入Casdoor身份认证组件同时可选引入 RagFlow 知识库服务。官方对三大组件的定位是组件角色是否必要Casdoor身份认证和单点登录服务提供 OAuth 2.0、OIDC、SAML 等认证协议支持必要RagFlow知识库和文档检索服务RAG 引擎按需部署Astron Agent核心业务服务集群必要4.2 启动 Casdoor 认证服务可选分步docker-compose-with-auth.yaml已通过include机制将 docker-compose-auth.ymlCasdoor 及其专用 MySQL和 docker-compose.yaml核心服务组合为同一astron-agent-network。也可以先单独启动 Casdoorcd docker/astronAgent docker compose -f docker-compose-auth.yml up -d访问地址http://localhost:8000容器名称casdoor镜像casbin/casdoor:v2.67.0默认配置生产模式GIN_MODErelease。从 docker-compose-auth.yml 可以看到Casdoor 公网访问仅通过casdoor-gatewayNginx提供端口由CASDOOR_PORT默认8000控制casdoor-password-check容器会在发布前只读校验密码存储契约配合 CASDOOR_PASSWORD_STORAGE.md 完成初始化与迁移不自动转换任何密码。4.3 准备环境变量带鉴权部署建议用更严格的权限创建.envcd docker/astronAgent install -m 600 .env.example .env同样先配置主机地址HOST_BASE_ADDRESShttp://localhost。4.4 配置 Casdoor 认证集成在.env中填写 Casdoor 连接信息# Casdoor配置 CONSOLE_CASDOOR_URLhttp://your-casdoor-server:8000 CONSOLE_CASDOOR_IDyour-casdoor-client-id CONSOLE_CASDOOR_APPyour-casdoor-app-name CONSOLE_CASDOOR_ORGyour-casdoor-org-name.env.example 中的默认值.env.exampleCONSOLE_CASDOOR_URL${HOST_BASE_ADDRESS}:${CASDOOR_PORT}、CONSOLE_CASDOOR_IDastron-agent-client、CONSOLE_CASDOOR_APPastron-agent-app、CONSOLE_CASDOOR_ORGbuilt-in。获取 Casdoor 配置信息首次部署或新建应用/组织时访问 Casdoor 管理控制台http://localhost:8000使用默认管理员账号登录admin / 123创建组织进入http://localhost:8000/organizations页面点击「添加」填写组织名称。在带鉴权部署中官方还特别提示新组织请将密码类型设为 Argon2id不要使用明文密码存储创建应用并绑定组织进入http://localhost:8000/applications页面点击「添加」填写Name自定义应用名称例如agentRedirect URL项目的回调地址。Nginx 暴露端口为80时使用http://your-local-ip/callback其他端口如888时使用http://your-local-ip:888/callbackOrganization选择刚创建的组织名称保存应用后将以下信息与.env配置项一一对应Casdoor 信息项示例值.env中对应配置项Casdoor 服务地址URLhttp://localhost:8000CONSOLE_CASDOOR_URLhttp://localhost:8000客户端 IDClient IDyour-casdoor-client-idCONSOLE_CASDOOR_IDyour-casdoor-client-id应用名称Nameyour-casdoor-app-nameCONSOLE_CASDOOR_APPyour-casdoor-app-name组织名称Organizationyour-casdoor-org-nameCONSOLE_CASDOOR_ORGyour-casdoor-org-name说明.env.example注释指出CONSOLE_DOMAIN变量用于动态设置 Casdoor 的 redirectUrisCasdoor 容器的 entrypoint.sh 会将 redirectUris 替换为${CONSOLE_DOMAIN}/callback因此该值与你的实际访问域名保持一致即可。4.5 启动全部服务含 Casdoorcd docker/astronAgent # 变更服务前先校验完整渲染后的凭据共享与健康检查契约 python3 scripts/verify_security_contract.py --compose-file docker-compose-with-auth.yaml # 新旧数据库均须先完成 docs/zh/CASDOOR_PASSWORD_STORAGE.md 的私有初始化与迁移 # 启动所有服务并等待已配置的健康检查收敛 docker compose -f docker-compose-with-auth.yaml up -d --wait --wait-timeout 900升级注意事项升级时必须让检出的 Compose 清单与应用镜像同步更新——docker compose pull只更新镜像不会更新docker-compose.yaml停止现有服务前应运行仓库提供的部署契约预检并保留.env与命名卷。常规升级禁止使用down -v否则会销毁命名卷中的数据。verify_security_contract.py是仓库提供的部署契约预检脚本scripts/verify_security_contract.py它校验渲染后 Compose 清单中的凭据共享与健康检查契约覆盖console-hub、core-agent、core-workflow等关键服务检查internal-credentials-init生成的workflow_internal_secrets与tenant_bootstrap_secrets是否正确注入到各消费方。此外docker-compose.yaml 中internal-credentials-init一次性容器会在首次启动时自动生成并持久化WORKFLOW_INTERNAL_API_KEY32–128 位安全字符与租户引导凭据TENANT_KEY/TENANT_SECRET32–50 位 URL 安全字符旧版默认的租户凭据会被自动轮换minio-credentials-check一次性容器则会校验对象存储凭据非空、非对称且与 MinIO 根账号一致——这些机制让「零配置」启动与升级自动轮换成为可能。4.6 方案二 plus叠加 RPA 后端能力若需要让 Agent 不仅会思考、还能在数字与桌面环境执行自动化流程使用 docker-compose-with-auth-rpa.yaml它通过include机制在带鉴权栈之上叠加了astronRPA编排对应 DEPLOYMENT_GUIDE_WITH_AUTH_RPA.mdcd docker/astronAgent python3 scripts/verify_security_contract.py --compose-file docker-compose-with-auth-rpa.yaml docker compose -f docker-compose-with-auth-rpa.yaml up -d该清单通过env_file同时加载.env.with-rpa、.env与astronRPA/.env父级.env先加载、astronRPA/.env可覆盖。RPA 后端默认地址配置见.env.exampleRPA_URLhttps://newapi.iflyrpa.com任务创建与查询 URL 分别对应XIAOWU_RPA_TASK_CREATE_URL与XIAOWU_RPA_TASK_QUERY_URL。启动后 RPA 后端服务入口Nginx 代理为http://localhost:32742。五、业务能力账号配置平台账号管理启动后页面配置无论哪种部署方案业务能力账号都不写入.env。启动并登录控制台后在左侧菜单进入平台账号管理与应用管理、资源管理等菜单同级包含四张配置卡片保存后立即全局生效、系统自动刷新缓存、无需重启容器某功能依赖的能力未配置时系统会提示前往平台账号管理配置不会阻塞系统启动。5.1 讯飞开放平台内置星火模型、实时语音转写、图片生成等能力需要准备并在卡片中填写PLATFORM_APP_IDPLATFORM_API_KEYPLATFORM_API_SECRETSPARK_API_PASSWORD星火大模型 API 的额外口令在页面上获取SPARK_RTASR_API_KEY实时语音转写5.2 AI Ability ChatOpenAI 协议用于平台 AI 生成相关能力AI_ABILITY_CHAT_BASE_URLAI_ABILITY_CHAT_MODELAI_ABILITY_CHAT_API_KEY5.3 虚拟人能力SPARK_VIRTUAL_MAN_APP_IDSPARK_VIRTUAL_MAN_API_KEYSPARK_VIRTUAL_MAN_API_SECRET使用虚拟人能力时若服务地址非 localhost / 127.0.0.1需确保是 HTTPS 环境HTTP 环境需配置浏览器绕过不安全来源检查例如 Chrome 的chrome://flags/#unsafely-treat-insecure-origin-as-secure。5.4 知识库平台RAGFlow / 星火知识库二选一RAGFlowRAGFLOW_BASE_URL、RAGFLOW_API_TOKEN、RAGFLOW_TIMEOUT、RAGFLOW_DEFAULT_GROUP星火知识库XINGHUO_DATASET_ID。创建知识库时会选择使用 RAGFlow 或星火知识库只需配置实际使用的平台。获取 RagFlow API Token访问 RagFlow Web 界面http://localhost:18080登录后点击头像进入用户设置点击 API 生成 API KEY在「平台账号管理 - 知识库平台」中填写到RAGFLOW_API_TOKEN。获取星火知识库数据集 ID两种方式方式一页面获取使用讯飞开放平台创建的 APP_ID 和 API_SECRET直接在页面中获取星火数据集 ID详见仓库内的 xinghuo_rag_tool.html。方式二cURL 命令行curl -X PUT https://chatdoc.xfyun.cn/openapi/v1/dataset/create \ -H Accept: application/json \ -H appId: your_app_id \ -H timestamp: $(date %s) \ -H signature: $(echo -n $(echo -n your_app_id$(date %s) | md5sum | awk {print $1}) | openssl dgst -sha1 -hmac your_api_secret -binary | base64) \ -F name我的数据集请将your_app_id替换为实际 APP ID、your_api_secret替换为实际 API Secret。获取数据集 ID 后填入XINGHUO_DATASET_ID。六、可选的 RagFlow 知识库服务部署RagFlow 是开源的 RAG检索增强生成引擎使用深度文档理解技术提供准确的问答服务可按需部署cd docker/ragflow chmod x *.sh docker compose up -d # 查看状态与日志 docker compose ps docker compose logs -f ragflow访问地址http://localhost:18080模型配置步骤点击头像进入Model Providers模型提供商页面选择Add Model添加模型填写对应API 地址和API Key分别添加Chat 模型与Embedding 模型然后在页面右上角点击Set Default Models设置默认模型将二者设为默认重要配置默认使用 Elasticsearch如需使用 OpenSearch、Infinity修改.env中的DOC_ENGINE配置支持 GPU 加速使用docker-compose-gpu.yml启动。macOS 环境可改用 docker-compose-macos.yml。七、方案三Helm / Kubernetes 生产化部署当需要多实例、弹性伸缩与统一运维时切换到 Helm 路径。前置条件可用的 Kubernetes 集群且kubectl已配置、已安装 Helm 3、启用 Ingress 时需要 Ingress Controller推荐ingress-nginx。7.1 快速部署cd helm/astron-agent编辑 values.yaml 的关键配置global: astronAgentVersion: latest hostBaseAddress: http://your-domain.com ingress: enabled: true hosts: - host: your-domain.com tls: hosts: - your-domain.com部署helm install astron-agent . -n astron-agent --create-namespace生产环境配置域名解析后访问http://your-domain.com。业务能力账号同样在系统启动后进入「平台账号管理」配置。7.2 Helm 的凭据与安全设计源码级要点从 values.yaml 可以归纳出与 Docker Compose 一脉相承的凭据管理约定workflowInternalAuthconsole-hub与core-workflow之间特权调用的共享认证existingSecret.name留空时由 Helm 生成并保留随机 SecrettenantBootstrap由 Tenant、Console Hub、Agent、Workflow 共享的引导身份tenantId固定为680ab54f稳定 ID因为已有数据引用它key/secret 与existingSecret.name留空即为零配置安装Helm 生成强随机 Secret并通过lookup在在线升级时复用离线 GitOps 渲染helm template则需引用预创建 Secret因为helm template无法读取集群中已存储的值Langfuse 可观测性langfuse.enabledfalse默认关闭凭据一律通过预创建的 Kubernetes Secret 注入禁止把密钥写进 values.yamlMinIO 端点独立配置global.hostBaseAddress只影响应用 IngressMinIO 端点独立配置启用应用 Ingress 不会顺带暴露对象存储。7.3 无 LoadBalancer 时的 NodePort 外挂 Nginx当集群没有 LoadBalancer云 LB / MetalLB能力时可将 Ingress Controller 以 NodePort 方式暴露再在集群外入口机部署一层 Nginx 监听 80 转发流量kubectl -n ingress-nginx get svc ingress-nginx-controllerserver { listen 80; server_name your-domain.com; location / { proxy_pass http://any-k8s-node-ip:ingress-nodeport; 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; } }八、服务访问地址速查服务地址Astron Agent 控制台前端Nginx 代理http://localhost/Casdoor 管理界面http://localhost:8000RagFlow Web 界面http://localhost:18080RPA 后端服务入口Nginx 代理RPA 部署http://localhost:32742九、常见选择建议与下一步按 docs/zh/guide/deploy.md 的官方建议快速决策只想尽快跑起来优先 Docker Compose标准或带鉴权需要统一身份认证优先带鉴权部署文档DEPLOYMENT_GUIDE_WITH_AUTH.md需要 RPA 时使用 DEPLOYMENT_GUIDE_WITH_AUTH_RPA.md计划进入生产环境结合 Helmhelm/astron-agent、配置说明 与 FAQ 一起评估。推荐的阅读顺序先读本文对应的部署指南再读配置说明遇到问题时查阅 FAQ 与仓库根目录 FAQ.md。此外CASDOOR_PASSWORD_STORAGE.md 是带鉴权部署初始化与升级时必读的密码存储契约文档。最后提醒无论选择哪种部署路径首次部署都建议先在测试环境中验证所有功能再部署到生产环境日常升级遵循「先运行部署契约预检、保留.env与命名卷、禁止down -v」的原则即可让 Astron Agent 从本地体验平滑演进到企业级生产环境。赞分享人工智能AI AgentAgent 工作流RPA后端前端工具调用【免费下载链接】astron-agentAn enterprise-ready AI agent development platform combining intelligent RPA, enabling agents to not only think but also act—automating workflows across digital and desktop environments. 这是一个镜像仓库有issue、pr欢迎去github提交。项目地址https://gitcode.com/ifly_opensource/astron-agent点击查看免费下载相关推荐Astron Agent 部署方式选型与实施指南从 Docker Compose 快速体验到 Helm 生产化Astron Agent 部署方式选型与实施指南从 Docker Compose 快速体验到 Helm 生产化 本文是 Astron Agent企业级智能体人工智能AI AgentAgent 编排RPA后端前端企业应用Astron Agent 部署路线指南从 Docker Compose 快速起步到 Helm/Kubernetes 生产落地Astron Agent 部署路线指南从 Docker Compose 快速起步到 Helm/Kubernetes 生产落地 Astron Agent 是一套人工智能AI AgentAgent 编排RPA后端前端企业应用Astron Agent Helm Chart 部署指南从前置检查到生产级配置的完整实践Astron Agent Helm Chart 部署指南从前置检查到生产级配置的完整实践 Astron Agent 是一个面向企业级、可商用化的 Agenti人工智能AI AgentAgent 编排RPA后端前端企业应用上一篇Wiseflow数据库事务隔离确保并发操作的数据一致性下一篇Sliver 服务器通知Notifications完整配置指南从 Slack/Telegram 到自定义模板创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考