一、Anchor介绍

1.1 Anchor简介

Anchor 是一款注重速度、隐私、简洁与可靠性的跨平台笔记应用，支持移动端与网页端，笔记默认本地存储、离线可编辑，并在联网时自动同步。

1.2 Anchor主要特点

• 富文本编辑器：支持加粗、斜体、下划线、标题、列表和复选框等格式化功能。
• 笔记分享：可将笔记以“仅查看”或“可编辑”权限分享给其他用户。
• 标签系统：通过自定义标签及颜色对笔记进行分类管理。
• 笔记背景：支持为笔记设置纯色或图案背景以个性化外观。
• 置顶笔记：可将重要笔记置顶，便于快速访问。
• 归档笔记：将不常用但需保留的笔记移至归档区。
• 本地搜索：支持按标题或内容在本地快速查找笔记。
• 回收站机制：删除笔记后进入回收站，保留一段时间以便恢复。
• 离线优先：所有编辑操作均可在无网络状态下进行，数据保存在本地。
• 自动同步：设备联网时自动同步笔记变更至所有授权设备。
• 管理后台：提供用户管理、注册控制及系统运行统计等管理功能。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下部署Anchor自托管个人笔记工具。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

root@jeven:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
     Active: active (running) since Thu 2026-02-05 00:27:40 CST; 1s ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 841698 (dockerd)
      Tasks: 65
     Memory: 73.5M (peak: 77.1M)
        CPU: 975ms
     CGroup: /system.slice/docker.service

3.2 检查Docker版本

检查Docker版本

root@jeven:~# docker -v
Docker version 28.5.0, build 887030f

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

root@jeven:~# docker compose version
Docker Compose version v2.39.4

四、拉取Anchor镜像

下载Anchor镜像，执行以下命令：

 docker pull ghcr.io/zhfahim/anchor:latest

五、部署Anchor服务

5.1 创建部署目录

• 创建部署目录

mkdir -p /data/anchor/data  && cd /data/anchor

• 在测试环境下，设置目录权限。

 chmod -R 777 /data/anchor

5.2 创建Anchor容器

（可选）如果使用docker-cli方式部署，可参考以下命令。

docker run -d \
   --restart unless-stopped \
   --name anchor \
   -p 7000:3000 \
   -v $(pwd)/data:/data \
   ghcr.io/zhfahim/anchor:latest

新建及编辑docker-compose.yaml文件，宿主机映射端口可自行设置，注意防止端口冲突。

vim docker-compose.yaml

services:
 anchor:
    image: ghcr.io/zhfahim/anchor:latest
    container_name: anchor
    restart: unless-stopped
    ports:
      - "7000:3000"
    volumes:
      - /data/anchor/data:/data

5.3 创建Anchor容器

执行以下命令，创建Anchor容器。

docker compose up -d

5.4 查看Anchor容器状态

检查Anchor容器运行状态，确保Anchor容器正常启动。

root@jeven:/data/anchor# docker compose ps
NAME      IMAGE                           COMMAND                   SERVICE   CREATED         STATUS                            PORTS
anchor    ghcr.io/zhfahim/anchor:latest   "/app/docker-entrypo…"   anchor    3 seconds ago   Up 3 seconds (health: starting)   5432/tcp, 0.0.0.0:7000->3000/tcp, [::]:7000->3000/tcp

5.5 检查Anchor容器日志

检查容器运行日志，确保Anchor服务正常运行。

docker compose logs

六、访问Anchor服务

6.1 访问Anchor初始页

浏览器地址： http://<个人的服务器IP>:7000，访问Anchor初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。

6.2 创建账号

点击“Create one ”项目，自行新建账号。

6.3 新建笔记

我们点击Anchor首页中间的“Create Your First Note ”选项，新建笔记，编辑笔记标题和内容，效果如下所示：

七、总结

Anchor作为一款轻量级自托管笔记工具，通过Docker部署可快速实现本地化知识管理。整个流程依赖明确的目录结构与容器配置，确保数据持久化和服务稳定性。实践过程中需重点关注网络端口暴露与卷挂载路径，避免因权限或路径错误导致服务异常。最终验证表明，该方案在个人或小团队场景下具备良好的可用性与维护效率。