haishanh/cherry

Cherry 镜像文档

镜像概述

Cherry 是一款开源的自托管书签服务，旨在为用户提供完全自主控制的书签管理解决方案。通过部署此镜像，用户可搭建个人书签系统，无需依赖第三方服务，从而实现书签数据的本地存储与隐私保护，适用于注重数据主权的个人或小型团队使用。

核心功能与特性

核心功能

• 书签管理：支持添加、编辑、删除书签，包含标题、URL、描述等元数据记录
• 分类与标签：提供文件夹分类与标签标记功能，实现书签的多维度组织
• 快速检索：支持按标题、URL、标签等条件搜索书签，提升查找效率
• 导入导出：兼容主流浏览器书签格式（如HTML），支持数据备份与迁移

特性

• 开源免费：基于开源协议发布，代码透明可审计，支持二次开发与定制
• 自托管部署：可在个人服务器、NAS或本地设备运行，数据完全自主掌控
• 轻量级设计：资源占用低，适合低配置环境部署
• 隐私优先：本地存储数据，避免第三方平台的数据收集与分析

使用场景与适用范围

适用场景

• 个人知识管理：学者、开发者整理学术资源、技术文档链接，构建个人知识库
• 内容创作辅助：博主、编辑分类管理素材链接，支持创作灵感整理
• 团队资源共享：小型团队在内部网络部署，共享工作相关书签（需配置访问控制）
• 数据隐私敏感场景：对第三方服务数据存储不信任，需完全掌控数据所有权的用户

适用人群

• 注重数据隐私的个人用户
• 需要高效管理大量网页链接的研究者、内容创作者
• 希望搭建个人知识管理系统的技术爱好者
• 对自托管服务有实践需求的开发者

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+版本推荐）
• （可选）Docker Compose（用于简化部署流程）

快速部署（Docker Run）

通过以下命令快速启动服务：

bash
docker run -d \
  --name cherry \
  -p 8080:8080 \
  -v /path/to/cherry/data:/app/data \
  --restart unless-stopped \
  cherryimage/cherry:latest

参数说明：

• -p 8080:8080：端口映射，格式为主机端口:容器端口，可根据需求修改主机端口
• -v /path/to/cherry/data:/app/data：数据卷挂载，将容器内数据目录映射至主机目录（替换/path/to/cherry/data为实际主机路径）
• --restart unless-stopped：配置容器自动重启策略

Docker Compose 部署

创建docker-compose.yml配置文件：

yaml
version: '3'

services:
  cherry:
    image: cherryimage/cherry:latest
    container_name: cherry
    ports:
      - "8080:8080"  # 端口映射
    volumes:
      - ./cherry-data:/app/data  # 数据持久化
    environment:
      - TZ=Asia/Shanghai  # 设置时区（如Asia/Shanghai）
      - LOG_LEVEL=info     # 日志级别：debug/info/warn/error
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

配置参数说明

环境变量

数据持久化

通过挂载/app/data目录实现数据持久化，避免容器重启导致书签数据丢失。示例：

bash
-v /home/user/cherry-data:/app/data  # 将主机/home/user/cherry-data目录映射至容器数据目录

访问与初始化

部署完成后，通过浏览器访问 http://<主机IP>:<映射端口>（如http://192.168.1.100:8080），首次使用需完成管理员账户创建及基础配置。

总结

Cherry 镜像提供了轻量、安全的自托管书签解决方案，结合开源特性与本地化部署优势，适合注重数据隐私的用户构建个人书签管理系统。通过简单的Docker命令即可快速部署，满足个人或小型团队的书签组织与管理需求。