PromptX Docker 生产部署指南数据持久化、环境变量与故障排查一次讲透【免费下载链接】PromptXPromptX · 领先的AI 智能体上下文平台 PromptX · Leading AI Agent Context Platform项目地址: https://gitcode.com/Deepractice/PromptXPromptX 是领先的 AI 智能体上下文平台PromptX · Leading AI Agent Context Platform基于 MCP 协议可以用一行命令为 Claude、Cursor 等 AI 应用注入专业能力。本文面向新手和普通用户手把手教你用 Docker 把 PromptX MCP Server 部署到生产环境重点讲透数据持久化、环境变量配置与常见故障排查三大核心问题让你少走弯路、一次跑通。部署后PromptX 会以 HTTP 服务形式运行在5203 端口AI 客户端通过http://127.0.0.1:5203/mcp地址即可接入开箱即用。为什么选择 Docker 部署相比手动安装 Node 环境再跑脚本Docker 部署有三大好处环境一致镜像基于node:20-alpine依赖版本固定不会出现在我机器上能跑的问题。安全隔离容器内以非 root 用户运行降低生产环境风险。一键启停配合restart: unless-stopped服务器重启后服务自动拉起。官方镜像文件位于 Dockerfile编排文件位于 docker-compose.yml部署文档见 docker/README.md。三种快速启动方式方式一直接运行官方镜像推荐新手一条命令即可拉起服务并把数据目录挂载到本地docker run -d \ -p 5203:5203 \ -v $(pwd)/.promptx:/root/.promptx \ --name promptx \ deepracticexs/promptx:latest参数说明-p 5203:5203把容器内的 5203 端口映射到宿主机。-v $(pwd)/.promptx:/root/.promptx把本地.promptx目录挂载进容器这是数据持久化的关键。--name promptx给容器起名方便后续管理。方式二Docker Compose 编排推荐生产进入docker目录后执行cd docker docker-compose up -dCompose 文件默认已配置好端口映射、数据卷、NODE_ENVproduction和自动重启策略适合长期运行。方式三从源码构建镜像如果需要用本地代码构建docker build -t deepracticexs/promptx -f docker/Dockerfile . docker run -d \ -p 5203:5203 \ -v $(pwd)/.promptx:/root/.promptx \ --name promptx \ deepracticexs/promptx数据持久化配置详解这是生产部署最容易踩坑的环节。PromptX 会把用户角色、记忆数据、配置文件统一存放在数据目录中。默认数据位置使用 Docker Compose 时数据默认保存在docker-compose.yml旁边的.promptx文件夹里。Compose 文件中的卷映射为volumes: - ${PROMPTX_DATA:-./.promptx}:/root/.promptx含义是读取环境变量PROMPTX_DATA若未设置则回退到默认的./.promptx。自定义数据目录当你想把数据放到专门的盘符或备份目录时只需设置PROMPTX_DATA环境变量# 临时指定 PROMPTX_DATA/path/to/data docker-compose up -d # 或导出后使用 export PROMPTX_DATA/home/user/.promptx docker-compose up -d生产建议把数据目录放在独立磁盘并纳入定期备份升级镜像时只要保留.promptx目录所有角色与记忆数据都不会丢失。环境变量清单速查变量名作用默认值PROMPTX_DATA自定义数据目录路径./.promptxNODE_ENV运行环境标识production端口服务对外端口5203服务器核心配置端口、主机、传输协议等由 serverConfigManager 管理默认端口正是5203配置文件持久化在.promptx目录中。AI 客户端接入配置服务跑起来后把下面这段填进 Claude Desktop 的 MCP 配置即可{ mcpServers: { promptx: { type: streamable-http, url: http://127.0.0.1:5203/mcp } } }接入成功后PromptX 会暴露discover、action、project、recall、remember、toolx等工具工具集合定义见 tools/index.ts。故障排查清单遇到服务异常时按下面顺序逐一排查能解决 90% 的问题。1. 用健康检查接口验证服务镜像内置了健康检查直接访问curl http://localhost:5203/health正常应返回{ status: ok, service: mcp-server, version: 2.4.1, sessions: 0, uptime: 12.3 }健康检查逻辑实现于 StreamableHttpMCPServer每 30 秒自动探测一次。2. 端口被占用如果启动时报端口冲突换一个映射端口即可docker run -d -p 6000:5203 -v $(pwd)/.promptx:/root/.promptx deepracticexs/promptx:latest3. 数据没有持久化常见原因是挂载路径写错。用下面命令确认容器内的挂载点docker inspect promptx | grep -A 5 Mounts4. 查看实时日志docker logs -f promptx5. 健康检查一直不通过确认PROMPTX_DATA目录存在且容器有写入权限重启容器docker restart promptx观察docker logs中是否有依赖加载报错。总结镜像deepracticexs/promptx:latest端口5203MCP 接入地址http://127.0.0.1:5203/mcp。持久化把.promptx目录挂载到宿主机或用PROMPTX_DATA自定义路径。生产要点开启restart: unless-stopped纳入数据备份用/health接口做服务监控。按照本文步骤操作你应当能用一条命令稳定跑起 PromptX 生产服务并随时快速定位故障。祝部署顺利 【免费下载链接】PromptXPromptX · 领先的AI 智能体上下文平台 PromptX · Leading AI Agent Context Platform项目地址: https://gitcode.com/Deepractice/PromptX创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
企业数字化 ERP 产品动态
相关推荐
LORA+Spectrum加速实战：qwen image2.1 2K出图提速2.8倍 做AI生图这一年多，我感受最深的一件事不是模型效果进步有多快，而是“高质量出图”和“出图速度”这两个目标之间，永远是打架的。尤其是qwen image2.1这类偏底层的开源图像生成模型，本地跑2K分辨率的时候，单张图动辄四五… · 2026/9/26 5:31:12
Visual Studio 2026 环境搭建与编译器配置避坑指南 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/26 5:31:12
CATIA V5-6R2022安装部署全链路验证指南 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/26 5:31:06
城市级低空飞行服务保障与空域管理系统建设方案落地实践 简介：这份《城市级低空飞行服务保障与空域管理系统建设方案》面向低空经济从业者、城市空中交通规划人员及政企信息化方案编写者，围绕城市低空治理的现状痛点，给出从需求分析到工程落地的完整建设思路。方案覆盖监管端、企业端与个人用户三类… · 2026/9/26 6:13:08
大促 AI 网关告警风暴抑制：基于 Alertmanager 聚合与抑制规则实战 大促 AI 网关告警风暴抑制：基于 Alertmanager 聚合与抑制规则实战在大促核心峰值期间，基础设施与网关团队最恐惧的场景之一不是系统出现局部故障，而是遭遇伴随故障而来的**“海量告警风暴（Alert Storm）”。当底层某台物… · 2026/9/26 6:13:08
Blender接入Hyper3D Rodin的MCP协议实操指南 1. 项目概述：这不是“AI一键建模”，而是打通3D工作流的实操接口你搜“Blender MCP 接入 Hyper3D Rodin 教程”时，大概率正卡在某个环节：插件装好了但连不上、API Key填了却报401、模型生成后导不进Blender、或者根本分不清MCP协议… · 2026/9/26 6:13:08
列式存储优化实战：从物理布局到压缩编码的完整调优指南 开头如果你在数据仓库或者分析型数据库里跑过那种“怎么调 SQL 都还是慢”的查询，大概率问题根本不在 SQL，而在存储层。我在一家做用户行为分析的公司干了五年数据工程，最常看到的场景是：一张几十亿行的明细表，每次分析… · 2026/9/26 6:13:08
Notepad++ x64绿色便携配置迁移实战指南 1. 为什么“免安装版”不是点开就能用——Notepad x64绿色便携的本质陷阱Notepad x64免安装版，这个词组在程序员、运维、测试、文档工程师的日常搜索里高频出现，但绝大多数人第一次双击notepad.exe后，看到的只是一个干净得过分的编辑器界面—… · 2026/9/26 6:13:08
Realtek PCIe网卡Win7驱动安装全链路修复指南 1. 这不是普通网卡驱动：Realtek PCIe GBE Family Controller 在 Win7 上的特殊性与真实痛点 你拿到一台二手工控机、老款服务器主板，或者重装 Win7 的台式机，开机后设备管理器里赫然出现一个黄色感叹号——“Realtek PCIe GBE Family Contro… · 2026/9/26 6:13:02
数据库课后习题答案别硬背：当测试用例集刷，效率翻倍 简介：万常选版《数据库原理与设计》课后习题答案资源，覆盖第2至6章及第9章，适合正在学习关系模型、数据库建模、关系数据理论与模式求精的本科生、自学者作为复习与自测材料。压缩包共7个文件，含3个doc参考答案、2个sql示例脚本、… · 2026/9/26 0:00:21
OpenClaw 替代品？Hermes Agent 踩坑实录：macOS 飞书接入 TaoToken 配置 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/26 0:00:40
向下兼容与向上兼容：接口设计中的兼容性策略与工程实践 一次版本升级事故，是很多团队绕不过去的坎。线上环境里，服务端明明已经上线了新版接口，老的移动端还在照着旧文档传参数。请求一到网关，校验直接拒绝，用户操作失败，客服群炸了锅，开发群里开始互… · 2026/9/26 0:00:46
