Memory Center 35｜如何部署与维护一个本地优先的 AI 服务

本文属于 Memory Center：AI 编程上下文与记忆系统工程实践，第 35 篇，位于“存储与运维治理”模块。案例背景统一采用实际开发项目；复现步骤使用脱敏教学样例，不代表特定生产事故。

从实际问题出发

容器里的路径与宿主路径不同，服务端也不能读取一个未挂载的本机目录。源码、服务数据和公开入口分开规划，是部署是否可维护的基础。

本地优先需要明确边界

源码以只读方式挂载，服务生成的 catalog、索引和知识写入独立数据目录。本机模式按回环访问假设运行；容器内部监听和宿主端口发布是两件事，不能把本机模式直接开放到公网。

如何部署与维护一个本地优先的 AI 服务：设计链路示意

图中展示的是本篇关注的职责和顺序。正常流程之外，还要结合下面的源码与实验检查失败分支；它不是对某次线上调用的运行时追踪。

维护以可恢复为目标

停止应保留数据卷，备份要覆盖目录与数据库的一致状态，恢复后还需检查登记项目与源码位置。能够重建索引并不表示人工知识可以丢弃。发布包版本、服务状态与当前索引版本也需要分开核对。

关键源码与阅读方法

源码基线为 Memory Center 6e90553（文档标注 5.0.0b24）。定位：memory_center/service/config.py，函数 __post_init__，起始行 18。

以下为当前基线中的函数代码；依赖项目模块，不能作为独立脚本执行。

    def __post_init__(self):
        if not 1 <= self.port <= 65535:
            raise ValueError("端口必须介于 1 和 65535 之间")
        if not self.host:
            raise ValueError("监听地址不能为空")
        if self.auth_mode not in {"local", "token"}:
            raise ValueError("认证模式需为 local 或 token")
        if self.auth_mode == "local" and not self.container_local:
            try:
                loopback = self.host == "localhost" or ipaddress.ip_address(self.host).is_loopback
            except ValueError:
                loopback = False
            if not loopback:
                raise ValueError("免认证模式只允许监听本机；容器仅在宿主回环端口发布时使用 --container-local")

阅读时先找输入由谁提供，再区分纯计算、读取和写入；遇到异常或提前返回，追问调用方会得到什么，以及已有状态是否仍然有效。上面的代码只证明展示范围内的实现，跨模块行为应继续查看调用处和相应测试。

用一个小实验核对设计

建议在独立临时目录和隔离数据中操作，使用虚构的接口、文档与项目名称。

建立隔离数据目录与只读样例挂载。
启动并核对就绪。
备份后停止、恢复，再验证项目与知识。

**要核对的结果：**恢复成功应以可读取的登记和知识为依据，不能只检查容器处于运行状态。

可把观察记录为下表；没有执行的项写“未执行”，不能用设计预期冒充实测结果。

核对项	应保留的证据
使用条件	源码版本、配置、输入与项目范围
正常行为	实际返回、来源位置或状态变化
关键失败分支	错误码、可见结果与原状态是否保留
结论范围	已覆盖、未覆盖和需要进一步验证的条件

适用边界与继续阅读

本篇以静态源码与项目设计为依据，给出可执行的核对方法，未据此宣称已经完成新的性能或生产环境测试。不同版本的入口、默认值和底层实现可能变化，应先核对当前合同，再把方法用于自己的实际开发项目。

理解这一节后，可以回到专题总导航，沿同一模块继续阅读；顺序学习时使用专栏内的上一篇和下一篇。涉及具体技术选择，应连同本篇的代价与限制一起采用。

专题目录

如何部署与维护一个本地优先的 AI 服务