【Docker项目实战】使用Docker部署Readeck书签管理工具一、Readeck介绍1.1 Readeck简介1.2 Readeck主要特点二、本次实践规划2.1 本地环境规划2.2 本次实践介绍三、本地环境检查3.1 检查Docker服务状态3.2 检查Docker版本3.3 检查docker compose 版本四、拉取Readeck镜像五、部署Readeck服务5.1 创建部署目录5.2 编辑部署文件5.3 创建Readeck容器5.4 查看Readeck容器状态5.5 检查Readeck容器日志六、访问Readeck服务6.1 访问Readeck初始页6.2 注册账号6.3 添加书签七、总结一、Readeck介绍1.1 Readeck简介Readeck是一款简洁高效的 Web 应用程序旨在帮助用户保存网页中真正有价值的可读内容超越传统书签打造个人专属的“数字剪报”。它不仅是一个书签管理器更是一个强大的“稍后阅读”工具让您能永久珍藏喜爱的文章、教程或资讯无论原始网页是否依然存在。1.2 Readeck主要特点一键保存网页精华只需点击一下即可抓取并存储网页的核心可读内容。永久保存珍贵内容即使原网页失效或被删除您保存的内容依然可随时查阅。纯净无干扰的阅读体验自动去除广告、侧边栏等干扰元素呈现清晰整洁的文章排版。智能内容提取精准识别文章主体保留文字、图片和关键格式确保信息完整。便捷的分类与管理支持标签和文件夹功能轻松组织和查找您收藏的各类文章。跨设备同步访问登录您的账户即可在任何设备上无缝访问您的内容库。离线阅读支持保存的内容可离线查看让您随时随地获取所需信息。二、本次实践规划2.1 本地环境规划本次实践为个人测试环境操作系统版本为 Ubuntu 24.04.2 LTS。hostnameIP地址操作系统版本Docker版本部署项目备注jeven192.168.3.88Ubuntu 24.04.2 LTS28.3.3Readeck——2.2 本次实践介绍1.本次实践部署环境为个人测试环境生产环境请谨慎2.在Docker环境下部署Readeck书签管理工具。三、本地环境检查3.1 检查Docker服务状态检查Docker服务是否正常运行确保Docker正常运行。rootjeven:~# systemctl status docker● docker.service - Docker Application Container Engine Loaded: loaded(/usr/lib/systemd/system/docker.service;enabled;preset: enabled)Active: active(running)since Thu2025-09-1821:50:05 CST;3days ago TriggeredBy: ● docker.socket Docs: https://docs.docker.com Main PID:858(dockerd)Tasks:30Memory:5.2G(peak:5.4G)CPU: 11min54.268s CGroup: /system.slice/docker.service3.2 检查Docker版本检查Docker版本rootjeven:~# docker -vDocker version28.3.3, build 980b8563.3 检查docker compose 版本检查Docker compose版本确保2.0以上版本。dockercompose version四、拉取Readeck镜像下载Readeck容器镜像如下所示dockerpull codeberg.org/readeck/readeck:0.20.3五、部署Readeck服务5.1 创建部署目录创建部署目录mkdir-p/data/readeck/datacd/data/readeck5.2 编辑部署文件使用docker-cli方式部署可参考以下命令dockerrun-d\--restartalways\--namereadeck\-p5200:8000\-v/data/readeck/data:/readeck\codeberg.org/readeck/readeck:0.20.3在部署目录下创建docker-compose.yaml文件内容如下所示vimdocker-compose.yamlversion:3services:readeck:image:codeberg.org/readeck/readeck:0.20.3container_name:readeckrestart:alwaysports:-5200:8000volumes:-/data/readeck/data:/readec5.3 创建Readeck容器执行以下命令创建Readeck容器。dockercompose up-d5.4 查看Readeck容器状态检查Readeck容器运行状态确保Readeck容器正常启动。rootjeven:/data/readeck# docker compose psWARN[0000]/data/readeck/docker-compose.yaml: the attributeversionis obsolete, it will be ignored, please remove it to avoid potential confusion NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS readeck codeberg.org/readeck/readeck:0.20.3/bin/readeck serve …readeck2minutes ago Up2minutes0.0.0.0:5200-8000/tcp,[::]:5200-8000/tcp5.5 检查Readeck容器日志检查容器运行日志确保Readeck服务正常运行。rootjeven:/data/readeck# docker compose logsWARN[0000]/data/readeck/docker-compose.yaml: the attributeversionis obsolete, it will be ignored, please remove it to avoid potential confusion readeck|{time:2025-09-22T17:28:13.79547846Z,level:INFO,msg:workers started,num:4}readeck|{time:2025-09-22T17:28:13.795583922Z,level:INFO,msg:server started,addr:tcp://0.0.0.0:8000,url:http://localhost:8000/}六、访问Readeck服务6.1 访问Readeck初始页浏览器地址http://个人的服务器IP:5200访问Readeck初始页。如果无法访问请确保宿主机的防火墙已关闭或已放行相关端口对于云服务器还需配置相应的安全组规则。6.2 注册账号自定义设置账号密码后点击“完成安装”。6.3 添加书签将博客文章链接复制粘贴到Readeck首页地址栏点击“保存链接”。可以看到书签列表中刚才添加的网页我们点击即可在线浏览文章内容。七、总结通过本次实践我们成功使用Docker快速部署了Readeck书签管理工具整个过程简洁高效体现了容器化部署的优势。Readeck凭借其清爽的界面和强大的网页内容保存能力为个人知识管理提供了理想的解决方案。结合Docker的隔离性与可移植性Readeck服务更易于维护和扩展保障了数据的持久化与安全性。未来可以进一步探索其标签管理和跨设备同步功能深度打造个性化的“数字第二大脑”。