因为浏览器书签太难用，我自己做了一个网站导航……

几月前，我开始重建 PKM（个人信息管理）系统，其中有一个环节就是浏览器书签的管理。

实话说，我对于现有的书签程序并不是特别满意，主要因为它们都不能同时满足我的以下几个预期：

在尝试了使用各种软件之后，我偶遇了一个波兰程序员小哥的项目 Flame 。这是一款个人网址导航制作工具，你可以用它将常用的书签和在线应用制成一个美观的本地页面。

不过，Flame 也并不完全符合我的预期。在深入使用这个软件，重构了一部分代码、封装了容器应用，并提交了几个 PR 之后，我想清楚了我到底要的是什么。于是我决定自己动手，基于 Flame 制作了一个外观和功能相仿，但性能更高、数据更透明、使用起来更简单的书签导航工具——Flare。

与原版相比，Flare 保留了美观的界面，但有很大的性能优势：容器镜像体积不到 10MB，内存占用通常低于 30MB，即使添加上千条书签也能「秒开」（每秒 4800—5000 的并发请求下，依旧可以在 1—2 毫秒内打开页面），在笔记本上也不会引发风扇狂转。事实上，Flare 在前端工具的测试中可以拿到满分的成绩，甚至可以跑在一台成本差不多 50 元、搭载 2015 年 S805 芯片的 ARM 盒子上。

此外，我进一步精简了数据存储和网络活动，用纯文本格式来存储书签，并将联网限制在天气展示这唯一一个场景（也可以 完全禁用网络操作 ）。（当然，除了上面这些内容之外，还有一些很小的细节，就留给好奇的你来探索啦！）

接下来，我就想为你介绍如何快速通过 Docker 部署 Flare，从而拥有一个轻巧、美观、受自己掌控的个人书签导航应用。

注： 本文行文考虑到了不同水平的读者：如果你熟悉 Docker，那么将能够在十分钟内拥有属于自己的书签导航；如果你是一个新手，也没关系；跟着文章一步步操作，大概半个小时，相信你也能够将 Flare 运行起来，顺带熟悉 Docker 的使用，步入容器世界的大门。

▍快速安装和使用指南

Flare 的使用方式灵活网页快速添加进书签，丰俭由人。全面起见，我会将常用的方式都讲解一遍，读者根据个人情况选择一种顺手的即可。

准备运行环境：安装 Docker

如上所述，Flare 的下载和安装依赖 Docker。

Docker 的具体安装和配置方式超出了本文的讨论范围，这里只简单提及。如果你是 Mac 或 Windows 用户，最推荐的安装方法还是使用官方的桌面版安装包。如果你用 Linux，相信已经对于命令行的包管理有所熟悉；当然，初学者也可以考虑使用我做的两个简单脚本，分别用来快速安装和初始化 Docker 和常用工具 docker-compose，运行下列命令即可（注：正如在将任何脚本导入终端前应当做的，请先审阅一遍 源文件 ）：

# 安装 Docker

curl -sL | bash

# 国内服务器可改用下列使用国内镜像源的版本

# curl -sL | bash

# 安装 Docker Compose

curl -sL | bash

# 国内服务器可改用下列使用国内镜像源的版本

# curl -sL | bash使用 Docker 快速试用 Flare

在 Docker 环境就绪之后，我们可以通过一条简单的命令启动 Flare：

docker run --rm -it -p 5005:5005 -v `pwd`/app:/app soulteary/flare:latest

这条命令将拉取 Flare 的镜像，将其运行在本地的 5005 端口上，并将当前目录下的 app 目录作为数据存储路径。你可以根据自己的需求更换这些参数。例如希望软件能够换个 8080端口运行，可以将运行参数修改为：

docker run --rm -d -p 8080:5005 -v `pwd`/app:/app soulteary/flare:latest

当命令执行完毕，我们将能看到类似下面的日志输出：

2022/02/17 22:56:46 用户未指定 `FLARE_USER`，使用默认用户名 flare

2022/02/17 22:56:46 用户未指定 `FLARE_PASS`，自动生成应用密码 [...]

[...]

2022/02/17 22:56:46 应用已启动

[...]

这个时候，我们在浏览器中打开:5005，就能够看到书签导航页面了。

▍基本使用和配置

为了方便你了解和使用 Flare，我制作了一个小向导，只需要在原来的地址后面加上 /guide即可访问：:5005/guide。你可以通过这个向导了解 Flare 的基本功能布局。

接下来，就该为 Flare 增加自己所需的链接、显示自己所在城市的天气了。

