服务器部署教程

如果你想在私有服务器上部署 Memento 同步服务，实现多设备数据同步，可以按照以下步骤操作。

准备工作

在开始之前，你需要：

• 一台服务器（云服务器、NAS 或本地电脑均可）
• 已安装 Node.js（推荐 18 或更高版本）

如何检查 Node.js 是否已安装？

打开终端（命令行），输入 node -v。如果显示版本号（如 v18.17.0），说明已安装。

安装服务器

最简单的方式：一条命令安装

打开终端（命令行），输入：

npm install -g @hunmer/memento-server

安装完成后，启动服务器：

memento-server

就这么简单！服务器会默认在 8874 端口运行。

修改端口

如果你想使用其他端口（比如 8080）：

Windows PowerShell

$env:PORT=8080; memento-server

Mac / Linux

PORT=8080 memento-server

访问管理界面

启动后，在浏览器打开：

http://你的服务器IP:8874

首次访问会看到管理界面，你可以：

• 注册账号
• 登录管理数据

在 App 中连接服务器

1. 打开 Memento App
2. 进入「设置」→「同步设置」
3. 填写服务器地址：http://你的服务器IP:8874
4. 使用在网页端注册的账号登录

登录后，你的数据会自动在多个设备间同步。

更改数据存储位置

服务器数据默认存储在运行目录下的 data 文件夹。

你可以通过设置环境变量来更改位置：

Windows PowerShell

$env:DATA_DIR="D:\memento-data"; memento-server

Mac / Linux

DATA_DIR=/var/memento-data memento-server

后台运行

如果你希望服务器在后台持续运行（关闭终端后不停止），推荐使用 PM2：

# 安装 PM2
npm install -g pm2

# 启动服务器
pm2 start memento-server

# 设置开机自启
pm2 startup
pm2 save

常见问题

服务器启动后无法访问？

1. 检查防火墙：确保服务器防火墙开放了对应端口（默认 8874）
2. 确认 IP 地址：确保使用的是正确的服务器 IP 地址
3. 检查端口占用：确保端口没有被其他程序占用

如何在局域网使用？

如果你只想在家庭或公司局域网内使用：

• 使用服务器的局域网 IP（如 192.168.1.100）
• 确保你的设备和服务器在同一网络下

数据安全吗？

• 所有数据使用 AES-256 加密存储
• 即使服务器管理员也无法读取你的内容
• 加密密钥由你的设备生成，从不发送到服务器
• 只有你能解密自己的数据

忘记密码怎么办？

Memento 使用端到端加密，密码丢失后数据无法恢复。建议：

• 设置一个容易记住但安全的密码
• 或者将密码记录在安全的地方