您自己的同步服务器

您将获得

FastMemo 服务器是云同步中 Google Firebase 的自托管替代方案。一个 Docker 容器，一个数据库文件。

• 私密

  笔记在离开您的设备之前就已加密。服务器保存它们，但无法读取。

• 实时

  修改大约一秒内就会出现在您的其他设备上，即使笔记正打开着。

• 不怕离线

  连不上服务器的设备会保留修改，一旦可以就立即发送。

• 带仪表盘

  设备、空间、每日读取/写入/删除次数、警告，以及一键备份。

您需要

• 一台一直开着的电脑：电脑、NAS、VPS，或装有 64 位系统的树莓派 3、4 或 5。
• Docker，它让服务器在自己独立的环境中运行。
• 大约 15 分钟。无需编程：只需复制几条命令。

启动服务器

在将要托管它的电脑上打开终端（Windows 上为 PowerShell），按以下步骤操作。

1. 1

   安装 Docker

   在 Windows 或 macOS 上安装 Docker Desktop (在新标签页中打开)，在 Linux 和树莓派上安装 Docker Engine。

2. 2

   下载服务器

   这会把服务器复制到名为 fastmemo-server 的文件夹，并创建它的设置文件。

   复制

   git clone https://github.com/ontech7/fastmemo-server.git
   cd fastmemo-server
   cp .env.example .env

3. 3

   启动

   服务器现在运行在 8787 端口。重启后它会自动再次启动。

   复制

   docker compose up -d

4. 4

   找到您的访问密钥

   这是您的设备用来连接的密码。服务器首次启动时已生成一个：在这条命令的输出中找到它，并妥善保存。

   复制

   docker compose logs fastmemo

5. 5

   打开仪表盘

   在那台电脑的浏览器中打开 http://localhost:8787 并输入访问密钥：您将看到设备、每日操作和备份。

从手机访问

请使用 https:// 地址：网页版和 Windows 应用只能连接这类地址，而且无论在哪个网络，它都能保护您的笔记标题和设备凭据。选择适合您的方式：

Tailscale（最简单）

在服务器和每台设备上安装 Tailscale (在新标签页中打开)，并用同一个账户登录。然后在服务器上运行：

sudo tailscale serve --bg 8787

它会显示您服务器的地址，例如 https://raspberrypi.your-tailnet.ts.net。如果提示启用 HTTPS 证书，请打开它显示的链接：只需点一下。最后，在 .env 文件中设置 TRUST_PROXY=true，然后再次运行 docker compose up -d。

Coolify

从 fastmemo-server 仓库创建资源，使用 Docker Compose 构建包和 compose 文件 /docker-compose.coolify.yml。为服务设置您的域名并加上 :8787（例如 https://notes.example.com:8787），然后部署：Coolify 会处理 HTTPS 并生成密钥（Environment Variables）。

Caddy（VPS 和域名）

将域名指向服务器，把它写入 .env 文件，然后与 Caddy 一起启动服务器，Caddy 会自动获取 HTTPS 证书：

# in .env: DOMAIN=notes.example.com
docker compose -f docker-compose.caddy.yml up -d

连接 FastMemo

在每台设备上：

1. 1

   打开设置 → Cloud Sync，开启启用云同步。

2. 2

   在同步到中选择 FastMemo 服务器。

3. 3

   输入服务器地址（https://…）和访问密钥，然后点按保存设置。

4. 4

   在第一台设备上设置一个加密密码，并记下显示的恢复密钥。其他设备会要求输入同一个密码。

备份与更新

• 在仪表盘中备份：一个包含全部内容的文件。其中的笔记仍然是加密的，但它也包含标题和访问密钥：请妥善保管。
• 手机丢了？在仪表盘（或应用中的“管理设备”）里移除它：它的访问权限立即失效。
• 要更新服务器，请在它的文件夹中运行这两条命令：

git pull
docker compose up -d --build

须知