综合介绍
Hoarder 是一个自主托管的书签管理工具,支持链接、笔记、PDF和图像的存储。它利用 AI 技术进行自动标记,并提供全文搜索功能。用户可以通过 Chrome 插件和 Firefox 插件快速添加书签,还支持 iOS 和 Android 应用。Hoarder 还具备从 RSS 源自动收集内容的功能,确保用户不会错过任何重要信息。
功能列表
- 管理链接、笔记和图像
- 自动获取链接标题、描述和图像
- 将书签分类到不同列表中
- 全文搜索存储的所有内容
- 基于 AI 的自动标记
- 从图像中提取文本的 OCR 功能
- Chrome 和 Firefox 插件快速添加书签
- iOS 和 Android 应用
- 从 RSS 源自动收集内容
- 提供 REST API
- 使用 monolith 进行网页全页存档,防止链接失效
- 使用 youtube-dl 进行视频自动存档
- 支持批量操作
- 支持单点登录(SSO)
- 支持暗模式
- 自主托管优先
使用帮助
安装流程
- Docker
- Docker Compose
1. 创建一个新目录
创建一个新目录,用于存放 compose 文件和环境变量。
2. 下载 compose 文件
下载提供的 Docker Compose 文件:这里。
wget https://raw.githubusercontent.com/hoarder-app/hoarder/main/docker/docker-compose.yml
3. 填写环境变量
为了配置应用,在目录中创建一个 .env
文件,并添加以下基本环境变量文件:
HOARDER_VERSION=release
NEXTAUTH_SECRET=super_random_string
MEILI_MASTER_KEY=another_random_string
NEXTAUTH_URL=http://localhost:3000
你必须更改随机字符串。可以使用 openssl rand -base64 36
来生成随机字符串。同时,需要将 NEXTAUTH_URL
变量改为你的服务器地址。
使用 HOARDER_VERSION=release
会拉取最新的稳定版本。如果希望控制升级,可以固定版本(例如:HOARDER_VERSION=0.10.0
)。查看最新版本:这里。
持久化存储和不同服务之间的连接已经在 Docker Compose 文件中处理好了。
注意,每次更改 .env
文件时,都需要重新运行 docker compose up
。
如果需要更多配置参数,请查看 配置文档。
4. 配置 OpenAI
为了启用自动标记功能,你需要配置 OpenAI。这是可选的,但强烈推荐。
- 按照 OpenAI 的帮助文档 获取 API 密钥。
- 将 OpenAI API 密钥添加到
.env
文件中:
OPENAI_API_KEY=<key>
如果你想使用 Ollama 进行本地推理,可以替代 OpenAI。
5. 启动服务
运行以下命令启动服务:
docker compose up -d
然后访问 http://localhost:3000
,你将看到登录页面。
【可选】6. 启用可选功能
查看 配置文档 以启用额外功能,例如全页面存档、全页面截图、推理语言等。
【可选】7. 设置快速分享扩展
访问 快速分享页面,安装移动应用和浏览器扩展。这些工具将帮助你更快地收集资源!
更新
更新 hoarder 的方式取决于 HOARDER_VERSION
环境变量的设置。
- 如果你将应用固定到特定版本,请更新版本号并重新运行
docker compose up -d
。这会拉取新版本。 - 如果使用了
HOARDER_VERSION=release
,需要强制 Docker 拉取最新版本,运行以下命令:docker compose up --pull always -d
。
使用功能
管理链接、笔记和图像
- 用户可以通过 Chrome 和 Firefox 插件快速添加书签,或者在 iOS 和 Android 应用中直接添加。
- 在 Web 界面中,用户可以查看、编辑和删除已保存的链接、笔记和图像。
自动获取链接标题、描述和图像
- Hoarder 会自动抓取链接的标题、描述和相关图像,方便用户快速了解内容。
将书签分类到不同列表中
- 用户可以创建不同的列表,将书签分类存储,便于管理和查找。
全文搜索存储的所有内容
- Hoarder 提供强大的全文搜索功能,用户可以通过关键词快速找到所需内容。
基于 AI 的自动标记
- Hoarder 利用 AI 技术对存储的内容进行自动标记,帮助用户更好地组织和管理书签。
从图像中提取文本的 OCR 功能
- 用户可以上传图像,Hoarder 会自动提取图像中的文本内容,方便搜索和管理。
从 RSS 源自动收集内容
- 用户可以订阅 RSS 源,Hoarder 会自动收集并存储最新内容,确保用户不会错过任何重要信息。
提供 REST API
- Hoarder 提供 REST API,开发者可以根据需要进行二次开发和集成。
使用 monolith 进行网页全页存档
- Hoarder 使用 monolith 工具对网页进行全页存档,防止链接失效,确保内容长期可用。
使用 youtube-dl 进行视频自动存档
- 用户可以通过 Hoarder 自动存档视频内容,确保视频资源不会丢失。
支持批量操作
- Hoarder 支持批量添加、编辑和删除书签,提升用户操作效率。
支持单点登录(SSO)
- Hoarder 支持单点登录,用户可以方便地使用已有账户进行登录。
支持暗模式
- 用户可以根据喜好切换暗模式,提升使用体验。