飞牛搭建全平台书签管理工具Shaarli喂饭教程

前言

前段时间入手了一台HP小主机，装了飞牛，想着把黑群晖里面个人常用的docker应用转到飞牛上，结果在安装过程中出现了一些问题，特此记录下来，既是对此次操作的复盘，也希望能给有类似需求的朋友提供一点参考。

Shaarli简介

Shaarli 是一款开源、轻量级、自托管的个人书签管理工具，用 PHP 编写，无需数据库，所有数据以文件形式保存。它强调“极简、快速、个人掌控”，适合希望脱离第三方服务、完全拥有书签数据的技术用户。

支持书签导入、数据库导出。

演示地址：

用户名: demo、 密码: demo

安装过程

1、利用Docker Compose部署，yaml文件内容如下（红色字体根据自己需要修改）：

version: '3'

services:

shaarli:

container_name: shaarli

image: ghcr.io/shaarli/shaarli:latest

restart: always

# 直接映射端口（宿主机 888 端口 → 容器 80 端口，可修改宿主机端口）

ports:

- 888:80/tcp

volumes:

# 飞牛云自定义持久化路径（数据不丢失），/vol1/1000根据自己路径修改，plugins文件夹映射出来是为了安装一个必要的插件

- /vol1/1000/Docker/shaarli/data:/var/www/shaarli/data

- /vol1/1000/Docker/shaarli/cache:/var/www/shaarli/cache

- /vol1/1000/Docker/shaarli/plugins:/var/www/shaarli/plugins

# 飞牛云核心：匹配宿主机 UID/GID，解决权限问题

user: "1000:1000"

# 启动自动修复目录读写权限（彻底解决 cache/data 不可用问题）

entrypoint: ["/bin/sh", "-c", "chmod -R 775 /var/www/shaarli/cache/ && chmod -R 775 /var/www/shaarli/data/ && /bin/s6-svscan /etc/services.d"]

# 使用默认桥接网络（简化配置，无需自定义网络）

network_mode: bridge

2、部署完成后就可以在Docker容器里面点击链接打开了，开始设置用户名、密码、时区等。

3、由于shaarli点击书签不会新标签页打开，个人感觉使用起来非常不便，需要安装一个第三方插件来实现新标签页打开书签功能。

插件：targetblank.zip 提取码: ce5h，将压缩包解压放至plugins文件夹内。

进入shaarli，点击工具，找到插件管理，然后勾选targetblank即可。

总结

1、一开始是使用的Docker迁移小工具生产的yaml文件部署，项目地址：

结果安装完成后出现文件夹权限错误。最后还是问了豆包，增加了两条命令，完美解决！

2、强烈推荐shaarli搭配个人导航页使用

3、由于plugins文件夹映射出来了，shaarli自带的那些插件就没了我还是从海纳思安装的shaarli里面复制过来的。

4、支持书签导入、数据库导出，也可以直接备份data文件夹、plugins文件夹。

作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～