• 作者: 作者
  • 时间:
  • 分类: 文章

抛弃臃肿的浏览器书签，自建一个轻量级导航页

还在为浏览器书签栏挤爆、换设备同步麻烦而焦虑吗？或者你也在寻找一个能够聚合常用工具、技术资料和个人收藏的“私人主页”？

最近我发现了一个非常轻量、开源的项目——LiteMark。它不仅仅是一个简单的书签存储工具，更是一个支持多种部署方式（甚至不需要购买服务器）、集成了 AI 和 MCP 协议的现代化导航系统。

今天就来聊聊这个工具的亮点，以及如何快速把它跑起来。

LiteMark 系统界面展示

LiteMark 书签管理系统界面，展示了其清爽的导航设计和集成的基础 AI 功能。

为什么选择 LiteMark？

市面上书签管理工具很多，但 LiteMark 之所以吸引我，主要因为它在“轻量”和“扩展性”之间找到了一个很好的平衡点：

  1. 极简主义，拒绝臃肿：它主打轻量，不依赖复杂的大型数据库，加载速度快，界面清爽。对于只是想把常用链接归类的用户来说，没有多余的学习成本。

  2. 强大的部署灵活性：这是它最大的杀手锏。无论你是技术大佬，还是刚入门的新手，都能找到合适的部署方式。它不仅支持传统的 Docker 部署，还完美支持 Cloudflare Workers 部署。这意味着你甚至可以把它免费托管在 CF 的边缘网络上，全球秒开，完全不需要自己买 VPS！

Cloudflare Workers 部署流程示意图

Cloudflare Workers 控制台部署流程示意，展示了创建 Worker 及绑定配置的关键步骤。

  1. 紧跟 AI 潮流：现在的工具不带 AI 都不好意思出门。LiteMark 集成了基础 AI 功能，并且支持 MCP (Model Context Protocol)。对于喜欢折腾 Agent 或者想在工作流中调用书签数据的朋友来说，这个开放接口非常有价值。

  2. 完全开源，掌控数据：项目在 GitHub 上完全开源，没有未开源的私有部分。所有的数据都掌握在自己手里，不用担心像某浪某瓣那样哪天突然关闭服务或者数据丢失。

两种主流部署方式的保姆级教程

LiteMark 支持多种环境，这里重点介绍最常用的两种：适合有服务器朋友的 Docker 部署，和适合白嫖党的 Cloudflare Workers 部署。

方式一：Docker 部署（适合有 VPS/NAS 的用户）

如果你手头有 Linux 服务器、群晖 NAS 或者装了 Docker 的软路由，这是最正统的跑法。

  1. 安装环境：确保你的机器上已经安装了 Docker 和 Docker Compose。

  2. 拉取镜像：执行以下命令拉取官方镜像（这里以示例命令为主，具体请以 GitHub 最新 README 为准）：

    docker pull topqaz/litemark:latest

  3. 启动容器：使用 docker run 或者编写 docker-compose.yml 文件。为了数据安全，建议挂载一个本地目录来存储配置和书签数据。 简单的启动命令示例：

    docker run -d -p 8080:8080 -v $(pwd)/data:/app/data --name litemark topqaz/litemark:latest

    运行成功后，直接访问 http://你的服务器IP:8080 即可看到界面。

方式二：Cloudflare Workers 部署（零成本，极速访问）

对于没有服务器，或者追求全球边缘加速的用户，CF Workers 是最佳选择。

  1. 准备代码：前往 LiteMark 的 GitHub 仓库，下载适配 Cloudflare Workers 的源码版本。

  2. 部署到 Workers：

    • 登录 Cloudflare 控制台，进入 Workers & Pages。
    • 点击“创建应用程序”，选择“创建 Worker”。
    • 将下载的项目代码上传（如果是使用 Wrangler CLI，直接在项目目录下运行 npx wrangler deploy 即可）。

  3. 绑定 KV 命名空间（如果需要持久化存储）：

    • 大部分基于 Workers 的应用都需要存储数据。在 CF 控制台的 Workers KV 中创建一个 Namespace。
    • 在 Worker 的设置 -> 变量 -> 绑定中，将这个 KV 命名空间绑定到变量名上（具体变量名请参考项目文档，通常为 DB 或类似名称）。

  4. 完成访问：部署完成后，你会获得一个 *.workers.dev 的域名，直接通过浏览器访问即可。如果你有自定义域名，还可以在 Workers 设置中绑定自己的域名。

常见问题与解决方案（Q&A）

在折腾过程中，新手可能会遇到一些小问题，这里集中解答一下：

  • Q：Docker 部署后重启，书签数据不见了？

    • A：检查启动命令时是否正确挂载了 -v 数据卷。如果没有挂载，容器重启后内部文件会重置。请确保将宿主机的目录映射到了容器内的 /app/data 路径。

  • Q：Cloudflare Workers 部署报错 Script size exceeded？

    • A：Workers 对单个脚本的大小有限制。如果项目较大，建议检查是否已经过精简构建，或者尝试使用 Wrangler CLI 进行上传，而不是直接在网页端粘贴代码，这样通常能处理更复杂的项目结构。

  • Q：集成的 AI 功能怎么用？需要配置 Key 吗？

    • A：LiteMark 的 AI 功能需要你提供 API Key。在后台设置或环境变量中填入你自己的 OpenAI 或其他兼容 API 的 Key 即可。数据不会经过第三方服务器（除了你调用的 AI 接口），安全无虞。

总结

LiteMark 是一个非常适合个人用户和小团队使用的导航系统。它没有花里胡哨的营销功能，专注于“书签管理”这个核心需求，同时通过 Docker 和 CF Workers 的支持，极大地降低了自建服务的门槛。

无论是为了整理混乱的技术文档，还是搭建一个家庭内部使用的导航页，它都值得一试。最关键的是，它是完全开源的，你可以随意修改代码来定制自己的专属页面。

如果你对自建服务感兴趣，不妨去 GitHub 下载源码玩一玩！

标签: none

评论已关闭