Linux 服务器部署
在无桌面环境的 Linux 服务器上以无头模式运行 Nowledge Mem
Nowledge Mem 可以在没有图形界面的 Linux 服务器上以无头模式运行。安装相同的 .deb 或 .AppImage 包，然后通过命令行管理一切。
需要 Pro 许可证
后台智能功能（每日简报、洞察检测、知识图谱丰富）需要 Pro 许可证。服务器本身可在免费版上运行，限制为 20 条记忆。
系统要求
| 要求 | 规格 |
|---|---|
| 操作系统 | Ubuntu 22.04+、Debian 12+、RHEL 9+ 或兼容版本 |
| 架构 | x86_64 |
| 内存 (RAM) | 最低 8 GiB（推荐 16 GiB） |
| 磁盘空间 | 10 GiB 可用空间 |
| 依赖 | libgtk-3-0、libwebkit2gtk-4.1-0、zstd（.deb 自动安装） |
安装
# 安装包
sudo dpkg -i nowledge-mem_*.deb
# 修复缺失的依赖
sudo apt-get install -f.deb 安装后脚本自动完成以下操作：
- 解压内置的 Python 运行时
- 在
/usr/local/bin/nmem创建nmemCLI - 设置桌面启动项（在无头服务器上可忽略）
# 添加可执行权限
chmod +x Nowledge_Mem_*.AppImage
# 首次运行以解压 Python 运行时
./Nowledge_Mem_*.AppImage --appimage-extract
# 首次运行后 nmem CLI 可用
# 路径: ~/.local/bin/nmem验证 CLI 可用：
nmem --version快速开始
启动服务器
nmem serve此命令在前台运行服务器（按 Ctrl+C 停止）。服务器默认在 0.0.0.0:14242 上启动。通过参数自定义：
nmem serve --host 127.0.0.1 --port 8080生产环境建议使用 nmem service install。它会设置一个后台 systemd 服务，开机自动启动。参见下方作为 systemd 服务运行。
激活许可证
nmem license activate <许可证密钥> <邮箱>
nmem license status # 验证激活状态配置 LLM 提供商
Linux 上需要远程 LLM（不支持本地 LLM）：
nmem config provider set anthropic \
--api-key sk-ant-xxx \
--model claude-sonnet-4-20250514
nmem config provider test # 验证连接支持的提供商：anthropic、openai、ollama、openrouter 以及 OpenAI 兼容端点。
启用后台智能
nmem config settings set backgroundIntelligence true
nmem config settings set autoDailyBriefing true验证所有配置
nmem status作为 systemd 服务运行
生产部署建议使用 nmem service install 设置后台 systemd 服务，开机自动启动：
# 一键安装、启用并启动
sudo nmem service install
# 自定义主机/端口
sudo nmem service install --host 0.0.0.0 --port 8080# 无需 root 权限
nmem service install --user管理服务
nmem service status # 查看服务状态
nmem service logs -f # 跟踪服务日志
nmem service stop # 停止服务
nmem service start # 启动服务
nmem service uninstall # 停止、禁用并删除服务如果安装的是用户级服务，请在任何 nmem service 命令后添加 --user。
serve 与 service 的区别
nmem serve | nmem service install | |
|---|---|---|
| 运行方式 | 前台（当前终端） | 后台（systemd） |
| 何时停止 | Ctrl+C 或关闭终端 | nmem service stop 或系统关机 |
| 开机自启 | 否 | 是（自动启用） |
| 适用场景 | 测试、开发 | 生产部署 |
远程访问
默认情况下，服务器监听所有网络接口（0.0.0.0）。从其他机器访问：
# 在远程机器上安装 nmem-cli
export NMEM_API_URL=http://你的服务器:14242
nmem status
nmem m search "查询内容"在远程机器上安装独立 CLI：
pip install nmem-cli
# 或
uv pip install nmem-cli安全提示
服务器不包含身份验证。生产环境中，请通过防火墙规则限制访问，或绑定到 127.0.0.1 并使用 SSH 隧道或带认证的反向代理。
交互式 TUI
使用 TUI 获得交互式终端体验：
nmem tuiTUI 提供完整的设置管理界面，包括许可证激活、LLM 配置和知识处理开关。
配置参考
环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
NMEM_API_URL | http://127.0.0.1:14242 | CLI 命令的服务器地址 |
NOWLEDGE_DB_PATH | 自动检测 | 覆盖数据库位置 |
NOWLEDGE_BACKEND_HOST | 0.0.0.0 | 服务器绑定地址 |
CLI 命令摘要
| 命令 | 描述 |
|---|---|
nmem serve | 在前台启动服务器 |
nmem service install | 安装并启动 systemd 服务 |
nmem service status | 查看 systemd 服务状态 |
nmem service logs -f | 跟踪服务日志 |
nmem service stop / start | 停止或启动服务 |
nmem service uninstall | 删除 systemd 服务 |
nmem status | 检查服务器状态 |
nmem license activate <key> <email> | 激活许可证 |
nmem models download | 下载嵌入模型 |
nmem config provider set <p> --api-key <k> | 配置 LLM 提供商 |
nmem config provider test | 测试 LLM 连接 |
nmem config settings | 显示处理设置 |
nmem config settings set <key> <value> | 更新设置 |
nmem tui | 交互式终端 UI |