TencentDB Agent Memory 本地端口 8125、8420、8424、8096 冲突时如何改端口【免费下载链接】TencentDB-Agent-MemoryTencentDB Agent Memory is a team-level memory hub for AI Agents — turning conversations, docs, and code into four reusable memory assets (Chat Memory, Skill, LLM-Wiki, Code-Graph) that are governed, shared, and equipped across agents and frameworks.项目地址: https://gitcode.com/GitHub_Trending/te/TencentDB-Agent-Memory在 macOS / Linux 上用 Docker 本地拉起 TencentDB Agent Memory下称 TDAI的三件套镜像时脚本会把四个宿主机端口固定映射出来8125Panel 面板、8420Memory Gateway、8424Knowledge 知识服务、8096proxy 转发代理。如果这些端口被本机的其他服务占用容器会起不来或访问不到。解决办法很简单启动脚本的所有端口映射都从.env文件读取只需在deploy/global-images/目录下的.env里改四个端口变量重启脚本即可不需要改镜像或改脚本。端口与组件的对应关系deploy/global-images/README.md中定义的三件套端口如下组件容器名默认宿主机端口用途memory-coretdai-memory-core8420内核 gateway记忆读写、鉴权、skill/RAG 数据面memory-hubtdai-memory-hub8125/8424管理面板Panel 知识服务Knowledge合并镜像proxytdai-proxy8096LLM 请求转发代理coding agent 的 API 入口改端口时注意一个前提各启动脚本如 start-memory-hub.sh里的映射写法是-p ${PANEL_PORT}:8125、-p ${KNOWLEDGE_PORT}:8424这类形式即容器内部监听端口是固定的只有冒号左边的宿主机端口可以改。容器之间走共享 docker 网络互访例如 memory-hub 通过http://memory-core:8420调内核不走宿主机端口所以改宿主机端口不影响组件之间的内部链路。在 .env 中修改端口变量前置条件已经在deploy/global-images/下执行过cp .env.example .env并且填好了两组 LLM 参数MEMORY_LLM_*与PROXY_UPSTREAM_*不能是REPLACE_ME否则require_vars校验会直接exit 1。.env模板中的默认值如下见 .env.exampleMEMORY_CORE_PORT8420 PANEL_PORT8125 KNOWLEDGE_PORT8424 PROXY_PORT8096按 README 的“端口冲突”章节 的做法冲突时直接改成可用的端口。文档给出的示例值是加 10000 的偏移MEMORY_CORE_PORT18420 PANEL_PORT18125 KNOWLEDGE_PORT18424 PROXY_PORT18096你换成自己机器上不冲突的端口即可这四个变量是start-all.sh的必填校验项不能留空。必改的联动项KNOWLEDGE_PUBLIC_BASE_URL是 knowledge 的对外可达地址必须跟着KNOWLEDGE_PORT走且必须保留/v3前缀模板中的注释明确写了“必须含 /v3 前缀”KNOWLEDGE_PUBLIC_BASE_URLhttp://host.docker.internal:18424/v3README 的常见问题里专门提到memory-hub 起来了但 Panel 打不开时要检查.env里KNOWLEDGE_PUBLIC_BASE_URL是否漏了/v3——缺了会报错。如果只改了三个端口、忘了改这一项agent / gateway 访问 knowledge 的 tools 接口就会指向旧端口。重启并验证新端口启动脚本是幂等的重复执行会先移除同名旧容器再起新容器数据 volume 保留。所以改完.env后直接重跑./stop-all.sh # 停掉现有容器保留 volume数据还在 ./start-all.sh # 按新端口重新拉起 memory-core → memory-hub → proxy验证方式有三层全部来自脚本自身的输出启动完成的服务地址表。start-all.sh结束时通过 _lib.sh 的print_endpoints打印一张“服务地址”表表中端口是从.env变量渲染的例如改成上面的示例值后表里会显示Panel UI http://localhost:18125/、Knowledge API http://localhost:18424/v3/、Memory Core http://localhost:18420/、Proxy http://localhost:18096/表中数值随你的.env值变化这里仅为示例。health 地址行。start-memory-hub.sh成功等待容器 healthy 后会打印KS Health → http://localhost:${KNOWLEDGE_PORT}/health浏览器或 curl 访问该地址应能通。容器状态与日志。脚本内部通过wait_healthy逐个等待容器进入healthymemory-core 90s、memory-hub 120s、proxy 90s 超时任何一步 unhealthy 会打印最近 30 行容器日志并中止。手动查看可用docker logs -f tdai-memory-core docker logs -f tdai-memory-hub docker logs -f tdai-proxy另外两个使用侧的联动点如果之前把 proxy 当作 coding agent 的 API base例如export ANTHROPIC_BASE_URLhttp://localhost:8096改完PROXY_PORT后要把 URL 里的端口换成新值OpenAI 协议客户端同理http://localhost:新端口/v1。Panel UI 的“客户端接入地址”卡片会自动用宿主机 LAN IP 加PROXY_PORT拼接探测失败才回落localhost其他机器通过卡片 URL 连接时也会跟着走新端口多网卡 / 反代场景下探测不准时可在.env显式设置MEMORY_HUB_PROXY_PUBLIC_URLhttp://真值:新端口覆盖。限制与边界能改的只有宿主机端口容器内端口8125/8420/8424/8096以及容器网络内的组件互访地址如memory-core:8420在脚本中写死不要试图通过改.env去动它们。四个端口变量和KNOWLEDGE_PUBLIC_BASE_URL都要改全漏改KNOWLEDGE_PUBLIC_BASE_URL会导致 knowledge 对外接口指向错误端口Panel 侧报错。环境要求与快速开始文档一致macOS / Linux、DockerDocker Desktop / colima / OrbStack 任一、bash 4。启动前建议先跑./verify.sh干跑校验不启动容器离线环境可加--skip-llm避免改完端口后把启动失败误判为端口问题。【免费下载链接】TencentDB-Agent-MemoryTencentDB Agent Memory is a team-level memory hub for AI Agents — turning conversations, docs, and code into four reusable memory assets (Chat Memory, Skill, LLM-Wiki, Code-Graph) that are governed, shared, and equipped across agents and frameworks.项目地址: https://gitcode.com/GitHub_Trending/te/TencentDB-Agent-Memory创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/13 15:48:34 · 阅读 1.2k TencentDB Agent Memory 本地端口 8125、8420、8424、8096 冲突时如何改端口
TencentDB Agent Memory 本地端口 8125、8420、8424、8096 冲突时如何改端口【免费下载链接】TencentDB-Agent-MemoryTencentDB Agent Memory is a team-level memory hub for AI Agents — turning conversations, docs, and code into four reusable memory assets (Chat Memory, Skill, LLM-Wiki, Code-Graph) that are governed, shared, and equipped across agents and frameworks.项目地址: https://gitcode.com/GitHub_Trending/te/TencentDB-Agent-Memory在 macOS / Linux 上用 Docker 本地拉起 TencentDB Agent Memory下称 TDAI的三件套镜像时脚本会把四个宿主机端口固定映射出来8125Panel 面板、8420Memory Gateway、8424Knowledge 知识服务、8096proxy 转发代理。如果这些端口被本机的其他服务占用容器会起不来或访问不到。解决办法很简单启动脚本的所有端口映射都从.env文件读取只需在deploy/global-images/目录下的.env里改四个端口变量重启脚本即可不需要改镜像或改脚本。端口与组件的对应关系deploy/global-images/README.md中定义的三件套端口如下组件容器名默认宿主机端口用途memory-coretdai-memory-core8420内核 gateway记忆读写、鉴权、skill/RAG 数据面memory-hubtdai-memory-hub8125/8424管理面板Panel 知识服务Knowledge合并镜像proxytdai-proxy8096LLM 请求转发代理coding agent 的 API 入口改端口时注意一个前提各启动脚本如 start-memory-hub.sh里的映射写法是-p ${PANEL_PORT}:8125、-p ${KNOWLEDGE_PORT}:8424这类形式即容器内部监听端口是固定的只有冒号左边的宿主机端口可以改。容器之间走共享 docker 网络互访例如 memory-hub 通过http://memory-core:8420调内核不走宿主机端口所以改宿主机端口不影响组件之间的内部链路。在 .env 中修改端口变量前置条件已经在deploy/global-images/下执行过cp .env.example .env并且填好了两组 LLM 参数MEMORY_LLM_*与PROXY_UPSTREAM_*不能是REPLACE_ME否则require_vars校验会直接exit 1。.env模板中的默认值如下见 .env.exampleMEMORY_CORE_PORT8420 PANEL_PORT8125 KNOWLEDGE_PORT8424 PROXY_PORT8096按 README 的“端口冲突”章节 的做法冲突时直接改成可用的端口。文档给出的示例值是加 10000 的偏移MEMORY_CORE_PORT18420 PANEL_PORT18125 KNOWLEDGE_PORT18424 PROXY_PORT18096你换成自己机器上不冲突的端口即可这四个变量是start-all.sh的必填校验项不能留空。必改的联动项KNOWLEDGE_PUBLIC_BASE_URL是 knowledge 的对外可达地址必须跟着KNOWLEDGE_PORT走且必须保留/v3前缀模板中的注释明确写了“必须含 /v3 前缀”KNOWLEDGE_PUBLIC_BASE_URLhttp://host.docker.internal:18424/v3README 的常见问题里专门提到memory-hub 起来了但 Panel 打不开时要检查.env里KNOWLEDGE_PUBLIC_BASE_URL是否漏了/v3——缺了会报错。如果只改了三个端口、忘了改这一项agent / gateway 访问 knowledge 的 tools 接口就会指向旧端口。重启并验证新端口启动脚本是幂等的重复执行会先移除同名旧容器再起新容器数据 volume 保留。所以改完.env后直接重跑./stop-all.sh # 停掉现有容器保留 volume数据还在 ./start-all.sh # 按新端口重新拉起 memory-core → memory-hub → proxy验证方式有三层全部来自脚本自身的输出启动完成的服务地址表。start-all.sh结束时通过 _lib.sh 的print_endpoints打印一张“服务地址”表表中端口是从.env变量渲染的例如改成上面的示例值后表里会显示Panel UI http://localhost:18125/、Knowledge API http://localhost:18424/v3/、Memory Core http://localhost:18420/、Proxy http://localhost:18096/表中数值随你的.env值变化这里仅为示例。health 地址行。start-memory-hub.sh成功等待容器 healthy 后会打印KS Health → http://localhost:${KNOWLEDGE_PORT}/health浏览器或 curl 访问该地址应能通。容器状态与日志。脚本内部通过wait_healthy逐个等待容器进入healthymemory-core 90s、memory-hub 120s、proxy 90s 超时任何一步 unhealthy 会打印最近 30 行容器日志并中止。手动查看可用docker logs -f tdai-memory-core docker logs -f tdai-memory-hub docker logs -f tdai-proxy另外两个使用侧的联动点如果之前把 proxy 当作 coding agent 的 API base例如export ANTHROPIC_BASE_URLhttp://localhost:8096改完PROXY_PORT后要把 URL 里的端口换成新值OpenAI 协议客户端同理http://localhost:新端口/v1。Panel UI 的“客户端接入地址”卡片会自动用宿主机 LAN IP 加PROXY_PORT拼接探测失败才回落localhost其他机器通过卡片 URL 连接时也会跟着走新端口多网卡 / 反代场景下探测不准时可在.env显式设置MEMORY_HUB_PROXY_PUBLIC_URLhttp://真值:新端口覆盖。限制与边界能改的只有宿主机端口容器内端口8125/8420/8424/8096以及容器网络内的组件互访地址如memory-core:8420在脚本中写死不要试图通过改.env去动它们。四个端口变量和KNOWLEDGE_PUBLIC_BASE_URL都要改全漏改KNOWLEDGE_PUBLIC_BASE_URL会导致 knowledge 对外接口指向错误端口Panel 侧报错。环境要求与快速开始文档一致macOS / Linux、DockerDocker Desktop / colima / OrbStack 任一、bash 4。启动前建议先跑./verify.sh干跑校验不启动容器离线环境可加--skip-llm避免改完端口后把启动失败误判为端口问题。【免费下载链接】TencentDB-Agent-MemoryTencentDB Agent Memory is a team-level memory hub for AI Agents — turning conversations, docs, and code into four reusable memory assets (Chat Memory, Skill, LLM-Wiki, Code-Graph) that are governed, shared, and equipped across agents and frameworks.项目地址: https://gitcode.com/GitHub_Trending/te/TencentDB-Agent-Memory创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考