如上所述，Flare 的配置都通过本地文件完成。初次运行后，查看当前目录，可以看到新出现了如下结构的目录和文件：

app

├── apps.yml

├── bookmarks.yml

└── config.yml

这些就是分别存储着网页应用书签、普通网址书签以及程序配置的数据文件啦，请注意妥善保存和备份。

Flare 的配置和数据都以 YAML 格式保存，可以通过纯文本编辑器直观地修改；在刷新浏览器页面后，Flare 中的内容也会同步更新。

例如，如果我想在 Flare 的「应用」模块增加 Evernote 和 Gmail 的快捷方式，则可以编辑 apps.yml 文件，在其中写上：

links:

- name: Evernote

desc: Evernote 笔记

link:

icon: evernote

- name: Gmail

desc: Gmail 邮件

link:

icon: gmail

# [... 其他需要添加的快捷方式]

其中，每个快捷方式均可以指定标题（name）、描述文字（desc）、链接（link）和图标（icon）。图标的名称可以从 Material Design Icon 网站检索。

「书签」模块的配置（bookmarks.yml）类似，区别在于多了链接分类，在开头的 categories: 下配置：

categories:

- id: cate-id-name-0

title: "链接分类 1"

- id: cate-id-name-1

title: "链接分类 2"

# [... 其他需要添加的分类]

此外，书签模块中的每个链接只有图标和名称，没有描述文字。

最后，在 config.yml 中，可以对如下内容：

等进行设置；根据配置项的名称一看便知，在此不赘述。

使用 Docker Compose 运行

上面的一句话命令固然方便，但终归还是适合尝鲜。如果想要长久使用，每次输入这样的命令就不太方便了。

为此，我们需要用到 Docker Compose。这是用配置文件来定义和运行一个或多个 Docker 应用的辅助工具，类似于一种「食谱」。与手打 Docker 命令相比，它的好处是基于明确的配置文件，可以细粒度地设置应用的功能，而无需记忆各种麻烦的参数。

Docker Compose 使用的配置文件称为「Compose 文件」，本质上也是 YAML 格式。例如，下面这段简短的 Compose 文件就能用来运行 Flare：

version: '3.6'

services:

flare:

image: soulteary/flare:latest

restart: always

command: flare

ports:

- 5005:5005

volumes:

- ./app:/app

上面的配置只用了十行左右的代码，就完成了启动、端口和存储映射、进程守护和自动重启的作用，是不是有点「真香」的味道呢。

写好 Compose 文件后，将其保存为docker-compose.yml，然后运行docker-compose up -d。

稍等片刻，就能在 :5005 看到 Flare 的界面了。

进阶用法：在公网服务器上使用

尽管 Flare 的常见使用场景是在本地运行，但也不排除有的小伙伴希望软件能够跑在云服务器上网页快速添加进书签，比如让吃灰久矣的「轻量云」焕发生机。这就会涉及到两个问题：如何增加登录要求，防止未经授权的访问和修改；以及如何配置自定义域名和反向代理。

对于前者，Flare 支持通过--nologin参数来关闭默认的「免登录模式」：

flare --nologin=0

默认情况下，程序会使用 flare 作为账户名称，并随机生成的管理密码。这可以从运行时输出的日志看到。如果我们想使用自己的指定账号和密码登录的话，可以通过在环境变量中设置 FLARE_USER 和 FLARE_PASS 来实现。

因此，如果使用 Compose 文件来表述，完整的配置是：

version: '3.6'

services:

flare:

image: soulteary/flare:latest

restart: always

command: flare --nologin=0

# 关闭免登录模式

environment:

- FLARE_USER=flare

# 指定的用户名

- FLARE_PASS=password

# 指定的密码

ports:

- 5005:5005

volumes:

- ./app:/app

至于第二个需求，即配置自定义域名和反向代理，我推荐使用 Traefik。这是一个现代的反向代理和负载均衡工具，相比于传统的 Apache、nginx，与 Docker 搭配使用更为方便。

▍写在最后

如果你觉得这个项目有帮到你，欢迎对本文进行点赞转发，让其他的小伙伴也能看到它（用户反馈越多，更新越快）。

如果你是一个代码爱好者，还可以在 GitHub 中为项目点赞给予制作人一个小小的鼓励；如果你希望收到这个项目的更新推送，建议点击 GitHub 项目中的关注并选择适合自己的关注模式，推荐选择 release 模式，一旦有新版出现，你会第一时间得到推送提醒。

当然，非常欢迎你在我主要出没的地方进行留言反馈，一起改进 Flare 的体验。

原文链接：