MemRelay/projects/ebb54e31-5afe-4f9b-a291-4e3b03ca3b21/curated/development/MemRelay System Architecture – Components and Deployment Topology.md

title, type, permalink, stable_id, scope, project_id, workspace_type, usage_profile_id, preference_context, document_type, revision, source_memory_ids, source_checkpoint_ids, source_file_ids, source_git_commit, source_git_commits, source_agent_sync_ids, model_connection, model_name, source_count, source_revisions, source_dispositions, cited_source_ids, job_cited_source_ids, conflicts, supersedes, preferences, source_cursor, source_hash, prompt_version, schema_version, curation_job_id, created_at, updated_at, tags, restored_from_commit

title	type	permalink	stable_id	scope	project_id	workspace_type	usage_profile_id	preference_context	document_type	revision	source_memory_ids	source_checkpoint_ids	source_file_ids	source_git_commit	source_git_commits	source_agent_sync_ids	model_connection	model_name	source_count	source_revisions	source_dispositions	cited_source_ids	job_cited_source_ids	conflicts	supersedes	preferences	source_cursor	source_hash	prompt_version	schema_version	curation_job_id	created_at	updated_at	tags	restored_from_commit
MemRelay System Architecture – Components and Deployment Topology	curated	main/projects/ebb54e31-5afe-4f9b-a291-4e3b03ca3b21/curated/development/mem-relay-system-architecture-components-and-deployment-topology	6b2d8349-7a95-4a18-8e4b-20dd2ab95e2f	project	ebb54e31-5afe-4f9b-a291-4e3b03ca3b21	development	null	development	architecture	1				null			Sub2API	git-restore	20	memory:7ab8ac01-9e4d-4222-b224-7735fdeafdc8 memory:b9a463d1-5659-4baa-aaf4-6464661ef074 memory:b3fc5d7e-f1d7-4a63-860b-37f9f35cb136 memory:23bcc4c0-4992-41d6-b70e-210937a76a0f memory:9092af09-6a60-404e-88ad-3344f2fdf0ca memory:c16b8950-20d2-4d3d-87b3-0a8bfd20790d memory:109e5244-ad26-4650-8a49-e6cebbabe7d7 1 1 1 1 1 1 1	processed unchanged unsupported skipped 20 0 0 0	curated_baseline:6b2d8349-7a95-4a18-8e4b-20dd2ab95e2f curated_baseline:eebf38d3-36dc-4b57-b8d7-1f2c8be2f234 curated_baseline:b54bd6b0-bbdd-4ab2-92d3-a4f5d58e8f83 curated_baseline:47740b04-4f30-47c0-a68c-8fe5e19133e7 curated_baseline:d459e837-b05c-4f31-9b05-7f9d09c71f25 global_guidance_memory:105b328f-4bda-4641-90a7-7282ef156316 global_guidance_memory:3f91189b-11a1-45bb-8357-4f413dc1609d global_guidance_memory:5ed86f53-b53e-4534-8e51-d3a010069d5e global_guidance_memory:bf88c265-4749-4c50-85bc-4bae25298cd5 global_guidance_memory:ff34c6eb-6bba-41e5-9e43-ff80941fa823 memory:7ab8ac01-9e4d-4222-b224-7735fdeafdc8 memory:23bcc4c0-4992-41d6-b70e-210937a76a0f memory:b9a463d1-5659-4baa-aaf4-6464661ef074 memory:9092af09-6a60-404e-88ad-3344f2fdf0ca memory:c16b8950-20d2-4d3d-87b3-0a8bfd20790d memory:109e5244-ad26-4650-8a49-e6cebbabe7d7 memory:b3fc5d7e-f1d7-4a63-860b-37f9f35cb136	curated_baseline:6b2d8349-7a95-4a18-8e4b-20dd2ab95e2f				0	cd96d5b27b5d1ef34ff30350e40c12b9d9b7e389c5813755521578d1f2597d9c	2026-08-12.3	3	null	2026-08-08T09:52:36.631067+00:00	2026-09-23T15:13:21.395620+00:00	architecture	6a6a895eaf

MemRelay 架构概览

高层技术栈

层级	技术
后端	Python 3.12, FastAPI, FastMCP, SQLAlchemy, SQLite
前端	Vue 3, TypeScript, Vite, Element Plus, Vue I18n
记忆引擎	Basic Memory v0.22.1 (Markdown 存储), MiniLM 语义搜索 (降级为全文搜索)
密码库	Vaultwarden (兼容 Bitwarden) 带进程内快照
代理 / CDN	OpenResty (HTTPS 终结, 静态资源缓存)
容器化	Docker Desktop (Windows) & Docker‑Compose (Linux) – 支持 amd64 与 arm64

部署拓扑

• 公网入口: https://mr.asio.asia – OpenResty 终止 TLS 并转发至 FRPS。
• 应用主机: Armbian ARM64 (192.168.32.100) 监听端口 3003。
• Compose 目录: /opt/1panel/docker/compose/memrelay。
• 持久化存储: /data/memrelay-stack（MemRelay 与 Basic Memory 共享挂载）。
• FRP 栈: OpenWrt 上的 FRPC 0.70.1 使用 WebSocket 连接 FRPS；MemRelay_http 将 mr.asio.asia 映射到 192.168.32.100:3003。
• 会话 Cookie: 根据请求协议动态决定 Secure 标记，局域网 HTTP 与公网 HTTPS 均可使用。
• 缓存策略: OpenResty 对登录、API、MCP、密码库、上传下载等端点不启用代理缓存；静态资源使用 ETag 与浏览器缓存。
• 备份: /data/memrelay-backups/memrelay-20260805T234836Z.tar.gz。
• 健康检查: 内网、公网均验证登录、95 个 MCP 工具、Basic Memory、Vaultwarden 与数据迁移均正常。