工作流自动化低代码桌面应用AI Agent后端【免费下载链接】astron-rpaAgent-ready RPA suite with out-of-the-box automation tools. Built for individuals and enterprises.项目地址https://gitcode.com/gh_mirrors/as/astron-rpa点击查看免费下载AstronRPA 是一款面向个人与企业的开源企业级机器人流程自动化RPA桌面应用通过可视化设计器支持低代码/无代码开发让业务人员能快速构建自动化工作流并驱动桌面软件与网页浏览器完成跨应用操作。本文以仓库根目录 README.zh.md 为主体脉络完整覆盖从服务端 Docker 部署、客户端构建到引擎组件生态与 AI Agent 协同的实战路径并深入源码级实现细节帮助读者一次性掌握 AstronRPA 从零搭建到二次开发的关键技术要点。一、项目定位与核心能力1.1 什么是 AstronRPAAstronRPA 是一款企业级 RPA 桌面应用。通过可视化设计器用户无需编写代码即可快速构建工作流实现桌面软件与浏览器页面的自动化。项目采用服务端-客户端架构服务端承载 Web 管理界面、API 服务、数据库与 AI 能力客户端承载 RPA 执行引擎与桌面管理应用两者配合完成任务的调度与执行。1.2 与 Astron Agent 的协同Astron Agent 是该项目原生支持的 Agent 平台。用户既可以在 Astron Agent 中直接调用 RPA 流程节点也可以在 AstronRPA 中使用 Agent 的工作流实现自动化流程与智能体系统的双向调用与能力融合将任务推理、决策判断与自动化执行无缝衔接拓展自动化边界。1.3 六大核心优势优势说明全面自动化支持全面覆盖 Windows 桌面各类软件与浏览器页面自动化支持 WPS、Office 等办公软件金蝶、用友、SAP 等财务及 ERP 系统以及 IE、Edge、Chrome 等多种浏览器实现跨应用端到端自动化高度组件化内置 300 余项常用原子能力覆盖 UI 操作、数据处理、系统交互等场景支持图形化编排与自定义组件扩展企业级安全协同内置卓越中心、团队市场等企业级模块提供终端监控、调度模式、机器人团队共享等协作功能保障流程安全、权限管控与跨团队协作开发体验友好提供低代码、可视化流程设计与调试环境通过拖拽方式快速构建流程降低开发门槛原生 Agent 赋能深度集成 Astron Agent 平台支持自动化流程与 AI 智能体的双向调用多渠道触发集成支持直接运行、计划任务、调度模式、API 调用及 MCP 服务等多种执行方式二、系统要求与环境依赖2.1 系统要求客户端操作系统Windows 10/11主要支持详见 FAQ.zh.md内存 8 GiB服务端部署需要自备服务器与域名详见下文 Docker 部署部分2.2 环境依赖源码部署场景工具版本要求说明Node.js 22JavaScript 运行时Python3.13.xRPA 引擎核心JavaJDK 8后端服务运行时pnpm 9Node.js 包管理器UV0.8Python 包管理工具7-Zip-创建部署归档文件SWIG-连接 Python 与 C/C注意构建客户端不需要Java 和 Docker缺少这两项不影响客户端构建但构建时若安装pywinhook、psycopg2等依赖报错需确保已安装 Microsoft Visual C 14.0 或更高版本编译环境。完整的环境安装方式与常见问题参考 BUILD_GUIDE.zh.md。三、服务端 Docker 部署3.1 部署前准备DNS 与证书推荐使用 Docker 快速部署服务端。自托管部署需要自行准备服务器和域名并在域名当前的权威 DNS 服务商处为网关RPA与认证Casdoor两个子域名添加解析记录同时申请覆盖两个域名的证书。部署者负责域名解析、私钥保管、开放端口和证书续期。完整的 DNS 配置、证书申请DNS-01/HTTP-01、凭据初始化与轮换流程请参阅 docker/HTTPS_DEPLOYMENT.md。核心要点包括DNS 记录中只填 IP 地址或主机名不包含https://、端口或 URL 路径证书的 Subject Alternative NameSAN必须同时覆盖 AstronRPA 与 Casdoor 两个公网域名端口号不写入 SAN证书链与私钥需分别复制到docker/certs/tls.crt和docker/certs/tls.keyHTTPS 模式下若证书/私钥缺失或为空网关容器将拒绝启动fail-closed。3.2 复制 .env 并配置域名# 克隆项目 git clone https://github.com/iflytek/astron-rpa.git cd astron-rpa # 进入 docker 目录 cd docker # 复制 .env cp .env.example .env # 在 .env 中配置公网 HTTPS 域名 RPA_SERVER_NAMErpa.example.com CASDOOR_SERVER_NAMEauth.example.com RPA_HTTPS_REDIRECT_AUTHORITYrpa.example.com CASDOOR_HTTPS_REDIRECT_AUTHORITYauth.example.com:8443 CASDOOR_EXTERNAL_ENDPOINThttps://auth.example.com:8443各配置项含义与取值规则如下来源docker/HTTPS_DEPLOYMENT.md配置项说明DEPLOYMENT_MODE部署模式默认httpslegacy-http为显式的明文兼容模式RPA_SERVER_NAME/CASDOOR_SERVER_NAME仅主机名不含 scheme、端口与路径RPA_HTTPS_REDIRECT_AUTHORITY/CASDOOR_HTTPS_REDIRECT_AUTHORITY外部主机名及非标准端口不含 scheme 与路径CASDOOR_EXTERNAL_ENDPOINTCasdoor 完整公网 HTTPS 源origin包含非标准端口RPA_HTTPS_PORT/CASDOOR_HTTPS_PORT网关与 Casdoor 的 HTTPS 端口默认443/8443TLS_CERTIFICATE_FILE/TLS_CERTIFICATE_KEY_FILE证书与私钥文件名默认tls.crt/tls.keySESSION_COOKIE_SECUREtrue生产环境开启安全 Cookie 标志如果 443/8443 端口被占用可改用自定义端口但需同步修改RPA_HTTPS_PORT、CASDOOR_HTTPS_PORT、两个*_HTTPS_REDIRECT_AUTHORITY、CASDOOR_EXTERNAL_ENDPOINT、客户端remote_addr以及 n8n MCP 端点等全部相关配置。同时注意CASDOOR_ENDPOINT必须保持为容器内部的 HTTP 地址如http://rpa-opensource-casdoor:8000供容器间通信使用。3.3 启动全部服务# 将覆盖上述两个域名的证书和私钥分别复制到 # docker/certs/tls.crt 和 docker/certs/tls.key # 启动所有服务 # 初始化本部署独立的 Casdoor 凭据详见 docker/HTTPS_DEPLOYMENT.md 1.3 docker compose up -d mysql casdoor # 等待 Casdoor 初始化完成 python3 scripts/sync-casdoor-credentials.py docker compose up -d # 检查服务状态 docker compose pspython3 scripts/sync-casdoor-credentials.py脚本位于 docker/scripts/sync-casdoor-credentials.py会从本项目的 MySQL 容器中读取所选应用的 Client ID、生成的 Secret 与公开签名证书并原子化地更新docker/.env权限 0600它不会导出签名私钥也不会打印凭据。若 Casdoor 尚未就绪脚本会在不修改.env的情况下退出可待其就绪后重试。启动成功后docker compose ps的预期输出大致如下具体以实际环境为准NAME STATUS PORTS robot-service Up 30 seconds 0.0.0.0:8080-8080/tcp ai-service Up 30 seconds 0.0.0.0:8001-8001/tcp openapi-service Up 30 seconds 0.0.0.0:8002-8002/tcp mysql Up 30 seconds 0.0.0.0:3306-3306/tcp redis Up 30 seconds 0.0.0.0:6379-6379/tcp3.4 部署验证# 查看服务日志 docker compose logs -f在浏览器访问https://rpa.example.com/api/rpa-auth/user/login-check如果显示{code:900001,data:null,message:unauthorized}表示部署正确且网关链路正常连通在浏览器访问https://auth.example.com:8443如果显示 Casdoor 登录页面则表示认证服务部署正确。3.5 服务端管理命令# 停止服务不删除数据卷 docker compose down # 重启服务 docker compose restart # 查看特定服务日志 docker compose logs -f robot-service # ⬆️ 更新镜像 docker compose pull docker compose up -d # 验证/重载网关证书生产换证时使用 docker compose exec -T openresty-nginx openresty -t docker compose exec -T openresty-nginx openresty -s reload3.6 服务端容器组成源码视角从 docker/docker-compose.yml 可以看到服务端由以下容器构成服务说明mysqlMySQL 8.4.6 数据库启动时依次执行schema.sql及若干初始化 SQL字典数据、示例模板、原子组件元数据等atlas数据库 Schema 迁移工具任务完成即退出日志出现 Schema is synced 即成功属正常现象redis缓存与分布式状态存储bitnami/redisminio对象存储用于文件与资源管理openresty-nginx网关终止公网 TLS内置 Lua 鉴权脚本见 docker/volumes/nginx/lua容器间通信走私有网络 HTTPcasdoor认证服务casbin/casdoor:v2.67.0承载登录页与 OAuth 签发ai-servicePython FastAPI AI 服务backend/ai-serviceopenapi-servicePython FastAPI OpenAPI 服务提供工作流管理、执行、WebSocket 与 MCPbackend/openapi-serviceresource-service资源管理服务Javarobot-service机器人调度服务Javabackend/robot-servicerpa-auth认证网关服务Javabackend/rpa-auth3.7 HTTPS 兼容与回滚legacy-http 明文兼容模式仅用于受控迁移或本地开发docker compose -f docker-compose.yml -f docker-compose.legacy-http.yml up -d需要 Docker Compose 2.24.4。远程部署若确需明文暴露需显式设置RPA_HTTP_BIND_ADDRESS0.0.0.0、CASDOOR_HTTP_BIND_ADDRESS0.0.0.0与LEGACY_CASDOOR_EXTERNAL_ENDPOINT请勿用于新的公网安装。回滚docker compose down后再以 legacy-http 模式启动即可回滚无需恢复数据库、不删除数据卷。四、客户端部署本地客户端包含 RPA 执行引擎与桌面管理应用需部署在执行 RPA 任务的机器上。4.1 直接下载推荐从项目的 Release 页面下载最新安装包。官方也建议优先使用 Release 提供的稳定版安装包避免本地自建客户端可能遇到的配置与环境问题见 FAQ.zh.md。4.2 一键构建准备 Python 环境准备一个 Python 3.13.x 安装目录可以是本地文件夹或系统安装路径脚本会复制该目录来创建python_core。建议使用纯净安装不装额外第三方包以减小打包体积。运行构建脚本项目根目录执行# 完整构建引擎 前端 桌面应用 ./build.bat --python-exe C:\Program Files\Python313\python.exe # 或使用默认配置如果 Python 在默认路径 ./build.bat # 当控制台显示 Full Build Complete! 时表示构建成功构建流程包含检测/复制 Python 环境到build/python_core安装 RPA 引擎依赖包压缩 Python 核心到resources/python_core.7z安装前端依赖构建前端 Web 应用构建桌面应用常用参数参数简写说明--python-exe 路径-p指定 Python 可执行文件路径需指向python.exe而非目录--sevenz-exe 路径-s指定 7-Zip 可执行文件路径--skip-engine-跳过引擎Python构建--skip-frontend-跳过前端构建--help-h显示帮助信息例如./build.bat --skip-frontend # 只构建引擎 ./build.bat --skip-engine # 只构建前端 ./build.bat -p D:\Python313\python.exe -s D:\7-Zip\7z.exe # 组合短参数前端也可手动构建--skip-engine可自动完成同样步骤cd frontend pnpm install pnpm set-env pnpm build:desktop打包产物位于frontend/packages/electron-app/dist/双击 Exe 安装。关于pnpm、UV、7-Zip、SWIG的逐项安装方式参见 BUILD_GUIDE.zh.md。安装后配置服务端地址编辑安装目录下resources/conf.yamlremote_addr: https://rpa.example.com/ skip_engine_start: falseremote_addr需替换为实际部署的 HTTPS 网关域名。客户端远程传输会根据该值推导出https/wss连接并对真实连接做证书校验。五、架构概览项目采用前后端分离架构前端Vue 3 TypeScript Electron 构建桌面应用后端Java Spring Boot 与 Python FastAPI 构建微服务支撑业务与 AI 能力引擎层基于 Python集成 20 RPA 组件支持图像识别与 UI 自动化部署方式整体通过 Docker 部署具备高可观测性与扩展性专为复杂 RPA 场景设计。AstronRPA 前后端分离总体架构图从源码结构看engine 目录引擎层采用组件 服务器 共享库三层组织组件engine/components/提供原子能力服务器engine/servers/提供执行器、调度器、触发器、元素拾取等服务进程共享库engine/shared/沉淀框架核心与通用通信能力。用户通过可视化设计器编排组件形成工作流定义再由执行引擎将工作流生成 Python 脚本并驱动运行。六、组件生态6.1 核心组件包组件包能力astronverse.system系统操作、进程管理、截图astronverse.browser浏览器自动化、网页操作astronverse.gui图形界面自动化、鼠标键盘操作astronverse.excelExcel 表格操作、数据处理astronverse.vision计算机视觉、图像识别astronverse.aiAI 智能服务集成astronverse.network网络请求、API 调用astronverse.email邮件发送和接收astronverse.docxWord 文档处理astronverse.pdfPDF 文档操作astronverse.encrypt加密解密功能6.2 执行框架模块职责astronverse.actionlib原子操作定义和执行astronverse.executor工作流执行引擎astronverse.picker工作流拾取元素引擎astronverse.scheduler引擎调度器astronverse.trigger引擎触发器6.3 共享库模块职责astronverse.baselineRPA 框架核心astronverse.websocketserverWebSocket 通信astronverse.websocketclientWebSocket 通信astronverse.locator元素定位技术6.4 组件定义方式源码视角每个组件包都通过config.yaml声明原子能力atomic及其输入输出参数。以 engine/components/astronverse-system/config.yaml 为例System.screen_shot定义如下结构atomic: System.screen_shot: title: 屏幕截图 comment: 按 {screen_type} 方式截图并保存到 {png_path}输出图片保存路径 {screenshot_path} icon: screen-screenshot inputList: - key: png_path title: 图片保存路径 tip: 输入或选择截图后的文件保存路径 - key: screen_type title: 截图区域 tip: 指定截图区域 - key: top_left_x title: 左上角x坐标 tip: 输入截图的矩形区域左上角横坐标单位为像素px ... outputList: - key: screenshot_path title: 截图保存路径 tip: 每个原子能力包含title显示名、comment流程中的自然语言描述{key}为参数占位符、icon图标以及结构化inputList/outputList输入输出参数含类型与提示。组件包同时通过meta.py生成meta.json元数据并由 engine/meta_json.py 统一合并上传到服务端供前端可视化设计器加载渲染。浏览器组件engine/components/astronverse-browser/config.yaml则展示了完整的网页自动化能力矩阵元素拾取、点击、输入、悬停、滚动、下拉框/复选框操作、数据抓取、Js 脚本执行、Cookie 管理、标签页切换与网页截图等。6.5 引擎执行链路源码视角从 engine/servers/astronverse-executor/src/astronverse/executor/start.py 可以看到执行器的主要命令行参数与流程执行器通过--project_id、--version、--mode等参数启动读取--run_paramJSON 或文件路径注入运行参数执行前调用Flow.gen_component与Flow.gen_code将工作流编译为 Python 脚本运行参数解析run_params.py对encoding json的输入保持原生 JSON 字面量对普通输入走表达式解析路径调试场景支持--debug、--line/--end_line断点调试、--log_wsWebSocket 日志开关、录屏配置--recording_config等执行完成后通过svc.end()上报执行状态SUCCESS/FAIL/CANCEL。引擎入口在 engine/main.py直接调用astronverse.scheduler的主函数。七、多渠道触发与 AI/API 集成AstronRPA 支持直接运行、计划任务、调度模式、API 调用及 MCP 服务等多种执行方式。其中 OpenAPI 服务backend/openapi-service是面向外部系统集成的主入口REST API工作流管理/workflows的 upsert/查询/删除、执行管理/executions的创建/查询/取消、API 密钥管理/api-keys的生成/列表/删除WebSocket 实时通信/ws提供执行状态实时推送、执行日志流与多客户端连接管理MCP 协议支持/mcp支持 AI 模型与工作流的交互采用流式 HTTP 处理生产环境推荐使用Authorization: Bearer API_KEY鉴权也支持X-API-Key请求头默认不接受 URL 查询参数中的?key避免密钥进入浏览器历史与代理日志仅在迁移旧客户端时临时设置MCP_ALLOW_QUERY_API_KEYtrue完整的接口契约见 backend/openapi-service/api.yaml。n8n 集成integrations/n8n将 MCP Client 的 Streamable HTTP 端点配置为https://rpa.example.com/api/rpa-openapi/mcp/使用 API Key 作为 Bearer 凭据即可在外部编排平台中调用 RPA 工作流。八、常见问题速览问题处理建议客户端不支持 Linux开源版客户端目前仅支持 Windows 10/11Atlas 容器启动后自动退出正常它是 Schema 迁移容器日志显示 Schema is synced 即成功客户端无法连接服务端检查网络连通性、防火墙、服务端健康状态及conf.yaml中地址从 Agent 所在机器验证RPA_URL可达安装时提示 Windows Installer 程序包有问题安装/更新 Microsoft Edge WebView2 Runtime本地构建安装pywinhook、psycopg2报错安装 Microsoft Visual C 14.0 编译环境、以管理员权限运行或裁剪astronverse-database/pyproject.toml中不需要的数据库驱动依赖WebSocket 连接失败检查https://域名/api/rpa-openapi/ws端点、代理设置与防火墙规则更多问题排查详见 FAQ.zh.md。九、相关文档与后续学习BUILD_GUIDE.zh.md构建与部署完整指南docker/QUICK_START.mdHTTPS 快速开始docker/HTTPS_DEPLOYMENT.mdDNS、证书、迁移与回滚backend/openapi-service/api.yamlOpenAPI 接口契约engine/components组件开发参考目录FAQ.zh.md常见问题与故障排查仓库采用开源协议发布见 LICENSE由科大讯飞开发维护。开发者可参照上述路径完成部署、构建与二次开发将自动化能力嵌入自身的业务流程与 AI 智能体体系。赞分享工作流自动化低代码桌面应用AI Agent后端【免费下载链接】astron-rpaAgent-ready RPA suite with out-of-the-box automation tools. Built for individuals and enterprises.项目地址https://gitcode.com/gh_mirrors/as/astron-rpa点击查看免费下载相关推荐AstronRPA 开源企业级 RPA 全解析架构设计、Docker 部署与 Python 组件生态实战指南AstronRPA 开源企业级 RPA 全解析架构设计、Docker 部署与 Python 组件生态实战指南 AstronRPA 是一个面向企业与个人的开源工作流自动化桌面应用AI 应用企业应用后端前端AstronRPA 企业级 RPA 桌面平台全解析架构设计、Docker 服务端部署与 Windows 客户端构建实战AstronRPA 企业级 RPA 桌面平台全解析架构设计、Docker 服务端部署与 Windows 客户端构建实战 AstronRPA星辰 RPA是一工作流自动化桌面应用AI 应用企业应用后端前端Photon组件库终极指南快速构建专业级桌面应用界面Photon组件库终极指南快速构建专业级桌面应用界面 Photon是一个专为Electron桌面应用设计的UI工具包通过简单的HTML和CSS就能构建出美观桌面应用UI组件上一篇深度解析ClearerVoice-Studio企业级语音处理AI工具包的核心技术架构与实战应用下一篇Xenia Canary如何在现代PC上完美模拟Xbox 360游戏的终极技术指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考